La modifica di una vista Apache Iceberg ti consente di evolvere lo schema e la definizione SQL della vista o di impostare e annullare l'impostazione delle proprietà della vista personalizzata, senza modificare l'identità della vista nel catalogo di runtime Lakehouse.
La ridenominazione di una visualizzazione non è supportata. Per rinominare una vista, creane una con il nuovo nome, quindi elimina la vista originale. Anche la località di archiviazione di una visualizzazione è immutabile dopo la creazione e un aggiornamento che imposta una località diversa non va a buon fine con un errore 400 Bad Request.
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 modificare una vista, chiedi all'amministratore di concederti i seguenti ruoli IAM sul progetto e sul bucket di archiviazione:
-
Modifica una vista:
BigLake Editor (
roles/biglake.editor) - il tuo progetto -
Scrivi i file dei metadati della vista in modalità credenziali dell'utente finale:
Storage Object User (
roles/storage.objectUser) - 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 modificare una vista. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:
Autorizzazioni obbligatorie
Per modificare una vista sono necessarie le seguenti autorizzazioni:
-
Modifica una vista:
-
biglake.views.updatenella vista -
biglake.tables.getsu ogni tabella Iceberg a cui fa riferimento la nuova definizione della vista
-
-
Scrivi i file di metadati della vista in modalità credenziali utente finale:
storage.objects.createsul 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.
Sostituisci una definizione di visualizzazione
Sostituisci lo schema e la logica SQL di una vista esistente. Quando sostituisci una vista, il catalogo scrive un nuovo file metadata.json con versione (ad esempio 00001-UUID.metadata.json), aggiunge una nuova versione e uno schema della vista ai metadati della vista e conserva il view-uuid della vista.
Spark
CREATE OR REPLACE VIEW my_ns.eng_employees (
emp_id,
emp_name,
dept,
salary,
is_senior
)
COMMENT 'Updated Engineering view with seniority flag'
AS SELECT id, name, dept, salary, (salary >= 140000.0) AS is_senior
FROM my_ns.employees
WHERE dept = 'Engineering';
REST
Per aggiornare una visualizzazione utilizzando l'API REST, invia una richiesta POST all'endpoint UpdateIcebergView:
POST /iceberg/v1/restcatalog/v1/projects/PROJECT_ID/catalogs/CATALOG_ID/namespaces/NAMESPACE_NAME/views/VIEW_NAME
Il corpo della richiesta deve contenere un payload JSON Iceberg CommitViewRequest valido con requirements e updates da applicare. Il catalogo convalida i requisiti di contemporaneità ottimistica ed esegue il commit degli aggiornamenti in un nuovo file metadata.json.
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.
Imposta e annulla l'impostazione delle proprietà della visualizzazione
Imposta o rimuovi le proprietà personalizzate in una vista senza modificarne la definizione.
Spark
Imposta le proprietà:
ALTER VIEW my_ns.eng_employees
SET TBLPROPERTIES ('tier' = 'gold', 'reviewed' = 'true');
Annulla l'impostazione di una proprietà:
ALTER VIEW my_ns.eng_employees
UNSET TBLPROPERTIES IF EXISTS ('reviewed');
Per informazioni dettagliate su come il catalogo gestisce proprietà come write.metadata.compression-codec, consulta Visualizza proprietà.
REST
Invia un CommitViewRequest all'endpoint UpdateIcebergView con aggiornamenti set-properties o remove-properties. Consulta Sostituisci una definizione di visualizzazione per il percorso dell'endpoint.
Passaggi successivi
- Scopri come visualizzare i dettagli.
- Scopri come eliminare una visualizzazione.