排查 Apache Iceberg 视图问题

在 Lakehouse 运行时目录中创建、查询、更改或删除 Apache Iceberg 视图时,您可能会遇到一些错误,例如与表名称冲突、访问遭拒、对视图进行时间旅行、快照过期、目录类型不受支持或视图位置不可变。本文档可帮助您找出这些常见错误的原因并加以解决。如需了解一般目录问题,请参阅问题排查。

409 Conflict 或 AlreadyExistsException,用于在创建或替换视图或表时附加标记

表和视图在目录命名空间内共享相同的标识符命名空间,并且目录会阻止跨类型覆盖。您无法创建与现有表同名的视图,也无法创建与现有视图同名的表。

如需查找名称冲突,请列出命名空间中的表和视图:

SHOW TABLES IN NAMESPACE_NAME;
SHOW VIEWS IN NAMESPACE_NAME;

请选择其他名称,或先删除冲突的对象。

对视图执行 403 Forbidden 或 AccessDeniedException 操作

由于 Compute Engine 会在客户端评估视图,因此查询视图需要对视图以及视图引用的每个表拥有权限。请验证以下内容:

  • 对于视图 DDL,调用方具有 BigLake Editor (roles/biglake.editor) 或 BigLake Admin (roles/biglake.admin) 角色。
  • 对于 SELECT 查询,调用方具有 BigLake Viewer (roles/biglake.viewer),该角色会授予对视图的 biglake.views.get 权限以及对所引用表的 biglake.tables.get 和 biglake.tables.getData 权限。
  • 在最终用户凭据模式下,调用方对 Cloud Storage 存储桶具有 Storage Object User (roles/storage.objectUser) 角色(用于视图 DDL)或 Storage Object Viewer (roles/storage.objectViewer) 角色(用于只读查询)。
  • 在凭证发放模式下,目录的服务账号对 Cloud Storage 存储桶具有 Storage Object User (roles/storage.objectUser) 角色,并且 Spark 配置了 spark.sql.catalog.CATALOG_NAME.header.X-Iceberg-Access-Delegation=vended-credentials。

如需了解详情,请参阅所需的角色和权限。

UNSUPPORTED_FEATURE.TIME_TRAVEL_ON_VIEW

当查询直接对视图标识符应用 TIMESTAMP AS OF 或 VERSION AS OF 时,Spark 会返回 AnalysisException: [UNSUPPORTED_FEATURE.TIME_TRAVEL_ON_VIEW] Cannot time travel on view。

从查询中移除时间旅行子句。如果您需要历史数据,请定义一个视图,其 SQL 定义将 TIMESTAMP AS OF 应用于底层表,或使用直接查询底层表的 CTE。如需了解详情,请参阅在底层表上创建具有时间旅行功能的视图。

ValidationException: Cannot find snapshot older than timestamp

使用时间旅行子句定义的视图引用了已过期或已从底层表中移除的快照。

使用较新的时间戳或快照 ID 将视图替换为 CREATE OR REPLACE VIEW,或调整底层 Iceberg 表的快照保留设置。

409 Conflict: Namespace is not empty(删除命名空间时)

您无法删除仍包含视图的命名空间。列出并删除所有剩余视图,然后删除命名空间:

SHOW VIEWS IN NAMESPACE_NAME;
DROP VIEW IF EXISTS NAMESPACE_NAME.VIEW_NAME;

400 Bad Request(对视图执行 FAILED_PRECONDITION 操作)

Iceberg 视图仅在多存储桶目录和单存储桶目录中受支持。目录会拒绝针对 BigQuery 目录或联合目录的视图操作。在受支持的目录类型中创建视图。

400 Bad Request: View location is immutable

创建视图后,您无法更改视图的存储位置。从请求中移除位置信息更新。

在 Trino 481 及更早版本中,CREATE OR REPLACE VIEW 会发送位置信息更新,从而触发此错误。升级到 Trino 482 或更高版本,或者运行 DROP VIEW,然后运行 CREATE VIEW 以更新视图定义。如需了解详情,请参阅 Trino 支持。

后续步骤