Skip to main content
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.
1

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

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:
  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.
Preste atenção às aspas. O ClickHouse não oferece suporte a espaços de nomes com três partes; você deve colocar schema.table entre aspas.
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
Última modificação em 28 de agosto de 2026