Recupero dettagli della tabella

La visualizzazione dei dettagli della tabella espone lo schema sottostante, le proprietà della tabella e i metadati di configurazione per una tabella Apache Iceberg nel catalogo di runtime di Lakehouse.

In modalità di distribuzione delle credenziali, i motori di query recuperano anche credenziali di accesso di breve durata per interagire in modo sicuro con i file Cloud Storage sottostanti senza richiedere autorizzazioni di archiviazione IAM dirette.

Puoi esaminare i dettagli della tabella utilizzando la console Google Cloud , i comandi SQL describe in Spark e Trino o la specifica dell'API REST Catalog Iceberg open source.

Prima di iniziare

Consulta la panoramica delle tabelle per comprendere i diversi tipi di tabelle e le implicazioni del loro utilizzo.

  1. Verifica che la fatturazione sia attivata per il tuo progetto Google Cloud .

  2. Abilita l'API BigLake.

    Ruoli richiesti per abilitare le API

    Per abilitare le API, devi disporre del ruolo IAM Amministratore utilizzo dei servizi (roles/serviceusage.serviceUsageAdmin), che include l'autorizzazione serviceusage.services.enable. Scopri come concedere i ruoli.

    Abilitare l'API

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per visualizzare i dettagli della tabella, chiedi all'amministratore di concederti i seguenti ruoli IAM nel tuo progetto:

  • Tutti: Visualizzatore BigLake (roles/biglake.viewer) - il tuo progetto

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.

Recupero dettagli della tabella

Esamina lo schema e le proprietà della tabella.

Console

  1. Nella console Google Cloud , vai a Lakehouse.

    Vai a Lakehouse

  2. Seleziona un catalogo esistente o creane uno se non ne hai.

  3. Nella tabella Dettagli spazio dei nomi, fai clic sul nome della tabella che vuoi esaminare.

  4. Nella pagina Dettagli tabella, esplora lo schema, la specifica della partizione e le proprietà dei metadati della tabella.

Spark 

spark.sql("DESCRIBE EXTENDED NAMESPACE_NAME.TABLE_NAME").show()

Trino 

DESCRIBE SCHEMA_NAME.TABLE_NAME;

REST

Per recuperare i metadati della tabella utilizzando l'API REST, invia una richiesta GET all'endpoint GetIcebergTable:

GET /iceberg/v1/restcatalog/v1/projects/PROJECT_ID/catalogs/CATALOG_ID/namespaces/NAMESPACE_NAME/tables/TABLE_NAME

Per caricare le credenziali della tabella di breve durata in modalità di distribuzione delle credenziali, invia una richiesta GET all'endpoint LoadIcebergTableCredentials:

GET /iceberg/v1/restcatalog/v1/projects/PROJECT_ID/catalogs/CATALOG_ID/namespaces/NAMESPACE_NAME/tables/TABLE_NAME/credentials

Sostituisci quanto segue:

  • PROJECT_ID: il tuo ID progetto Google Cloud .
  • CATALOG_ID: l'ID del catalogo del runtime di Lakehouse.
  • NAMESPACE_NAME: il nome dello spazio dei nomi del catalogo.
  • TABLE_NAME: il nome della tabella Iceberg.

Passaggi successivi