Migrar a Managed Postgres con ClickHouse Cloud

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.
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.

Conéctate a tu base de datos de origen

Abre la consola de ClickHouse Cloud y selecciona tu servicio de Managed Postgres.En la barra lateral izquierda, haz clic en orígenes 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 origen lo requiere.Si necesitas una conexión privada a tu base de datos de origen, puedes optar por 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.

Exporta el esquema de tu base de datos

El asistente muestra un comando pg_dump ya rellenado con los datos de conexión de tu origen. Ejecútalo en una terminal:

pg_dump \
  -h <source_host> \
  -U <source_user> \
  -d <source_database> \
  --schema-only \
  -f pg.sql

Esto crea pg.sql en tu directorio actual.Haz clic en Next.

Importa el esquema en tu servicio de Managed Postgres

Selecciona la base de datos de destino en el menú desplegable o haz clic en Create a new database 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:

psql \
  -h <target_host> \
  -p 5432 \
  -U <target_user> \
  -d <target_database> \
  -f pg.sql

Haz clic en Next.

Configura los ajustes de ingestión

Especifica la publicación que se usará para la replicación lógica. Si dejas este campo en blanco, se crea una publicación automáticamente.Expande Advanced replication settings para ajustar el rendimiento:

Ajuste	Predeterminado	Descripción
Intervalo de sincronización (segundos)	10	Frecuencia con la que se consulta el slot 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 obtenidas por lote de replicación
Número de filas de la instantánea por partición	100000	Tamaño de la partición para instantáneas de tablas grandes
Número de tablas de la instantánea en paralelo	1	Tablas cuya instantánea se toma de forma concurrente

Haz clic en Next.

Selecciona tablas

Selecciona las tablas que quieres replicar. Las tablas están agrupadas por esquema. Selecciona tablas individuales o expande un esquema para elegirlas todas.Haz clic en Create migration.

Supervisar la migración

Después de crear la migración, la verá en orígenes 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:

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:

ALTER DATABASE <source_db> SET default_transaction_read_only = on;

Confirme que la replicación esté al día. Compare la última fila del origen y del destino:

-- 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:

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:

SELECT pg_drop_replication_slot('<slot_name>');

Primeros pasos

Características

Benchmarks

Precios

Integración de ClickHouse

Migraciones

Monitorización

FAQ

Migrar a Managed Postgres con ClickHouse Cloud

Requisitos previos

Consideraciones antes de migrar

Supervisar la migración

Tareas posteriores a la migración

Siguientes pasos

​Requisitos previos

​Consideraciones antes de migrar

​Supervisar la migración

​Tareas posteriores a la migración

​Siguientes pasos

Requisitos previos

Consideraciones antes de migrar

Supervisar la migración

Tareas posteriores a la migración

Siguientes pasos