> ## Documentation Index > Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Migre para o Managed Postgres usando o ClickHouse Cloud > Saiba como migrar seu banco de dados PostgreSQL para o ClickHouse Managed Postgres usando o assistente integrado de importação das Fontes de dados no ClickHouse Cloud. export const Image = ({img, alt, size = "lg"}) => { const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg"; return
{alt}
; }; export const BetaBadge = ({link, galaxyTrack, galaxyEvent}) => { if (link) { return Beta ; } return
Funcionalidade Beta.  Saiba mais.
; }; O ClickHouse Cloud inclui um assistente integrado de importação que migra seu banco de dados PostgreSQL externo para um serviço Managed Postgres. O assistente gerencia a conexão com a origem, a exportação e importação do esquema, as configurações de replicação e a seleção de tabelas em cinco etapas guiadas.
## Pré-requisitos
* Acesso ao seu banco de dados PostgreSQL de origem com um usuário que tenha privilégios de replicação. * Um serviço ClickHouse Managed Postgres como destino da migração. Se você ainda não tiver um, consulte o [quickstart](/docs/pt-BR/products/managed-postgres/quickstart). * `pg_dump` e `psql` instalados na sua máquina local. Ambos vêm com as ferramentas padrão do cliente PostgreSQL.
## Considerações antes da migração
* **Propagação de DDL**: a replicação contínua (CDC) captura operações de DML e `ADD COLUMN`. Outras alterações de DDL, como `DROP COLUMN` e `ALTER COLUMN`, não são propagadas e precisam ser aplicadas manualmente no destino. Abra o [console do ClickHouse Cloud](https://clickhouse.cloud) e selecione seu serviço Managed Postgres. Cartão do serviço Managed Postgres na lista de serviços do ClickHouse Cloud Na barra lateral esquerda, clique em **Fontes de dados**. Entrada Fontes de dados na barra lateral do serviço Managed Postgres Clique em **Start import**. Página Fontes de dados com o botão Start import Preencha os detalhes de conexão do banco de dados PostgreSQL de origem: host, porta, nome de usuário, senha e nome do banco de dados. Ative **TLS** se a origem exigir. Se precisar de uma conexão privada com o banco de dados de origem, você pode optar por **SSH tunneling** e fornecer os detalhes necessários de SSH. Isso permite que a migração se conecte com segurança a bancos de dados que não são acessíveis publicamente. Escolha um método de ingestão: * **Carga inicial + CDC** — copia os dados existentes e depois mantém o destino sincronizado com as alterações contínuas. * **Somente carga inicial** — cópia única, sem replicação contínua. * **Somente CDC** — pula a cópia inicial e replica apenas novas alterações a partir deste ponto. Etapa 1: formulário de conexão com o banco de dados de origem com opções de método de ingestão Clique em **Next**. O assistente exibe um comando `pg_dump` pré-preenchido com os detalhes de conexão da sua origem. Execute-o em um terminal: Etapa 2: comando pg_dump para exportar o esquema ```shell theme={null} pg_dump \ -h \ -U \ -d \ --schema-only \ -f pg.sql ``` Isso cria `pg.sql` no diretório atual. Saída do terminal após executar pg_dump Clique em **Next**. Selecione o banco de dados de destino na lista suspensa ou clique em **Create a new database** para provisionar um. O assistente exibe um comando `psql` para aplicar o dump do esquema ao seu serviço Managed Postgres. Execute-o em um terminal: Etapa 3: comando psql para importar o esquema ```shell theme={null} psql \ -h \ -p 5432 \ -U \ -d \ -f pg.sql ``` Saída do terminal após executar a importação do esquema com psql Clique em **Next**. Especifique a publication a ser usada para replicação lógica. Se você deixar esse campo em branco, uma publication será criada automaticamente. Expanda **Advanced replication settings** para ajustar a taxa de transferência: | Definição | Padrão | Descrição | | ----------------------------------------- | ------- | ----------------------------------------------------- | | Intervalo de sincronização (segundos) | 10 | Frequência com que o slot de replicação é consultado | | Threads em paralelo para a carga inicial | 4 | Número de threads para a fase de cópia em massa | | Tamanho do lote de coleta | 100,000 | Linhas obtidas por lote de replicação | | Número de linhas do snapshot por partição | 100000 | Tamanho da partição para snapshots de tabelas grandes | | Número de tabelas do snapshot em paralelo | 1 | Tabelas processadas em snapshot simultaneamente | Etapa 4: formulário de definições de ingestão com publication e opções avançadas de replicação Clique em **Next**. Selecione as tabelas que deseja replicar. As tabelas são agrupadas por esquema. Selecione tabelas individuais ou expanda um esquema para escolher todas. Etapa 5: seletor de tabelas agrupado por esquema com o botão Create migration Clique em **Create migration**.
## Monitore a migração
Após criar a migração, ela aparecerá em **Fontes de dados** com o status **Em execução**. Lista de fontes de dados mostrando uma migração em execução Clique na migração para abrir a tela de detalhes. A aba **Tables** mostra o progresso da carga inicial de cada tabela, incluindo linhas processadas, partições e o tempo médio por partição. A aba **Metrics** mostra a defasagem da replicação e a taxa de transferência quando o CDC começa. Tela de detalhes da migração mostrando estatísticas da carga inicial por tabela
## Tarefas pós-migração
Quando a carga inicial estiver concluída e, se estiver usando CDC, a defasagem da replicação estiver próxima de zero: **Valide a contagem de linhas.** Faça uma verificação pontual das tabelas críticas na origem e no destino antes de redirecionar o tráfego: ```sql theme={null} SELECT COUNT(*) FROM public.orders; ``` **Interrompa as gravações no sistema de origem.** Pause as gravações do aplicativo. Para forçar o modo somente leitura durante a transição: ```sql theme={null} ALTER DATABASE SET default_transaction_read_only = on; ``` **Confirme se a replicação está sincronizada.** Compare a linha mais recente da origem e do destino: ```sql theme={null} -- Execute na origem e no destino SELECT MAX(id), MAX(updated_at) FROM public.orders; ``` **Redefina as sequências.** Alinhe as sequências aos valores máximos atuais em cada tabela: ```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 $$; ``` **Direcione o tráfego da aplicação.** Aponte leituras e gravações para o seu serviço Managed Postgres e monitore erros, violações de restrições e a integridade da replicação. **Limpeza.** Depois de concluir a transição e confirmar que o novo serviço está funcionando corretamente, exclua a migração em **Fontes de dados**. Se você usou CDC, remova o slot de replicação da origem para liberar recursos: ```sql theme={null} SELECT pg_drop_replication_slot(''); ```
## Próximas etapas
* [Guia de início rápido do Managed Postgres](/docs/pt-BR/products/managed-postgres/quickstart) * [Detalhes de conexão do Managed Postgres](/docs/pt-BR/products/managed-postgres/connection) * [FAQ do ClickPipes para Postgres](/docs/pt-BR/integrations/clickpipes/postgres/faq)