Seit dem 10. April 2026 heißt Dataplex Universal Catalog jetzt Knowledge Catalog. Die Namen der API, der Clientbibliothek, der CLI und von IAM bleiben unverändert. Weitere Informationen finden Sie unter Google Cloud Knowledge Catalog.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Fehler beim Import von Unternehmensglossaren und Eintragslinks beheben

In diesem Leitfaden erfahren Sie, wie Sie Probleme mit dem Knowledge Catalog beheben können, wenn Sie Glossare und Eintragslinks importieren und exportieren. Dazu gehören fehlende Eintragslinks, Fehler bei ungültigen Glossar-URLs oder wenn ein Importjob fehlschlägt.

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 Knowledge Catalog korrigieren

Nachdem Sie Eintragslinks aus dem Knowledge Catalog in eine Google-Tabelle exportiert haben, indem Sie das Tool 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 automatisch Eintragslinks unter den folgenden Bedingungen überspringt:

Unzureichende Berechtigungen (entfernte Ressourcen): Sie haben nicht die erforderlichen IAM-Berechtigungen, um den mit dem Link verknüpften Quell- oder Zieleintrag aufzurufen.
Ungültiger Linktyp für Eintrag: Für den Link für den Eintrag wird ein nicht unterstützter oder nicht erkannter Beziehungstyp verwendet. Gültige Typen sind definition, related und synonym.
Unvollständige Eintragsreferenzen: In den Metadaten des Eintrags fehlen erforderliche Schematafelder, sodass die Ressource bei der Validierungsprüfung übersprungen wird.

So beheben Sie das Problem:

Berechtigungen prüfen: Sie benötigen die Berechtigung zum Aufrufen fehlender Eintragslinks. Prüfen Sie, ob dem Hauptkonto, das das Skript ausführt, die erforderlichen Rollen zugewiesen wurden.
Ausführungslogs prüfen: Sehen Sie im Terminal oder in den Skriptlogs nach Warnungen mit Skipping redacted entrylink. In den Logs werden die spezifischen Ressourcen-IDs der übersprungenen Eintragslinks und der Grund für das Überspringen ausgegeben.
Linkschema auf Gültigkeit prüfen: Wenn Sie diese Links zuvor programmatisch geändert haben, prüfen Sie, ob ihre Eigenschaften 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 Skript das angegebene Glossar nicht finden kann oder nicht die erforderlichen Zugriffsberechtigungen zum Abrufen der Inhalte hat. Das kann folgende Gründe haben:

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

So beheben Sie das Problem: Überprüfen Sie Ihre Konfiguration und Berechtigungen:

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 Utility-Script übergeben.
IAM-Berechtigungen prüfen: Prüfen Sie, ob Ihren authentifizierten Anmeldedaten (dem Dienstkonto oder Ihrem imitierten Nutzerkonto) die erforderlichen Rollen zugewiesen wurden.
Glossar-URL-Struktur prüfen: Wenn Sie einen direkten Ressourcenpfad oder eine URL an das Script übergeben, muss das Format der Knowledge Catalog-Ressource korrekt sein:

projects/PROJECT_ID/locations/LOCATION/glossaries/GLOSSARY_ID

Warnung: Einträge nicht in Knowledge Catalog gefunden

Während eines Eintragslink-Imports 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 im Knowledge Catalog nicht vorhanden sind.

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

Wenn Sie einen teilweisen Import durchführen möchten, geben Sie bei der Aufforderung y ein. Das Tool 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 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 den gesamten Vorgang nicht neu starten oder Ihr Google-Quelltabellenblatt ändern.

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

So setzen Sie den Job fort:

Führen Sie das Importprogramm noch einmal aus. Das Tool erkennt den Status Ihres vorherigen Laufs und zeigt den folgenden Prompt an:
```
Found X existing file(s) in archive folder from a previous incomplete import
Continue using existing files? [y/N]:
```
Geben Sie y ein. Das Tool überspringt die Batches, die bereits erfolgreich importiert wurden, und verarbeitet nur die verbleibenden Dateien.

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

Beim Ausführen des Import- oder Export-Utility-Skripts wird die Ausführung angehalten, es kommt zu einem Zeitüberschreitungsfehler oder in Ihrem Terminal werden SSL-Fehler 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 untersucht ihn. Dadurch werden die SSL-Zertifikate ungültig.
Aktive VPN-Einschränkungen: Ihre VPN-Konfiguration schränkt den ausgehenden Traffic auf bestimmte Google Cloud APIs oder Google Tabellen-Endpunkte ein.
Instabilität des lokalen Netzwerks: Die Sitzung wurde durch einen vorübergehenden Ausfall der Internetverbindung unterbrochen.

Versuchen Sie Folgendes, um diese Netzwerkprobleme zu beheben:

Achten Sie darauf, dass Sie eine stabile Netzwerkverbindung haben.
Proxy- und Firewalleinstellungen prüfen
Prüfen Sie Ihre VPN-Konfiguration.
Integrierte Wiederholungsversuche nutzen: Das Utility-Skript enthält eine integrierte Wiederholungslogik für vorübergehende Netzwerkfehler. Wenn der Netzwerkausfall nur kurzzeitig ist, warten Sie, bis das Skript die Wiederholungsversuche abgeschlossen hat, bevor Sie die Ausführung neu starten.

Fehler durch ungültige Tabellen-URL

Wenn Sie versuchen, ein Import- oder Exportprogramm auszuführen, gibt die Befehlszeilenschnittstelle einen Invalid spreadsheet URL-Fehler zurück und beendet die Ausführung.

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

Falsch formatierte URL: Die URL entspricht nicht dem Standardpfadformat von Google Tabellen.
Fehlende Tabellen-ID: Im Pfad fehlt die eindeutige alphanumerische ID, die auf Ihr spezifisches Tabellenblatt verweist.
Zugriffsbeschränkungen: Ihr authentifiziertes Dienstkonto hat keine Berechtigung zum Aufrufen oder Bearbeiten des Tabellenblatts. Daher kann das Tool den Link nicht validieren.

So beheben Sie das Problem: Überprüfen Sie den Link zu Ihrer Tabelle und die Zugriffseinstellungen.

URL-Präfix validieren: Die Tabellen-URL, die Sie an das Tool übergeben, muss mit dem folgenden Standardpfad für Google Tabellen beginnen: https://docs.google.com/spreadsheets/
Tabellen-ID prüfen: Achten Sie darauf, dass die URL die eindeutige ID Ihrer Tabelle enthält. Eine gültige URL sollte dieser Struktur entsprechen: https://docs.google.com/spreadsheets/d/SPREADSHEET_ID/edit
Zugriffsberechtigungen prüfen: Öffnen Sie das Google-Tabellenblatt 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 Befehlszeilenschnittstelle einen Invalid glossary URL-Fehler zurück und beendet die Ausführung. Prüfen Sie, ob in Ihren Parametern eine ungültige Glossar-URL enthalten ist.

Dieses Problem tritt auf, wenn das Skript den angegebenen Glossarressourcenpfad für Knowledge Catalog nicht parsen kann oder nicht berechtigt ist, die Ressource aufzurufen. Das kann folgende Gründe haben:

Falsch formatierter Ressourcenpfad: Der Ressourcenpfad entspricht nicht dem Standardformat für Glossarpfade im Knowledge Catalog.
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 Ihrem authentifizierten Dienstkonto fehlen die IAM-Berechtigungen, die für den Zugriff darauf erforderlich sind.