Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs
49.6kGet Started

Como conectar seu catálogo Iceberg ao ClickHouse Cloud

View as MarkdownEdit this pageReport an issueSet up docs MCP
All quickstarts
Armazenamento de dadosCloud

Pré-requisitos

Antes de iniciar este Quickstart, você deve ter:

To successfully follow this guide, you’ll need the following:

  • Acesso a um lago de dados compatível com Iceberg
  • Catálogo do lago de dados (URL + credenciais)
  • Dependendo do tipo de catálogo do lago de dados: credenciais para armazenamento de objetos (por exemplo, armazenamento compatível com S3)
  • Pelo menos uma tabela Iceberg existente registrada no catálogo

Se você ainda não tiver dados no seu catálogo Iceberg, poderá fazer upload deste conjunto de dados. Faremos a demonstração usando o conjunto de dados indicado aqui.

O que você vai criar

Neste Quickstart, você vai:

  • Conectar-se a um REST Catalog do Iceberg no ClickHouse Cloud
  • Criar um banco de dados no ClickHouse com esse catálogo como base
  • Consultar uma tabela Iceberg existente diretamente no ClickHouse
  • Verificar se o ClickHouse está lendo dados do seu lago de dados

Ao final, você terá o ClickHouse Cloud conectado ao seu catálogo Iceberg e poderá executar consultas SQL nas tabelas Iceberg sem copiar os dados.

Criar uma conexão catálogo do lago de dados

Nesta etapa, você vai se conectar ao seu catálogo do lago de dados no ClickHouse Cloud.

  1. Abra seu serviço ClickHouse Cloud.

  2. Navegue até Data Sources → Connect to your catálogo do lago de dados.

  3. Selecione seu catálogo de dados no menu suspenso.

  4. Preencha o formulário com suas credenciais e informações de conexão. Para o Unity Catalog, informe:

    • Open Table Format (Iceberg)
    • Nome do banco de dados do ClickHouse. Esse será o nome do banco de dados do ClickHouse a partir do qual você consultará suas tabelas Iceberg.
    • ID do workspace
    • Nome do catálogo do Databricks
    • ID do cliente
    • Secret do cliente

    inserir imagens

  5. Salve o catálogo. Agora, você deverá ver o catálogo de dados carregado na página Data Sources, com o número de tabelas disponíveis no banco de dados.

Consultar uma tabela Iceberg

Nesta etapa, você vai consultar uma tabela Iceberg do seu catálogo de dados.

  1. Ao clicar em Show Tables ou SQL Console, você será direcionado ao SQL Console com seu novo banco de dados conectado ao lago de dados materializado. Se você acessar por SQL Console, altere o menu suspenso de banco de dados para o seu banco de dados Iceberg.
  2. Você deverá ver uma ou mais tabelas Iceberg listadas na árvore de arquivos. Execute esta consulta:
select * from iceberg_database.`iceberg_db.your_table`
  1. O ClickHouse retornará as linhas da sua tabela Iceberg.

Próximos passos

Agora que você se conectou ao seu lago de dados, pode testar a gravação de uma tabela Iceberg no ClickHouse.

ClickHouse Academy — Master ClickHouse with expert-designed training for every skill level
Check out the ClickHouse academy for on-demand and live training
All quickstarts
Navigation