L'esecuzione di query su una vista Apache Iceberg ti consente di leggere i risultati selezionati e senza copia dalle tabelle Iceberg sottostanti eseguendo la definizione SQL archiviata nel catalogo di runtime Lakehouse. Il motore di computing carica la definizione della vista dal catalogo, risolve ogni tabella e vista nidificata a cui viene fatto riferimento, quindi legge i file di dati in Cloud Storage.
Puoi eseguire query sulle viste Iceberg solo da motori open source compatibili con Iceberg, come Spark e Trino. BigQuery non supporta l'esecuzione di query sulle viste 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
Poiché il motore di Compute Engine valuta le viste lato client, devi disporre delle autorizzazioni per la vista e per ogni tabella e vista nidificata a cui fa riferimento.
Per ottenere le autorizzazioni necessarie per eseguire query su una vista, chiedi all'amministratore di concederti i seguenti ruoli IAM sul progetto e sul bucket di archiviazione:
-
Leggi la vista e le tabelle di riferimento in modalità di distribuzione delle credenziali:
BigLake Viewer (
roles/biglake.viewer) - il tuo progetto -
Leggi la vista e le tabelle di riferimento in modalità credenziali utente finale:
- BigLake Viewer (
roles/biglake.viewer) - il tuo progetto - Storage Object Viewer (
roles/storage.objectViewer): il bucket Cloud Storage
- BigLake Viewer (
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 eseguire query su una visualizzazione. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:
Autorizzazioni obbligatorie
Per eseguire una query su una vista sono necessarie le seguenti autorizzazioni:
-
Esegui una query su una vista:
-
biglake.views.getsulla vista e su eventuali viste nidificate -
biglake.tables.getsu ogni tabella Iceberg a cui fa riferimento la vista
-
-
Leggi i dati della tabella in modalità di distribuzione delle credenziali:
biglake.tables.getDatasu ogni tabella Iceberg a cui fa riferimento la vista -
Leggi i metadati della vista e i dati della tabella 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.
Esegui una query su una vista
Seleziona tutti i dati da una visualizzazione:
Spark
SELECT * FROM NAMESPACE_NAME.VIEW_NAME;
Sostituisci quanto segue:
NAMESPACE_NAME: il nome del tuo namespace.VIEW_NAME: il nome della visualizzazione.
Puoi eseguire query su viste che contengono join, aggregazioni, CTE e viste nidificate nello stesso modo. Ad esempio, le seguenti query utilizzano le viste di Crea una vista:
SELECT * FROM my_ns.eng_employees ORDER BY emp_id;
SELECT * FROM my_ns.employee_directory ORDER BY id;
SELECT * FROM my_ns.top_eng_employees;
Spostamento cronologico e visualizzazioni
Non puoi applicare una clausola di viaggio nel tempo come TIMESTAMP AS OF o VERSION AS OF direttamente a un identificatore di visualizzazione. Se hai bisogno di dati storici, definisci una vista la cui definizione SQL applica il viaggio nel tempo alla tabella sottostante o utilizza una CTE che esegue query direttamente sulla tabella sottostante. Per saperne di più, consulta Crea una vista con l'esplorazione cronologica sulle tabelle sottostanti.
Passaggi successivi
- Scopri come visualizzare i dettagli.
- Scopri come risolvere i problemi relativi alle viste Iceberg.