ビューを一覧表示する

リスト表示では、Lakehouse ランタイム カタログの名前空間に登録されている Apache 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. ビューを作成します。

必要なロール

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

  • リスト表示: BigLake 閲覧者(roles/biglake.viewer)- プロジェクト

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

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

必要な権限

ビューを一覧表示するには、次の権限が必要です。

  • リスト表示: 名前空間に対する biglake.views.list

カスタムロールや他の事前定義ロールを使用して、これらの権限を取得することもできます。

表示権限の完全なリストについては、必要なロールと権限をご覧ください。

リスト表示

名前空間内のビューを一覧表示します。

Spark

SHOW VIEWS IN NAMESPACE_NAME;

NAMESPACE_NAME は、名前空間の名前に置き換えます。

REST

REST API を使用してリスト表示を一覧表示するには、ListIcebergViewIdentifiers エンドポイントに GET リクエストを送信します。

GET /iceberg/v1/restcatalog/v1/projects/PROJECT_ID/catalogs/CATALOG_ID/namespaces/NAMESPACE_NAME/views

このエンドポイントは、pageToken クエリ パラメータと pageSize クエリ パラメータをサポートしています。

次のように置き換えます。

  • PROJECT_ID: 実際の Google Cloudプロジェクト ID。
  • CATALOG_ID: カタログの ID。
  • NAMESPACE_NAME: カタログの名前空間の名前。

次のステップ