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
- Leia Sobre o catálogo do ambiente de execução do Lakehouse para entender como ele 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. - 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.
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 os detalhes do endpoint 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 de armazenamento (
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 endpoint do catálogo
Inspecione a configuração e as propriedades do endpoint 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.
Para catálogos federados, a página Detalhes do catálogo também mostra as seguintes propriedades quando configuradas:
- Modo de identidade: exibe
Service identityouUser identity federationpara 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.
- Modo de identidade: exibe
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.