取得資料表詳細資料

查看資料表詳細資料時，系統會顯示 Lakehouse 執行階段目錄中 Apache Iceberg 資料表的基礎結構定義、資料表屬性和設定中繼資料。

在憑證販售模式中，查詢引擎也會擷取短期存取憑證，以便安全地與底層 Cloud Storage 檔案互動，不必直接取得 IAM 儲存空間權限。

您可以使用 Google Cloud 控制台、Spark 和 Trino 中的 SQL 說明指令，或開放原始碼 Iceberg REST 目錄 API 規格，檢查資料表詳細資料。

事前準備

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

  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. 選取現有目錄，或建立目錄 (如果沒有)。

  3. 在「命名空間詳細資料」表格中，按一下要檢查的表格名稱。

  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 資料表的名稱。

後續步驟