排查常见的 Lakehouse for Apache Iceberg 问题

本页面介绍了如何解决 Lakehouse for Apache Iceberg 及其关联资源的常见问题。

无法查询元数据表

当您使用五部分名称标识符查询 BigQuery 中由 Lakehouse 运行时目录支持的 Apache Iceberg 表的元数据表（例如 .snapshots 或 .files）时，会出现此问题。

如需解决此问题，请使用 Apache Spark 查询这些表。

metadata.json 文件大小限制

Apache Iceberg metadata.json 文件大小限制为 1 MB。此限制适用于跟踪表快照、架构和分区规范的元数据文件。如果您的元数据文件超出此大小，则通过 Apache Iceberg REST 目录端点执行表操作时可能会遇到错误。

如需解决此问题，请与您的 Google 客户支持团队联系，申请提高限制。

查询多区域目录时出现 NOT_FOUND 错误

如果您在 Lakehouse 运行时目录中使用多区域 Cloud Storage 存储桶创建目录，但未指定主要位置，然后尝试通过指定 BigQuery 虚拟区域（例如 US 或 EU）来查询目录，则会出现此问题。

使用多区域存储桶创建目录时，其元数据存储在多区域地理范围内的特定区域位置，而不是相应的 BigQuery 虚拟区域中。如果您强制在元数据不存在的虚拟区域中运行查询，则查询会失败并显示 NOT_FOUND 错误。

如需解决此问题，请在创建目录时指定主要位置（例如 US 或 EU）。如需了解详情，请参阅为美国和欧盟多区域指定主要区域。

注意 ：如果您已使用多区域存储桶创建目录，并且想要 将其与 BigQuery 多区域（US 或 EU）搭配使用， 则 必须删除并重新创建目录以指定主要位置。