通过更改 Apache Iceberg 视图,您可以演进视图的架构和 SQL 定义,或设置和取消设置自定义视图属性,而无需更改视图在 Lakehouse 运行时目录中的身份。
不支持重命名视图。如需重命名视图,请创建一个具有新名称的视图,然后删除原始视图。视图的存储位置在创建后也是不可变的,如果更新设置了其他位置,则会失败并显示 400 Bad Request 错误。
准备工作
-
启用 BigLake API(如果尚未启用)。
启用 API 所需的角色
如需启用 API,您需要拥有
serviceusage.services.enable权限。如果您创建了项目,则可能已经通过 Owner 角色 (roles/owner) 拥有此权限。否则,您可以通过 Service Usage Admin 角色 (roles/serviceusage.serviceUsageAdmin) 获得此权限。了解如何授予角色。 - 使用 Apache Iceberg REST 目录端点设置 Lakehouse 运行时目录。
- 查看 Iceberg 视图的限制。
- 创建视图。
所需的角色
如需获得更改视图所需的权限,请让管理员向您授予项目和存储桶的以下 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 更新。如需了解端点路径,请参阅替换视图定义。