ビューをクエリする

Apache Iceberg ビューをクエリすると、Lakehouse ランタイム カタログに保存されている SQL 定義を実行して、基盤となる Iceberg テーブルからキュレートされたゼロコピーの結果を読み取ることができます。Compute Engine は、カタログからビュー定義を読み込み、参照されているすべてのテーブルとネストされたビューを解決してから、Cloud Storage のデータファイルを読み取ります。

Iceberg ビューをクエリできるのは、Spark や Trino などの Iceberg 互換のオープンソース エンジンからのみです。BigQuery では、Iceberg ビューのクエリはサポートされていません。

始める前に

  1. Google Cloud プロジェクトで課金が有効になっていることを確認します。

  2. BigLake API を有効にします(有効になっていない場合)。

    API を有効にするために必要なロール

    API を有効にするには、serviceusage.services.enable 権限が必要です。プロジェクトを作成した場合は、オーナーロール(roles/owner)を介してこの権限がすでに付与されている可能性があります。それ以外の場合は、Service Usage 管理者ロール(roles/serviceusage.serviceUsageAdmin)を介してこの権限を取得できます。ロールを付与する方法を確認する。

    API の有効化

  3. Apache Iceberg REST カタログ エンドポイントを使用して Lakehouse ランタイム カタログを設定します。
  4. Iceberg ビューの制限事項を確認します。
  5. ビューを作成します。

必要なロール

Compute Engine はクライアントサイドでビューを評価するため、ビューに対する権限と、ビューが参照するすべてのテーブルとネストされたビューに対する権限が必要です。

ビューに対してクエリを実行するために必要な権限を取得するには、プロジェクトとストレージ バケットに対する次の IAM ロールを付与するよう管理者に依頼してください。

  • 認証情報自動販売モードでビューと参照テーブルを読み取る: BigLake 閲覧者(roles/biglake.viewer)- プロジェクト
  • エンドユーザー認証情報モードでビューと参照テーブルを読み取ります。
    • BigLake 閲覧者(roles/biglake.viewer)- プロジェクト
    • Storage オブジェクト閲覧者(roles/storage.objectViewer)- Cloud Storage バケット

ロールの付与については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。

これらの事前定義ロールには、ビューに対するクエリを実行するために必要な権限が含まれています。必要とされる正確な権限については、「必要な権限」セクションを開いてご確認ください。

必要な権限

ビューにクエリを実行するには、次の権限が必要です。

  • ビューをクエリする:
    • ビューとネストされたビューに対する 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 を使用します。詳細については、基盤となるテーブルでタイムトラベルを使用してビューを作成するをご覧ください。

次のステップ