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),并检索资源的当前状态。