テーブルを一覧表示すると、 Lakehouse ランタイム カタログの名前空間内のすべての登録済みテーブル エンティティを表示できます。
クエリエンジンは標準の SQL コマンドを使用してテーブルを一覧表示できます。また、REST API を使用してテーブル識別子を取得できます。
始める前に
-
BigLake API を有効にします。
API を有効にするために必要なロール
API を有効にするには、
serviceusage.services.enable権限を含む Service Usage 管理者 IAM ロール（roles/serviceusage.serviceUsageAdmin）が必要です。詳しくは、ロールを付与する方法をご覧ください。 - 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 にアップグレードするをご覧ください。
テーブルのリスト表示
テーブルの一覧を表示します。
コンソール
コンソールで、[Lakehouse] に移動します。 Google Cloud
既存のカタログを選択するか、カタログがない場合は作成します。
テーブルが [Namespace details] ページに表示されます。
Spark
spark.sql("SHOW TABLES").show()
読み取り/書き込みの相互運用性とテーブル管理（プレビュー）を有効にするには、次のプロパティを TBLPROPERTIES 句に追加します。
TBLPROPERTIES (
'gcp.biglake.bigquery-dml.enabled' = true,
'gcp.biglake.table-management.enabled' = true
)
Trino
SHOW TABLES;
読み取り/書き込みの相互運用性とテーブル管理（プレビュー）を有効にするには、次のプロパティを WITH 句に追加します。
WITH (
"gcp.biglake.bigquery-dml.enabled" = 'true',
"gcp.biglake.table-management.enabled" = 'true'
)
gcloud
gcloud を使用してテーブルを一覧表示するには、gcloud biglake iceberg tables list コマンドを実行します。
gcloud biglake iceberg tables list \ --project="PROJECT_ID" \ --catalog="CATALOG_ID" \ --namespace="NAMESPACE_NAME"
次のように置き換えます。
PROJECT_ID: 実際の Google Cloud プロジェクト ID。CATALOG_ID: カタログの ID。NAMESPACE_NAME: カタログの名前空間の名前。
BigQuery
BigQuery から Lakehouse ランタイム カタログ内の Apache Iceberg テーブルを一覧表示するには、BigQuery コンソールの [エクスプローラ] ペインで確認するか、bq ls コマンドを使用します。
REST
REST API を使用して名前空間内のテーブル識別子を一覧表示するには、GET
リクエストを ListIcebergTableIdentifiers エンドポイントに送信します。
GET /iceberg/v1/restcatalog/v1/projects/PROJECT_ID/catalogs/CATALOG_ID/namespaces/NAMESPACE_NAME/tables
レスポンスには、指定された名前空間に登録されているテーブル識別子の JSON 配列が含まれます。
次のように置き換えます。
PROJECT_ID: 実際の Google Cloud プロジェクト ID。CATALOG_ID: カタログの ID。NAMESPACE_NAME: カタログの名前空間の名前。