Glossare und Eintragslinks importieren und exportieren

Mit Knowledge Catalog (ehemals Dataplex Universal Catalog) können Sie Unternehmensglossare und Eintragslinks im Bulk importieren und exportieren, um Ihr Unternehmensvokabular in großem Umfang zu verwalten. Wenn Ihr Katalog wächst, können Sie mit Bulk-Vorgängen Begriffe und ihre Beziehungen aktualisieren, ohne sie einzeln in der Google Cloud Console verwalten zu müssen.

Terminologie

Mit dem Unternehmensglossar von Knowledge Catalog können Sie ein gemeinsames Unternehmensvokabular definieren und diese Begriffe mit physischen Daten-Assets verknüpfen. Bevor Sie mit den Import- und Exportdienstprogrammen arbeiten, sollten Sie sich mit den folgenden Schlüsselkomponenten vertraut machen:

  • Glossarressourcen:Bestehen aus Kategorien und Begriffen, die Ihr Unternehmensvokabular festlegen.

  • Eintragslinks:Die Beziehungen oder Verknüpfungen zwischen Ressourcen, z. B. zwischen Glossarbegriffen und Daten-Assets. Knowledge Catalog unterstützt drei Arten von Eintragslinks:

    • definition: Verknüpft einen Glossarbegriff mit einem bestimmten Daten-Asset (z. B. einer BigQuery-Spalte)
    • related: Stellt eine Beziehung zwischen zwei verwandten Glossarbegriffen her
    • synonym: Stellt eine Beziehung zwischen zwei synonymen Glossarbegriffen her

Methoden zum Importieren und Exportieren von Glossaren und Eintragslinks

Knowledge Catalog unterstützt zwei primäre Methoden für die Bulk-Glossarverwaltung. Wählen Sie die Methode aus, die am besten zu Ihren Automatisierungsanforderungen und Ihrer bevorzugten Benutzeroberfläche passt:

  • JSON-basierter Metadatenimport
  • Google Sheets-basierte Dienstprogramme für Import und Export

JSON-basierter Metadatenimport

Dies ist der integrierte, vollständig verwaltete Knowledge Catalog-Mechanismus. Mit der Dataplex API können Sie Glossarbegriffe und ihre Verknüpfungen importieren, die in JSON-formatierten Metadatendateien definiert sind.

Beispielanwendungsfall:Aktualisieren Sie Ihre Knowledge Catalog-Metadaten automatisch im Rahmen einer täglich geplanten Datenpipeline, z. B. durch Synchronisieren von Begriffen direkt aus einer externen Unternehmensdatenbank.

Weitere Informationen finden Sie unter Glossare und Eintragslinks mit JSON-Dateien importieren.

Google Sheets-basierte Dienstprogramme für Import und Export

Dies ist ein Open-Source-Ansatz auf Skriptbasis, der im Repository dataplex-labs bereitgestellt wird. Dabei wird ein Python-Skript verwendet, um Glossarmetadaten zwischen einer Google-Tabelle und Knowledge Catalog zu synchronisieren.

Beispielanwendungsfall:Ein Data-Governance-Team möchte gemeinsam mit nicht technischen Stakeholdern aus dem Unternehmen Dutzende neuer Unternehmensbegriffe entwerfen und überprüfen. Das Team verwendet diese tabellenbasierte Methode, damit alle die Begriffe in Google Sheets bearbeiten, kommentieren und genehmigen können, bevor ein Administrator das Skript ausführt, um sie im Bulk in Knowledge Catalog hochzuladen.

Weitere Informationen finden Sie in folgenden Dokumenten:

Gängiger Anwendungsfall: Round-Trip-Bearbeitung mit Google Sheets

Ein gängiger administrativer Workflow ist die Round-Trip-Bearbeitung. Dabei wird die vorhandene Katalogkonfiguration exportiert, Bulk-Änderungen vorgenommen und diese Änderungen wieder auf Knowledge Catalog angewendet.

Der folgende Workflow veranschaulicht, wie Sie diesen Vorgang ausführen:

  1. Vorhandene Metadaten aus Knowledge Catalog nach Google Sheets exportieren

    Verwenden Sie die Dienstprogramme zum Exportieren von Glossaren und Exportieren von Eintragslinks, um die vorhandene Glossarstruktur und die Eintragslinks in eine Google-Tabelle zu extrahieren.

  2. Metadaten in Google Sheets ändern

    Nehmen Sie die erforderlichen Änderungen in der Google-Tabelle vor. Da symmetrische Links (z. B. synonym- und related-Eintragslinks) beim Exportieren in eine Richtung vereinfacht werden, um doppelte Zeilen zu vermeiden, müssen Sie sie nur einmal verwalten.

    Sie können der jeweiligen Tabelle neue Zeilen hinzufügen, indem Sie das erforderliche Spaltenschema verwenden. Sie können Details wie Beschreibungen oder Anzeigenamen auch direkt in den Zeilen ändern.

  3. Änderungen aus Google Sheets vorbereiten und wieder in Knowledge Catalog importieren

    Führen Sie zuerst das Dienstprogramm zum Importieren von Glossaren aus. So wird sichergestellt, dass alle neuen Begriffe oder Kategorien erfolgreich im Unternehmensglossar erstellt werden, bevor Sie versuchen, sie zu verknüpfen.

    Führen Sie das Dienstprogramm zum Importieren von Eintragslinks aus. Dieses Dienstprogramm liest Ihre aktualisierten Verknüpfungen, bereitet sie in Ihrem Cloud Storage-Bucket vor und wendet die Links definition, related und synonym auf Ihr neu aktualisiertes Glossar an.

Nächste Schritte