排查元数据更改 Feed 问题

Knowledge Catalog(以前称为 Dataplex Universal Catalog)元数据更改 Feed 可让您通过向 Pub/Sub 发布通知,近乎实时地跟踪元数据条目和切面的更改。在配置或监控这些 Feed 时,您可以诊断并解决与 Feed 创建权限、VPC Service Controls 边界、通知传送和消息载荷相关的常见问题。如需了解详情,请参阅元数据变更 Feed 简介。

如果您在解决本文档中未提及的问题时需要帮助,请参阅 Cloud Customer Care。

元数据更改 Feed 创建错误

本部分介绍了如何解决在创建元数据变更 Feed 时可能遇到的错误。

权限遭拒错误

您在尝试创建元数据变更 Feed 时收到 PERMISSION_DENIED 错误。

出现此问题的原因是,您或 Knowledge Catalog 服务账号可能缺少所需权限。

如需解决此问题,请查看以下要求:

  • 确保您拥有 dataplex.metadataFeeds.create 权限。

  • 确保您对 Feed 的范围(组织、项目或条目组)拥有 dataplex.entryGroups.export 权限。

  • 确保 Knowledge Catalog 服务账号 (service-{PROJECT_NUMBER}@gcp-sa-dataplex.iam.gserviceaccount.com) 在目标 Pub/Sub 主题上具有 roles/pubsub.publisher 角色。

VPC Service Controls 错误

创建 Feed 时,您收到 PERMISSION_DENIED 或 VPC Service Controls 错误。

如需解决此问题,请检查元数据变更 Feed 及其监控的资源是否属于同一 VPC Service Controls 边界:

  • 如果 Feed 的范围是组织,则系统只会监控同一边界内的项目。

  • 如果 Feed 的范围是项目或条目组,请确保所有指定的项目或条目组都与您在其中创建 Feed 的项目位于同一边界内。

通知传送问题

本部分介绍了如何解决通知传送问题。

未收到通知

您未在 Pub/Sub 主题中收到通知。这可能是由以下几个因素导致的:

  • 缺少权限:Knowledge Catalog 服务账号失去了对主题的 roles/pubsub.publisher 角色。

  • 激活延迟:新创建或更新的 Feed 最多可能需要 10 分钟才能生效。

  • 主题已删除:如果目标 Pub/Sub 主题被删除,Knowledge Catalog 将停止发布。

  • 范围或过滤条件不匹配:更改可能与配置的范围或过滤条件不匹配。

如需解决此问题,请检查以下各项:

  • 验证 Knowledge Catalog 服务账号是否具有该主题的 roles/pubsub.publisher 角色。

  • 创建或更新 Feed 后,请至少等待 10 分钟。

  • 检查 Pub/Sub 主题是否存在。如果已删除,则必须重新创建。

  • 请检查您的 Feed 配置,确保范围和过滤条件与您希望接收的元数据更改相匹配。

重复通知

您会收到重复的通知消息。Knowledge Catalog 确保“至少一次”传送,这意味着可能会出现重复消息,尤其是在重试期间。

将订阅者应用配置为处理潜在的重复消息。您可以使用 messageId 或更改时间戳来识别和删除重复消息。

内容问题

本部分介绍了如何解决元数据变更 Feed 通知内容的问题。

载荷中缺少完整元数据

通知消息仅包含资源名称和更改类型,不包含完整元数据或具体更改。

这是因为按照设计,元数据变更 Feed 通知提供的是“变更签名”(变更的内容),而不是完整的载荷。这样可以使消息保持轻量级,并避免载荷大小限制。

使用通知中提供的资源名称调用 Dataplex API(例如 GetEntry),并检索资源的当前状态。