Fehlerbehebung bei Apache Iceberg-Ansichten

Wenn Sie Apache Iceberg-Ansichten im Lakehouse-Laufzeitkatalog erstellen, abfragen, ändern oder löschen, können Fehler wie Namenskonflikte mit Tabellen, Zugriffsverweigerungen, Zeitreisen in einer Ansicht, abgelaufene Snapshots, nicht unterstützte Katalogtypen oder ein unveränderlicher Ansichtsspeicherort auftreten. Dieses Dokument hilft Ihnen, die Ursache dieser häufigen Fehler zu ermitteln und zu beheben. Informationen zu allgemeinen Katalogproblemen finden Sie unter Fehlerbehebung.

409 Conflict oder AlreadyExistsException beim Erstellen oder Ersetzen einer Ansicht oder Tabelle

Tabellen und Ansichten haben denselben Kennzeichnungs-Namespace innerhalb eines Katalog-Namespace und der Katalog blockiert typübergreifende Überschreibungen. Sie können keine Ansicht mit demselben Namen wie eine vorhandene Tabelle oder eine Tabelle mit demselben Namen wie eine vorhandene Ansicht erstellen.

Listen Sie beide Tabellen und Ansichten im Namespace auf, um die Namenskollision zu finden:

SHOW TABLES IN NAMESPACE_NAME;
SHOW VIEWS IN NAMESPACE_NAME;

Wählen Sie einen anderen Namen aus oder löschen Sie zuerst das in Konflikt stehende Objekt.

403 Forbidden oder AccessDeniedException für Ansichtsvorgänge

Da Ihre Compute Engine Ansichten clientseitig auswertet, sind für die Abfrage einer Ansicht Berechtigungen für die Ansicht und für jede Tabelle erforderlich, auf die die Ansicht verweist. Gehen Sie so vor:

  • Für die Ansichts-DDL hat der Aufrufer die Rolle „BigLake-Bearbeiter“ (roles/biglake.editor) oder „BigLake-Administrator“ (roles/biglake.admin).
  • Für SELECT-Abfragen hat der Aufrufer die Rolle „BigLake-Betrachter“ (roles/biglake.viewer), die biglake.views.get für die Ansicht und biglake.tables.get und biglake.tables.getData für die referenzierten Tabellen gewährt.
  • Im Modus für Endnutzer-Anmeldedaten hat der Aufrufer die Rolle „Storage-Objekt-Nutzer“ (roles/storage.objectUser) für den Cloud Storage-Bucket für die Ansichts-DDL oder die Rolle „Storage-Objekt-Betrachter“ (roles/storage.objectViewer) für schreibgeschützte Abfragen.
  • Im Modus für die Bereitstellung von Anmeldedaten hat das Dienstkonto des Katalogs die Rolle „Storage Object User“ (roles/storage.objectUser) für den Cloud Storage-Bucket und Spark ist mit spark.sql.catalog.CATALOG_NAME.header.X-Iceberg-Access-Delegation=vended-credentials konfiguriert.

Weitere Informationen finden Sie unter Erforderliche Rollen und Berechtigungen.

UNSUPPORTED_FEATURE.TIME_TRAVEL_ON_VIEW

Spark gibt AnalysisException: [UNSUPPORTED_FEATURE.TIME_TRAVEL_ON_VIEW] Cannot time travel on view zurück, wenn eine Abfrage TIMESTAMP AS OF oder VERSION AS OF direkt auf eine Ansichts-ID anwendet.

Entfernen Sie die Zeitreiseklausel aus der Abfrage. Wenn Sie Verlaufsdaten benötigen, definieren Sie eine Ansicht, deren SQL-Definition TIMESTAMP AS OF auf die zugrunde liegende Tabelle anwendet, oder verwenden Sie einen CTE, der die zugrunde liegende Tabelle direkt abfragt. Weitere Informationen finden Sie unter Ansicht mit Zeitreisen für zugrunde liegende Tabellen erstellen.

ValidationException: Cannot find snapshot older than timestamp

Eine Ansicht, die mit einer Zeitreiseklausel definiert wurde, verweist auf einen Snapshot, der abgelaufen ist oder aus der zugrunde liegenden Tabelle entfernt wurde.

Ersetzen Sie die Ansicht durch CREATE OR REPLACE VIEW mit einem neueren Zeitstempel oder einer neueren Snapshot-ID oder passen Sie die Einstellungen für die Snapshot-Aufbewahrung für die zugrunde liegende Iceberg-Tabelle an.

409 Conflict: Namespace is not empty beim Löschen eines Namespace

Sie können einen Namespace, der noch Ansichten enthält, nicht löschen. Listen Sie alle verbleibenden Ansichten auf und löschen Sie sie. Löschen Sie dann den Namespace:

SHOW VIEWS IN NAMESPACE_NAME;
DROP VIEW IF EXISTS NAMESPACE_NAME.VIEW_NAME;

400 Bad Request mit FAILED_PRECONDITION für Ansichtsvorgänge

Iceberg-Ansichten werden nur in Katalogen mit mehreren Buckets und Katalogen mit einem Bucket unterstützt. Der Katalog lehnt Ansichtsvorgänge für BigQuery-Kataloge oder föderierte Kataloge ab. Erstellen Sie die Ansicht in einem unterstützten Katalogtyp.

400 Bad Request: View location is immutable

Sie können den Speicherort einer Ansicht nach dem Erstellen nicht mehr ändern. Entfernen Sie die Standortaktualisierung aus Ihrer Anfrage.

In Trino 481 und früheren Versionen sendet CREATE OR REPLACE VIEW ein Standortupdate, das diesen Fehler auslöst. Führen Sie ein Upgrade auf Trino 482 oder höher durch oder führen Sie DROP VIEW gefolgt von CREATE VIEW aus, um die Ansichtsdefinition zu aktualisieren. Weitere Informationen finden Sie unter Trino-Unterstützung.

Nächste Schritte