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
-
Verifica che la fatturazione sia attivata per il tuo progetto Google Cloud .
-
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. - Configura il catalogo di runtime Lakehouse con l'endpoint del catalogo REST Apache Iceberg.
- Esamina le limitazioni delle visualizzazioni Iceberg.
- 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.getsulla visualizzazione -
Leggi i file di metadati della vista in modalità credenziali dell'utente finale:
storage.objects.getsul 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
- Scopri come eseguire query su una vista.
- Scopri come modificare una vista.