Glossare und Eintragslinks importieren und exportieren

In diesem Dokument wird beschrieben, wie Sie Unternehmensglossare und Eintragslinks in Knowledge Catalog (ehemals Dataplex Universal Catalog) importieren und exportieren.

Mit dem Unternehmensglossar von Knowledge Catalog können Sie ein gemeinsames Geschäftsvokabular definieren und diese Begriffe mit physischen Daten-Assets verknüpfen. Wenn Ihr Katalog wächst, kann es schwierig werden, diese Begriffe und ihre Beziehungen einzeln in der Google Cloud Konsole zu verwalten.

Um Ihr Unternehmensglossar im großen Maßstab zu verwalten, können Sie Glossare (Kategorien und Begriffe) und Eintragslinks (die Verknüpfungen zwischen Begriffen und Daten-Assets) im Bulk importieren und exportieren.

Terminologie

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 Geschäftsvokabular festlegen.

  • Eintragslinks:Die Beziehungen oder Verknüpfungen zwischen Ressourcen. 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 Geschäftsbedingungen 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 den 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 zeigt, wie Sie diesen Prozess ausführen:

  1. Exportieren Sie vorhandene Metadaten aus Knowledge Catalog nach Google Sheets.

    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. Ändern Sie die Metadaten in Google Sheets.

    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 dem entsprechenden Tabellenblatt 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. Bereiten Sie die Änderungen aus Google Sheets vor und importieren Sie sie wieder in Knowledge Catalog.

    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