Skip to main content

​
Contexto

TimescaleDB é uma extensão de código aberto do Postgres desenvolvida pela Timescale Inc que tem como objetivo melhorar o desempenho de consultas analíticas sem precisar deixar o Postgres. Isso é obtido por meio da criação de “hipertabelas”, que são gerenciadas pela extensão e oferecem suporte ao particionamento automático em “chunks”. As hipertabelas também oferecem suporte à compressão transparente e ao armazenamento híbrido linha-colunar (conhecido como “hypercore”), embora esses recursos exijam uma versão da extensão com licença proprietária. A Timescale Inc também oferece dois serviços gerenciados para o TimescaleDB:
  • Managed Service for Timescale
  • Timescale Cloud.
Há fornecedores terceirizados que oferecem serviços gerenciados que permitem usar a extensão TimescaleDB, mas, por questões de licenciamento, esses fornecedores oferecem suporte apenas à versão de código aberto da extensão. As hipertabelas do Timescale se comportam de forma diferente das tabelas comuns do Postgres em vários aspectos. Isso traz algumas complicações para o processo de replicação, razão pela qual a capacidade de replicar hipertabelas do Timescale deve ser considerada como best effort.

​
Versões compatíveis do Postgres

O ClickPipes é compatível com o Postgres 12 e versões posteriores.

​
Habilitar replicação lógica

As etapas a seguir dependem de como sua instância do Postgres com TimescaleDB está implantada.
  • Se você estiver usando um serviço gerenciado e seu provedor estiver listado na barra lateral, siga o guia desse provedor.
  • Se você estiver implantando o TimescaleDB por conta própria, siga o guia genérico.
Para outros serviços gerenciados, abra um chamado de suporte com seu provedor para obter ajuda para habilitar a replicação lógica, caso ela ainda não esteja habilitada.
O Timescale Cloud não oferece suporte à habilitação da replicação lógica, que é necessária para pipes do Postgres no modo CDC. Como resultado, os usuários do Timescale Cloud só podem fazer uma carga única dos seus dados (Initial Load Only) com o Postgres ClickPipe.

​
Configuração

As hipertabelas do Timescale não armazenam os dados inseridos diretamente nelas. Em vez disso, os dados são armazenados em várias tabelas “chunk” correspondentes no schema _timescaledb_internal. Para executar consultas nas hipertabelas, isso não é um problema. Mas, durante a replicação lógica, em vez de detectarmos alterações na hipertabela, nós as detectamos na tabela chunk correspondente. O ClickPipe do Postgres tem lógica para remapear automaticamente as alterações das tabelas chunk para a hipertabela pai, mas isso exige etapas adicionais.
Se você quiser apenas realizar uma carga única dos seus dados (Initial Load Only), pule a etapa 2 e as seguintes.
  1. Crie um usuário dedicado para o ClickPipes:
  2. Conceda acesso de somente leitura no nível do schema ao usuário que você criou na etapa anterior. O exemplo a seguir mostra as permissões para o schema public. Repita esses comandos para cada schema que contenha tabelas que você deseja replicar:
  3. Conceda privilégios de replicação ao usuário:
  4. Como superusuário/admin do Postgres, crie uma publicação com as hipertabelas que você deseja replicar. A publicação também deve incluir todo o schema _timescaledb_internal para que o pipe possa receber alterações dos chunks subjacentes. Recomendamos fortemente incluir na publicação apenas as tabelas de que você precisa para evitar sobrecarga de desempenho.
Qualquer tabela incluída na publicação deve ter uma chave primária definida ou ter sua replica identity configurada como FULL. Consulte as FAQs do Postgres para orientações sobre escopo.
A publicação clickpipes define o conjunto de tabelas cujos eventos de alteração serão transmitidos ao ClickPipes. Recomendamos não usar FOR ALL TABLES, a menos que você pretenda replicar todas as tabelas, pois incluir tabelas desnecessárias aumenta o tráfego de WAL do Postgres para o ClickPipes e reduz a eficiência geral da replicação.
Alguns serviços gerenciados não concedem aos usuários administradores as permissões necessárias para criar uma publicação para um schema inteiro. Se esse for o caso, abra um ticket de suporte com seu provedor. Como alternativa, você pode pular esta etapa (e as próximas) e, em vez disso, fazer uma carga única dos seus dados.
Após essas etapas, você poderá prosseguir com a criação de um ClickPipe.

​
Configurar acesso à rede

Se você quiser restringir o tráfego para sua instância do Timescale, adicione à lista de permissões os IPs NAT estáticos documentados. As instruções para fazer isso variam de acordo com o provedor. Consulte a barra lateral se o seu provedor estiver listado ou abra um chamado com ele.
Última modificação em 24 de julho de 2026