> ## 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 um catálogo de dados para tabelas Iceberg ou Delta no ClickHouse Cloud pela UI de fontes de dados.

# Conectar um catálogo de dados no ClickHouse Cloud

export const BetaBadge = ({link, galaxyTrack, galaxyEvent}) => {
  if (link) {
    return <a href={link} target="_blank" rel="noopener noreferrer" className="betaBadge" onClick={galaxyTrack && galaxyEvent ? galaxyOnClick(galaxyEvent) : undefined}>
                <span>Beta</span>
            </a>;
  }
  return <a href="https://clickhouse.com/docs/reference/settings/beta-and-experimental-features#beta-features" className="betaBadge">
            <span>Recurso beta</span>
        </a>;
};

export const Image = ({img, alt, size = "lg"}) => {
  const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
  return <div className={`ch-image-${normalizedSize}`}>
      <Frame>
        <img src={img} alt={alt} />
      </Frame>
    </div>;
};

<BetaBadge />

Conecte o ClickHouse Cloud aos seus catálogos de dados para acessar tabelas no formato de tabela aberto. Você pode configurar conexões na UI de **Fontes de dados**. Para configurar via SQL, use o motor de banco de dados [`DataLakeCatalog`](/docs/pt-BR/reference/engines/database-engines/datalake) no editor SQL de sua preferência.

<Image img="https://mintcdn.com/private-7c7dfe99/NMEuR4JBQvfvT5BG/images/cloud/features/data-catalogs-ui.png?fit=max&auto=format&n=NMEuR4JBQvfvT5BG&q=85&s=23c85c7480fa5f37a9ab95aa2943fb10" size="md" alt="UI do ClickHouse Cloud com integrações de catálogos de dados" width="4944" height="2610" data-path="images/cloud/features/data-catalogs-ui.png" />

Após a conexão, as tabelas do catálogo aparecem no console SQL sob o nome do banco de dados escolhido. Você pode consultá-las usando o ClickHouse SQL padrão, fazer join com tabelas [MergeTree](/docs/pt-BR/reference/engines/table-engines/mergetree-family/mergetree) e usá-las como fontes para [visões materializadas](/docs/pt-BR/concepts/features/materialized-views).

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

Antes de conectar um catálogo, confirme o seguinte:

* **Permissões do serviço.** Você precisa da permissão `control-plane:service:manage` para acessar a página **Fontes de dados** e adicionar catálogos.
* **Serviço em execução.** Se o serviço estiver inativo, reative-o nas páginas **Fontes de dados** ou de configurações do serviço antes de conectar ou visualizar catálogos vinculados.
* **Credenciais do catálogo.** Reúna as informações de conexão do seu tipo de catálogo antes de abrir o painel lateral. Cada catálogo usa campos e métodos de autenticação diferentes — consulte [Adicionar a conexão do seu catálogo](#add-your-catalog-connection) abaixo.

<div id="connect-your-catalog">
  ## Conecte seu catálogo
</div>

<Steps>
  <Step title="Abra o painel lateral do catálogo de dados" id="open-data-catalog-flyout">
    1. Selecione **Fontes de dados** na navegação à esquerda.
    2. Clique em **+ Adicionar catálogo** se ainda não tiver configurado nenhuma fonte de dados. Caso contrário, clique em **Adicionar fonte de dados** > **Adicionar catálogo do lago de dados**.
    3. No painel lateral **Conectar seu catálogo de dados**, selecione o catálogo no menu suspenso **Selecionar catálogo**. Se o catálogo oferecer suporte a vários formatos de tabela abertos, escolha o formato em **Formato de tabela aberto**.

    <Image img="https://mintcdn.com/private-7c7dfe99/Z-ZVGWH-X46hMIiN/images/integrations/data-catalogs/catalog-flyout-select.png?fit=max&auto=format&n=Z-ZVGWH-X46hMIiN&q=85&s=d9db0300502c5a3504848e707b5030bd" alt="Painel lateral Conectar seu catálogo de dados com o menu suspenso Selecionar catálogo exibindo AWS Glue, BigLake Metastore, Microsoft OneLake, Polaris, REST Catalog e Unity Catalog" size="lg" width="4490" height="2842" data-path="images/integrations/data-catalogs/catalog-flyout-select.png" />
  </Step>

  <Step title="Adicione a conexão com seu catálogo" id="add-your-catalog-connection">
    Selecione seu catálogo abaixo para ver orientações e pré-requisitos. Em seguida, preencha os parâmetros de conexão e informe também um **nome do banco de dados** — o banco de dados do ClickHouse que expõe as tabelas do seu catálogo no console SQL.

    <Tabs>
      <Tab title="AWS Glue" id="aws-glue">
        [AWS Glue Catalog](/docs/pt-BR/guides/use-cases/data-warehousing/glue-catalog) expõe tabelas [Iceberg](/docs/pt-BR/reference/engines/table-engines/integrations/iceberg) registradas no Glue Data Catalog.

        Antes de conectar, confirme o seguinte:

        * ClickHouse versão 25.12 ou posterior.
        * As tabelas Iceberg estão registradas no AWS Glue Data Catalog na região de destino.
        * Para autenticação por chave de acesso, você tem uma chave de acesso de usuário do IAM com permissões para ler os metadados do Glue e os objetos S3 subjacentes.
        * Para autenticação por função do IAM (26.2+), você tem uma função do IAM que confia na função de serviço do ClickHouse. Inclua o ARN da função de serviço em **Settings → Network security information** na política de confiança da função. Consulte [Como acessar dados Iceberg com segurança](/docs/pt-BR/products/cloud/guides/data-sources/accessing-iceberg-data-securely) para ver exemplos de políticas do IAM.

        No painel lateral, informe sua **Region** da AWS (por exemplo, `us-west-2`) e escolha um método de autenticação:

        **Autenticação por chave de acesso**

        1. Selecione **AWS Access Key** como **Authentication method**.
        2. Informe sua **Access Key ID** e sua **Secret Access Key**.
        3. Informe um **nome do banco de dados** para o banco de dados ClickHouse que expõe suas tabelas do Glue.

        **Autenticação por função do IAM (26.2+)**

        1. Selecione **AWS IAM Role** como **Authentication method**.
        2. Copie o **Service role ID (IAM)** do painel lateral e adicione-o à política de confiança da sua função do IAM.
        3. Informe seu **AWS Role ARN** e, opcionalmente, um **AWS Role Session Name**.
        4. Informe um **nome do banco de dados** para o banco de dados ClickHouse que expõe suas tabelas do Glue.

        <Note>
          O Glue oferece suporte a vários formatos de tabela, mas o ClickHouse lê apenas tabelas **Iceberg** do Glue.
        </Note>
      </Tab>

      <Tab title="Unity Catalog (Iceberg)" id="unity-iceberg">
        Consulte tabelas [Iceberg](/docs/pt-BR/reference/engines/table-engines/integrations/iceberg) do Unity Catalog que usam locais de armazenamento externo com credenciais de cliente OAuth de um principal de serviço do Databricks. Consulte o [guia do Unity Catalog](/docs/pt-BR/guides/use-cases/data-warehousing/unity-catalog#read-iceberg) para concluir a configuração.

        Antes de se conectar, confirme:

        * ClickHouse versão 25.12 ou posterior.
        * O [Unity Catalog está configurado para acesso a dados externos](https://docs.databricks.com/aws/en/external-access/admin).
        * Um [principal de serviço](https://docs.databricks.com/aws/en/dev-tools/auth/oauth-m2m) do Databricks com ID e secret de cliente OAuth. O principal de serviço tem os privilégios `USE CATALOG`, `USE SCHEMA`, `USE EXTERNAL SCHEMA` e `SELECT` nas tabelas que você deseja consultar.

        No flyout:

        1. Insira a **URL do workspace** do Databricks (por exemplo, `dbc-1234567a-cbde.cloud.databricks.com`).
        2. Insira o **nome do catálogo do Databricks** ao qual deseja se conectar (por exemplo, `icebench`).
        3. Insira o **ID do cliente** e o **secret do cliente** OAuth do seu principal de serviço.
        4. Insira um **nome do banco de dados** para o banco de dados do ClickHouse que expõe suas tabelas do Unity Catalog.
      </Tab>

      <Tab title="Unity Catalog (Delta)" id="unity-delta">
        Consulte tabelas do Unity Catalog [Delta Lake](/docs/pt-BR/reference/engines/table-engines/integrations/deltalake) que usam locais de armazenamento externo com um Token de Acesso Pessoal (PAT) do Databricks. Consulte o [guia do Unity Catalog](/docs/pt-BR/guides/use-cases/data-warehousing/unity-catalog#read-delta) para obter instruções completas de configuração.

        Antes de se conectar, confirme o seguinte:

        * ClickHouse versão 25.12 ou posterior.
        * O [Unity Catalog está configurado para acesso a dados externos](https://docs.databricks.com/aws/en/external-access/admin).
        * Um [Token de Acesso Pessoal](https://docs.databricks.com/aws/en/dev-tools/auth/pat) do Databricks com, no mínimo, as permissões `EXTERNAL USE SCHEMA`, `USE CATALOG`, `USE SCHEMA` e `SELECT` nas tabelas de destino.

        No painel lateral:

        1. Insira a **URL do workspace** do Databricks (por exemplo, `dbc-1234567a-cbde.azuredatabricks.net`).
        2. Insira o **nome do catálogo do Databricks** ao qual deseja se conectar.
        3. Insira seu **Token de Acesso Pessoal**.
        4. Insira um **nome do banco de dados** para o banco de dados do ClickHouse que expõe suas tabelas Delta.

        <Note>
          Iceberg e Delta usam métodos de autenticação diferentes na UI. Para acessar ambos os tipos de tabela, são necessários dois bancos de dados ClickHouse separados.
        </Note>
      </Tab>

      <Tab title="catálogo REST" id="rest">
        Conecte-se a qualquer catálogo que implemente a especificação [Iceberg REST Catalog](https://github.com/apache/iceberg/blob/main/open-api/rest-catalog-open-api.yaml). Consulte o [guia do catálogo REST](/docs/pt-BR/guides/use-cases/data-warehousing/rest-catalog) para ver as instruções completas de configuração.

        Antes de se conectar, confirme:

        * ClickHouse versão 25.12 ou posterior.
        * O endpoint do seu catálogo REST pode ser acessado pelo ClickHouse Cloud.
        * Você tem credenciais de cliente OAuth ou um token Bearer, dependendo da configuração do catálogo.
        * Você tem um URI de **Endpoint de armazenamento** do S3 ou compatível para os dados das tabelas (por exemplo, `s3://my-bucket/path`).

        No painel:

        1. Insira a **URL do catálogo** (por exemplo, `https://catalog.example.com/v1`).
        2. Insira o **Warehouse** ou o espaço de nomes do catálogo (por exemplo, `demo`).
        3. Insira o prefixo do URI de **Endpoint de armazenamento** para armazenar as tabelas.
        4. Selecione um **Método de autenticação**: **Credenciais de cliente OAuth** ou **Token Bearer** e insira as credenciais correspondentes.
        5. Insira um **nome do banco de dados** para o banco de dados do ClickHouse que expõe as tabelas do seu catálogo REST.
      </Tab>

      <Tab title="Microsoft OneLake" id="onelake">
        Consulte tabelas [Iceberg](/docs/pt-BR/reference/engines/table-engines/integrations/iceberg) no Microsoft Fabric OneLake usando credenciais de aplicativo do Azure AD. Consulte o [guia do Fabric OneLake](/docs/pt-BR/guides/use-cases/data-warehousing/onelake-catalog) para ver a configuração completa.

        Antes de se conectar, confirme que:

        * você usa o ClickHouse versão 25.12 ou posterior;
        * existem tabelas Iceberg em um workspace do Fabric;
        * você tem um aplicativo Entra ID (Azure AD) com ID do cliente e Secret;
        * você tem o ID do tenant, o ID do workspace e o ID de um item de dados. Use o **ID do Lakehouse** na URL da página do Lakehouse. Consulte os [pré-requisitos do Microsoft OneLake](https://learn.microsoft.com/en-us/fabric/onelake/table-apis/table-apis-overview#prerequisites) para saber como localizar esses valores.

        No flyout:

        1. Insira o **ID do workspace** do Fabric.
        2. Insira o **ID do item de dados** — use o ID do Lakehouse. IDs de warehouse não são compatíveis.
        3. Insira o **ID do tenant**, o **ID do aplicativo (cliente)** e o **Secret do cliente** do Entra ID.
        4. Insira um **nome do banco de dados** para o banco de dados do ClickHouse que expõe suas tabelas do OneLake.
      </Tab>

      <Tab title="Polaris" id="polaris">
        Conecte-se a uma implantação do Snowflake Open Catalog (Polaris) para tabelas [Iceberg](/docs/pt-BR/reference/engines/table-engines/integrations/iceberg). Consulte o [guia do catálogo Polaris](/docs/pt-BR/guides/use-cases/data-warehousing/polaris-catalog) para obter as instruções completas de configuração.

        Antes de se conectar, confirme:

        * ClickHouse versão 26.2 ou posterior.
        * Você tem um catálogo Polaris com credenciais de cliente OAuth.
        * Você tem um URI de endpoint de armazenamento para dados de tabelas Iceberg (por exemplo, `s3://company-iceberg-prod/warehouse/`).

        No painel lateral:

        1. Informe o **Identificador da Conta do Catálogo** (por exemplo, `ab12345.snowflakecomputing.com`).
        2. Informe o **Nome do Catálogo** (por exemplo, `snowflake_open_catalog`).
        3. Informe o **ID do Cliente** e o **Segredo do Cliente** do OAuth.
        4. Informe o prefixo do URI do **Endpoint de Armazenamento** para o armazenamento de tabelas.
        5. Informe um **nome do banco de dados** para o banco de dados ClickHouse que expõe suas tabelas Polaris.
      </Tab>

      <Tab title="BigLake Metastore" id="biglake">
        Conecte-se ao BigLake Metastore do Google Cloud (também chamado de Lakehouse runtime catalog) para tabelas [Iceberg](/docs/pt-BR/reference/engines/table-engines/integrations/iceberg) no GCS. Consulte o [guia do BigLake Metastore](/docs/pt-BR/guides/use-cases/data-warehousing/biglake-catalog) para ver a configuração completa.

        Antes de se conectar, confirme:

        * ClickHouse versão 26.2 ou posterior.
        * Você tem uma instância do BigLake Metastore com tabelas Iceberg no GCS.
        * Você tem credenciais padrão de aplicativo do Google (ADC) com ID do cliente, segredo do cliente, token de atualização e ID do projeto de cota.

        No flyout:

        1. Informe o **ID do cliente ADC do Google**, o **segredo do cliente**, o **token de atualização** e o **ID do projeto de cota**.
        2. Informe o URI do **bucket do Cloud Storage** para os dados da tabela (por exemplo, `gs://biglake-public-nyc-taxi-iceberg`).
        3. Informe um **nome do banco de dados** para o banco de dados ClickHouse que expõe suas tabelas do BigLake.
      </Tab>
    </Tabs>
  </Step>

  <Step title="Salvar a conexão" id="save-connection">
    Após preencher os campos:

    1. Clique em **Adicionar catálogo**. O ClickHouse valida a conexão e as credenciais ao salvar.
    2. Se a operação for bem-sucedida, será exibida uma notificação de confirmação com o link **Ver no console SQL**. Seu catálogo será listado na tabela **Catálogos vinculados**, com o status da conexão e o número de tabelas.

    No menu **Ações** de uma linha de catálogo vinculado, você pode remover a conexão do catálogo. A remoção exclui o banco de dados do catálogo do ClickHouse, mas não exclui dados do catálogo externo.
  </Step>
</Steps>

<div id="query-data">
  ## Consulte seus dados
</div>

<Steps>
  <Step title="Visualize as tabelas do seu catálogo" id="view-tables">
    Na página **Fontes de dados**, localize seu catálogo na tabela **Catálogos vinculados** e clique em **Visualizar tabelas**.

    <Image img="https://mintcdn.com/private-7c7dfe99/Z-ZVGWH-X46hMIiN/images/integrations/data-catalogs/linked-catalogs-table.png?fit=max&auto=format&n=Z-ZVGWH-X46hMIiN&q=85&s=0a1cc4e94f2ef096d9db5e5edf8699b6" alt="Tabela de catálogos vinculados com a ação Visualizar tabelas" size="lg" width="3510" height="868" data-path="images/integrations/data-catalogs/linked-catalogs-table.png" />

    O ClickHouse abre o console SQL com o banco de dados do catálogo selecionado e lista as tabelas disponíveis.

    <Note>
      As tabelas podem não aparecer imediatamente após a conexão de um catálogo. Dependendo do catálogo, pode levar até 3 minutos para que todas as tabelas sejam listadas.
    </Note>

    <Image img="https://mintcdn.com/private-7c7dfe99/Z-ZVGWH-X46hMIiN/images/integrations/data-catalogs/catalog-tables-browser.png?fit=max&auto=format&n=Z-ZVGWH-X46hMIiN&q=85&s=659600c739c761d3154018e338596fa6" alt="Navegador de tabelas do console SQL mostrando as tabelas do catálogo" size="lg" width="3560" height="1578" data-path="images/integrations/data-catalogs/catalog-tables-browser.png" />
  </Step>

  <Step title="Execute uma consulta" id="run-a-query">
    Escreva uma consulta no editor SQL e clique em **Executar**. Coloque o nome completo da tabela entre backticks:

    ```sql theme={null}
    SELECT * FROM `identity_profiles.identity_profiles_iceberg`
    ```

    <Image img="https://mintcdn.com/private-7c7dfe99/Z-ZVGWH-X46hMIiN/images/integrations/data-catalogs/catalog-sql-query.png?fit=max&auto=format&n=Z-ZVGWH-X46hMIiN&q=85&s=79bfd73f1b475795f1fd0e3c18950b50" alt="Consulta SQL com resultados usando backticks para nomes de tabela com pontos" size="lg" width="2810" height="1172" data-path="images/integrations/data-catalogs/catalog-sql-query.png" />
  </Step>
</Steps>

<div id="troubleshooting">
  ## Solução de problemas
</div>

* Se suas tabelas não aparecerem no Console SQL: verifique as credenciais, o acesso à rede e os tipos de tabela no catálogo. Verifique se as tabelas que você espera encontrar estão em formatos de arquivo e de tabela compatíveis.

<div id="see-also">
  ## Veja também
</div>

* [Acelerando analytics em dados de lakehouse](/docs/pt-BR/guides/use-cases/data-warehousing/getting-started/accelerating-analytics) — carregue tabelas do catálogo no MergeTree para consultas recorrentes
* [Acessando dados do Iceberg com segurança](/docs/pt-BR/products/cloud/guides/data-sources/accessing-iceberg-data-securely) — configuração da IAM role para acessar o AWS Iceberg e o Glue