Fehlerbehebung bei Metadaten-Änderungsfeeds

Mit Metadaten-Änderungsfeeds in Knowledge Catalog (ehemals Dataplex Universal Catalog) können Sie Änderungen an Ihren Metadateneinträgen und ‑aspekten nahezu in Echtzeit verfolgen, indem Sie Benachrichtigungen in Pub/Sub veröffentlichen. Beim Konfigurieren oder Überwachen dieser Feeds können Sie häufige Probleme mit Berechtigungen zur Feederstellung, VPC Service Controls-Perimetern, Benachrichtigungszustellung und Nachrichtennutzlasten diagnostizieren und beheben. Weitere Informationen finden Sie unter Metadaten-Änderungsfeeds.

Wenn Sie Hilfe bei der Behebung eines Problems benötigen, das in diesem Dokument nicht behandelt wird, wenden Sie sich an den Cloud Customer Care.

Fehler beim Erstellen von Feeds für Metadatenänderungen

In diesem Abschnitt wird beschrieben, wie Sie Fehler beheben, die beim Erstellen von Änderungsfeeds für Metadaten auftreten können.

Fehler „Berechtigung verweigert“

Sie erhalten den Fehler PERMISSION_DENIED, wenn Sie versuchen, einen Änderungsfeed für Metadaten zu erstellen.

Das Problem tritt auf, weil Ihnen oder dem Knowledge Catalog-Dienstkonto möglicherweise die erforderlichen Berechtigungen fehlen.

Prüfen Sie die folgenden Anforderungen, um dieses Problem zu beheben:

  • Sie benötigen die Berechtigung dataplex.metadataFeeds.create.

  • Sie benötigen die Berechtigung dataplex.entryGroups.export für den Bereich des Feeds (Organisation, Projekt oder Eintraggruppe).

  • Achten Sie darauf, dass das Knowledge Catalog-Dienstkonto (service-{PROJECT_NUMBER}@gcp-sa-dataplex.iam.gserviceaccount.com) die Rolle roles/pubsub.publisher für das Pub/Sub-Zielthema hat.

VPC Service Controls-Fehler

Sie erhalten beim Erstellen eines Feeds einen PERMISSION_DENIED- oder VPC Service Controls-Fehler.

Prüfen Sie zur Behebung des Problems, ob der Metadaten-Änderungsfeed und die von ihm überwachten Ressourcen zum selben VPC Service Controls-Perimeter gehören:

  • Wenn der Feed auf die Organisation beschränkt ist, werden nur Projekte innerhalb desselben Perimeters überwacht.

  • Wenn der Feed auf ein Projekt oder eine Eintraggruppe beschränkt ist, müssen sich alle angegebenen Projekte oder Eintraggruppen im selben Perimeter wie das Projekt befinden, in dem Sie den Feed erstellen.

Probleme bei der Zustellung von Benachrichtigungen

In diesem Abschnitt wird beschrieben, wie Sie Probleme mit der Zustellung von Benachrichtigungen beheben.

Benachrichtigungen werden nicht empfangen

Sie erhalten keine Benachrichtigungen in Ihrem Pub/Sub-Thema. Das kann verschiedene Ursachen haben:

  • Fehlende Berechtigungen: Das Knowledge Catalog-Dienstkonto hat die Rolle roles/pubsub.publisher für das Thema verloren.

  • Aktivierungsverzögerung: Es kann bis zu 10 Minuten dauern, bis ein neu erstellter oder aktualisierter Feed aktiv wird.

  • Thema gelöscht: Wenn das Pub/Sub-Zielthema gelöscht wird, beendet Knowledge Catalog die Veröffentlichung.

  • Umfangs- oder Filterkonflikt: Die Änderungen stimmen möglicherweise nicht mit dem konfigurierten Umfang oder den konfigurierten Filtern überein.

Prüfen Sie Folgendes, um das Problem zu beheben:

  • Prüfen Sie, ob das Knowledge Catalog-Dienstkonto die Rolle roles/pubsub.publisher für das Thema hat.

  • Warten Sie nach dem Erstellen oder Aktualisieren eines Feeds mindestens 10 Minuten.

  • Prüfen Sie, ob das Pub/Sub-Thema vorhanden ist. Wenn es gelöscht wurde, müssen Sie es neu erstellen.

  • Prüfen Sie die Feedkonfiguration, um sicherzustellen, dass der Umfang und die Filter den erwarteten Metadatenänderungen entsprechen.

Doppelte Benachrichtigungen

Du erhältst doppelte Benachrichtigungen. Knowledge Catalog sorgt für eine „mindestens einmalige“ Zustellung. Das bedeutet, dass doppelte Nachrichten auftreten können, insbesondere bei Wiederholungsversuchen.

Konfigurieren Sie Ihre Abonnentenanwendung so, dass potenzielle Duplikate verarbeitet werden. Sie können die messageId oder den Änderungszeitstempel verwenden, um Nachrichten zu identifizieren und zu deduplizieren.

Probleme mit Inhalten

In diesem Abschnitt wird beschrieben, wie Sie Probleme mit dem Inhalt von Benachrichtigungen zu Metadatenänderungsfeeds beheben.

Vollständige Metadaten in Nutzlast fehlen

Die Benachrichtigung enthält nur den Ressourcennamen und den Änderungstyp, aber nicht die vollständigen Metadaten oder die spezifischen Änderungen.

Das liegt daran, dass Benachrichtigungen über Metadatenänderungsfeeds standardmäßig „Änderungssignaturen“ (was sich geändert hat) und nicht die vollständige Nutzlast bereitstellen. So bleiben die Nachrichten klein und die Größenbeschränkungen für Nutzlasten werden vermieden.

Verwenden Sie den in der Benachrichtigung angegebenen Ressourcennamen, um die Dataplex API aufzurufen (z. B. GetEntry) und den aktuellen Status der Ressource abzurufen.