リスト表示では、Lakehouse ランタイム カタログの名前空間に登録されている Apache Iceberg ビューを確認できます。結果にはビュー識別子のみが含まれます。テーブルは除外されます。同様に、テーブルを一覧表示するとビューが除外されます。
始める前に
-
BigLake API を有効にします(有効になっていない場合)。
API を有効にするために必要なロール
API を有効にするには、
serviceusage.services.enable権限が必要です。プロジェクトを作成した場合は、オーナーロール(roles/owner)を介してこの権限がすでに付与されている可能性があります。それ以外の場合は、Service Usage 管理者ロール(roles/serviceusage.serviceUsageAdmin)を介してこの権限を取得できます。ロールを付与する方法を確認する。 - Apache Iceberg REST カタログ エンドポイントを使用して Lakehouse ランタイム カタログを設定します。
- Iceberg ビューの制限事項を確認します。
- ビューを作成します。
必要なロール
ビューをリスト表示するために必要な権限を取得するには、プロジェクトに対する次の 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: カタログの名前空間の名前。