列出表

列出表可让您在 Lakehouse 运行时目录中查看命名空间内的所有已注册表实体。

查询引擎可以使用标准 SQL 命令列出表，而 REST 客户端可以直接通过开源 Iceberg REST 目录 API 规范 (GET /v1/{prefix}/namespaces/{namespace}/tables) 检索表标识符。

准备工作

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

  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. 选择现有目录，或者在没有目录的情况下创建一个目录。

您的表会显示在命名空间详细信息 页面上。

Spark 

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

Trino 

SHOW TABLES;

REST

如需使用 REST API 列出命名空间内的表标识符，请向 ListIcebergTableIdentifiers 端点发出 GET 请求：

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

响应包含在指定命名空间下注册的表标识符的 JSON 数组。

替换以下内容：

  • PROJECT_ID：您的 Google Cloud 项目 ID。
  • CATALOG_ID：Lakehouse 运行时目录的 ID。
  • NAMESPACE_NAME：目录命名空间的名称。

后续步骤