获取表格详细信息

查看表详细信息会公开 Lakehouse 运行时目录中 Apache Iceberg 表的底层架构、表属性和配置元数据。

在凭据销售模式下，查询引擎还会检索短期有效的访问凭据，以便与底层 Cloud Storage 文件安全地交互，而无需直接 IAM 存储权限。

您可以使用 Google Cloud 控制台、Spark 和 Trino 中的 SQL describe 命令 或开源 Iceberg REST Catalog API 规范来检查表详细信息。

准备工作

请参阅表概览，了解 不同类型的表以及使用这些表的影响。

  1. 验证是否已为您的 Google Cloud 项目启用结算功能。

  2. 启用 BigLake API。

    启用 API 所需的角色

    如需启用 API，您需要拥有 Service Usage Admin IAM 角色 (roles/serviceusage.serviceUsageAdmin)，该角色包含 serviceusage.services.enable 权限。了解如何授予角色。

    启用 API

所需的角色

如需获取查看表详细信息所需的权限，请让管理员在您的项目上向您授予以下 IAM 角色：

  • 全部： BigLake Viewer (roles/biglake.viewer) - 您的项目

如需详细了解如何授予角色，请参阅管理对项目、文件夹和组织的访问权限。

您也可以通过自定义 角色或其他预定义 角色来获取所需的权限。

获取表详细信息

检查表架构和属性。

控制台

  1. 在 Google Cloud 控制台中，前往 Lakehouse。

    前往 Lakehouse

  2. 选择现有目录，或者在没有目录的情况下创建一个目录。

  3. 在命名空间详细信息 表中，点击要检查的表的名称。

  4. 在表详细信息 页面上，探索表的架构、分区规范和元数据属性。

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 表的名称。

后续步骤