Receber detalhes do endpoint do catálogo

O catálogo do ambiente de execução do Lakehouse permite inspecionar a configuração e os metadados dos endpoints do catálogo no Lakehouse sem fronteiras. Para endpoints do catálogo REST do Apache Iceberg, é possível recuperar o URI do catálogo REST necessário para conexões de cliente, o método de autenticação e a conta de serviço associada. Para mais informações sobre endpoints de catálogo, consulte Tipos de catálogo e configuração de endpoint.

Antes de começar

  1. Leia Sobre o catálogo do ambiente de execução do Lakehouse para entender como ele funciona e as limitações do serviço.
  2. Faça login na sua conta do Google Cloud . Se você começou a usar o Google Cloudagora, crie uma conta para avaliar o desempenho dos nossos produtos em situações reais. Clientes novos também recebem US $300 em créditos para executar, testar e implantar cargas de trabalho sem custos financeiros.

    In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

    Verify that billing is enabled for your Google Cloud project.

    Enable the BigLake API, if it is not already enabled.

    Roles required to enable APIs

    To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

    Enable the API

    In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

    Verify that billing is enabled for your Google Cloud project.

    Enable the BigLake API, if it is not already enabled.

    Roles required to enable APIs

    To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

    Enable the API

Funções exigidas

Para receber as permissões necessárias para visualizar os detalhes do endpoint do catálogo, peça ao administrador para conceder a você os seguintes papéis do IAM no projeto:

Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Também é possível conseguir as permissões necessárias usando papéis personalizados ou outros papéis predefinidos.

Receber detalhes do endpoint do catálogo

Inspecione a configuração e as propriedades do endpoint do catálogo.

Console

  1. No console do Google Cloud , abra a página Lakehouse.

    Acessar o Lakehouse

  2. Clique no nome de qualquer catálogo.

  3. Na página Detalhes do catálogo, confira informações sobre o catálogo, como ID, carimbo de data/hora de criação, URI do catálogo REST, método de autenticação e conta de serviço.

    Para catálogos federados, a página Detalhes do catálogo também mostra as seguintes propriedades quando configuradas:

    • Modo de identidade: exibe Service identity ou User identity federation para conexões do Databricks Unity Catalog.
    • Nome do diretório de serviços: mostra o nome do recurso do serviço do Diretório de Serviços configurado para o transporte de consultas particulares nas conexões do AWS Glue, do Snowflake Horizon Catalog e do Databricks Unity Catalog.
    • Nome do diretório de serviços de metadados: exibe o nome do recurso de serviço do Diretório de Serviços configurado para atualização de metadados em segundo plano particular nas conexões do AWS Glue, do Snowflake Horizon Catalog e do Databricks Unity Catalog.

gcloud

Para descrever um endpoint de catálogo usando a Google Cloud CLI, execute o comando gcloud biglake iceberg catalogs describe.

gcloud biglake iceberg catalogs describe CATALOG_ID \
    --project="PROJECT_ID"

Substitua:

  • CATALOG_ID: o ID do catálogo.
  • PROJECT_ID: o ID do projeto Google Cloud .

REST

Para recuperar os detalhes e a configuração do endpoint do catálogo usando a API REST, faça uma solicitação GET ao endpoint GetIcebergCatalog:

GET /iceberg/v1/restcatalog/extensions/projects/PROJECT_ID/catalogs/CATALOG_ID

A resposta contém um objeto JSON IcebergCatalog que descreve a configuração do catálogo.

Substitua:

  • PROJECT_ID: o ID do projeto Google Cloud .
  • CATALOG_ID: o ID do catálogo.