修改视图

通过更改 Apache Iceberg 视图,您可以演进视图的架构和 SQL 定义,或设置和取消设置自定义视图属性,而无需更改视图在 Lakehouse 运行时目录中的身份。

不支持重命名视图。如需重命名视图,请创建一个具有新名称的视图,然后删除原始视图。视图的存储位置在创建后也是不可变的,如果更新设置了其他位置,则会失败并显示 400 Bad Request 错误。

准备工作

  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 Editor (roles/biglake.editor) - 您的项目
  • 在最终用户凭据模式下写入视图元数据文件:Storage Object User (roles/storage.objectUser) - 针对 Cloud Storage 存储桶

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

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

所需权限

如需更改视图,您需要具备以下权限:

  • 更改视图:
    • 针对视图的 biglake.views.update 权限
    • 针对新视图定义引用的每个 Iceberg 表的 biglake.tables.get 权限
  • 在最终用户凭据模式下写入视图元数据文件:针对 Cloud Storage 存储桶的 storage.objects.create

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

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

替换视图定义

替换现有视图的架构和 SQL 逻辑。替换视图时,目录会写入一个新的版本化 metadata.json 文件(例如 00001-UUID.metadata.json),将新的视图版本和架构附加到视图元数据,并保留视图的 view-uuid。

Spark

CREATE OR REPLACE VIEW my_ns.eng_employees (
  emp_id,
  emp_name,
  dept,
  salary,
  is_senior
)
COMMENT 'Updated Engineering view with seniority flag'
AS SELECT id, name, dept, salary, (salary >= 140000.0) AS is_senior
FROM my_ns.employees
WHERE dept = 'Engineering';

REST

如需使用 REST API 更新视图,请向 UpdateIcebergView 端点发出 POST 请求:

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

请求正文必须包含有效的 Iceberg CommitViewRequest JSON 载荷,其中包含要应用的 requirements 和 updates。目录会验证乐观并发要求,并将更新提交到新的 metadata.json 文件。

替换以下内容:

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

设置和取消设置视图属性

在不更改视图定义的情况下,在视图上设置或移除自定义属性。

Spark

设置属性:

ALTER VIEW my_ns.eng_employees
SET TBLPROPERTIES ('tier' = 'gold', 'reviewed' = 'true');

取消设置属性:

ALTER VIEW my_ns.eng_employees
UNSET TBLPROPERTIES IF EXISTS ('reviewed');

如需详细了解目录如何处理 write.metadata.compression-codec 等属性,请参阅查看属性。

REST

向 UpdateIcebergView 端点发送 CommitViewRequest,并附带 set-properties 或 remove-properties 更新。如需了解端点路径,请参阅替换视图定义。

后续步骤