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 del runtime Lakehouse.

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

Puoi esaminare i dettagli della tabella utilizzando la Google Cloud console, i comandi SQL DESCRIBE in Spark e Trino o l'API REST.

Prima di iniziare

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

  2. Abilita l'API BigLake.

    Ruoli richiesti per abilitare le API

    Per abilitare le API, devi disporre dell'autorizzazione serviceusage.services.enable. Se hai creato il progetto, probabilmente hai già questa autorizzazione tramite il ruolo Proprietario (roles/owner). In caso contrario, puoi ottenere questa autorizzazione tramite il ruolo Amministratore utilizzo servizi (roles/serviceusage.serviceUsageAdmin). Scopri come concedere i ruoli.

    Abilitare l'API

  3. Configura il catalogo del runtime Lakehouse con l'endpoint del catalogo REST Apache Iceberg.

Ruoli obbligatori

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

  • Tutti: BigLake Viewer (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.

Funzionalità e supporto delle tabelle

Quando utilizzi le tabelle nel catalogo del runtime Lakehouse, è utile comprendere i diversi tipi di tabelle e le relative funzionalità di attivazione. Per saperne di più sull'utilizzo delle tabelle Apache Iceberg in particolare, consulta Panoramica delle tabelle Apache Iceberg.

Tabelle Iceberg supportate

Sono supportate solo le tabelle Apache Iceberg V2 (GA) e V3 (anteprima). Le tabelle Iceberg V1 non sono supportate. Per eseguire l'upgrade delle tabelle V1 esistenti, consulta Eseguire l'upgrade delle tabelle Iceberg V1 a V2.

Recuperare i dettagli della tabella

Esamina lo schema e le proprietà della tabella.

Console

  1. Nella Google Cloud console, vai a Lakehouse.

    Vai a Lakehouse

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

  3. Nella tabella Dettagli dello 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()

Per abilitare l'interoperabilità di lettura/scrittura e la gestione delle tabelle (anteprima), aggiungi le proprietà alla clausola TBLPROPERTIES:

TBLPROPERTIES (
  'gcp.biglake.bigquery-dml.enabled' = true,
  'gcp.biglake.table-management.enabled' = true
)

Trino 

DESCRIBE SCHEMA_NAME.TABLE_NAME;

Per abilitare l'interoperabilità di lettura/scrittura e la gestione delle tabelle (anteprima), aggiungi queste proprietà alla clausola WITH:

WITH (
  "gcp.biglake.bigquery-dml.enabled" = 'true',
  "gcp.biglake.table-management.enabled" = 'true'
)

gcloud

Per descrivere una tabella utilizzando gcloud, esegui il comando gcloud biglake iceberg tables describe.

gcloud biglake iceberg tables describe TABLE_NAME \
    --project="PROJECT_ID" \
    --catalog="CATALOG_ID" \
    --namespace="NAMESPACE_NAME"

Sostituisci quanto segue:

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

BigQuery

Per visualizzare i dettagli della tabella e le proprietà dei metadati di una tabella Apache Iceberg nel catalogo del runtime Lakehouse da BigQuery, puoi esaminare i dettagli della tabella nella console BigQuery o utilizzare il comando bq show.

REST

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

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 nella modalità di distribuzione delle credenziali, invia una GET richiesta all' LoadIcebergTableCredentials endpoint:

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

Sostituisci quanto segue:

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

Passaggi successivi