Apache Iceberg ビューをクエリすると、Lakehouse ランタイム カタログに保存されている SQL 定義を実行して、基盤となる Iceberg テーブルからキュレートされたゼロコピーの結果を読み取ることができます。Compute Engine は、カタログからビュー定義を読み込み、参照されているすべてのテーブルとネストされたビューを解決してから、Cloud Storage のデータファイルを読み取ります。
Iceberg ビューをクエリできるのは、Spark や Trino などの Iceberg 互換のオープンソース エンジンからのみです。BigQuery では、Iceberg ビューのクエリはサポートされていません。
始める前に
-
BigLake API を有効にします(有効になっていない場合)。
API を有効にするために必要なロール
API を有効にするには、
serviceusage.services.enable権限が必要です。プロジェクトを作成した場合は、オーナーロール(roles/owner)を介してこの権限がすでに付与されている可能性があります。それ以外の場合は、Service Usage 管理者ロール(roles/serviceusage.serviceUsageAdmin)を介してこの権限を取得できます。ロールを付与する方法を確認する。 - Apache Iceberg REST カタログ エンドポイントを使用して Lakehouse ランタイム カタログを設定します。
- Iceberg ビューの制限事項を確認します。
- ビューを作成します。
必要なロール
Compute Engine はクライアントサイドでビューを評価するため、ビューに対する権限と、ビューが参照するすべてのテーブルとネストされたビューに対する権限が必要です。
ビューに対してクエリを実行するために必要な権限を取得するには、プロジェクトとストレージ バケットに対する次の IAM ロールを付与するよう管理者に依頼してください。
-
認証情報自動販売モードでビューと参照テーブルを読み取る: BigLake 閲覧者(
roles/biglake.viewer)- プロジェクト -
エンドユーザー認証情報モードでビューと参照テーブルを読み取ります。
- BigLake 閲覧者(
roles/biglake.viewer)- プロジェクト - Storage オブジェクト閲覧者(
roles/storage.objectViewer)- Cloud Storage バケット
- BigLake 閲覧者(
ロールの付与については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。
これらの事前定義ロールには、ビューに対するクエリを実行するために必要な権限が含まれています。必要とされる正確な権限については、「必要な権限」セクションを開いてご確認ください。
必要な権限
ビューにクエリを実行するには、次の権限が必要です。
-
ビューをクエリする:
-
ビューとネストされたビューに対する
biglake.views.get -
ビューが参照する各 Iceberg テーブルに対する
biglake.tables.get
-
ビューとネストされたビューに対する
-
認証情報自動販売モードでテーブルデータを読み取る: ビューが参照する各 Iceberg テーブルに対する
biglake.tables.getData -
エンドユーザー認証情報モードでビューのメタデータとテーブルデータを読み取る: Cloud Storage バケットに対する
storage.objects.get
カスタムロールや他の事前定義ロールを使用して、これらの権限を取得することもできます。
表示権限の完全なリストについては、必要なロールと権限をご覧ください。
ビューをクエリする
ビューからすべてのデータを選択します。
Spark
SELECT * FROM NAMESPACE_NAME.VIEW_NAME;
次のように置き換えます。
NAMESPACE_NAME: 名前空間の名前。VIEW_NAME: ビューの名前。
結合、集計、CTE、ネストされたビューを含むビューも同様にクエリできます。たとえば、次のクエリでは、ビューを作成するのビューを使用します。
SELECT * FROM my_ns.eng_employees ORDER BY emp_id;
SELECT * FROM my_ns.employee_directory ORDER BY id;
SELECT * FROM my_ns.top_eng_employees;
タイムトラベルとビュー
TIMESTAMP AS OF や VERSION AS OF などのタイムトラベル句をビュー識別子に直接適用することはできません。過去のデータが必要な場合は、SQL 定義で基になるテーブルにタイムトラベルを適用するビューを定義するか、基になるテーブルを直接クエリする CTE を使用します。詳細については、基盤となるテーブルでタイムトラベルを使用してビューを作成するをご覧ください。
次のステップ
- 視聴回数を増やす方法を確認する。
- Iceberg ビューのトラブルシューティング方法を確認する。