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

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

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

テーブルの詳細は、 Google Cloud コンソール、Spark と Trino の SQL describe コマンド 、オープンソースの Iceberg REST カタログ API 仕様を使用して確認できます。

始める前に

テーブルの概要で、 さまざまな種類のテーブルと、それらを使用する場合の影響について確認してください。

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

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

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

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

    API の有効化

必要なロール

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

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

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

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

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

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

コンソール

  1. コンソールで、[Lakehouse] に移動します。 Google Cloud

    Lakehouse に移動

  2. 既存のカタログを選択するか、カタログがない場合は作成します。

  3. [Namespace details] テーブルで、確認するテーブルの名前をクリックします。

  4. [Table details] ページで、テーブルのスキーマ、パーティション仕様、メタデータ プロパティを確認します。

Spark 

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

Trino 

DESCRIBE SCHEMA_NAME.TABLE_NAME;

REST

REST API を使用してテーブル メタデータを取得するには、GetIcebergTable エンドポイントに GET リクエストを送信します。

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

認証情報ベンディング モードで有効期間の短いテーブル認証情報を読み込むには、LoadIcebergTableCredentials エンドポイントに GET リクエストを送信します。

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

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

  • PROJECT_ID: 実際の Google Cloud プロジェクト ID。
  • CATALOG_ID: Lakehouse ランタイム カタログの ID。
  • NAMESPACE_NAME: カタログ名前空間の名前。
  • TABLE_NAME: Iceberg テーブルの名前。

次のステップ