テーブルのリスト表示

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

クエリエンジンは標準 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） - プロジェクト

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

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

テーブルのリスト表示

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

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

SHOW TABLES;

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

次のステップ

• テーブルの詳細を取得する方法を学習する。
• テーブルをクエリする方法を学習する。