Glossar für Unternehmen verwalten

Das Geschäftsglossar von Dataplex Universal Catalog bietet einen zentralen Ort für die Verwaltung von geschäftsbezogenen Begriffen und Definitionen in Ihrem Unternehmen.

Wenn verschiedene Teams an einem gemeinsamen Projekt arbeiten oder ein großes Unternehmen viele Abteilungen hat, ist es üblich, dass jeder Teil des Unternehmens seine eigene Terminologie zur Beschreibung der verschiedenen Datenressourcen verwendet, mit denen er arbeitet. Dies kann zu Missverständnissen und einem inkonsistenten Verständnis dieser Ressourcen führen. Außerdem kann es vorkommen, dass für ein Konzept technisches oder spezielles Wissen erforderlich ist. Das kann es für geschäftliche Nutzer in anderen Bereichen schwierig machen, das Konzept zu verstehen.

Mit dem Geschäftsglossar von Dataplex Universal Catalog können Sie ein zentrales, standardisiertes Vokabular für Ihre Datenressourcen erstellen. Mit einem Unternehmensglossar können Sie Folgendes tun:

  • Definieren Sie eine hierarchische Struktur von Geschäftskategorien und ‑konzepten, die als Begriffe bezeichnet werden.
  • Verbindungen zwischen Konzepten herstellen, indem Sie Synonyme und verwandte Begriffe definieren.
  • Sie können Ihre Datenressourcen mit Begriffen im Glossar verknüpfen, um anhand von Geschäftskonzepten nach Datenressourcen zu suchen.

Ein Unternehmensglossar trägt dazu bei, die Suche nach Daten zu optimieren und Unklarheiten zu reduzieren. Das kann zu genaueren Analysen, einer besseren Governance und schnelleren Erkenntnissen führen.

Elemente eines Unternehmensglossars

In diesem Abschnitt werden die wichtigsten Elemente beschrieben, mit denen Sie ein Unternehmensglossar strukturieren können.

Glossar

Ein Glossar hat die folgenden Eigenschaften:

  • Übersicht Beschreibt den Zweck und den Inhalt des Unternehmensglossars. Sie können dem Glossar Bilder, Links, Tabellen oder formatierten Text hinzufügen. Die maximal unterstützte Größe beträgt 120 KB.
  • Beschreibung Beschreibt das Glossar. Der Text in diesem Feld wird für die Suche indexiert. Die maximal unterstützte Größe beträgt 1 KB.
  • Region Gibt die Region an, in der sich das Glossar befindet.

Kategorie

Mit einer Kategorie können Sie verschiedene Kategorien und Begriffe organisieren und strukturieren. Kategorien werden in einem Geschäftsglossar definiert. Sie können Kategorien bis zu drei Ebenen tief verschachteln.

Eine Kategorie hat die Eigenschaften eines Glossars sowie die folgenden Eigenschaften:

  • Kontakte Gibt die Person an, die für die Verwaltung der Kategorie verantwortlich ist. Diese Property ist beschreibend und hat keinen Einfluss auf die Berechtigungen der Kategorie.
  • Elternteil Gibt eine Beziehung an, die verwendet wird, um das übergeordnete Element der aktuellen Kategorie festzulegen. Sie können bis zu drei Kategorien verschachteln.

Die Region einer Kategorie entspricht der Region des Glossars, das sie enthält.

Begriff

Ein Begriff (kurz für „Glossarbegriff“) beschreibt ein Konzept, das in einem bestimmten Geschäftsbereich Ihres Unternehmens verwendet wird. Die Marketingabteilung eines Unternehmens könnte beispielsweise einen Begriff für die Kosten pro Klick erstellen. Begriffe werden in einem Geschäftsglossar definiert, entweder direkt im Glossar oder in einer Kategorie des Glossars.

Ein Begriff hat die Eigenschaften einer Kategorie sowie die folgenden Eigenschaften:

  • Synonyme: Gibt Links zwischen Begriffen mit derselben Bedeutung an. Synonyme
  • Ähnliche Begriffe: Gibt Links zwischen Begriffen an, die konzeptionell miteinander verbunden sind, aber unterschiedliche Bedeutungen haben. Weitere Informationen
  • Zugehörige Einträge Gibt Links zwischen Begriffen und Daten-Assets oder zwischen Begriffen und Spalten in Daten-Assets an.
  • Kontakte Gibt die Person an, die für die Verwaltung des Begriffs verantwortlich ist. Begriffe übernehmen nicht die Kontakte, die in Kategorien definiert sind.

Die Region eines Begriffs entspricht der Region des Glossars, das ihn enthält.

Synonyme Begriffe

Ein Synonym ist eine Beziehung, die die Äquivalenz zwischen zwei verschiedenen Begriffen angibt. Verwenden Sie Synonyme, wenn zwei Begriffe mit derselben Bedeutung von verschiedenen Teams in verschiedenen Glossaren definiert werden. Sie können beispielsweise ein Synonym erstellen, um die Begriffe „Gewinn“ und „Einnahmen“ zu verknüpfen.

Ein verwandter Begriff ist eine Beziehung, die angibt, dass zwei Begriffe miteinander in Verbindung stehen, aber unterschiedliche Bedeutungen haben. Sie können beispielsweise einen ähnlichen Begriff erstellen, um die Begriffe „Umsatz“ und „Gewinn“ zu verknüpfen.

Beschränkungen

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für das Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Erstellen und Verwalten von Glossaren benötigen:

  • Datenadministratoren erhalten vollständigen Zugriff auf Glossare, Kategorien, Begriffe, Synonyme und zugehörige Begriffe sowie die Möglichkeit, IAM-Richtlinien festzulegen: Dataplex Catalog Admin (roles/dataplex.catalogAdmin)
  • Datenverantwortliche oder Dateninhaber erhalten Zugriff auf das Erstellen, Bearbeiten oder Löschen von Glossaren, Kategorien, Begriffen, Links zwischen Begriffen, Links zwischen Begriffen und Daten-Assets sowie auf die Suche: Dataplex Catalog-Bearbeiter (roles/dataplex.catalogEditor)
  • Datenanalysten oder Datenkonsumenten erhalten schreibgeschützten Zugriff auf Glossare, Kategorien, Begriffe, Links zwischen Begriffen und zwischen Begriffen und Daten-Assets sowie auf die Suche: Dataplex Catalog Viewer (roles/dataplex.catalogViewer)

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

Diese vordefinierten Rollen enthalten die Berechtigungen, die zum Erstellen und Verwalten von Glossaren erforderlich sind. Erweitern Sie den Abschnitt Erforderliche Berechtigungen, um die erforderlichen Berechtigungen anzuzeigen:

Erforderliche Berechtigungen

Die folgenden Berechtigungen sind erforderlich, um Glossare zu erstellen und zu verwalten:

  • Unternehmensglossar, Kategorie und Begriffe in Ihrem Projekt erstellen, lesen, aktualisieren und löschen:
    • dataplex.glossaries.list
    • dataplex.glossaries.create
    • dataplex.glossaries.get
    • dataplex.glossaries.update
    • dataplex.glossaries.delete
    • dataplex.glossaryCategories.create
    • dataplex.glossaryCategories.list
    • dataplex.glossaryCategories.get
    • dataplex.glossaryCategories.update
    • dataplex.glossaryCategories.delete
    • dataplex.glossaryTerms.create
    • dataplex.glossaryTerms.list
    • dataplex.glossaryTerms.get
    • dataplex.glossaryTerms.update
    • dataplex.glossaryTerms.delete
  • Synonymbegriff-zu-Begriff-Links in Ihrem Projekt erstellen und löschen:
    • dataplex.entryLinks.create für die Dataplex Universal Catalog-Eintragsgruppe im Projekt, in dem einer der Glossarbegriffe vorhanden ist. Der Link wird in der Eintragsgruppe erstellt, für die die Berechtigung erteilt wurde.
    • dataplex.entryGroups.useSynonymEntryLink für die Dataplex Universal Catalog-Eintragsgruppe im Projekt, in dem einer der Glossarbegriffe vorhanden ist. Der Link wird in der Eintragsgruppe erstellt, für die die Berechtigung erteilt wurde.
    • dataplex.glossaryTerms.use für die Glossare, deren Begriffe verknüpft werden müssen.
    • dataplex.entryLinks.delete für die Dataplex Universal Catalog-Eintragsgruppe im Projekt, in dem der Link vorhanden ist.
  • Zugehörige Begriff-zu-Begriff-Links in Ihrem Projekt erstellen und löschen:
    • dataplex.entryLinks.create für die Dataplex Universal Catalog-Eintragsgruppe im Projekt, in dem einer der Glossarbegriffe vorhanden ist. Der Link wird in der Eintragsgruppe erstellt, für die die Berechtigung erteilt wurde.
    • dataplex.entryGroups.useRelatedEntryLink für die Dataplex Universal Catalog-Eintragsgruppe im Projekt, in dem einer der Glossarbegriffe vorhanden ist. Der Link wird in der Eintragsgruppe erstellt, für die die Berechtigung erteilt wurde.
    • dataplex.entries.link für die Dataplex Universal Catalog-Eintragsgruppe in Projekten, in denen Einträge vorhanden sind, die Glossarbegriffen entsprechen.
    • dataplex.entryLinks.delete für die Dataplex Universal Catalog-Eintragsgruppe im Projekt, in dem der Link vorhanden ist.
  • Erstellen Sie Links zwischen Begriffen und Daten-Assets oder Spalten in Ihrem Projekt:
    • dataplex.entryLinks.create für die Systemeingabegruppe, die den Datenassets oder Spalten im Projekt entspricht. Der Link wird in dem Projekt erstellt, für das die Berechtigung erteilt wird.
    • dataplex.entryGroups.useDefinitionEntryLink für die Systemeingabegruppe, die den Datenassets oder Spalten im Projekt entspricht. Der Link wird in dem Projekt erstellt, für das die Berechtigung erteilt wird.
    • dataplex.entries.link für die Systemeingabegruppe, die den Datenassets oder Spalten im Projekt entspricht. Der Link wird in dem Projekt erstellt, für das die Berechtigung erteilt wird.
    • dataplex.glossaryTerms.use im Glossar, dessen Begriff verknüpft werden muss.
    • dataplex.entryLinks.delete für die Systemeintragsgruppe, in der der Link vorhanden ist.

Sie können diese Berechtigungen auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.

Weitere Informationen finden Sie unter Vordefinierte Rollen für Data Catalog.

Unternehmensglossare erstellen und verwalten

In den folgenden Abschnitten wird beschrieben, wie Sie ein Unternehmensglossar erstellen, ansehen, bearbeiten und löschen.

Geschäftsglossar erstellen

Console

  1. Rufen Sie in der Google Cloud -Console die Seite Glossare des Dataplex Universal Catalog auf.

    Zu „Glossare“

  2. Klicken Sie auf Unternehmensglossar erstellen.

  3. Geben Sie auf der Seite Unternehmensglossar erstellen einen Namen und einen Speicherort für das Unternehmensglossar an. Nachdem Sie das Glossar erstellt haben, können Sie den Speicherort nicht mehr ändern.

  4. Klicken Sie auf Erstellen. Das Glossar wird im aktuellen Projekt erstellt.

  5. Optional: Fügen Sie unter Beschreibung eine kurze Beschreibung (bis zu 1.024 Zeichen) oder unter Übersicht eine lange Beschreibung (bis zu 120 KB) hinzu.

REST

Wenn Sie ein Glossar erstellen, wird in Dataplex Universal Catalog ein Eintrag für das Glossar erstellt.

  1. Erstellen Sie das Glossar.

    alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'
    
    gcurl -X POST https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries?glossary_id=GLOSSARY_ID --data @- << EOF
    {
    "displayName": "DISPLAY_NAME",
    "description": "DESCRIPTION"
    }
    EOF

    Ersetzen Sie Folgendes:

    • PROJECT_ID: die ID des Projekts, in dem Sie das Glossar erstellen möchten
    • LOCATION_ID: Die ID des Standorts, an dem Sie das Glossar erstellen möchten
    • GLOSSARY_ID: die ID des Glossars
    • DISPLAY_NAME: Der Anzeigename des Glossars
    • DESCRIPTION: die Beschreibung des Glossars mit maximal 1.024 Zeichen
  2. Optional: Fügen Sie dem Glossar eine Übersicht hinzu.

    1. Suchen Sie den Eintrag für Ihr Glossar:

      gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID
      :lookupEntry\
      ?entry=projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID
      \
      \&view=ALL

      Ersetzen Sie PROJECT_NUMBER durch die Nummer des Projekts, in dem Ihr Glossar erstellt wird.

    2. So fügen Sie Ihrem Glossar eine Übersicht hinzu:

      gcurl -X PATCH https://dataplex.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID\
      ?update_mask=aspects\
      \&deleteMissingAspects=false\
      \&aspect_keys=projects/dataplex-types/locations/global/aspectTypes/overview \
      --data @- << EOF
      {
      "aspects": {
         "dataplex-types.global.overview": {
            "aspect_type": "projects/dataplex-types/locations/global/aspectTypes/overview",
            "data": {
            "content": "OVERVIEW",
            "links": []
            },
         }
      }
      }
      EOF

      Ersetzen Sie OVERVIEW durch Klartext oder HTML, um Ihre Glossarkategorie oder Ihren Glossarbegriff zu beschreiben.

Verfügbare Glossare ansehen

Console

  • Rufen Sie in der Google Cloud -Console die Seite Glossare des Dataplex Universal Catalog auf.

    Zu „Glossare“

    Im Bereich Meine Glossare werden alle Glossare der Organisation angezeigt, die Sie aufrufen dürfen, zusammen mit ihren Beschreibungen und Zeitstempeln für die letzte Änderung.

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries

Glossar bearbeiten

Sie können den Namen und die Beschreibung eines Glossars bearbeiten.

Console

  1. Rufen Sie in der Google Cloud -Console die Seite Glossare des Dataplex Universal Catalog auf.

    Zu „Glossare“

  2. Klicken Sie auf das Glossar, das Sie bearbeiten möchten.

  3. Klicken Sie neben dem Namen, der Beschreibung oder der Übersicht auf Bearbeiten und nehmen Sie dann die gewünschte Änderung vor.

  4. Klicken Sie auf Speichern.

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X PATCH https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID?update_mask=displayName,description --data @- << EOF
{
"displayName": "DISPLAY_NAME",
"description": "DESCRIPTION"
}
EOF

Glossar löschen

Bevor Sie ein Glossar löschen können, müssen Sie zuerst alle Kategorien und Begriffe im Glossar löschen.

Console

  1. Rufen Sie in der Google Cloud -Console die Seite Glossare des Dataplex Universal Catalog auf.

    Zu „Glossare“

  2. Klicken Sie auf das Glossar, das Sie löschen möchten.

  3. Klicken Sie auf Löschen und bestätigen Sie den Vorgang, wenn Sie dazu aufgefordert werden.

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X DELETE https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID

Kategorien erstellen und verwalten

In den folgenden Abschnitten wird beschrieben, wie Sie Kategorien erstellen, ansehen, aktualisieren und löschen.

Kategorie unter einem Glossar erstellen

Ein Unternehmensglossar kann maximal 200 Kategorien enthalten.

Console

  1. Rufen Sie in der Google Cloud -Console die Seite Glossare des Dataplex Universal Catalog auf.

    Zu „Glossare“

  2. Wählen Sie das Glossar aus, in dem Sie eine Kategorie erstellen möchten, und klicken Sie dann auf Kategorie erstellen.

  3. Geben Sie einen Namen für die Kategorie ein.

  4. Klicken Sie auf Erstellen.

  5. Optional: Fügen Sie unter Beschreibung eine kurze Beschreibung (bis zu 1.024 Zeichen) oder unter Übersicht eine lange Beschreibung (bis zu 120 KB) hinzu.

REST

Wenn Sie eine Kategorie erstellen, wird in Dataplex Universal Catalog ein Eintrag für die Kategorie erstellt.

  1. Erstellen Sie die Kategorie.

    alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'
    
    gcurl -X POST https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories?category_id=CATEGORY_ID --data @- << EOF
    {
    "displayName": "CATEGORY_DISPLAY_NAME",
    "description": "CATEGORY_DESCRIPTION",
    "parent": "projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID"
    }
    EOF

    Ersetzen Sie Folgendes:

    • CATEGORY_ID: die Kategorie-ID
    • CATEGORY_DISPLAY_NAME: Der Anzeigename der Kategorie
    • CATEGORY_DESCRIPTION: die Kategoriebeschreibung
  2. Optional: Fügen Sie der Kategorie eine Übersicht hinzu.

    1. Suchen Sie den Eintrag für Ihre Kategorie:

      gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID
      :lookupEntry\
      ?entry=projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/CATEGORY_ID
      \
      \&view=ALL
    2. So fügen Sie Ihrer Kategorie eine Übersicht hinzu:

      gcurl -X PATCH https://dataplex.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/CATEGORY_ID\
      ?update_mask=aspects\
      \&deleteMissingAspects=false\
      \&aspect_keys=projects/dataplex-types/locations/global/aspectTypes/overview
      \
      --data @- << EOF
      {
      "aspects": {
      "dataplex-types.global.overview": {
         "aspect_type":"projects/dataplex-types/locations/global/aspectTypes/overview
      ",
         "data": {
         "content": "OVERVIEW",
         "links": []
         },
      }
      }
      }
      EOF

      Ersetzen Sie OVERVIEW durch Klartext oder HTML, um Ihre Glossarkategorie oder Ihren Glossarbegriff zu beschreiben.

  3. Optional: Kontakte hinzufügen

    1. Suchen Sie den Eintrag für Ihre Kategorie:

      gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID
      :lookupEntry\
      ?entry=projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/CATEGORY_ID
      \
      \&view=ALL
    2. So aktualisieren Sie den Eintrag für Ihre Kategorie mit Kontakten:

      gcurl -X PATCH https://dataplex.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/CATEGORY_ID\
      ?update_mask=aspects\
      \&deleteMissingAspects=false\
      \&aspect_keys=projects/dataplex-types/locations/global/aspectTypes/contacts \
      --data @- << EOF
      {
      "aspects": {
      "dataplex-types.global.contacts": {
         "aspect_type": "projects/dataplex-types/locations/global/aspectTypes/contacts",
         "data": {
         "identities": [
            {
               "role": "steward",
               "name": "CONTACT_NAME",
               "id": "CONTACT_EMAIL"
            }
         ]
         },
      }
      }
      }
      EOF

Verschachtelte Kategorie erstellen

Ein Glossar kann maximal drei verschachtelte Kategorieebenen haben, die Stammglossarebene nicht mitgezählt.

Console

  1. Rufen Sie in der Google Cloud -Console die Seite Glossare des Dataplex Universal Catalog auf.

    Zu „Glossare“

  2. Maximieren Sie das Glossar, in dem Sie eine Kategorie erstellen möchten.

  3. Wählen Sie die übergeordnete Kategorie aus, in der Sie eine weitere Kategorie erstellen möchten, und klicken Sie auf Kategorie erstellen.

  4. Geben Sie einen Namen für die Kategorie ein.

  5. Klicken Sie auf Erstellen.

  6. Optional: Fügen Sie unter Beschreibung eine kurze Beschreibung (bis zu 1.024 Zeichen) oder unter Übersicht eine lange Beschreibung (bis zu 120 KB) hinzu.

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X POST https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories?category_id=CATEGORY_ID --data @- << EOF
{
  "displayName": "CATEGORY_DISPLAY_NAME",
  "description": "CATEGORY_DESCRIPTION",
  "parent": "projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/PARENT_CATEGORY_ID"
}
EOF

Ersetzen Sie PARENT_CATEGORY_ID durch die ID der übergeordneten Kategorie.

Kategorien ansehen, die zu einem Glossar gehören

Console

  1. Rufen Sie in der Google Cloud -Console die Seite Glossare des Dataplex Universal Catalog auf.

    Zu „Glossare“

  2. Maximieren Sie das Glossar, um die Kategorien darin aufzurufen.

  3. Wenn Sie die untergeordneten Kategorien einer Kategorie aufrufen möchten, maximieren Sie die Kategorie.

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories

Kategorie bearbeiten

Sie können den Namen, die Beschreibung und die Kontakte für eine Kategorie bearbeiten. Bei untergeordneten Kategorien können Sie auch die übergeordnete Kategorie bearbeiten.

Console

  1. Rufen Sie in der Google Cloud -Console die Seite Glossare des Dataplex Universal Catalog auf.

    Zu „Glossare“

  2. Maximieren Sie das Glossar und klicken Sie auf die Kategorie, die Sie bearbeiten möchten.

  3. Klicken Sie neben dem Namen, der Beschreibung oder der Übersicht auf  Bearbeiten und nehmen Sie die gewünschten Änderungen vor.

  4. Klicken Sie auf Speichern.

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X PATCH https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/CATEGORY_ID?update_mask=displayName,description --data @- << EOF
{
"displayName": "CATEGORY_DISPLAY_NAME",
"description": "DESCRIPTION"
}
EOF

Kategorie löschen

Console

  1. Rufen Sie in der Google Cloud -Console die Seite Glossare des Dataplex Universal Catalog auf.

    Zu „Glossare“

  2. Maximieren Sie das Glossar und klicken Sie auf die Kategorie, die Sie löschen möchten.

  3. Klicken Sie auf Löschen und bestätigen Sie den Vorgang, wenn Sie dazu aufgefordert werden.

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X DELETE https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/CATEGORY_ID

Begriffe erstellen und verwalten

In den folgenden Abschnitten wird beschrieben, wie Sie Begriffe erstellen, ansehen, darauf zugreifen, bearbeiten und löschen.

Begriff in einem Unternehmensglossar erstellen

Ein Geschäftsglossar kann maximal 5.000 Begriffe enthalten.

Console

  1. Rufen Sie in der Google Cloud -Console die Seite Glossare des Dataplex Universal Catalog auf.

    Zu „Glossare“

  2. Wenn Sie einen Begriff auf der Glossarebene erstellen möchten, wählen Sie das Glossar aus, in dem Sie einen Begriff erstellen möchten, und klicken Sie dann auf Begriff erstellen.

  3. Geben Sie einen Namen für den Begriff ein.

  4. Klicken Sie auf Erstellen.

  5. Optional: Fügen Sie unter Beschreibung eine kurze Beschreibung (bis zu 1.024 Zeichen) oder unter Übersicht eine lange Beschreibung (bis zu 120 KB) hinzu.

  6. Optional: Wenn Sie Kontakte hinzufügen möchten, klicken Sie auf Bearbeiten und geben Sie eine Liste mit E‑Mail-Adressen für die Datenverantwortlichen, Dateninhaber oder Inhaber von Datenbereichen an. Klicken Sie dann auf Speichern.

REST

Wenn Sie einen Begriff erstellen, wird in Dataplex Universal Catalog ein Eintrag erstellt, der den Begriff repräsentiert.

  1. Erstellen Sie den Begriff.

    alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'
    
    gcurl -X POST https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms?term_id=TERM_ID --data @- << EOF
    {
    "displayName": "TERM_DISPLAY_NAME",
    "description": "TERM_DESCRIPTION",
    "parent": "projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID"
    }
    EOF

    Ersetzen Sie Folgendes:

    • TERM_ID: die ID des Begriffs, den Sie erstellen
    • TERM_DISPLAY_NAME: Der Anzeigename für den Begriff, den Sie erstellen.
    • TERM_DESCRIPTION: die Beschreibung für den Begriff, den Sie erstellen
  2. Optional: Fügen Sie dem Begriff eine Übersicht hinzu.

    1. Suchen Sie nach dem Eintrag für Ihren Begriff:

      gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID
      :lookupEntry\
      ?entry=projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM_ID
      \
      \&view=ALL
    2. Fügen Sie Ihrem Begriff eine Übersicht hinzu:

      gcurl -X PATCH https://dataplex.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM_ID
      \
      ?update_mask=aspects\
      \&deleteMissingAspects=false\
      \&aspect_keys=projects/dataplex-types/locations/global/aspectTypes/overview
      \
      --data @- << EOF
      {
      "aspects": {
      "dataplex-types.global.overview": {
         "aspect_type":"projects/dataplex-types/locations/global/aspectTypes/overview
      ",
         "data": {
         "content": "OVERVIEW",
         "links": []
         },
      }
      }
      }
      EOF

      Ersetzen Sie OVERVIEW durch Klartext oder HTML, um Ihre Glossarkategorie oder Ihren Glossarbegriff zu beschreiben.

  3. Optional: Fügen Sie Kontakte hinzu.

    1. Suchen Sie nach dem Eintrag für Ihren Begriff:

      gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID
      :lookupEntry\
      ?entry=projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM_ID
      \
      \&view=ALL
    2. Aktualisieren Sie den Eintrag für Ihren Begriff mit Kontakten:

      gcurl -X PATCH https://dataplex.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM_ID
      ?update_mask=aspects\
      \&deleteMissingAspects=false\
      \&aspect_keys=projects/dataplex-types/locations/global/aspectTypes/contacts \
      --data @- << EOF
      {
      "aspects": {
      "dataplex-types.global.contacts": {
         "aspect_type": "projects/dataplex-types/locations/global/aspectTypes/contacts",
         "data": {
         "identities": [
            {
               "role": "steward",
               "name": "CONTACT_NAME",
               "id": "CONTACT_EMAIL"
            }
         ]
         },
      }
      }
      }
      EOF

Begriff unter einer Kategorie erstellen

Console

  1. Rufen Sie in der Google Cloud -Console die Seite Glossare des Dataplex Universal Catalog auf.

    Zu „Glossare“

  2. Wenn Sie einen Begriff in einer Kategorie erstellen möchten, wählen Sie die Kategorie aus, in der Sie einen Begriff erstellen möchten, und klicken Sie dann auf Begriff hinzufügen.

  3. Geben Sie einen Namen für den Begriff ein.

  4. Klicken Sie auf Erstellen.

  5. Optional: Fügen Sie unter Beschreibung eine kurze Beschreibung (bis zu 1.024 Zeichen) oder unter Übersicht eine lange Beschreibung (bis zu 120 KB) hinzu.

  6. Optional: Wenn Sie Kontakte hinzufügen möchten, klicken Sie auf Bearbeiten und geben Sie eine Liste mit E‑Mail-Adressen für die Datenverantwortlichen, Dateninhaber oder Inhaber von Datenbereichen an. Klicken Sie dann auf Speichern.

REST

Wenn Sie einen Begriff erstellen, wird in Dataplex Universal Catalog ein Eintrag erstellt, der den Begriff repräsentiert.

  1. Begriff erstellen

    alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'
    
    gcurl -X POST https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms?term_id=TERM_ID --data @- << EOF
    {
    "displayName": "TERM_DISPLAY_NAME",
    "description": "TERM_DESCRIPTION",
    "parent": "projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/PARENT_CATEGORY_ID"
    }
    EOF

    Ersetzen Sie Folgendes:

    • TERM_ID: die ID des Begriffs, den Sie erstellen
    • TERM_DISPLAY_NAME: Der Anzeigename für den Begriff, den Sie erstellen.
    • TERM_DESCRIPTION: die Beschreibung für den Begriff, den Sie erstellen
  2. Optional: Fügen Sie dem Begriff eine Übersicht hinzu.

    1. Suchen Sie nach dem Eintrag für Ihren Begriff:

      gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID
      :lookupEntry\
      ?entry=projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM_ID
      \
      \&view=ALL
    2. Fügen Sie Ihrem Begriff eine Übersicht hinzu:

      gcurl -X PATCH https://dataplex.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM_ID
      \
      ?update_mask=aspects\
      \&deleteMissingAspects=false\
      \&aspect_keys=projects/dataplex-types/locations/global/aspectTypes/overview
      \
      --data @- << EOF
      {
      "aspects": {
      "dataplex-types.global.overview": {
         "aspect_type":"projects/dataplex-types/locations/global/aspectTypes/overview
      ",
         "data": {
         "content": "OVERVIEW",
         "links": []
         },
      }
      }
      }
      EOF

      Ersetzen Sie OVERVIEW durch Klartext oder HTML, um Ihre Glossarkategorie oder Ihren Glossarbegriff zu beschreiben.

  3. Optional: Fügen Sie Kontakte hinzu.

    1. Suchen Sie nach dem Eintrag für Ihren Begriff:

      gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID
      :lookupEntry\
      ?entry=projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM_ID
      \
      \&view=ALL
    2. Aktualisieren Sie den Eintrag für Ihren Begriff mit Kontakten:

      gcurl -X PATCH https://dataplex.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM_ID
      ?update_mask=aspects\
      \&deleteMissingAspects=false\
      \&aspect_keys=projects/dataplex-types/locations/global/aspectTypes/contacts \
      --data @- << EOF
      {
      "aspects": {
      "dataplex-types.global.contacts": {
         "aspect_type": "projects/dataplex-types/locations/global/aspectTypes/contacts",
         "data": {
         "identities": [
            {
               "role": "steward",
               "name": "CONTACT_NAME",
               "id": "CONTACT_EMAIL"
            }
         ]
         },
      }
      }
      }
      EOF

Begriffe in einem Glossar oder einer Kategorie ansehen

Console

  1. Rufen Sie in der Google Cloud -Console die Seite Glossare des Dataplex Universal Catalog auf.

    Zu „Glossare“

  2. Maximieren Sie das Glossar, um die Begriffe darin aufzurufen. Wenn Sie Begriffe in einer Kategorie in diesem Glossar aufrufen möchten, maximieren Sie die Kategorie. Wenn Sie Begriffe in einer verschachtelten Kategorie aufrufen möchten, maximieren Sie die verschachtelte Kategorie.

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms

Details eines Begriffs ansehen

Console

  1. Rufen Sie in der Google Cloud -Console die Seite Glossare des Dataplex Universal Catalog auf.

    Zu „Glossare“

  2. Wenn Sie die Liste der Begriffe in einem Glossar aufrufen möchten, maximieren Sie das Glossar.

  3. Klicken Sie auf einen Begriff. Auf der Seite Begriffdetails werden der Begriffname, die Beschreibung, verwandte Begriffe, Synonyme und verwandte Einträge angezeigt.

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM_ID

Begriff bearbeiten

Sie können den Namen, die Beschreibung, die Übersicht, die Kontakte und das übergeordnete Element eines Begriffs bearbeiten.

Console

  1. Rufen Sie in der Google Cloud -Console die Seite Glossare des Dataplex Universal Catalog auf.

    Zu „Glossare“

  2. Maximieren Sie das Glossar und klicken Sie auf den Begriff, den Sie bearbeiten möchten.

  3. Klicken Sie auf Bearbeiten.

  4. Bearbeiten Sie die gewünschten Felder und klicken Sie auf Speichern.

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X PATCH https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM_ID?update_mask=displayName,description --data @- << EOF
{
  "displayName": "TERM_DISPLAY_NAME",
  "description": "TERM_DESCRIPTION"
}
EOF

Begriff löschen

Console

  1. Rufen Sie in der Google Cloud -Console die Seite Glossare des Dataplex Universal Catalog auf.

    Zu „Glossare“

  2. Erweitern Sie das Glossar und klicken Sie auf den Begriff, den Sie löschen möchten.

  3. Klicken Sie auf Löschen und bestätigen Sie den Vorgang, wenn Sie dazu aufgefordert werden.

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X DELETE https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM_ID

Sie können Beziehungen zwischen Begriffen hinzufügen, indem Sie sie als Synonyme oder verwandte Begriffe verknüpfen.

Begriffsbeziehungen sind bidirektional. Wenn Sie beispielsweise profit als Synonym für earnings verknüpfen, wird earnings auch zu einem Synonym für profit.

Console

  1. Rufen Sie in der Google Cloud -Console die Seite Glossare des Dataplex Universal Catalog auf.

    Zu „Glossare“

  2. Maximieren Sie das Glossar und klicken Sie auf den Begriff, mit dem Sie Links erstellen möchten.

  3. Klicken Sie neben Synonyme auf Bearbeiten.

  4. Suchen Sie nach den Begriffen, die Sie verlinken möchten, und wählen Sie sie aus.

    Der Begriff wird sofort verlinkt, wenn Sie ihn auswählen.

  5. Klicken Sie auf Schließen.

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X POST https://dataplex.googleapis.com/v1/projects/TERM1_PROJECT_ID/locations/TERM1_LOCATION_ID/entryGroups/@dataplex/entryLinks?entry_link_id=ENTRY_LINK_ID -d "$(cat<<EOF
{
  "entry_link_type": "projects/dataplex-types/locations/global/entryLinkTypes/synonym",
"entry_references": [{
     "name": "projects/TERM1_PROJECT_NUMBER/locations/TERM1_LOCATION_ID/entryGroups/@dataplex/entries/projects/TERM1_PROJECT_NUMBER/locations/TERM1_LOCATION_ID/glossaries/TERM1_GLOSSARY_ID/terms/TERM1_ID",
     "type": "UNSPECIFIED"
  }, {
     "name": "projects/TERM2_PROJECT_NUMBER/locations/TERM2_LOCATION_ID/entryGroups/@dataplex/entries/projects/TERM2_PROJECT_NUMBER/locations/TERM2_LOCATION_ID/glossaries/TERM2_GLOSSARY_ID/terms/TERM2_ID",
     "type": "UNSPECIFIED"
  }
  ]

}
EOF
)"

Ersetzen Sie Folgendes:

  • TERM1_PROJECT_NUMBER: die Projektnummer für den ersten zu verknüpfenden Begriff.
  • TERM1_LOCATION_ID: Die Standort-ID des Glossars, das den ersten Begriff enthält.
  • TERM1_GLOSSARY_ID: die ID des Glossars, das den ersten Begriff enthält.
  • TERM1_ID: Die ID des ersten Begriffs.
  • TERM2_PROJECT_NUMBER: Die Projektnummer des zweiten Begriffs, den Sie als Synonymbegriff verknüpfen möchten. Wenn sich beide Begriffe im selben Projekt befinden, entspricht dieser Wert der Projektnummer des ersten Begriffs.
  • TERM2_LOCATION_ID: Die Standort-ID des Glossars, das den zweiten Begriff enthält. Wenn sich beide Begriffe am selben Ort befinden, entspricht dieser Wert der Orts-ID für den ersten Begriff.
  • TERM2_GLOSSARY_ID: die ID des Glossars, das den zweiten Begriff enthält. Wenn sich beide Begriffe im selben Glossar befinden, ist dieser Wert derselbe wie die Glossar-ID für den ersten Begriff.
  • TERM2_ID: Die ID des zweiten Terms.
  • ENTRY_LINK_ID: eine ID für die Verknüpfung zwischen den beiden Begriffen. Jeder Begriff wird als Dataplex Universal Catalog-Eintrag dargestellt. Der Eintragslink ist die Beziehung zwischen Synonymen.

Console

  1. Rufen Sie in der Google Cloud -Console die Seite Glossare des Dataplex Universal Catalog auf.

    Zu „Glossare“

  2. Maximieren Sie das Glossar und klicken Sie auf den Begriff, mit dem Sie Links erstellen möchten.

  3. Klicken Sie neben Verwandte Begriffe auf Bearbeiten.

  4. Suchen Sie nach den Begriffen, die Sie verlinken möchten, und wählen Sie sie aus.

    Der Begriff wird sofort verlinkt, wenn Sie ihn auswählen.

  5. Klicken Sie auf Schließen.

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X POST https://dataplex.googleapis.com/v1/projects/TERM1_PROJECT_ID/locations/TERM1_LOCATION_ID/entryGroups/@dataplex/entryLinks?entry_link_id=ENTRY_LINK_ID -d "$(cat<<EOF
{
  "entry_link_type": "projects/dataplex-types/locations/global/entryLinkTypes/related",
"entry_references": [{
     "name": "projects/TERM1_PROJECT_NUMBER/locations/TERM1_LOCATION_ID/entryGroups/@dataplex/entries/projects/TERM1_PROJECT_NUMBER/locations/TERM1_LOCATION_ID/glossaries/TERM1_GLOSSARY_ID/terms/TERM1_ID",
     "type": "UNSPECIFIED"
  }, {
     "name": "projects/TERM2_PROJECT_NUMBER/locations/TERM2_LOCATION_ID/entryGroups/@dataplex/entries/projects/TERM2_PROJECT_NUMBER/locations/TERM2_LOCATION_ID/glossaries/TERM2_GLOSSARY_ID/terms/TERM2_ID",
     "type": "UNSPECIFIED"
  }
  ]

}
EOF
)"

Ersetzen Sie Folgendes:

  • TERM1_PROJECT_NUMBER: die Projektnummer für den ersten verknüpften Begriff.
  • TERM1_LOCATION_ID: Die Standort-ID des Glossars, das den ersten Begriff enthält.
  • TERM1_GLOSSARY_ID: die ID des Glossars, das den ersten Begriff enthält.
  • TERM1_ID: Die ID des ersten Begriffs.
  • TERM2_PROJECT_NUMBER: die Projektnummer für den zweiten Begriff, den Sie als verwandten Begriff verknüpfen möchten. Wenn sich beide Begriffe im selben Projekt befinden, entspricht dieser Wert der Projektnummer für den ersten Begriff.
  • TERM2_LOCATION_ID: Die Standort-ID des Glossars, das den zweiten Begriff enthält. Wenn sich beide Begriffe am selben Ort befinden, entspricht dieser Wert der Orts-ID für den ersten Begriff.
  • TERM2_GLOSSARY_ID: die ID des Glossars, das den zweiten Begriff enthält. Wenn sich beide Begriffe im selben Glossar befinden, ist dieser Wert derselbe wie die Glossar-ID für den ersten Begriff.
  • TERM2_ID: Die ID des zweiten Terms.
  • ENTRY_LINK_ID: eine ID für die Verknüpfung zwischen den beiden Begriffen. Jeder Begriff wird als Dataplex Universal Catalog-Eintrag dargestellt. Der Eintragslink beschreibt die Beziehung zwischen verwandten Begriffen.

Console

  1. Rufen Sie in der Google Cloud -Console die Seite Glossare des Dataplex Universal Catalog auf.

    Zu „Glossare“

  2. Maximieren Sie das Glossar und klicken Sie auf den Begriff, dessen Synonyme oder verwandte Begriffe Sie entfernen möchten.

  3. Wenn Sie Links zwischen verwandten Begriffen löschen möchten, klicken Sie neben Verwandte Begriffe auf Bearbeiten. Löschen Sie die zugehörigen Begriffe und klicken Sie auf Schließen.

  4. Wenn Sie Links zwischen Synonymen löschen möchten, klicken Sie neben Synonyme auf Bearbeiten. Löschen Sie die Synonyme und klicken Sie dann auf Schließen.

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X DELETE https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/entryGroups/ENTRY_GROUP_ID/entryLinks/ENTRY_LINK_ID

Sie können Begriffe an Daten-Assets oder Daten-Asset-Spalten anhängen. Sie können beispielsweise einem BigQuery-Dataset Nutzungsbedingungen hinzufügen.

Console

  1. Rufen Sie in der Google Cloud -Console die Seite Suche des Dataplex Universal Catalog auf.

    Zur Suche

  2. Suchen Sie nach dem Daten-Asset (z. B. einem Dataset, einer Datei oder einer Tabelle), mit dem Sie einen Begriff verknüpfen möchten, und klicken Sie darauf.

  3. Führen Sie auf der Seite des Daten-Assets einen der folgenden Schritte aus:

    • Wenn Sie Begriffe mit einem Asset verknüpfen möchten, klicken Sie auf dem Tab Details im Bereich Glossarbegriffe auf Hinzufügen. Suchen Sie nach den Begriffen, wählen Sie sie aus und klicken Sie dann auf Schließen.
    • Wenn das Asset ein Schema hat, können Sie Begriffe mit einer Spalte verknüpfen. Wählen Sie auf dem Tab Schema eine Spalte aus, mit der Sie Begriffe verknüpfen möchten, und klicken Sie dann auf Geschäftsbedingung hinzufügen. Suchen Sie nach den Begriffen, wählen Sie sie aus und klicken Sie dann auf Schließen.

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X POST https://dataplex.googleapis.com/v1/projects/PROJECT_NUMBER/locations/ENTRY_LOCATION_ID/entryGroups/ENTRY_GROUP_ID/entryLinks?entry_link_id=ENTRY_LINK_ID -d "$(cat<<EOF
{
  "entry_link_type": "projects/dataplex-types/locations/global/entryLinkTypes/definition",
  "entry_references": [{
     "name": "projects/PROJECT_NUMBER/locations/ENTRY_LOCATION_ID/entryGroups/ENTRY_GROUP_ID/entries/ENTRY_ID",
     "type": "SOURCE"
  }, {
     "name": "projects/TERM_PROJECT_NUMBER/locations/TERM_LOCATION_ID/entryGroups/@dataplex/entries/projects/TERM_PROJECT_NUMBER/locations/TERM_LOCATION_ID/glossaries/TERM_GLOSSARY_ID/terms/TERM_ID",
     "type": "TARGET"
  }
  ]
}
EOF
)"

Ersetzen Sie Folgendes:

  • PROJECT_NUMBER: die Projektnummer des Daten-Assets, mit dem verknüpft wird
  • ENTRY_LOCATION_ID: die Standort-ID des Datenassets, mit dem verknüpft wird
  • ENTRY_GROUP_ID: die Eintragsgruppe des Daten-Assets, mit dem verknüpft wird
  • ENTRY_LINK_ID: Eine ID für die Verknüpfung zwischen dem Begriff und dem Dataplex Universal Catalog-Eintrag, der das Daten-Asset darstellt.
  • TERM_PROJECT_NUMBER: die Projektnummer für den zu verknüpfenden Begriff.

Begriffe an eine Spalte in einem Eintragschema anhängen

Console

  1. Rufen Sie in der Google Cloud -Console die Seite Suche des Dataplex Universal Catalog auf.

    Zur Suche

  2. Suchen Sie nach dem Daten-Asset (z. B. einem Dataset, einer Datei oder einer Tabelle) mit einem Schema, das eine Spalte enthält, mit der Sie einen Begriff verknüpfen möchten. Klicken Sie auf das Daten-Asset.

  3. Führen Sie auf der Seite des Daten-Assets einen der folgenden Schritte aus:

    • Wenn Sie Begriffe mit einer Spalte im Daten-Asset verknüpfen möchten, wählen Sie auf dem Tab „Schema“ die Spalten aus, denen Sie den Begriff zuordnen möchten.
    • Klicken Sie auf Unternehmensbegriff hinzufügen. Suchen Sie nach dem Begriff, den Sie anhängen möchten, und klicken Sie darauf.

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X POST https://dataplex.googleapis.com/v1/projects/PROJECT_NUMBER/locations/ENTRY_LOCATION_ID/entryGroups/ENTRY_GROUP_ID/entryLinks?entry_link_id=ENTRY_LINK_ID -d "$(cat<PROJECT_NUMBER/locations/ENTRY_LOCATION_ID/entryGroups/ENTRY_GROUP_ID/entries/ENTRY_ID",
  "type": "SOURCE"
  "path": "Schema/COLUMN_NAME"
}, {
  "name": "projects/TERM_PROJECT_NUMBER/locations/TERM_LOCATION_ID/entryGroups/@dataplex/entries/projects/TERM_PROJECT_NUMBER/locations/TERM_LOCATION_ID/glossaries/TERM_GLOSSARY_ID/terms/TERM_ID",
  "type": "TARGET"
}
]
}
EOF
)"

Ersetzen Sie Folgendes:

  • PROJECT_NUMBER: die Projektnummer des Daten-Assets, mit dem verknüpft wird
  • ENTRY_LOCATION_ID: die Standort-ID des Datenassets, mit dem verknüpft wird
  • ENTRY_GROUP_ID: die Eintragsgruppe des Daten-Assets, mit dem verknüpft wird
  • ENTRY_LINK_ID: eine ID für die Verknüpfung zwischen dem Begriff und dem Dataplex Universal Catalog-Eintrag, der das Daten-Asset darstellt
  • TERM_PROJECT_NUMBER: die Projektnummer für den verknüpften Begriff
  • COLUMN_NAME: Die Spalte, an die Sie den Begriff anhängen möchten

Console

  1. Rufen Sie in der Google Cloud -Console die Seite Suche des Dataplex Universal Catalog auf.

    Zur Suche

  2. Suchen Sie nach dem Daten-Asset (z. B. Dataset, Datei oder Tabelle), aus dem Sie die Begriffe entfernen möchten, und klicken Sie darauf.

  3. Führen Sie auf der Seite des Daten-Assets einen der folgenden Schritte aus:

    • Wenn Sie einen Begriff aus einem Asset entfernen möchten, klicken Sie auf dem Tab Details im Bereich Glossarbegriffe auf den Begriff. Klicken Sie dann auf .
    • Wenn Sie einen Begriff aus einer Spalte entfernen möchten, klicken Sie auf dem Tab Schema neben dem Begriff auf .

REST

alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

gcurl -X DELETE https://dataplex.googleapis.com/v1/projects/ENTRY_PROJECT_ID/locations/ENTRY_LOCATION_ID/entryGroups/ENTRY_GROUP_ID/entryLinks/ENTRY_LINK_ID

Glossare, Begriffe und verknüpfte Daten-Assets suchen

Console

Wenn Sie die Inhalte Ihres geschäftlichen Glossars durchsuchen möchten, verwenden Sie den Glossar- und Begriffbaum auf der Seite Glossare.

  1. Rufen Sie in der Google Cloud -Console die Seite Glossare des Dataplex Universal Catalog auf.

    Zu „Glossare“

  2. Verwenden Sie auf der Seite Glossare die Filterleiste, um Kategorien zu finden. Folgende Filter sind verfügbar:

    • Name: Gibt die Glossare, Kategorien und Begriffe zurück, deren Name den von Ihnen angegebenen Text enthält.
    • Übergeordnet: Gibt die Begriffe zurück, deren übergeordneter Glossarname oder die übergeordnete Glossarbeschreibung mit dem von Ihnen angegebenen Text übereinstimmt. Mit parent:Finance werden beispielsweise die Begriffe zurückgegeben, die mit dem übergeordneten Glossar verknüpft sind, dessen Name oder Beschreibung den Begriff Finance enthält.
    • Synonym: Gibt die Liste der Begriffe mit einem Synonym zurück, dessen Name oder ID den von Ihnen angegebenen Text enthält. Mit synonym:Profit werden beispielsweise die Begriffe zurückgegeben, die einen Synonymbegriff haben, dessen Name oder ID den Ausdruck profit enthält.
    • Kontakt: Gibt die Begriffe zurück, bei denen der Datenverwalter als Kontakt aufgeführt ist. Mit contact:alex@example.com werden beispielsweise die Einträge zurückgegeben, die mit Begriffen verknüpft sind, deren Datenverantwortlicher alex@example.com entspricht.

REST

Wenn Sie Glossare, Begriffe und verknüpfte Daten-Assets mit der REST API suchen möchten, müssen Sie sich für die Vorabversion registrieren.

Nach Datenassets suchen, die mit Begriffen verknüpft sind

Console

  1. Rufen Sie in der Google Cloud -Console die Seite Glossare des Dataplex Universal Catalog auf.

    Zu „Glossare“

  2. Geben Sie auf der Seite Glossare in die Filterleiste eine Freiform-Suchanfrage ein. Dadurch wird eine Liste mit entsprechenden Übereinstimmungen in den Glossar-, Kategorie- und Begriffsnamen zurückgegeben.

  3. Klicken Sie auf einen zugeordneten Begriff.

  4. Auf der Seite Begriffdetails sehen Sie die verknüpften Begriffe (Synonyme und verwandte Begriffe) und verknüpften Einträge (Daten-Assets) für diesen Begriff.

  5. Wenn Sie die Details zu einem Eintrag in Dataplex Universal Catalog aufrufen möchten, klicken Sie auf den Eintrag.

REST

Wenn Sie Glossare, Begriffe und verknüpfte Daten-Assets mit der REST API suchen möchten, müssen Sie sich für die Vorabversion registrieren.

Wenn Sie Glossare und Links aus einem anderen Katalogisierungstool importieren oder Ihre Glossare in Dataplex Universal Catalog aktualisieren möchten, können Sie Glossare, Kategorien, Begriffe, Links zwischen Begriffen, Links zwischen Begriffen und Daten-Assets oder Spalten mithilfe der REST API im Bulk-Verfahren importieren.

  1. Erstellen Sie das Zielglossar.

    REST

    alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'
    
    gcurl -X POST https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/glossaries?glossary_id=GLOSSARY_ID -d "$(cat<<EOF
    
    {
     "displayName": "DISPLAY_NAME",
     "description": "DESCRIPTION"
    }
    EOF
    )"

    Ersetzen Sie Folgendes:

    • PROJECT_ID: die Projekt-ID des Projekts, in dem Sie das Glossar erstellen
    • LOCATION_ID: der Ort, an dem wir das Glossar erstellen möchten
    • GLOSSARY_ID: die Glossar-ID
    • DISPLAY_NAME: Der Anzeigename des Glossars
    • DESCRIPTION: die Beschreibung des Glossars
  2. Wenn Sie Kategorien, Begriffe und Links zwischen Begriffen und Daten-Assets in das Zielglossar importieren möchten, laden Sie Dateien für jedes dieser Elemente in einen Cloud Storage-Bucket hoch. Diese Dateien haben das folgende Format:

    • Beispielformat für Begriffe und Kategorien eines Glossars

       {"entry":{"name":"projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/CATEGORY_ID","entryType":"projects/dataplex-types/locations/global/entryTypes/glossary-category","aspects":{"dataplex-types.global.glossary-category-aspect":{"data":{}},"dataplex-types.global.overview":{"data":{"content":"CONTENT"}},"dataplex-types.global.contacts":{"data":{"identities":[{role: "steward", name: "CONTACT_DISPLAY_NAME", id: "CONTACT_EMAIL"}]}}},"parentEntry":"projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID","entrySource":{"resource":"projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/CATEGORY_ID","displayName":"CATEGORY_NAME","description":"CATEGORY_DESCRIPTION","ancestors":[{"name":"projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID","type":"projects/dataplex-types/locations/global/entryTypes/glossary"}]}}}
       {"entry":{"name":"projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM1_ID","entryType":"projects/dataplex-types/locations/global/entryTypes/glossary-term","aspects":{"dataplex-types.global.glossary-term-aspect":{"data":{}},"dataplex-types.global.overview":{"data":{"content":"TERM1_CONTENT"}},"dataplex-types.global.contacts":{"data":{"identities":[{role: "steward", name: "CONTACT_DISPLAY_NAME", id: "CONTACT_EMAIL"}]}}},"parentEntry":"projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID","entrySource":{"resource":"projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM1_ID","displayName":"TERM1_DISPLAY_NAME","description":"TERM1_DESCRIPTION","ancestors":[{"name":"projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID","type":"projects/dataplex-types/locations/global/entryTypes/glossary"},{"name":"projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/CATEGORY_ID","type":"projects/dataplex-types/locations/global/entryTypes/glossary-category"}]}}}
       {"entry":{"name":"projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM2_ID","entryType":"projects/dataplex-types/locations/global/entryTypes/glossary-term","aspects":{"dataplex-types.global.glossary-term-aspect":{"data":{}},"dataplex-types.global.overview":{"data":{"content":"TERM1_CONTENT"}},"dataplex-types.global.contacts":{"data":{"identities":[{role: "steward", name: "CONTACT_DISPLAY_NAME", id: "CONTACT_EMAIL"}]}}},"parentEntry":"projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID","entrySource":{"resource":"projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/terms/TERM2_ID","displayName":"TERM2_DISPLAY_NAME","description":"TERM2_DESCRIPTION","ancestors":[{"name":"projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID","type":"projects/dataplex-types/locations/global/entryTypes/glossary"},{"name":"projects/PROJECT_NUMBER/locations/LOCATION_ID/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/LOCATION_ID/glossaries/GLOSSARY_ID/categories/CATEGORY_ID","type":"projects/dataplex-types/locations/global/entryTypes/glossary-category"}]}}}
       
    • Beispielformat für Links zwischen Begriffen

       {"entryLink":{"name":"projects/PROJECT_NUMBER/locations/global/entryGroups/@dataplex/entryLinks/el-import-0606e3f2-8206-4f3a-aba9-32c6196f6048","entryLinkType":"projects/dataplex-types/locations/global/entryLinkTypes/synonym","entryReferences":[{"name":"projects/PROJECT_NUMBER/locations/global/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/global/glossaries/import-glossary/terms/term-1"},{"name":"projects/PROJECT_NUMBER/locations/global/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/global/glossaries/import-glossary/terms/term-2"}]}}
       {"entryLink":{"name":"projects/PROJECT_NUMBER/locations/global/entryGroups/@dataplex/entryLinks/el-import-2f7408e3-af3d-405d-81bb-861cf9ec5146","entryLinkType":"projects/dataplex-types/locations/global/entryLinkTypes/related","entryReferences":[{"name":"projects/PROJECT_NUMBER/locations/global/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/global/glossaries/import-glossary/terms/term-1"},{"name":"projects/PROJECT_NUMBER/locations/global/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/global/glossaries/import-glossary/terms/term-2"}]}}
       
    • Beispielformat für Links zwischen Begriffen und Daten-Assets

       projects/PROJECT_NUMBER/locations/us-central1/entryGroups/entry-group-1/entries/entry-1 and term projects/PROJECT_NUMBER/locations/global/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/global/glossaries/import-glossary/terms/term-1
       {"entryLink":{"name":"projects/PROJECT_NUMBER/locations/global/entryGroups/@dataplex/entryLinks/el-import-0606e3f2-8206-4f3a-aba9-32c6196f6048","entryLinkType":"projects/dataplex-types/locations/global/entryLinkTypes/definition","entryReferences":[{"name":"projects/PROJECT_NUMBER/locations/global/entryGroups/@dataplex/entries/projects/PROJECT_NUMBER/locations/global/glossaries/import-glossary/terms/term-1"},{"name":"projects/PROJECT_NUMBER/locations/us-central1/entryGroups/entry-group-1/entries/entry-1"}]}}
       
    # Set GCURL alias
    alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'
    
    gcurl https://DATAPLEX_API/metadataJobs?metadata_job_id=JOB_ID -d "$(cat<<EOF
    {
      "type":"IMPORT",
      "import_spec":{
         "log_level":"DEBUG",
         "source_storage_uri":"gs://STORAGE_BUCKET/",
         "entry_sync_mode":"FULL",
         "aspect_sync_mode":"INCREMENTAL",
         "scope":{
            "glossaries": "GLOSSARY_NAME"
         }
      }
    }
    EOF
    )"

    Ersetzen Sie DATAPLEX_API durch den Dataplex Universal Catalog-API-Endpunkt im Format dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID.

  3. Optional: Rufen Sie den Status des Vorgangs ab.

    gcurl https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/operations/operation-OPERATION_ID

    Ersetzen Sie OPERATION_ID durch die ID des Vorgangs.

  4. Optional: Rufen Sie den Status des Metadatenjobs ab.

    gcurl -X GET https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/metadataJobs/JOB_ID
  5. Importieren Sie Links zwischen Begriffen als Synonyme oder verwandte Begriffe.

    gcurl https://DATAPLEX_API/metadataJobs?metadata_job_id=JOB_ID -d "$(cat<<EOF
    {
      "type":"IMPORT",
      "import_spec":{
         "log_level":"DEBUG",
         "source_storage_uri":"gs://STORAGE_BUCKET/",
         "entry_sync_mode":"FULL",
         "aspect_sync_mode":"INCREMENTAL",
         "scope":{
            "entry_groups":[  "projects/PROJECT_ID/locations/LOCATION_ID/entryGroups/@dataplex"
            ],
            "entry_link_types":[
               "projects/dataplex-types/locations/global/entryLinkTypes/synonym",
               "projects/dataplex-types/locations/global/entryLinkTypes/related"
            ],
            "referenced_entry_scopes":[
               "PROJECT_IDS"
            ]
         }
      }
    }
    EOF
    )"

    Ersetzen Sie DATAPLEX_API durch dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID.

  6. Importieren Sie Links zwischen Begriffen und Daten-Assets oder Spalten.

    Wenn Sie eine Verknüpfung zwischen Glossarbegriffen und Datenassets erstellen möchten, führen Sie den Importjob für jede Eintragsgruppe aus, zu der der Eintrag für das Datenasset gehört. Alle Links zu Definitionseinträgen werden in dieser Eintragsgruppe erstellt.

    gcurl https://DATAPLEX_API/metadataJobs?metadata_job_id=JOB_ID -d "$(cat<<EOF
    {
    "type":"IMPORT",
    "import_spec":{
      "log_level":"DEBUG",
      "source_storage_uri":"gs://STORAGE_BUCKET/",
      "entry_sync_mode":"FULL",
      "aspect_sync_mode":"INCREMENTAL",
      "scope":{
         "entry_groups":[  "projects/PROJECT_ID/locations/ENTRY_GROUP_LOCATION_ID/entryGroups/@dataplex"
         ],
         "entry_link_types":[
            "projects/dataplex-types/locations/global/entryLinkTypes/definition"
         ],
         "referenced_entry_scopes":[
            "PROJECT_IDS"
         ]
      }
    }
    }
    EOF
    )"

    Ersetzen Sie DATAPLEX_API durch dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID.

Preise

Ab Juli 2026 wird das Unternehmensglossar im Dataplex Universal-Katalog genauso abgerechnet wie der Metadatenspeicher. Weitere Informationen finden Sie unter Preise für den Metadatenspeicher in Dataplex Universal Catalog.

Nächste Schritte