Elenca tabelle

L'elenco delle tabelle consente di visualizzare tutte le entità tabella registrate all'interno di uno spazio dei nomi nel catalogo runtime Lakehouse.

I motori di query possono elencare le tabelle utilizzando i comandi SQL standard e puoi recuperare gli identificatori delle tabelle utilizzando l'API REST.

Prima di iniziare

  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 dell'autorizzazione serviceusage.services.enable. Se hai creato il progetto, probabilmente disponi già di questa autorizzazione tramite il ruolo Proprietario (roles/owner). In caso contrario, puoi ottenere questa autorizzazione tramite il ruolo Amministratore utilizzo dei servizi (roles/serviceusage.serviceUsageAdmin). Scopri come concedere i ruoli.

    Abilitare l'API

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

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per elencare le tabelle, chiedi all'amministratore di concederti i seguenti ruoli IAM nel progetto:

  • Elenca tabelle: 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 la differenza tra i tipi di tabelle. Per saperne di più sull'utilizzo delle tabelle Apache Iceberg, 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, vedi Eseguire l'upgrade delle tabelle Iceberg V1 alla versione V2.

Elenca tabelle

Elenca tabelle.

Console

  1. Nella console Google Cloud , vai a Lakehouse.

    Vai a Lakehouse

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

Le tabelle vengono visualizzate nella pagina Dettagli spazio dei nomi.

Spark 

spark.sql("SHOW TABLES").show()

Per attivare l'interoperabilità in 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 

SHOW TABLES;

Per attivare l'interoperabilità in 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 elencare le tabelle utilizzando gcloud, esegui il comando gcloud biglake iceberg tables list.

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

Sostituisci quanto segue:

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

BigQuery

Per elencare le tabelle Apache Iceberg nel catalogo del runtime Lakehouse da BigQuery, puoi esplorare il riquadro Explorer nella console BigQuery o utilizzare il comando bq ls.

REST

Per elencare gli identificatori di tabella all'interno di uno spazio dei nomi utilizzando l'API REST, invia una richiesta GET all'endpoint ListIcebergTableIdentifiers:

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

La risposta contiene un array JSON di identificatori di tabelle registrati nello spazio dei nomi specificato.

Sostituisci quanto segue:

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

Passaggi successivi