Fehler beim Import von Unternehmensglossaren und Eintragslinks beheben

Mit Knowledge Catalog (früher Dataplex Universal Catalog) können Sie Unternehmensglossare und Eintragslinks im Bulk importieren und exportieren, um Ihr Unternehmensvokabular in großem Umfang zu verwalten. Wenn Sie die Skripts für das Import- oder Exportdienstprogramm ausführen, können Sie häufige Probleme wie fehlende Eintragslinks, leere Glossarexporte, ungültige Glossar- oder Tabellen-URLs, unterbrochene Importjobs und Zeitüberschreitungen im Skriptnetzwerk diagnostizieren und beheben. Weitere Informationen finden Sie unter Glossare und Eintragslinks importieren und exportieren.

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.

Fehlende Eintragslinks in Knowledge Catalog korrigieren

Nachdem Sie Eintragslinks aus Knowledge Catalog in eine Google-Tabelle exportiert haben, indem Sie das Dienstprogramm zum Exportieren von Eintragslinks ausgeführt haben, stellen Sie fest, dass einige Eintragslinks (Verknüpfungen) in der generierten Google-Tabelle fehlen.

Dieses Problem tritt auf, wenn das Exportdienstprogramm Eintragslinks aufgrund der folgenden Bedingungen automatisch überspringt:

  • Unzureichende Berechtigungen (entfernte Ressourcen): Sie haben nicht die erforderlichen IAM-Berechtigungen, um den Quelleintrag oder den Zieleintrag aufzurufen, der mit dem Link verknüpft ist.

  • Ungültiger Eintragstyp: Der Eintragslink verwendet einen nicht unterstützten oder nicht erkannten Beziehungstyp. Gültige Typen sind auf definition, related und synonym beschränkt.

  • Unvollständige Eintragsverweise: In den Eintragsmetadaten fehlen erforderliche Schemafelder, sodass die Ressource bei der Validierungsprüfung übersprungen wird.

So behebst du das Problem:

  • Berechtigungen prüfen: Sie benötigen Berechtigungen zum Aufrufen fehlender Eintragslinks. Bestätigen Sie, dass dem Hauptkonto, das das Skript ausführt, die erforderlichen Rollen zugewiesen wurden.

  • Ausführungslogs prüfen: Suchen Sie in den Terminal- oder Skriptlogs nach Warnungen, die Skipping redacted entrylink enthalten. In den Logs werden die spezifischen Ressourcen-IDs der übersprungenen Eintragslinks und der Grund für das Auslassen ausgegeben.

  • Gültigkeit des Linkschemas prüfen: Wenn Sie diese Links zuvor programmatisch geändert haben, prüfen Sie, ob ihre Attribute den Schemaanforderungen entsprechen.

Fehler: Keine Begriffe im Glossar gefunden

Wenn Sie Glossare in eine Google-Tabelle exportieren, schlägt die Ausführung fehl oder es wird ein leeres Ergebnis mit der Meldung No terms found in the glossary zurückgegeben, obwohl das Unternehmensglossar aktive Begriffe enthält.

Dieses Problem tritt auf, wenn das Script das angegebene Glossar nicht finden kann oder nicht die erforderlichen Zugriffsberechtigungen zum Abrufen des Inhalts hat. Das kann folgende Gründe haben:

  • Falsche Glossar-URL: Die in Ihren Ausführungsparametern konfigurierte Glossar-URL ist falsch oder enthält einen Tippfehler.
  • Unzureichende IAM-Berechtigungen: Das authentifizierte Dienstkonto oder die Nutzeranmeldedaten, mit denen das Script ausgeführt wird, haben keine Berechtigung, Begriffe im Zielglossar aufzurufen oder aufzulisten.
  • Glossar-ID stimmt nicht überein: Die in Ihrem Scriptbefehl angegebene Glossar-ID stimmt nicht mit der tatsächlichen Glossar-Ressourcen-ID im Knowledge Catalog überein.

Prüfen Sie Ihre Konfiguration und Berechtigungen, um dieses Problem zu beheben:

  • Glossar-ID prüfen: Rufen Sie in der Google Cloud Console die Seite Glossare im Knowledge Catalog auf, wählen Sie Ihr Glossar aus und prüfen Sie, ob die Ressourcen-ID mit der ID übereinstimmt, die Sie an das Dienstprogramm-Script übergeben.

  • IAM-Berechtigungen prüfen: Bestätigen Sie, dass Ihren authentifizierten Anmeldedaten (dem Dienstkonto oder Ihrem imitierten Nutzerkonto) die erforderlichen Rollen zugewiesen wurden.

  • Glossar-URL-Struktur validieren: Wenn Sie einen direkten Ressourcenpfad oder eine URL an das Script übergeben, muss das richtige Knowledge Catalog-Ressourcenformat verwendet werden:

    projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID

Warnung: Einträge nicht im Knowledge Catalog gefunden

Während eines Eintragslink-Imports wird das Script pausiert und eine Warnung ähnlich der folgenden angezeigt:

Found X entries not found in Knowledge Catalog. EntryLinks associated with
these entries will be skipped. Continue with import? [y/N]:

Dieses Problem tritt auf, wenn Ihr Google-Tabellendokument Eintragslinks enthält, die auf Daten-Assets oder Glossarbegriffe verweisen, die im Knowledge Catalog nicht vorhanden sind.

Wählen Sie eine der folgenden Optionen aus, um dieses Problem zu beheben:

  • Wenn Sie mit einem Teilimport fortfahren möchten, geben Sie bei der Aufforderung y ein. Das Dienstprogramm importiert alle gültigen Eintragslinks und überspringt nur die Links, die auf die fehlenden Ressourcen verweisen.

  • Wenn Sie den Vorgang abbrechen und die fehlenden Ressourcen korrigieren möchten, geben Sie n ein, um die Ausführung abzubrechen. Prüfen Sie, ob die Eintrags-IDs in Ihrem Quelldokument genau mit den Ressourcennamen in Ihrem Knowledge Catalog übereinstimmen. Korrigieren Sie fehlende Ressourcen oder Tippfehler und führen Sie das Importskript dann noch einmal aus.

Fehlerbehebung bei fehlgeschlagenen Knowledge Catalog-Importjobs

Wenn ein Importjob unterbrochen wird oder während der Ausführung fehlschlägt, müssen Sie nicht den gesamten Prozess neu starten oder die Google-Tabelle in der Quelle ändern.

Das Dienstprogramm verfolgt erfolgreich importierte Batches mithilfe eines Archivordners in Ihrem Cloud Storage-Staging-Bucket.

So setzen Sie den Job fort:

  1. Führen Sie das Importdienstprogramm noch einmal aus. Das Dienstprogramm erkennt den Status der vorherigen Ausführung und zeigt die folgende Eingabeaufforderung an:

    Found X existing file(s) in archive folder from a previous incomplete import
Continue using existing files? [y/N]:

  2. Geben Sie y ein. Das Dienstprogramm überspringt die Batches, die bereits erfolgreich importiert wurden, und verarbeitet nur die verbleibenden Dateien.

Zeitüberschreitungen bei Skripts oder SSL-Fehler während der Ausführung

Während der Ausführung des Import- oder Export-Dienstprogrammskripts wird die Ausführung angehalten, es kommt zu einer Zeitüberschreitung oder es werden SSL-Fehler im Terminal zurückgegeben.

Dieses Problem tritt aufgrund der folgenden Fehler auf Netzwerkebene auf:

  • Abfangen durch Unternehmensproxy oder Firewall: Ein Sicherheitsproxy oder eine Firewall fängt HTTPS-Traffic ab und prüft ihn, wodurch die SSL-Zertifikate ungültig werden.
  • Aktive VPN-Einschränkungen: Ihre VPN-Konfiguration beschränkt den ausgehenden Traffic auf bestimmte Google Cloud APIs oder Google Sheets-Endpunkte.
  • Instabilität des lokalen Netzwerks: Eine vorübergehende Unterbrechung der Internetverbindung hat die Sitzung unterbrochen.

Versuche Folgendes, um diese Netzwerkprobleme zu beheben:

  • Achte darauf, dass du eine stabile Netzwerkverbindung hast.

  • Proxy- und Firewall-Einstellungen prüfen

  • Prüfen Sie Ihre VPN-Konfiguration.

  • Integrierte Wiederholungsversuche: Das Dienstprogramm-Script verfügt über eine integrierte Wiederholungslogik für vorübergehende Netzwerkfehler. Wenn der Netzwerkausfall nur vorübergehend ist, warten Sie, bis das Script seine Wiederholungsversuche abgeschlossen hat, bevor Sie die Ausführung neu starten.

Fehler durch ungültige Tabellen-URL

Wenn Sie versuchen, ein Import- oder Exportdienstprogramm auszuführen, gibt die Befehlszeile einen Invalid spreadsheet URL-Fehler zurück und die Ausführung wird angehalten.

Dieses Problem tritt auf, wenn das Script den Link der angegebenen Google-Tabelle nicht parsen kann oder keine Berechtigung zum Aufrufen der Datei hat. Das kann folgende Gründe haben:

  • Fehlerhafte URL: Die URL entspricht nicht dem Standardpfadformat von Google Sheets.
  • Fehlende Tabellen-ID: Im Pfad fehlt die eindeutige alphanumerische ID, die auf Ihre spezifische Tabelle verweist.
  • Zugriffsbeschränkungen: Ihr authentifiziertes Dienstkonto ist nicht berechtigt, die Tabelle aufzurufen oder zu bearbeiten. Daher kann das Dienstprogramm den Link nicht validieren.

So beheben Sie dieses Problem:

  • URL-Präfix validieren: Die Tabellen-URL, die Sie an das Dienstprogramm übergeben, muss mit dem folgenden Standardpfad für Google Sheets beginnen: https://docs.google.com/spreadsheets/

  • Tabellen-ID prüfen: Bestätigen Sie, dass die URL die eindeutige ID Ihrer Tabelle enthält. Eine gültige URL sollte diese Struktur haben: https://docs.google.com/spreadsheets/d/SPREADSHEET_ID/edit

  • Zugriffsberechtigungen prüfen: Öffnen Sie die Google-Tabelle in einem Browser, klicken Sie auf Freigeben und prüfen Sie, ob Sie die E‑Mail-Adresse Ihres Dienstkontos als Bearbeiter hinzugefügt haben.

Fehler aufgrund ungültiger Glossar-URLs beheben

Wenn Sie versuchen, ein Import- oder Exportdienstprogramm für Glossare auszuführen, gibt die Befehlszeile den Fehler Invalid glossary URL zurück und die Ausführung wird angehalten. Prüfen Sie, ob Ihre Parameter eine ungültige Glossar-URL enthalten.

Dieses Problem tritt auf, wenn das Script den angegebenen Ressourcenpfad des Knowledge Catalog-Glossars nicht parsen kann oder nicht berechtigt ist, die Ressource aufzurufen. Das kann folgende Gründe haben:

  • Fehlerhafter Ressourcenpfad: Der Ressourcenpfad entspricht nicht dem Standardformat für Knowledge Catalog-Glossarpfade.
  • Falsche ID: Der Pfad enthält eine falsche Projekt-ID, einen falschen Regionsstandort oder eine falsche Glossar-ID.
  • Zugriffsbeschränkungen oder fehlende Ressource: Das Glossar ist nicht vorhanden oder Ihr authentifiziertes Dienstkonto hat nicht die erforderlichen IAM-Berechtigungen, um darauf zuzugreifen.

So beheben Sie dieses Problem: Überprüfen Sie den Ressourcenpfad und die Anmeldedaten des Glossars:

  • Ressourcenpfadstruktur validieren: Der Glossarpfad, den Sie an das Dienstprogramm übergeben, muss dem folgenden Knowledge Catalog-Standardformat entsprechen: projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID

  • Prüfen Sie die Kennungen im Pfad: Verwenden Sie die richtige Projekt-ID, den richtigen Standort und die richtige Glossar-ID.

  • Existenz und Zugriff auf die Ressource bestätigen: Prüfen Sie, ob das Glossar mit der angegebenen ID vorhanden ist und ob Ihrem authentifizierten Dienstkonto die erforderlichen IAM-Rollen zugewiesen wurden.

Ausführungslogs ansehen

Die Import- und Export-Dienstprogramme generieren während der Ausführung detaillierte Ausführungslogs. Wenn der Importjob fehlschlägt, prüfen Sie die Logs auf bestimmte Fehler. Mithilfe dieser Logs können Sie den Übertragungsprozess prüfen und übersprungene Einträge oder Formatierungswarnungen identifizieren.

  • Logspeicherort: Die Import- und Exportdienstprogramme schreiben Logdateien in das Verzeichnis logs/ in Ihrem lokalen Ausführungspfad.
  • Logformat: Jede Logdatei wird mit einem Zeitstempel versehen, damit Sie Logs für eine bestimmte Ausführung finden können.