ビューの詳細を取得する

Lakehouse ランタイム カタログに登録されている Apache Iceberg ビューのスキーマ、列コメント、プロパティ、SQL 定義を検査するには、Spark または Apache Iceberg REST カタログ エンドポイントを使用します。

始める前に

  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)- プロジェクト
  • エンドユーザー認証情報モードでビュー メタデータ ファイルを読み取る: ストレージ オブジェクト閲覧者(roles/storage.objectViewer)- Cloud Storage バケット

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

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

必要な権限

ビューの詳細を取得するには、次の権限が必要です。

  • ビューの詳細を取得する: ビューに対する biglake.views.get
  • エンドユーザー認証情報モードでビュー メタデータ ファイルを読み取る: Cloud Storage バケットに対する storage.objects.get

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

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

ビューの詳細を取得する

ビューを検査する。

Spark

ビューのスキーマ、列のコメント、ビューのプロパティを表示します。

DESCRIBE EXTENDED NAMESPACE_NAME.VIEW_NAME;

ビューを定義する SQL ステートメントを表示します。

SHOW CREATE TABLE NAMESPACE_NAME.VIEW_NAME;

ビューのプロパティのみを表示します。

SHOW TBLPROPERTIES NAMESPACE_NAME.VIEW_NAME;

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

  • NAMESPACE_NAME: 名前空間の名前。
  • VIEW_NAME: ビューの名前。

REST

REST API を使用してビューの現在のメタデータを読み込むには、GetIcebergView エンドポイントに GET リクエストを送信します。

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

レスポンスには、ビューの metadata-location と metadata が含まれます。

メタデータを読み込まずにビューが存在するかどうかを確認するには、同じパスに HEAD リクエストを送信します。CheckIcebergViewExists エンドポイントは、ビューが存在する場合は 204 No Content を返し、存在しない場合は 404 Not Found を返します。

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

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

次のステップ