Elenca tabelle

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

I motori di query possono elencare le tabelle utilizzando i comandi SQL standard e i client REST possono recuperare gli identificatori delle tabelle direttamente tramite la specifica dell'API REST Catalog open source di Iceberg (GET /v1/{prefix}/namespaces/{namespace}/tables).

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 elencare le tabelle, chiedi all'amministratore di concederti i seguenti ruoli IAM nel 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.

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()

Trino 

SHOW TABLES;

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 del runtime di Lakehouse.
  • NAMESPACE_NAME: il nome dello spazio dei nomi del catalogo.

Passaggi successivi