Lakehouse ランタイム カタログに登録されている Apache Iceberg ビューのスキーマ、列コメント、プロパティ、SQL 定義を検査するには、Spark または Apache Iceberg REST カタログ エンドポイントを使用します。
始める前に
-
BigLake API を有効にします(有効になっていない場合)。
API を有効にするために必要なロール
API を有効にするには、
serviceusage.services.enable権限が必要です。プロジェクトを作成した場合は、オーナーロール(roles/owner)を介してこの権限がすでに付与されている可能性があります。それ以外の場合は、Service Usage 管理者ロール(roles/serviceusage.serviceUsageAdmin)を介してこの権限を取得できます。ロールを付与する方法を確認する。 - Apache Iceberg REST カタログ エンドポイントを使用して Lakehouse ランタイム カタログを設定します。
- Iceberg ビューの制限事項を確認します。
- ビューを作成します。
必要なロール
ビューの詳細を取得するために必要な権限を取得するには、プロジェクトとストレージ バケットに対する次の 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: ビューの名前。