> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-vortex-format.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Sincronize com o ClickHouse usando ClickPipes

> Replique seus dados do Postgres para o ClickHouse com recursos nativos de CDC

export const Image = ({img, alt, size = "lg", background}) => {
  const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
  const backgroundColor = background === "white" ? "white" : background === "black" ? "rgb(31 31 28)" : undefined;
  return <div className={`ch-image-${normalizedSize}`}>
      <Frame>
        <img src={img} alt={alt} style={{
    backgroundColor
  }} />
      </Frame>
    </div>;
};

export const BetaBadge = ({link, galaxyTrack, galaxyEvent}) => {
  if (link) {
    return <a href={link} target="_blank" rel="noopener noreferrer" className="betaBadge" onClick={galaxyTrack && galaxyEvent ? galaxyOnClick(galaxyEvent) : undefined}>
                <span>Beta</span>
            </a>;
  }
  return <a href="https://clickhouse.com/docs/reference/settings/beta-and-experimental-features#beta-features" className="betaBadge">
            <span>Recurso beta</span>
        </a>;
};

<BetaBadge link="https://clickhouse.com/cloud/postgres" galaxyTrack={true} galaxyEvent="docs.managed-postgres.clickhouse-integration-beta" />

Toda instância do ClickHouse Managed Postgres já vem com recursos de CDC integrados para qualquer um dos seus serviços do ClickHouse. Isso permite mover parte ou a totalidade dos dados da sua instância Postgres para o ClickHouse e fazer com que as alterações de dados no Postgres sejam refletidas no ClickHouse de forma contínua e quase em tempo real. Nos bastidores, esse recurso é viabilizado pelo [ClickPipes](/pt-BR/integrations/clickpipes/home).

Para acessá-lo, clique em **Sync to ClickHouse** na barra lateral da sua instância Postgres.

<Image img="https://mintcdn.com/private-7c7dfe99-vortex-format/xHfTFhAoB3hIpGFb/images/managed-postgres/clickhouse-integration-intro.webp?fit=max&auto=format&n=xHfTFhAoB3hIpGFb&q=85&s=f2de966f7661a462fbb9a0a310bbb270" alt="Página inicial da integração com o ClickHouse mostrando a opção de integração na barra lateral" size="md" border width="1526" height="956" data-path="images/managed-postgres/clickhouse-integration-intro.webp" />

<Note>
  Antes de prosseguir, verifique se o seu serviço Postgres está acessível ao serviço ClickPipes. Esse é o comportamento padrão, mas, se você restringiu o acesso por IP, talvez seja necessário liberar o acesso a alguns IPs de origem [desta](/pt-BR/integrations/clickpipes/networking/static-ips) lista, de acordo com a região onde o seu **serviço do ClickHouse** está localizado.
</Note>

Clique em **Replicate data in ClickHouse** para começar a configurar o seu ClickPipe.

<Steps>
  <Step title="Configure o serviço de replicação" id="configure-replication-service">
    Preencha as configurações de replicação:

    * **Integration name**: um nome para este ClickPipe
    * **ClickHouse service**: selecione um serviço do ClickHouse Cloud existente ou crie um novo
    * **Postgres database**: o banco de dados de origem a ser replicado
    * **Replication method**: escolha uma das opções:
      * **Initial load + CDC**: importa os dados existentes e mantém as tabelas atualizadas com as novas alterações (recomendado)
      * **Initial load only**: snapshot único dos dados existentes, sem atualizações contínuas
      * **CDC only**: ignora o snapshot inicial e captura apenas as novas alterações daí em diante

    <Image img="https://mintcdn.com/private-7c7dfe99-vortex-format/xHfTFhAoB3hIpGFb/images/managed-postgres/replication-service-step.webp?fit=max&auto=format&n=xHfTFhAoB3hIpGFb&q=85&s=71c792ea56ab5ed02222c2979498ae84" alt="Configuração do serviço de replicação mostrando o nome da integração, o serviço de destino e as opções de método de replicação" size="md" border width="1620" height="956" data-path="images/managed-postgres/replication-service-step.webp" />

    Clique em **Next** para continuar.
  </Step>

  <Step title="Defina as configurações de replicação" id="replication-settings">
    Ajuste em detalhes como os dados são replicados:

    * **Sync interval (seconds)**: com que frequência as alterações são extraídas do Postgres (padrão: 60)
    * **Parallel threads for initial load**: número de threads usadas durante o snapshot inicial (padrão: 4)
    * **Pull batch size**: número de linhas obtidas por lote durante a replicação (padrão: 100000)
    * **Snapshot number of rows per partition**: linhas por partição durante o snapshot inicial (padrão: 100000)
    * **Snapshot number of tables in parallel**: quantas tabelas têm snapshot feito simultaneamente (padrão: 1)

    <Image img="https://mintcdn.com/private-7c7dfe99-vortex-format/xHfTFhAoB3hIpGFb/images/managed-postgres/integration-replication-settings.webp?fit=max&auto=format&n=xHfTFhAoB3hIpGFb&q=85&s=f73c47e084727b55d05755db6127c896" alt="Etapa de configurações de replicação mostrando o intervalo de sincronização, threads paralelas, tamanho do lote de extração e opções de configuração do snapshot inicial" size="md" border width="1526" height="957" data-path="images/managed-postgres/integration-replication-settings.webp" />

    Clique em **Next** para continuar.
  </Step>

  <Step title="Selecione as tabelas a replicar" id="select-tables">
    Escolha um banco de dados de destino e selecione quais tabelas replicar:

    * **Destination database**: selecione um banco de dados ClickHouse existente ou crie um novo
    * **Prefix default destination table names with schema name**: adiciona o schema do Postgres como prefixo para evitar conflitos de nomes
    * **Preserve NULL values from source**: mantém os valores NULL em vez de convertê-los para os padrões do tipo. Essa configuração se aplica a todas as tabelas do pipe e não pode ser alterada depois que o pipe é criado.
    * **Remove deleted rows during merges**: para tabelas [ReplacingMergeTree](/pt-BR/reference/engines/table-engines/mergetree-family/replacingmergetree), remove fisicamente as linhas excluídas durante os merges em segundo plano

    Expanda os schemas e selecione as tabelas individuais a replicar. Você também pode personalizar os nomes das tabelas de destino e as configurações de colunas.

    <Image img="https://mintcdn.com/private-7c7dfe99-vortex-format/xHfTFhAoB3hIpGFb/images/managed-postgres/select-tables-step.webp?fit=max&auto=format&n=xHfTFhAoB3hIpGFb&q=85&s=be0345181d3022080ad8653542714421" alt="Etapa de seleção de tabelas mostrando a escolha do banco de dados, as opções de replicação e o seletor de tabelas agrupadas por schema" size="md" border width="2454" height="1804" data-path="images/managed-postgres/select-tables-step.webp" />

    Clique em **Replicate data to ClickHouse** para iniciar a replicação.
  </Step>

  <Step title="Monitore seu ClickPipe" id="monitor-clickpipe">
    Assim que o ClickPipe iniciar, ele aparecerá listado no mesmo menu. O snapshot inicial de todos os dados pode levar algum tempo, dependendo do tamanho das suas tabelas.

    <Image img="https://mintcdn.com/private-7c7dfe99-vortex-format/xHfTFhAoB3hIpGFb/images/managed-postgres/integration-running.webp?fit=max&auto=format&n=xHfTFhAoB3hIpGFb&q=85&s=37b194710421e11fdbeaf84474491c60" alt="Lista de integrações do ClickHouse mostrando um ClickPipe em execução com seu serviço de destino e status" size="md" border width="2518" height="622" data-path="images/managed-postgres/integration-running.webp" />

    Clique no nome da integração para ver o status detalhado, monitorar o progresso, visualizar erros e gerenciar o ClickPipe. Consulte [Ciclo de vida de um ClickPipe do Postgres](/pt-BR/integrations/clickpipes/postgres/lifecycle) para entender os diferentes estados em que seu ClickPipe pode estar.
  </Step>
</Steps>