通过列出视图,您可以查看 Lakehouse 运行时目录的命名空间中注册了哪些 Apache Iceberg 视图。结果仅包含视图标识符;表会被排除,同样,列出表也会排除视图。
准备工作
-
启用 BigLake API(如果尚未启用)。
启用 API 所需的角色
如需启用 API,您需要拥有
serviceusage.services.enable权限。如果您创建了项目,则可能已经通过 Owner 角色 (roles/owner) 拥有此权限。否则,您可以通过 Service Usage Admin 角色 (roles/serviceusage.serviceUsageAdmin) 获得此权限。了解如何授予角色。 - 使用 Apache Iceberg REST 目录端点设置 Lakehouse 运行时目录。
- 查看 Iceberg 视图的限制。
- 创建视图。
所需的角色
如需获得列出视图所需的权限,请让管理员向您授予项目的以下 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:目录命名空间的名称。