Fehlerbehebung beim Import und Export von Glossaren

In diesem Dokument wird beschrieben, wie Sie häufige Probleme und Fehler beheben, die beim Importieren und Exportieren von Glossaren und Eintragslinks in Knowledge Catalog (ehemals Dataplex Universal Catalog) auftreten können.

Wenn Sie Hilfe bei der Behebung eines Problems benötigen, das auf dieser Seite nicht behandelt wird, wenden Sie sich an den Google Cloud-Support.

Fehlende Eintragslinks in der exportierten Google-Tabelle

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 (geschützte Ressourcen): Sie haben nicht die erforderlichen IAM-Berechtigungen, um den Quelleneintrag oder den Zieleintrag aufzurufen, der mit dem Link verknüpft ist.

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

  • Unvollständige Eintragsreferenzen: In den Metadaten des Eintrags fehlen erforderliche Schemafelder, sodass die Validierungsprüfung die Ressource überspringt.

So beheben Sie dieses Problem:

  • Berechtigungen prüfen: Bestätigen Sie, dass dem Hauptkonto, das das Skript ausführt, die erforderlichen Rollenzugewiesen wurden.

  • Ausführungsprotokolle prüfen: Suchen Sie im Terminal oder in den Skriptprotokollen nach Warnungen mit Skipping redacted entrylink. In den Protokollen werden die spezifischen Ressourcen-IDs der übersprungenen Eintragslinks und der Grund für das Überspringen ausgegeben.

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

Fehler „No terms found in the glossary“ (Keine Begriffe im Glossar gefunden)

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

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

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

So beheben Sie dieses Problem: Prüfen Sie Ihre Konfiguration und Berechtigungen:

  • Glossar-ID prüfen: Rufen Sie in der Google Cloud Console die Seite Knowledge Catalog Glossare auf, wählen Sie Ihr Glossar aus und prüfen Sie, ob die Ressourcen-ID mit der ID übereinstimmt, die Sie an das Dienstprogramm skript ü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 Skript übergeben, prüfen Sie, ob es dem korrekten Knowledge Catalog-Ressourcenformat entspricht:

    projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID

Warnung „Entries not found in Knowledge Catalog“ (Einträge nicht in Knowledge Catalog gefunden)

Während eines Imports von Eintragslinks wird das Skript angehalten 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 Ihre Google-Tabelle Eintragslinks enthält, die auf Daten-Assets oder Glossarbegriffe verweisen, die in Knowledge Catalog nicht vorhanden sind.

So beheben Sie dieses Problem:

  • Wenn Sie mit einem teilweisen Import fortfahren möchten, geben Sie an der Eingabeaufforderung 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 Knowledge Catalog übereinstimmen. Korrigieren Sie alle fehlenden Ressourcen oder Tippfehler und führen Sie das Importskript noch einmal aus.

Importjob schlägt fehl oder wird mittendrin unterbrochen

Wenn ein Importjob unterbrochen wird oder mittendrin fehlschlägt, müssen Sie den gesamten Vorgang nicht neu starten oder Ihre Google-Quelltabelle ä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 Ihrer 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.

Skript-Time-outs oder SSL-Fehler während der Ausführung

Während der Ausführung des Dienstprogrammskripts für den Import oder Export wird die Ausführung angehalten, es kommt zu einem Time-out 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 Sicherheits-Proxy 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.

So beheben Sie diese Netzwerkprobleme:

  • Achten Sie auf eine stabile Netzwerkverbindung.

  • Proxy- und Firewalleinstellungen prüfen

  • VPN-Konfiguration prüfen

  • Integrierte Wiederholungsversuche verwenden: Das Dienstprogrammskript enthält eine integrierte Wiederholungslogik für vorübergehende Netzwerkfehler. Wenn die Netzwerkunterbrechung nur kurz ist, warten Sie, bis das Skript die Wiederholungsversuche abgeschlossen hat, bevor Sie die Ausführung neu starten.

Fehler „Invalid spreadsheet URL“ (Ungültige Tabellen-URL)

Wenn Sie versuchen, ein Import- oder Exportdienstprogramm auszuführen, gibt die Befehlszeilenschnittstelle den Fehler Invalid spreadsheet URL zurück und hält die Ausführung an.

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

  • Ungültige 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 hat keine Berechtigung, die Tabelle aufzurufen oder zu bearbeiten, sodass das Dienstprogramm den Link nicht validieren kann.

So beheben Sie dieses Problem: Prüfen Sie den Tabellenlink und die Zugriffseinstellungen:

  • URL-Präfix validieren: Prüfen Sie, ob die Tabellen-URL, die Sie an das Dienstprogramm übergeben, mit dem folgenden Standardpfad von Google Sheets beginnt: https://docs.google.com/spreadsheets/

  • Tabellen-ID prüfen: Prüfen Sie, ob die URL die eindeutige ID Ihrer Tabelle enthält. Eine gültige URL sollte dieser Struktur folgen: https://docs.google.com/spreadsheets/d/SPREADSHEET_ID/edit

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

Fehler „Invalid glossary URL“ (Ungültige Glossar-URL)

Wenn Sie versuchen, ein Import- oder Exportdienstprogramm für Glossare auszuführen, gibt die Befehlszeilenschnittstelle den Fehler Invalid glossary URL zurück und hält die Ausführung an.

Dieses Problem tritt auf, wenn das Skript den angegebenen Ressourcenpfad des Knowledge Catalog-Glossars nicht parsen kann oder keine Berechtigung zum Aufrufen der Ressource hat. Das kann folgende Gründe haben:

  • Ungültiger Ressourcenpfad: Der Ressourcenpfad entspricht nicht dem Standardpfadformat für Knowledge Catalog-Glossare.
  • Falsche ID: Der Pfad enthält eine falsche Projekt-ID, einen falschen Standort oder eine falsche Glossar-ID.
  • Zugriffsbeschränkungen oder fehlende Ressource: Das Glossar ist nicht vorhanden oder Ihrem authentifizierten Dienstkonto fehlen die erforderlichen IAM-Berechtigungen, um darauf zuzugreifen.

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

  • Struktur des Ressourcenpfads validieren: Prüfen Sie, ob der Glossarpfad, den Sie an das Dienstprogramm übergeben dem folgenden Standardformat von Knowledge Catalog entspricht: projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID

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

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

Ausführungsprotokolle ansehen

Die Import- und Exportdienstprogramme generieren während der Ausführung detaillierte Ausführungsprotokolle. Anhand dieser Protokolle können Sie den Übertragungsvorgang prüfen und übersprungene Einträge oder Formatierungswarnungen erkennen.

  • Protokollspeicherort: Die Import- und Exportdienstprogramme schreiben Protokolldateien in das Verzeichnis logs/ in Ihrem lokalen Ausführungspfad.
  • Protokollformat: An jede Protokolldatei wird ein Zeitstempel angehängt, damit Sie Protokolle für eine bestimmte Ausführung finden können.