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

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

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

テーブルの詳細を調べるには、 Google Cloud コンソール、Spark と Trino の SQL describe コマンド、またはオープンソースの Iceberg REST Catalog API 仕様を使用します。

始める前に

さまざまなタイプのテーブルと、それらを使用した場合の影響については、テーブルの概要をご覧ください。

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

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

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

   API を有効にするには、serviceusage.services.enable 権限を含む Service Usage 管理者 IAM ロール（roles/serviceusage.serviceUsageAdmin）が必要です。詳しくは、ロールを付与する方法をご覧ください。

   API の有効化

必要なロール

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

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

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

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

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

テーブルのスキーマとプロパティを調べます。

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

DESCRIBE SCHEMA_NAME.TABLE_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

次のステップ

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