Visualizza i dettagli della vista

Puoi esaminare lo schema, i commenti delle colonne, le proprietà e la definizione SQL di una vista Apache Iceberg registrata nel catalogo di runtime Lakehouse utilizzando Spark o l'endpoint del catalogo REST di Apache Iceberg.

Prima di iniziare

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

  2. Abilita l'API BigLake, se non è già abilitata.

    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 Service Usage (roles/serviceusage.serviceUsageAdmin). Scopri come concedere i ruoli.

    Abilitare l'API

  3. Configura il catalogo di runtime Lakehouse con l'endpoint del catalogo REST Apache Iceberg.
  4. Esamina le limitazioni delle visualizzazioni Iceberg.
  5. Crea una vista.

Ruoli obbligatori

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

  • Ottieni i dettagli della vista: BigLake Viewer (roles/biglake.viewer) - il tuo progetto
  • Leggi i file di metadati della vista in modalità credenziali dell'utente finale: Storage Object Viewer (roles/storage.objectViewer) - il bucket Cloud Storage

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

Questi ruoli predefiniti contengono le autorizzazioni necessarie per ottenere i dettagli della visualizzazione. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per ottenere i dettagli della visualizzazione sono necessarie le seguenti autorizzazioni:

  • Recupera i dettagli della visualizzazione: biglake.views.get sulla visualizzazione
  • Leggi i file di metadati della vista in modalità credenziali dell'utente finale: storage.objects.get sul bucket Cloud Storage

Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Per un elenco completo delle autorizzazioni di visualizzazione, consulta Ruoli e autorizzazioni richiesti.

Visualizza i dettagli della vista

Ispeziona una vista.

Spark

Mostra lo schema della vista, i commenti delle colonne e le proprietà della vista:

DESCRIBE EXTENDED NAMESPACE_NAME.VIEW_NAME;

Mostra l'istruzione SQL che definisce la vista:

SHOW CREATE TABLE NAMESPACE_NAME.VIEW_NAME;

Mostra solo le proprietà della vista:

SHOW TBLPROPERTIES NAMESPACE_NAME.VIEW_NAME;

Sostituisci quanto segue:

  • NAMESPACE_NAME: il nome del tuo namespace.
  • VIEW_NAME: il nome della visualizzazione.

REST

Per caricare i metadati correnti di una vista utilizzando l'API REST, invia una richiesta GET all'endpoint GetIcebergView:

GET /iceberg/v1/restcatalog/v1/projects/PROJECT_ID/catalogs/CATALOG_ID/namespaces/NAMESPACE_NAME/views/VIEW_NAME

La risposta contiene i campi metadata-location e metadata della visualizzazione.

Per verificare se una visualizzazione esiste senza caricare i relativi metadati, invia una richiesta HEAD allo stesso percorso. L'endpoint CheckIcebergViewExists restituisce 204 No Content se la vista esiste o 404 Not Found se non esiste.

Sostituisci quanto segue:

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

Passaggi successivi