取得資料表詳細資料

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

在憑證販售模式中，查詢引擎也會擷取短期存取憑證，安全地與基礎 Cloud Storage 檔案互動，不需要直接的 IAM 儲存空間權限。

您可以使用 Google Cloud 控制台、Spark 和 Trino 中的 SQL DESCRIBE 指令，或 REST API 檢查資料表詳細資料。

事前準備

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

  2. 啟用 BigLake API。

    啟用 API 時所需的角色

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

    啟用 API

  3. 使用 Apache Iceberg REST 目錄端點設定 Lakehouse 執行階段目錄。

必要的角色

如要取得查看表格詳細資料所需的權限，請要求管理員在專案中授予您下列 IAM 角色：

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

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

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

表格功能和支援

在 Lakehouse 執行階段目錄中使用表格時，建議瞭解不同表格類型及其選擇加入功能。如要進一步瞭解如何使用 Apache Iceberg 資料表，請參閱 Apache Iceberg 資料表總覽。

支援的 Iceberg 資料表

系統僅支援 Apache Iceberg V2 (正式發布版) 和 V3 (預先發布版) 資料表。不支援 Iceberg V1 資料表。如要升級現有的 V1 資料表，請參閱「將 Iceberg V1 資料表升級至 V2」。

取得資料表詳細資料

檢查資料表結構定義和屬性。

控制台

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

    前往 Lakehouse

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

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

  4. 在「Table details」(資料表詳細資料) 頁面中，探索資料表的結構定義、分割區規格和中繼資料屬性。

Spark 

spark.sql("DESCRIBE EXTENDED NAMESPACE_NAME.TABLE_NAME").show()

如要啟用讀取/寫入互通性和表格管理 (預覽版)，請將屬性新增至 TBLPROPERTIES 子句：

TBLPROPERTIES (
  'gcp.biglake.bigquery-dml.enabled' = true,
  'gcp.biglake.table-management.enabled' = true
)

Trino 

DESCRIBE SCHEMA_NAME.TABLE_NAME;

如要啟用讀取/寫入互通性和表格管理 (預覽版)，請在 WITH 子句中加入下列屬性：

WITH (
  "gcp.biglake.bigquery-dml.enabled" = 'true',
  "gcp.biglake.table-management.enabled" = 'true'
)

gcloud

如要使用 gcloud 描述資料表，請執行 gcloud biglake iceberg tables describe 指令。

gcloud biglake iceberg tables describe TABLE_NAME \
    --project="PROJECT_ID" \
    --catalog="CATALOG_ID" \
    --namespace="NAMESPACE_NAME"

更改下列內容：

  • TABLE_NAME：Iceberg 資料表名稱。
  • PROJECT_ID：您的 Google Cloud 專案 ID。
  • CATALOG_ID：目錄 ID。
  • NAMESPACE_NAME：目錄命名空間的名稱。

BigQuery

如要透過 BigQuery 查看 Lakehouse 執行階段目錄中 Apache Iceberg 資料表的詳細資料和中繼資料屬性，請在 BigQuery 主控台中檢查資料表詳細資料，或使用 bq show 指令。

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

後續步驟