テーブルの詳細を取得する

テーブルの詳細を表示すると、Lakehouse ランタイム カタログ 内の Apache Iceberg テーブルの基盤となるスキーマ、テーブル プロパティ、構成メタデータが表示されます。

認証情報ベンディング モードでは、クエリエンジンは、直接 IAM ストレージ権限を必要とせずに、基盤となる Cloud Storage ファイルと安全にやり取りするための有効期間の短いアクセス認証情報も取得します。

テーブルの詳細は、 Google Cloud コンソール、Spark と Trino の SQL DESCRIBE コマンド、または REST API を使用して確認できます。

始める前に

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

2. BigLake API を有効にします。

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

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

   API の有効化

3. Apache Iceberg REST カタログ エンドポイントを使用して Lakehouse ランタイム カタログを設定します。

必要なロール

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

• すべて: BigLake 閲覧者（roles/biglake.viewer） - プロジェクト

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

必要な権限は、カスタム ロールや他の事前定義 ロールから取得することもできます。

テーブルの機能とサポート

Lakehouse ランタイム カタログでテーブルを使用する場合は、さまざまなテーブルタイプとそのオプトイン 機能を理解して おくと便利です。Apache Iceberg テーブルの使用について詳しくは、Apache Iceberg テーブルの概要をご覧ください。

サポートされている Iceberg テーブル

Apache Iceberg V2（GA）テーブルと V3（プレビュー）テーブルのみがサポートされています。Iceberg V1 テーブルはサポートされていません。既存の V1 テーブルをアップグレードするには、Iceberg V1 テーブルを V2 にアップグレードするをご覧ください。

テーブルの詳細を取得する

テーブルのスキーマとプロパティを確認します。

spark.sql("DESCRIBE EXTENDED NAMESPACE_NAME.TABLE_NAME").show()

TBLPROPERTIES (
  'gcp.biglake.bigquery-dml.enabled' = true,
  'gcp.biglake.table-management.enabled' = true
)

DESCRIBE SCHEMA_NAME.TABLE_NAME;

WITH (
  "gcp.biglake.bigquery-dml.enabled" = 'true',
  "gcp.biglake.table-management.enabled" = 'true'
)

gcloud biglake iceberg tables describe TABLE_NAME \
    --project="PROJECT_ID" \
    --catalog="CATALOG_ID" \
    --namespace="NAMESPACE_NAME"

GET /iceberg/v1/restcatalog/v1/projects/PROJECT_ID/catalogs/CATALOG_ID/namespaces/NAMESPACE_NAME/tables/TABLE_NAME

GET /iceberg/v1/restcatalog/v1/projects/PROJECT_ID/catalogs/CATALOG_ID/namespaces/NAMESPACE_NAME/tables/TABLE_NAME/credentials

次のステップ

• テーブルにクエリを実行する方法を学習する。
• テーブルを変更する方法を学習する。