列出表格

列出資料表可讓您在 Lakehouse 執行階段目錄中，查看命名空間內所有已註冊的資料表實體。

查詢引擎可以使用標準 SQL 指令列出資料表，REST 用戶端則可透過開放原始碼 Iceberg REST 目錄 API 規格 (GET /v1/{prefix}/namespaces/{namespace}/tables) 直接擷取資料表 ID。

事前準備

請參閱表格總覽，瞭解不同類型的表格，以及使用這些表格的影響。

  1. 確認專案已啟用計費功能 Google Cloud 。

  2. 啟用 BigLake API。

    啟用 API 時所需的角色

    如要啟用 API，您需要服務使用情形管理員 IAM 角色 (roles/serviceusage.serviceUsageAdmin)，其中包含 serviceusage.services.enable 權限。瞭解如何授予角色。

    啟用 API

必要的角色

如要取得列出資料表所需的權限，請要求系統管理員在專案中授予您下列 IAM 角色：

  • 全部： BigLake 檢視者 (roles/biglake.viewer) - 您的專案

如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和組織的存取權」。

您或許也能透過自訂角色或其他預先定義的角色，取得必要權限。

列出表格

列出資料表。

控制台

  1. 前往 Google Cloud 控制台的「Lakehouse」Lakehouse。

    前往 Lakehouse

  2. 選取現有目錄，或建立目錄 (如果沒有)。

資料表會顯示在「命名空間詳細資料」頁面。

Spark 

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

Trino 

SHOW TABLES;

REST

如要使用 REST API 列出命名空間中的資料表 ID，請向 ListIcebergTableIdentifiers 端點發出 GET 要求：

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

回應會包含 JSON 陣列，內含在指定命名空間下註冊的表格 ID。

更改下列內容：

  • PROJECT_ID：您的 Google Cloud 專案 ID。
  • CATALOG_ID：Lakehouse 執行階段目錄的 ID。
  • NAMESPACE_NAME：目錄命名空間名稱。

後續步驟