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
- 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.
- 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 theresourcemanager.projects.createpermission. Learn how to grant roles.
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
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.
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:
-
Todos:
- Administrador do BigLake (
roles/biglake.admin) - Administrador do Storage (
roles/storage.admin)
- Administrador do BigLake (
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
No console do Google Cloud , abra a página Lakehouse.
Clique no nome de qualquer catálogo.
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.