Receber detalhes do catálogo

A recuperação das propriedades de configuração expõe metadados do Lakehouse para Apache Iceberg.

No catálogo de ambientes de execução do Lakehouse, a inspeção de um catálogo atual (como um catálogo REST do Apache Iceberg ou do Apache Hive) revela os detalhes dele. Para catálogos REST do Apache Iceberg, isso inclui 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 de ambientes de execução do Lakehouse para entender como ele funciona e as limitações do serviço.
    2. Faça login na sua Google Cloud conta do. 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.

    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.

    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.

    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 catálogo, peça para o administrador 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 com papéis personalizados ou outros papéis predefinidos.

Acessar detalhes do catálogo

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

Console

  1. No Google Cloud console do, 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 seu catálogo.
  • PROJECT_ID: o ID do Google Cloud projeto.

REST

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

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 Google Cloud projeto.
  • CATALOG_ID: o ID do seu catálogo.