您可以使用 Spark 或 Apache Iceberg REST 目录端点,检查在 Lakehouse 运行时目录中注册的 Apache Iceberg 视图的架构、列注释、属性和 SQL 定义。
准备工作
-
启用 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) - 您的项目 -
在最终用户凭证模式下读取视图元数据文件: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:视图的名称。