Skip to main content
Permite conectar-se a bancos de dados em um servidor PostgreSQL remoto. Suporta operações de leitura e escrita (consultas SELECT e INSERT) para troca de dados entre o ClickHouse e o PostgreSQL. Fornece acesso em tempo real à lista e à estrutura das tabelas no PostgreSQL remoto por meio das consultas SHOW TABLES e DESCRIBE TABLE. Suporta alterações na estrutura da tabela (ALTER TABLE ... ADD|DROP COLUMN). Se o parâmetro use_table_cache (consulte Parâmetros do mecanismo abaixo) estiver definido como 1, a estrutura da tabela será armazenada em cache e não será verificada em busca de alterações, mas poderá ser atualizada com as consultas DETACH e ATTACH.

Criar um banco de dados

Parâmetros do mecanismo
  • host:port — Endereço do servidor PostgreSQL.
  • database — Nome do banco de dados remoto.
  • user — Usuário do PostgreSQL.
  • password — Senha do usuário.
  • schema — Esquema do PostgreSQL.
  • use_table_cache — Define se a estrutura da tabela do banco de dados é armazenada em cache ou não. Opcional. Valor padrão: 0.

Suporte a tipos de dados

Exemplos de uso

Banco de dados no ClickHouse, trocando dados com o servidor PostgreSQL:
Lendo dados da tabela do PostgreSQL:
Gravando dados na tabela do PostgreSQL:
Considere que a estrutura da tabela foi alterada no PostgreSQL:
Como o parâmetro use_table_cache foi definido como 1 quando o banco de dados foi criado, a estrutura da tabela no ClickHouse ficou armazenada em cache e, por isso, não foi modificada:
Depois de desanexar a tabela e anexá-la novamente, a estrutura foi atualizada:
Última modificação em 12 de junho de 2026