テーブルのリスト表示

テーブルを一覧表示すると、Lakehouse ランタイム カタログ内の名前空間に登録されているすべてのテーブル エンティティを表示できます。

クエリエンジンは標準 SQL コマンドを使用してテーブルを一覧表示できます。また、REST クライアントはオープンソースの Iceberg REST カタログ API 仕様（GET /v1/{prefix}/namespaces/{namespace}/tables）を介してテーブル識別子を直接取得できます。

始める前に

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

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

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

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

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

    API の有効化

必要なロール

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

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

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

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

テーブルのリスト表示

テーブルを一覧表示します。

コンソール

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

    [Lakehouse] に移動

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

テーブルが [Namespace の詳細] ページに表示されます。

Spark 

spark.sql("SHOW TABLES").show()

Trino 

SHOW TABLES;

REST

REST API を使用して名前空間内のテーブル識別子を一覧表示するには、ListIcebergTableIdentifiers エンドポイントに GET リクエストを行います。

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

レスポンスには、指定された名前空間に登録されているテーブル識別子の JSON 配列が含まれます。

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

  • PROJECT_ID: 実際の Google Cloud プロジェクト ID。
  • CATALOG_ID: Lakehouse ランタイム カタログの ID。
  • NAMESPACE_NAME: カタログ Namespace の名前。

次のステップ