> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Como conectar seu catálogo Iceberg ao ClickHouse Cloud

> Saiba como conectar o ClickHouse Cloud ao seu catálogo de dados e consultar tabelas Iceberg.

export const e_1 = undefined

export const e_0 = undefined

<a href="/docs/get-started/quickstarts/home" onClick={(e_0) => { e_0.preventDefault(); window.location.href = (window.location.pathname.startsWith('/docs') ? '/docs' : '') + '/get-started/quickstarts/home'; }} className="inline-flex items-center gap-1.5 text-sm text-gray-500 dark:text-zinc-500 hover:text-gray-900 dark:hover:text-[#fdff75] transition-colors font-normal no-underline"><svg xmlns="http://www.w3.org/2000/svg" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round" className="shrink-0"><path d="M19 12H5" /><path d="M12 19l-7-7 7-7" /></svg>All quickstarts</a>

<div className="mt-2 flex flex-wrap gap-2">
  <Badge size="lg" color="blue">Armazenamento de dados</Badge>
  <Badge size="lg" color="orange">Cloud</Badge>
</div>

<div id="prerequisites">
  ## Pré-requisitos
</div>

Antes de iniciar este Quickstart, você deve ter:

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

* A running ClickHouse Cloud service. If you don't have one yet, complete the [ClickHouse Cloud quick start](/docs/get-started/setup/cloud) first.

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

<div id="what-youll-build">
  ## O que você vai criar
</div>

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.

<Steps titleSize="h3">
  <Step title="Criar uma conexão catálogo do lago de dados" id="create-a-datalakecatalog-connection">
    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.
  </Step>

  <Step title="Consultar uma tabela Iceberg" id="query-iceberg-table">
    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:

    ```sql theme={null}
    select * from iceberg_database.`iceberg_db.your_table`
    ```

    3. O ClickHouse retornará as linhas da sua tabela Iceberg.
  </Step>
</Steps>

<div id="next-steps">
  ## Próximos passos
</div>

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

<Tip>
  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.
</Tip>

<Frame caption="Check out the ClickHouse academy for on-demand and live training">
  <a href="https://learn.clickhouse.com/" target="_blank">
    <img src="https://mintcdn.com/private-7c7dfe99/EDr8ydtGBgFPOQea/images/academy.webp?fit=max&auto=format&n=EDr8ydtGBgFPOQea&q=85&s=27e92fc656183cc2f176211907a7aa49" alt="ClickHouse Academy — Master ClickHouse with expert-designed training for every skill level" width="560" noZoom data-path="images/academy.webp" />
  </a>
</Frame>

<div className="mt-8">
  <a href="/docs/get-started/quickstarts/home" onClick={(e_1) => { e_1.preventDefault(); window.location.href = (window.location.pathname.startsWith('/docs') ? '/docs' : '') + '/get-started/quickstarts/home'; }} className="inline-flex items-center gap-1.5 text-sm text-gray-500 dark:text-zinc-500 hover:text-gray-900 dark:hover:text-[#fdff75] transition-colors font-normal no-underline"><svg xmlns="http://www.w3.org/2000/svg" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round" className="shrink-0"><path d="M19 12H5" /><path d="M12 19l-7-7 7-7" /></svg>All quickstarts</a>
</div>