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.
Verwandte Begriffe
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
- Das Geschäftsglossar von Dataplex Universal Catalog wird für Assured Workloads-Projekte nicht unterstützt.
- Unternehmensglossare werden in Projekten und an Standorten gespeichert. Die Einschränkungen für Projekte und Standorte gelten auch für Glossare.
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
Rufen Sie in der Google Cloud -Console die Seite Glossare des Dataplex Universal Catalog auf.
Klicken Sie auf Unternehmensglossar erstellen.
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.
Klicken Sie auf Erstellen. Das Glossar wird im aktuellen Projekt erstellt.
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.
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öchtenLOCATION_ID
: Die ID des Standorts, an dem Sie das Glossar erstellen möchtenGLOSSARY_ID
: die ID des GlossarsDISPLAY_NAME
: Der Anzeigename des GlossarsDESCRIPTION
: die Beschreibung des Glossars mit maximal 1.024 Zeichen
Optional: Fügen Sie dem Glossar eine Übersicht hinzu.
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.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.
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
Rufen Sie in der Google Cloud -Console die Seite Glossare des Dataplex Universal Catalog auf.
Klicken Sie auf das Glossar, das Sie bearbeiten möchten.
Klicken Sie neben dem Namen, der Beschreibung oder der Übersicht auf Bearbeiten und nehmen Sie dann die gewünschte Änderung vor.
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
Rufen Sie in der Google Cloud -Console die Seite Glossare des Dataplex Universal Catalog auf.
Klicken Sie auf das Glossar, das Sie löschen möchten.
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
Rufen Sie in der Google Cloud -Console die Seite Glossare des Dataplex Universal Catalog auf.
Wählen Sie das Glossar aus, in dem Sie eine Kategorie erstellen möchten, und klicken Sie dann auf Kategorie erstellen.
Geben Sie einen Namen für die Kategorie ein.
Klicken Sie auf Erstellen.
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.
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-IDCATEGORY_DISPLAY_NAME
: Der Anzeigename der KategorieCATEGORY_DESCRIPTION
: die Kategoriebeschreibung
Optional: Fügen Sie der Kategorie eine Übersicht hinzu.
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
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.
Optional: Kontakte hinzufügen
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
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
Rufen Sie in der Google Cloud -Console die Seite Glossare des Dataplex Universal Catalog auf.
Maximieren Sie das Glossar, in dem Sie eine Kategorie erstellen möchten.
Wählen Sie die übergeordnete Kategorie aus, in der Sie eine weitere Kategorie erstellen möchten, und klicken Sie auf Kategorie erstellen.
Geben Sie einen Namen für die Kategorie ein.
Klicken Sie auf Erstellen.
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
Rufen Sie in der Google Cloud -Console die Seite Glossare des Dataplex Universal Catalog auf.
Maximieren Sie das Glossar, um die Kategorien darin aufzurufen.
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
Rufen Sie in der Google Cloud -Console die Seite Glossare des Dataplex Universal Catalog auf.
Maximieren Sie das Glossar und klicken Sie auf die Kategorie, die Sie bearbeiten möchten.
Klicken Sie neben dem Namen, der Beschreibung oder der Übersicht auf
Bearbeiten und nehmen Sie die gewünschten Änderungen vor.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
Rufen Sie in der Google Cloud -Console die Seite Glossare des Dataplex Universal Catalog auf.
Maximieren Sie das Glossar und klicken Sie auf die Kategorie, die Sie löschen möchten.
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
Rufen Sie in der Google Cloud -Console die Seite Glossare des Dataplex Universal Catalog auf.
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.
Geben Sie einen Namen für den Begriff ein.
Klicken Sie auf Erstellen.
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.
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.
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
Optional: Fügen Sie dem Begriff eine Übersicht hinzu.
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
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.
Optional: Fügen Sie Kontakte hinzu.
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
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
Rufen Sie in der Google Cloud -Console die Seite Glossare des Dataplex Universal Catalog auf.
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.
Geben Sie einen Namen für den Begriff ein.
Klicken Sie auf Erstellen.
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.
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.
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
Optional: Fügen Sie dem Begriff eine Übersicht hinzu.
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
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.
Optional: Fügen Sie Kontakte hinzu.
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
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
Rufen Sie in der Google Cloud -Console die Seite Glossare des Dataplex Universal Catalog auf.
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
Rufen Sie in der Google Cloud -Console die Seite Glossare des Dataplex Universal Catalog auf.
Wenn Sie die Liste der Begriffe in einem Glossar aufrufen möchten, maximieren Sie das Glossar.
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
Rufen Sie in der Google Cloud -Console die Seite Glossare des Dataplex Universal Catalog auf.
Maximieren Sie das Glossar und klicken Sie auf den Begriff, den Sie bearbeiten möchten.
Klicken Sie auf Bearbeiten.
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
Rufen Sie in der Google Cloud -Console die Seite Glossare des Dataplex Universal Catalog auf.
Erweitern Sie das Glossar und klicken Sie auf den Begriff, den Sie löschen möchten.
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
Synonyme und verwandte Begriffe verwalten
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
.
Synonymlinks zwischen Begriffen erstellen
Console
Rufen Sie in der Google Cloud -Console die Seite Glossare des Dataplex Universal Catalog auf.
Maximieren Sie das Glossar und klicken Sie auf den Begriff, mit dem Sie Links erstellen möchten.
Klicken Sie neben Synonyme auf
Bearbeiten.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.
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.
Ähnliche Links zwischen Begriffen erstellen
Console
Rufen Sie in der Google Cloud -Console die Seite Glossare des Dataplex Universal Catalog auf.
Maximieren Sie das Glossar und klicken Sie auf den Begriff, mit dem Sie Links erstellen möchten.
Klicken Sie neben Verwandte Begriffe auf
Bearbeiten.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.
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.
Links zwischen Synonymen und ähnlichen Begriffen entfernen
Console
Rufen Sie in der Google Cloud -Console die Seite Glossare des Dataplex Universal Catalog auf.
Maximieren Sie das Glossar und klicken Sie auf den Begriff, dessen Synonyme oder verwandte Begriffe Sie entfernen möchten.
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.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
Verknüpfungen zwischen Begriffen und Daten-Assets verwalten
Sie können Begriffe an Daten-Assets oder Daten-Asset-Spalten anhängen. Sie können beispielsweise einem BigQuery-Dataset Nutzungsbedingungen hinzufügen.
Bedingungen an ein Daten-Asset anhängen
Console
Rufen Sie in der Google Cloud -Console die Seite Suche des Dataplex Universal Catalog auf.
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.
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 wirdENTRY_LOCATION_ID
: die Standort-ID des Datenassets, mit dem verknüpft wirdENTRY_GROUP_ID
: die Eintragsgruppe des Daten-Assets, mit dem verknüpft wirdENTRY_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
Rufen Sie in der Google Cloud -Console die Seite Suche des Dataplex Universal Catalog auf.
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.
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 wirdENTRY_LOCATION_ID
: die Standort-ID des Datenassets, mit dem verknüpft wirdENTRY_GROUP_ID
: die Eintragsgruppe des Daten-Assets, mit dem verknüpft wirdENTRY_LINK_ID
: eine ID für die Verknüpfung zwischen dem Begriff und dem Dataplex Universal Catalog-Eintrag, der das Daten-Asset darstelltTERM_PROJECT_NUMBER
: die Projektnummer für den verknüpften BegriffCOLUMN_NAME
: Die Spalte, an die Sie den Begriff anhängen möchten
Begriffe aus einem Daten-Asset entfernen
Console
Rufen Sie in der Google Cloud -Console die Seite Suche des Dataplex Universal Catalog auf.
Suchen Sie nach dem Daten-Asset (z. B. Dataset, Datei oder Tabelle), aus dem Sie die Begriffe entfernen möchten, und klicken Sie darauf.
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.
Rufen Sie in der Google Cloud -Console die Seite Glossare des Dataplex Universal Catalog auf.
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 BegriffFinance
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 Ausdruckprofit
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 Datenverantwortlicheralex@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
Rufen Sie in der Google Cloud -Console die Seite Glossare des Dataplex Universal Catalog auf.
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.
Klicken Sie auf einen zugeordneten Begriff.
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.
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.
Glossare und Links zwischen Begriffen und Begriffen oder Daten-Assets importieren
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.
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 erstellenLOCATION_ID
: der Ort, an dem wir das Glossar erstellen möchtenGLOSSARY_ID
: die Glossar-IDDISPLAY_NAME
: Der Anzeigename des GlossarsDESCRIPTION
: die Beschreibung des Glossars
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 Formatdataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID
.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.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
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
durchdataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID
.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
durchdataplex.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
- Wenn Sie die Vorabversion des Geschäftsglossars für Data Catalog verwenden, lesen Sie den Abschnitt Umstellung auf das Geschäftsglossar in Dataplex Universal Catalog.