Quando crei, esegui query, modifichi o elimini visualizzazioni Apache Iceberg nel catalogo di runtime Lakehouse, potresti riscontrare errori come conflitti di nomi con le tabelle, negazioni di accesso, viaggi nel tempo su una visualizzazione, snapshot scaduti, tipi di catalogo non supportati o una posizione di visualizzazione immutabile. Questo documento ti aiuta a identificare la causa di questi errori comuni e a risolverli. Per problemi generali relativi al catalogo, consulta Risoluzione dei problemi.
409 Conflict o AlreadyExistsException durante la creazione o la sostituzione di una vista o di una tabella
Le tabelle e le viste condividono lo stesso spazio dei nomi dell'identificatore all'interno di uno spazio dei nomi del catalogo e il catalogo blocca le sovrascritture tra tipi. Non puoi creare una vista con lo stesso nome di una tabella esistente o una tabella con lo stesso nome di una vista esistente.
Per trovare la collisione dei nomi, elenca sia le tabelle che le viste nello spazio dei nomi:
SHOW TABLES IN NAMESPACE_NAME;
SHOW VIEWS IN NAMESPACE_NAME;
Scegli un nome diverso o elimina prima l'oggetto in conflitto.
403 Forbidden o AccessDeniedException sulle operazioni di visualizzazione
Poiché Compute Engine valuta le viste lato client, l'esecuzione di query su una vista richiede autorizzazioni sulla vista e su ogni tabella a cui fa riferimento. Verifica quanto segue:
- Per la DDL della vista, il chiamante ha il ruolo BigLake Editor (
roles/biglake.editor) o BigLake Admin (roles/biglake.admin). - Per le query
SELECT, il chiamante ha il ruolo BigLake Viewer (roles/biglake.viewer), che concedebiglake.views.getsulla vista ebiglake.tables.getebiglake.tables.getDatasulle tabelle di riferimento. - In modalità credenziali dell'utente finale, il chiamante ha il ruolo Storage Object User (
roles/storage.objectUser) sul bucket Cloud Storage per visualizzare il DDL o Storage Object Viewer (roles/storage.objectViewer) per le query di sola lettura. - In modalità di distribuzione delle credenziali, il account di servizio del catalogo ha il ruolo Storage Object User (
roles/storage.objectUser) sul bucket Cloud Storage e Spark è configurato conspark.sql.catalog.CATALOG_NAME.header.X-Iceberg-Access-Delegation=vended-credentials.
Per saperne di più, consulta Ruoli e autorizzazioni richiesti.
UNSUPPORTED_FEATURE.TIME_TRAVEL_ON_VIEW
Spark restituisce AnalysisException: [UNSUPPORTED_FEATURE.TIME_TRAVEL_ON_VIEW]
Cannot time travel on view quando una query applica TIMESTAMP AS OF o VERSION AS OF direttamente a un identificatore di visualizzazione.
Rimuovi la clausola di viaggio nel tempo dalla query. Se hai bisogno di dati storici, definisci una vista la cui definizione SQL applica TIMESTAMP AS OF alla tabella sottostante o utilizza un'espressione CTE che esegue query direttamente sulla tabella sottostante. Per ulteriori informazioni, consulta Crea una vista con viaggio nel tempo sulle tabelle sottostanti.
ValidationException: Cannot find snapshot older than timestamp
Una vista definita con una clausola di cronologia fa riferimento a uno snapshot scaduto o rimosso dalla tabella sottostante.
Sostituisci la vista con CREATE OR REPLACE VIEW utilizzando un timestamp o un ID snapshot più recente oppure modifica le impostazioni di conservazione degli snapshot nella tabella Iceberg sottostante.
409 Conflict: Namespace is not empty quando viene eliminato uno spazio dei nomi
Non puoi eliminare uno spazio dei nomi che contiene ancora visualizzazioni. Elenca ed elimina le visualizzazioni rimanenti, quindi elimina lo spazio dei nomi:
SHOW VIEWS IN NAMESPACE_NAME;
DROP VIEW IF EXISTS NAMESPACE_NAME.VIEW_NAME;
400 Bad Request con FAILED_PRECONDITION per le operazioni di visualizzazione
Le visualizzazioni Iceberg sono supportate solo nei cataloghi con più bucket e con un solo bucket. Il catalogo rifiuta le operazioni di visualizzazione sui cataloghi BigQuery o sui cataloghi federati. Crea la vista in un tipo di catalogo supportato.
400 Bad Request: View location is immutable
Non puoi modificare la località di archiviazione di una vista dopo averla creata. Rimuovi l'aggiornamento della posizione dalla richiesta.
In Trino 481 e versioni precedenti, CREATE OR REPLACE VIEW invia un aggiornamento della posizione che attiva questo errore. Esegui l'upgrade a Trino 482 o versioni successive oppure esegui DROP VIEW seguito da CREATE VIEW per aggiornare la definizione della vista. Per ulteriori informazioni, consulta Supporto di Trino.
Passaggi successivi
- Leggi la panoramica delle viste Apache Iceberg.
- Scopri come creare una visualizzazione.