Skip to main content
O ClickHouse oferece integração com vários catálogos (Unity, Glue, Polaris, etc.). Neste guia, mostraremos as etapas para consultar seus dados em buckets do S3 usando o ClickHouse e o Glue Data Catalog.
O Glue oferece suporte a diversos formatos de tabela, mas esta integração oferece suporte apenas a tabelas Iceberg.

Configurando o Glue na AWS

Para se conectar ao catálogo do Glue, você precisará de:
  • Região da AWS em que seu catálogo está
  • Access Key ID/Access Secret Key (v25.12+) ou AWS Role ARN (v26.2+)
Para autenticação com AWS Role, AWS Role Session Name é um campo adicional opcional.
Você precisará habilitá-lo com SET allow_database_glue_catalog = 1;

Criando uma conexão entre o catálogo de dados do Glue e o ClickHouse

Com o AWS Glue Catalog configurado, você pode se autenticar e estabelecer uma conexão entre o ClickHouse e o AWS Glue Catalog.

Chave de acesso/chave secreta da AWS

Query

AWS Role

Query

Consulte o catálogo de dados do Glue com o ClickHouse

Agora que a conexão está estabelecida, você pode começar a consultar o Glue:
Query
Como você pode ver acima, algumas das tabelas listadas não são tabelas Iceberg, por exemplo iceberg-benchmark.hitsparquet. Não será possível consultá-las, pois no momento apenas o Iceberg é compatível. Para consultar uma tabela:
Query
Os backticks são obrigatórios porque o ClickHouse não oferece suporte a mais de um espaço de nomes.
Para inspecionar o DDL da tabela, execute a consulta a seguir:

Carregando dados do seu lago de dados no ClickHouse

Se você precisar carregar dados do Glue para o ClickHouse, comece criando uma tabela local no ClickHouse:
Query
Em seguida, carregue os dados da sua tabela Iceberg:
Query
Última modificação em 24 de julho de 2026