列出视图

通过列出视图,您可以查看 Lakehouse 运行时目录的命名空间中注册了哪些 Apache Iceberg 视图。结果仅包含视图标识符;表会被排除,同样,列出表也会排除视图。

准备工作

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

  2. 启用 BigLake API(如果尚未启用)。

    启用 API 所需的角色

    如需启用 API,您需要拥有 serviceusage.services.enable 权限。如果您创建了项目,则可能已经通过 Owner 角色 (roles/owner) 拥有此权限。否则,您可以通过 Service Usage Admin 角色 (roles/serviceusage.serviceUsageAdmin) 获得此权限。了解如何授予角色。

    启用 API

  3. 使用 Apache Iceberg REST 目录端点设置 Lakehouse 运行时目录。
  4. 查看 Iceberg 视图的限制。
  5. 创建视图。

所需的角色

如需获得列出视图所需的权限,请让管理员向您授予项目的以下 IAM 角色:

  • 列表视图:BigLake Viewer (roles/biglake.viewer) - 您的项目

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

这些预定义角色包含列出列表视图所需的权限。如需查看所需的确切权限,请展开所需权限部分:

所需权限

列出视图需要以下权限:

  • 列表视图: biglake.views.list 在命名空间中

您也可以使用自定义角色或其他预定义角色来获取这些权限。

如需查看查看权限的完整列表,请参阅所需的角色和权限。

列表视图

列出命名空间中的视图。

Spark

SHOW VIEWS IN NAMESPACE_NAME;

将 NAMESPACE_NAME 替换为命名空间的名称。

REST

如需使用 REST API 列出视图,请向 ListIcebergViewIdentifiers 端点发出 GET 请求:

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

该端点支持 pageToken 和 pageSize 查询参数。

替换以下内容:

  • PROJECT_ID: Google Cloud项目 ID。
  • CATALOG_ID:您的目录的 ID。
  • NAMESPACE_NAME:目录命名空间的名称。

后续步骤