Unternehmensglossare in eine Google-Tabelle exportieren

Mit dem Dienstprogramm zum Exportieren von Unternehmensglossaren können Sie Glossare, Kategorien und Begriffe aus Knowledge Catalog (früher Dataplex Universal Catalog) in eine Google-Tabelle extrahieren. Anschließend können Sie Ihre Metadaten in großen Mengen verwalten und Berichte erstellen.

Hinweis

Bevor Sie Glossare exportieren, müssen die folgenden Voraussetzungen erfüllt sein.

Dienstkonto einrichten

Damit Sie das Dienstprogramm zum Exportieren ausführen können, müssen Sie ein Dienstkonto mit den erforderlichen Berechtigungen einrichten, um auf die Google Sheets API zuzugreifen und Ihre Nutzeranmeldedaten zu übernehmen:

  1. Dienstkonto identifizieren oder erstellen

    Wählen Sie ein vorhandenes Dienstkonto aus oder erstellen Sie ein neues in dem Projekt, in dem Sie das Dienstprogramm zum Importieren ausführen. Weitere Informationen finden Sie unter Dienstkonten erstellen. Notieren Sie sich die E-Mail-Adresse des Dienstkontos (z. B. SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com).

  2. Identitätsübernahme des Dienstkontos konfigurieren

    Damit Sie das Skript des Dienstprogramms zum Exportieren lokal ausführen können, muss Ihr Nutzerkonto die Berechtigung haben, die Identität des Dienstkontos zu übernehmen. Weisen Sie Ihrem Nutzerkonto für das Dienstkonto die Rolle Ersteller von Dienstkonto-Tokens (roles/iam.serviceAccountTokenCreator) zu.

    Weitere Informationen finden Sie unter Zugriff auf Dienstkonten verwalten.

  3. Gewähren Sie dem Dienstkonto Editor-Zugriff auf das Google-Sheet.

    Öffnen Sie das Google-Sheet, das Sie für den Importvorgang verwenden möchten, klicken Sie auf Freigeben, und fügen Sie die E-Mail-Adresse des Dienstkontos als Editor hinzu. Mit dieser Berechtigung kann das Dienstkonto Daten aus Ihrem Sheet lesen oder Daten in Ihr Sheet schreiben.

Erforderliche Rollen

Damit das Dienstkonto die erforderlichen Berechtigungen zum Exportieren von Glossaren in ein Google-Sheet hat, bitten Sie Ihren Administrator, dem Dienstkonto die folgenden IAM-Rollen zuzuweisen:

Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Ihr Administrator kann dem Dienstkonto möglicherweise auch die erforderlichen Berechtigungen über benutzerdefinierte Rollen oder andere vordefinierte Rollen erteilen.

APIs aktivieren

Aktivieren Sie die folgenden APIs in Ihrem Projekt, um Glossare zu exportieren:

Rollen, die zum Aktivieren von APIs erforderlich sind

Zum Aktivieren von APIs benötigen Sie die Berechtigung serviceusage.services.enable. Wenn Sie das Projekt erstellt haben, haben Sie diese Berechtigung wahrscheinlich bereits über die Rolle „Inhaber“ (roles/owner). Andernfalls können Sie diese Berechtigung über die Rolle „Service Usage-Administrator“ (roles/serviceusage.serviceUsageAdmin) erhalten. Informationen zum Zuweisen von Rollen.

APIs aktivieren

Git-Repository einrichten

Klonen Sie das Repository dataplex-labs:

git clone https://github.com/GoogleCloudPlatform/dataplex-labs.git
cd dataplex-labs/dataplex-quickstart-labs/00-resources/scripts/python/business-glossary-import/dataplex-glossary/export

Abhängigkeiten installieren

Installieren Sie die erforderlichen Python-Abhängigkeiten:

pip3 install -r requirements.txt

Wenn Probleme bei der Paketinstallation auftreten, richten Sie eine neue Python-Entwicklungsumgebung ein.

Authentifizieren und Identitätsübernahme des Dienstkontos konfigurieren

Initialisieren Sie die Google Cloud CLI und authentifizieren Sie sich mit Standardanmeldedaten für Anwendungen (Application Default Credentials, ADC) mit Identitätsübernahme des Dienstkontos:

# Set your service account email address
SA_EMAIL="SERVICE_ACCOUNT_EMAIL"

# Authenticate ADC using service account impersonation and required scopes
gcloud auth application-default login \
  --impersonate-service-account="${SA_EMAIL}" \
  --scopes="https://www.googleapis.com/auth/spreadsheets"

Ersetzen Sie SERVICE_ACCOUNT_EMAIL durch die E-Mail-Adresse des Dienstkontos. Beispiel:

SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com

Google-Zielsheet für den Export einrichten

Erstellen Sie ein leeres Google-Sheet oder verwenden Sie ein vorhandenes. Das Exportskript schreibt in das erste Sheet. Achten Sie darauf, dass Sie dem Dienstkonto Editor-Zugriff auf das Google-Sheet gewährt haben.

Glossar in das Google-Sheet exportieren

Führen Sie das Skript glossary-export.py aus. Während der Ausführung werden Sie vom Dienstprogramm nach dem Google-Zielsheet und dem Namen des Glossars gefragt, das Sie exportieren möchten:

python3 glossary-export.py

Sie können die Ausführungsprotokolle im Verzeichnis logs/ in Ihrem lokalen Ausführungspfad aufrufen. Diese Protokolle helfen Ihnen, den Übertragungsvorgang zu prüfen und übersprungene Einträge oder Formatierungswarnungen zu erkennen.

Exportierte Glossardaten prüfen

Das Exportskript ruft Metadaten aus Ihrem Knowledge Catalog-Geschäftsglossar ab und füllt das Google-Sheet mit einem strukturierten Schema, einschließlich Beschreibungen, Datenverantwortlichen und Labels. Prüfen Sie die exportierten Daten in den folgenden Spalten:

Feld Beschreibung
id Eine eindeutige Kennung für den Begriff oder die Kategorie im Glossar.
parent Die ID der übergeordneten Kategorie.
display_name Der Anzeigename des Begriffs oder der Kategorie.
description Eine kurze Beschreibung des Begriffs oder der Kategorie.
overview Eine Rich-Text-Beschreibung des Begriffs oder der Kategorie (unterstützt HTML-Tags).
type Der Zeilentyp: TERM oder CATEGORY.
contact1_email E-Mail-Adresse des primären Datenverantwortlichen für den Begriff oder die Kategorie.
contact1_name Name des primären Datenverantwortlichen für den Begriff oder die Kategorie.
contact2_email E-Mail-Adresse des sekundären Datenverantwortlichen für den Begriff oder die Kategorie.
contact2_name Name des sekundären Datenverantwortlichen für den Begriff oder die Kategorie.
label1_key Schlüssel für das erste zugewiesene Label.
label1_value Wert für das erste zugewiesene Label.
label2_key Schlüssel für das zweite zugewiesene Label.
label2_value Wert für das zweite zugewiesene Label.

Nächste Schritte