Recupera i dettagli del catalogo

Il recupero delle proprietà di configurazione espone i metadati per Lakehouse senza limiti.

All'interno del catalogo runtime Lakehouse, l'ispezione di un catalogo esistente (ad esempio un catalogo REST Apache Iceberg o un catalogo Apache Hive) ne rivela i dettagli. Per i cataloghi REST Apache Iceberg, sono inclusi l'URI del catalogo REST richiesto per le connessioni client, il metodo di autenticazione e l'account di servizio associato.

Prima di iniziare

1. Leggi Informazioni sul catalogo runtime Lakehouse per capire come funziona il catalogo runtime Lakehouse e i limiti del servizio.
Accedi al tuo Google Cloud account. Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti senza costi per l'esecuzione, il test e il deployment dei carichi di lavoro.

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.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

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.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

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

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per visualizzare i dettagli del catalogo, chiedi all'amministratore di concederti i seguenti ruoli IAM sul progetto:

• Tutti:
  • Amministratore BigLake (roles/biglake.admin)
  • Amministratore spazio di archiviazione (roles/storage.admin)

Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Visualizza i dettagli del catalogo

Esamina la configurazione e le proprietà del catalogo.

Console

1. Nella Google Cloud console, apri la pagina Lakehouse.

   Vai a Lakehouse

2. Fai clic sul nome di un catalogo.

3. Nella pagina Dettagli catalogo, esplora le informazioni sul catalogo, come l'ID catalogo, il timestamp di creazione, l'URI del catalogo REST, il metodo di autenticazione e l'account di servizio.

gcloud

Per descrivere un catalogo utilizzando gcloud, esegui il comando gcloud biglake iceberg catalogs describe.

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

Sostituisci quanto segue:

• CATALOG_ID: l'ID del catalogo.
• PROJECT_ID: l' Google Cloud ID progetto.

REST

Per recuperare i dettagli e la configurazione del catalogo utilizzando l'API REST, invia una GET richiesta al GetIcebergCatalog endpoint:

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

La risposta contiene un oggetto JSON IcebergCatalog che descrive la configurazione del catalogo.

Sostituisci quanto segue:

• PROJECT_ID: l' Google Cloud ID progetto.
• CATALOG_ID: l'ID del catalogo.