获取视图详情

您可以使用 Spark 或 Apache Iceberg REST 目录端点,检查在 Lakehouse 运行时目录中注册的 Apache Iceberg 视图的架构、列注释、属性和 SQL 定义。

准备工作

  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) - 您的项目
  • 在最终用户凭证模式下读取视图元数据文件:Storage Object Viewer (roles/storage.objectViewer) - Cloud Storage 存储桶

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

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

所需权限

获取视图详情需要以下权限:

  • 获取视图详细信息:针对视图的 biglake.views.get 权限
  • 在最终用户凭证模式下读取视图元数据文件:针对 Cloud Storage 存储桶的 storage.objects.get

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

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

获取视图详情

检查视图。

Spark

显示视图架构、列注释和视图属性:

DESCRIBE EXTENDED NAMESPACE_NAME.VIEW_NAME;

显示用于定义视图的 SQL 语句:

SHOW CREATE TABLE NAMESPACE_NAME.VIEW_NAME;

仅显示视图属性:

SHOW TBLPROPERTIES NAMESPACE_NAME.VIEW_NAME;

替换以下内容:

  • NAMESPACE_NAME:命名空间的名称。
  • VIEW_NAME:视图的名称。

REST

如需使用 REST API 加载视图的当前元数据,请向 GetIcebergView 端点发出 GET 请求:

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

响应包含视图的 metadata-location 和 metadata。

如需在不加载视图元数据的情况下检查视图是否存在,请向同一路径发出 HEAD 请求。如果视图存在,CheckIcebergViewExists 端点会返回 204 No Content;如果视图不存在,则会返回 404 Not Found。

替换以下内容:

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

后续步骤