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 のサポートをご覧ください。
次のステップ
- Apache Iceberg ビューの概要を確認する。
- ビューを作成する方法を学ぶ。