Receber detalhes do catálogo

Com o catálogo de ambientes de execução do Lakehouse, é possível inspecionar a configuração e os metadados de um endpoint de catálogo REST do Apache Iceberg ou de um endpoint de catálogo do Apache Hive 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.

Antes de começar

  1. Leia Sobre o catálogo do ambiente de execução do Lakehouse para entender como o catálogo do ambiente de execução do Lakehouse funciona e as limitações do serviço.
  2. 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 detalhes 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 catálogo

Inspecione a configuração e as propriedades 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.

gcloud

Para descrever um catálogo usando gcloud, 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 detalhes e configuração 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.