> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-fix-nav-issues.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Migrar a Managed Postgres con ClickHouse Cloud
> Aprende a migrar tu base de datos de PostgreSQL a ClickHouse Managed Postgres con el asistente de importación integrado de orígenes de datos de ClickHouse Cloud.
export const Image = ({img, alt, size}) => {
return
;
};
export const galaxyOnClick = eventName => () => {
try {
if (typeof window !== "undefined" && window.galaxy && eventName) {
window.galaxy.track(eventName, {
interaction: "click"
});
}
} catch (e) {}
};
export const BetaBadge = ({link, galaxyTrack, galaxyEvent}) => {
if (link) {
return
Beta
;
}
return ;
};
ClickHouse Cloud incluye un asistente de importación integrado que migra tu base de datos externa de PostgreSQL a un servicio de Managed Postgres. El asistente gestiona la conexión de origen, la exportación e importación del esquema, la configuración de replicación y la selección de tablas en cinco pasos guiados.
## Requisitos previos
* Acceso a la base de datos PostgreSQL de origen con un usuario que tenga privilegios de replicación.
* Un servicio de ClickHouse Managed Postgres como destino de la migración. Si aún no dispone de uno, consulte la [guía de inicio rápido](/es/products/managed-postgres/quickstart).
* `pg_dump` y `psql` instalados en la máquina local. Ambos se incluyen con las herramientas estándar del cliente de PostgreSQL.
## Consideraciones antes de migrar
* **Propagación de DDL**: la replicación continua (CDC) captura las operaciones DML y `ADD COLUMN`. Otros cambios de DDL, como `DROP COLUMN` y `ALTER COLUMN`, no se propagan y deben aplicarse manualmente en el sistema de destino.
## Paso 1: Conéctate a tu base de datos de origen
Abre la [consola de ClickHouse Cloud](https://clickhouse.cloud) y selecciona tu servicio de Managed Postgres.
En la barra lateral izquierda, haz clic en **fuentes de datos**.
Haz clic en **Start import**.
Completa los datos de conexión de tu base de datos PostgreSQL de origen: host, puerto, nombre de usuario, contraseña y nombre de la base de datos. Habilita **TLS** si tu base de datos de origen lo requiere.
Si necesitas una conexión privada a tu base de datos de origen, puedes usar **SSH tunneling** y proporcionar los datos de SSH necesarios. Esto permite que la migración se conecte de forma segura a bases de datos que no son accesibles públicamente.
Elige un método de ingestión:
* **Initial load + CDC** — copia los datos existentes y luego mantiene el destino sincronizado con los cambios en curso.
* **Initial load only** — copia única, sin replicación continua.
* **CDC only** — omite la copia inicial y replica solo los cambios nuevos a partir de este momento.
Haz clic en **Next**.
## Paso 2: Exporta el esquema de tu base de datos
El asistente muestra un comando `pg_dump` ya completado con los datos de conexión del origen. Ejecútalo en una terminal:
```shell theme={null}
pg_dump \
-h \
-U \
-d \
--schema-only \
-f pg.sql
```
Esto crea `pg.sql` en el directorio actual.
Haz clic en **Next**.
## Paso 3: Importa el esquema en tu servicio de Managed Postgres
Selecciona la base de datos de destino en el menú desplegable o haz clic en **Crear una base de datos nueva** para aprovisionar una.
El asistente muestra un comando `psql` para aplicar el volcado del esquema a tu servicio de Managed Postgres. Ejecútalo en una terminal:
```shell theme={null}
psql \
-h \
-p 5432 \
-U \
-d \
-f pg.sql
```
Haz clic en **Siguiente**.
## Paso 4: Configurar la ingestión
Especifique la publicación que se usará para la replicación lógica. Si deja este campo en blanco, se creará una publicación automáticamente.
Expanda **Configuración avanzada de replicación** para ajustar el rendimiento:
| Configuración | Predeterminado | Descripción |
| ----------------------------------------------- | -------------- | ------------------------------------------------------------ |
| Intervalo de sincronización (segundos) | 10 | Frecuencia con la que se consulta la ranura de replicación |
| Hilos en paralelo para la carga inicial | 4 | Número de hilos para la fase de copia masiva |
| Tamaño del lote de extracción | 100,000 | Filas recuperadas por lote de replicación |
| Número de filas por partición en la instantánea | 100000 | Tamaño de la partición para instantáneas de tablas grandes |
| Número de tablas en paralelo en la instantánea | 1 | Tablas de las que se toman instantáneas de forma concurrente |
Haga clic en **Siguiente**.
## Paso 5: Seleccionar tablas
Selecciona las tablas que quieres replicar. Las tablas se agrupan por esquema. Selecciona tablas individuales o expande un esquema para seleccionarlas todas.
Haz clic en **Crear migración**.
## Supervisar la migración
Después de crear la migración, la verá en **Fuentes de datos** con el estado **En ejecución**.
Haga clic en la migración para abrir la vista detallada. La pestaña **Tablas** muestra el progreso de la carga inicial de cada tabla, incluidas las filas procesadas, las particiones y el tiempo promedio por partición. La pestaña **Métricas** muestra el retraso de replicación y el rendimiento una vez que comienza CDC.
## Tareas posteriores a la migración
Una vez completada la carga inicial y, si usa CDC, cuando el retraso de replicación sea casi nulo:
**Valide los recuentos de filas.** Compruebe las tablas críticas tanto en el origen como en el destino antes de redirigir el tráfico:
```sql theme={null}
SELECT COUNT(*) FROM public.orders;
```
**Detenga las escrituras en el origen.** Pause las escrituras de la aplicación. Para habilitar el modo de solo lectura durante la transición:
```sql theme={null}
ALTER DATABASE SET default_transaction_read_only = on;
```
**Confirme que la replicación esté al día.** Compare la última fila del origen y del destino:
```sql theme={null}
-- Ejecutar en el origen y en el destino
SELECT MAX(id), MAX(updated_at) FROM public.orders;
```
**Restablezca las secuencias.** Alinee las secuencias con los valores máximos actuales de cada tabla:
```sql theme={null}
DO $$
DECLARE r RECORD;
BEGIN
FOR r IN
SELECT
n.nspname AS schema_name,
c.relname AS table_name,
a.attname AS column_name,
pg_get_serial_sequence(format('%I.%I', n.nspname, c.relname), a.attname) AS seq_name
FROM pg_class c
JOIN pg_namespace n ON n.oid = c.relnamespace
JOIN pg_attribute a ON a.attrelid = c.oid
WHERE c.relkind = 'r'
AND a.attnum > 0
AND NOT a.attisdropped
AND n.nspname NOT IN ('pg_catalog', 'information_schema')
LOOP
IF r.seq_name IS NOT NULL THEN
EXECUTE format(
'SELECT setval(%L, COALESCE((SELECT MAX(%I) FROM %I.%I), 0) + 1, false)',
r.seq_name, r.column_name, r.schema_name, r.table_name
);
END IF;
END LOOP;
END $$;
```
**Redirija el tráfico de la aplicación.** Dirija las operaciones de lectura y escritura a su servicio de Managed Postgres y supervise si se producen errores, violaciones de restricciones y problemas en el estado de la replicación.
**Limpieza.** Una vez que haya redirigido el tráfico y confirmado que el nuevo servicio está en buen estado, elimine la migración de **fuentes de datos**. Si usó CDC, elimine el slot de replicación del origen para liberar recursos:
```sql theme={null}
SELECT pg_drop_replication_slot('');
```
## Próximos pasos
* [Guía de inicio rápido de Managed Postgres](/es/products/managed-postgres/quickstart)
* [Detalles de conexión de Managed Postgres](/es/products/managed-postgres/connection)
* [FAQ de ClickPipes para Postgres](/es/integrations/clickpipes/postgres/faq)