Apache Iceberg ビューのトラブルシューティング

Lakehouse ランタイム カタログで Apache Iceberg ビューを作成、クエリ、変更、削除すると、テーブルとの名前の競合、アクセス拒否、ビューでのタイムトラベル、期限切れのスナップショット、サポートされていないカタログタイプ、不変のビューの場所などのエラーが発生することがあります。このドキュメントは、これらの一般的なエラーの原因を特定して解決するのに役立ちます。カタログに関する一般的な問題については、トラブルシューティングをご覧ください。

ビューまたはテーブルの作成または置換時の 409 Conflict または AlreadyExistsException

テーブルとビューは、カタログ名前空間内で同じ識別子名前空間を共有し、カタログはクロスタイプのオーバーライトをブロックします。既存のテーブルと同じ名前のビューや、既存のビューと同じ名前のテーブルを作成することはできません。

名前の競合を特定するには、名前空間内のテーブルとビューの両方を一覧表示します。

SHOW TABLES IN NAMESPACE_NAME;
SHOW VIEWS IN NAMESPACE_NAME;

別の名前を選択するか、競合するオブジェクトを最初に削除してください。

ビュー オペレーションに対する 403 Forbidden または AccessDeniedException

Compute Engine はクライアントサイドでビューを評価するため、ビューをクエリするには、ビューと、ビューが参照するすべてのテーブルに対する権限が必要です。以下を確認してください。

  • ビュー DDL の場合、呼び出し元に BigLake 編集者(roles/biglake.editor)または BigLake 管理者(roles/biglake.admin)がある。
  • SELECT クエリの場合、呼び出し元には BigLake 閲覧者(roles/biglake.viewer)があり、ビューに対する biglake.views.get と、参照テーブルに対する biglake.tables.get と biglake.tables.getData が付与されます。
  • エンドユーザー認証情報モードでは、呼び出し元は、ビュー DDL の Cloud Storage バケットに対する Storage オブジェクト ユーザー(roles/storage.objectUser)または読み取り専用クエリの Storage オブジェクト閲覧者(roles/storage.objectViewer)を持っています。
  • 認証情報提供モードでは、カタログのサービス アカウントに Cloud Storage バケットに対する Storage オブジェクト ユーザー(roles/storage.objectUser)があり、Spark は spark.sql.catalog.CATALOG_NAME.header.X-Iceberg-Access-Delegation=vended-credentials で構成されています。

詳細については、必要なロールと権限をご覧ください。

UNSUPPORTED_FEATURE.TIME_TRAVEL_ON_VIEW

クエリが TIMESTAMP AS OF または VERSION AS OF をビュー識別子に直接適用すると、Spark は AnalysisException: [UNSUPPORTED_FEATURE.TIME_TRAVEL_ON_VIEW] Cannot time travel on view を返します。

クエリからタイムトラベル句を削除します。過去のデータが必要な場合は、SQL 定義が基になるテーブルに TIMESTAMP AS OF を適用するビューを定義するか、基になるテーブルを直接クエリする CTE を使用します。詳細については、基盤となるテーブルでタイムトラベルを使用してビューを作成するをご覧ください。

ValidationException: Cannot find snapshot older than timestamp

タイムトラベル句で定義されたビューが、期限切れのスナップショットまたは基になるテーブルから削除されたスナップショットを参照している。

新しいタイムスタンプまたはスナップショット ID を使用してビューを CREATE OR REPLACE VIEW に置き換えるか、基盤となる Iceberg テーブルのスナップショット保持設定を調整します。

409 Conflict: Namespace is not empty(名前空間を削除する場合)

ビューが残っている名前空間を削除することはできません。残りのビューを一覧表示して削除し、名前空間を削除します。

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

400 Bad Request(FAILED_PRECONDITION を使用): ビュー オペレーション

Iceberg ビューは、マルチバケット カタログとシングルバケット カタログでのみサポートされています。カタログは、BigQuery カタログまたは連携カタログに対するビュー オペレーションを拒否します。サポートされているカタログタイプでビューを作成します。

400 Bad Request: View location is immutable

ビューの作成後にビューのストレージ ロケーションを変更することはできません。リクエストから位置情報の更新を削除します。

Trino 481 以前では、CREATE OR REPLACE VIEW がこのエラーをトリガーする位置情報の更新を送信します。Trino 482 以降にアップグレードするか、DROP VIEW を実行してから CREATE VIEW を実行してビュー定義を更新します。詳細については、Trino のサポートをご覧ください。

次のステップ