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

# Controle da sincronização de um ClickPipe do Postgres

> Documentação para controlar a sincronização de um ClickPipe do Postgres

export const Image = ({img, alt, size}) => {
  return <Frame>
      <img src={img} alt={alt} />
    </Frame>;
};

Este documento descreve como controlar a sincronização de um ClickPipe do Postgres quando ele está no **modo CDC (em execução)**.

<div id="overview">
  ## Visão geral
</div>

Os ClickPipes de banco de dados têm uma arquitetura composta por dois processos paralelos: extração do banco de dados de origem e envio para o banco de dados de destino. O processo de extração é controlado por uma configuração de sincronização que define com que frequência os dados devem ser extraídos e qual volume de dados deve ser extraído por vez. Por "por vez", queremos dizer um lote, já que o ClickPipe extrai e envia dados em lotes.

Há duas formas principais de controlar a sincronização de um ClickPipe do Postgres. O ClickPipe começará a enviar quando uma das configurações abaixo for acionada.

<div id="interval">
  ### Intervalo de sincronização
</div>

O intervalo de sincronização do pipe é o período (em segundos) durante o qual o ClickPipe extrairá registros do banco de dados de origem. O tempo necessário para enviar o que foi extraído para o ClickHouse não está incluído nesse intervalo.

O padrão é **1 minuto**.
O intervalo de sincronização pode ser definido como qualquer número inteiro positivo, mas recomenda-se mantê-lo acima de 10 segundos.

<div id="batch-size">
  ### Tamanho do lote de extração
</div>

O tamanho do lote de extração é o número de registros que o ClickPipe extrairá do banco de dados de origem em um lote. Registros incluem inserções, atualizações e exclusões feitas nas tabelas que fazem parte do pipe.

O padrão é de **100.000** registros.
Um máximo seguro é de 10 milhões.

<div id="transactions">
  ### Uma exceção: Transações de longa duração no banco de dados de origem
</div>

Quando uma transação está em execução no banco de dados de origem, o ClickPipe aguarda até receber o COMMIT da transação antes de prosseguir. Isso **substitui** tanto o intervalo de sincronização quanto o tamanho do lote de extração.

<div id="configuring">
  ### Configurando a sincronização
</div>

Você pode definir o intervalo de sincronização e o tamanho do lote de extração ao criar um ClickPipe ou editar um já existente.
Ao criar um ClickPipe, essas opções aparecem na segunda etapa do assistente de criação, como mostrado abaixo:

<Image img="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/8xU-7NRzcVe16bmG/images/integrations/data-ingestion/clickpipes/postgres/create_sync_settings.png?fit=max&auto=format&n=8xU-7NRzcVe16bmG&q=85&s=412a27effa804c759b0b303c959754ac" alt="Criar configurações de sincronização" size="md" width="902" height="654" data-path="images/integrations/data-ingestion/clickpipes/postgres/create_sync_settings.png" />

Ao editar um ClickPipe existente, vá até a guia **Settings** do pipe, pause-o e clique em **Configure** aqui:

<Image img="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/8xU-7NRzcVe16bmG/images/integrations/data-ingestion/clickpipes/postgres/edit_sync_button.png?fit=max&auto=format&n=8xU-7NRzcVe16bmG&q=85&s=30b39dfdad9cce8936706e7c8282ab0e" alt="Botão para editar a sincronização" size="md" width="933" height="417" data-path="images/integrations/data-ingestion/clickpipes/postgres/edit_sync_button.png" />

Isso abrirá um painel lateral com as configurações de sincronização, onde você pode alterar o intervalo de sincronização e o tamanho do lote de extração:

<Image img="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/8xU-7NRzcVe16bmG/images/integrations/data-ingestion/clickpipes/postgres/sync_settings_edit.png?fit=max&auto=format&n=8xU-7NRzcVe16bmG&q=85&s=a2a2c74960206a297f679bda02614969" alt="Editar configurações de sincronização" size="md" width="598" height="588" data-path="images/integrations/data-ingestion/clickpipes/postgres/sync_settings_edit.png" />

<div id="tweaking">
  ### Ajustando as configurações de sincronização para ajudar a conter o crescimento do slot de replicação
</div>

Veja como usar essas configurações para lidar com um slot de replicação grande em um pipe de CDC.
O tempo de envio para o ClickHouse não aumenta linearmente em relação ao tempo de extração do banco de dados de origem. Isso pode ser aproveitado para reduzir o tamanho de um slot de replicação grande.
Ao aumentar tanto o intervalo de sincronização quanto o tamanho do lote de extração, o ClickPipe vai extrair uma grande quantidade de dados do banco de dados de origem de uma só vez e, em seguida, enviá-los para o ClickHouse.

<div id="monitoring">
  ### Monitorando o comportamento do controle de sincronização
</div>

Você pode ver quanto tempo cada lote leva na tabela **CDC Syncs**, na aba **Métricas** do ClickPipe. Observe que a duração aqui inclui o tempo de envio e, se não houver linhas chegando, o ClickPipe fica aguardando — esse tempo de espera também é incluído na duração.

<Image img="https://mintcdn.com/private-7c7dfe99-fix-nav-issues/8xU-7NRzcVe16bmG/images/integrations/data-ingestion/clickpipes/postgres/cdc_syncs.png?fit=max&auto=format&n=8xU-7NRzcVe16bmG&q=85&s=9516e13f2173892288776aa86a587959" alt="tabela CDC Syncs" size="md" width="2428" height="626" data-path="images/integrations/data-ingestion/clickpipes/postgres/cdc_syncs.png" />
