Mit Aspekten und Aspekttypen in Knowledge Catalog (früher Dataplex Universal Catalog) können Sie Einträgen, Spalten und Eintragslinks strukturierte Metadaten hinzufügen, um Ihre Daten-Assets und deren Beziehungen zu beschreiben. Dieser Kontext verbessert die Auffindbarkeit von Daten und hilft Ihnen, sensible Informationen wie personenidentifizierbare Informationen (PII) zu klassifizieren, um Datenqualitäts- oder Zugriffsrichtlinien anzuwenden.
Konzeptionelle Informationen zu Aspektschemas, System- und benutzerdefinierten Aspekttypen, Zielebenen und Einschränkungen für den Datenstandort finden Sie unter Aspekte und Aspekttypen. Eine Übersicht über die Architektur des gesamten Metadaten-Metamodells finden Sie unter Metadaten in Knowledge Catalog. Wenn Sie zum ersten Mal mit Knowledge Catalog-Metadaten arbeiten, lesen Sie die Kurzanleitungen Metadaten zu einer BigQuery-Tabelle hinzufügen oder Unternehmensglossar erstellen und verwenden.
Hinweis
Bevor Sie Aspekttypen und Aspekte erstellen und verwalten können, müssen Sie die in diesem Abschnitt beschriebenen Aufgaben ausführen.
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 Aspekttypen und Aspekten benötigen. Sie benötigen nicht alle diese Rollen gleichzeitig. Wählen Sie die Rolle oder Kombination aus, die zu Ihrem spezifischen Workflow passt:
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 Aspekttypen und Aspekten benötigen:
-
So verwalten Sie alle Katalogressourcen, einschließlich Aspekttypen und Einträgen, mit umfassendem Administratorzugriff:
Dataplex Catalog Admin (
roles/dataplex.catalogAdmin) oder Dataplex Catalog Editor (roles/dataplex.catalogEditor) -
Nur zum Erstellen und Verwalten benutzerdefinierter Aspekttypen mit Zugriff mit geringsten Berechtigungen für Aspekttyp-Administratoren:
Dataplex Aspect Type Owner (
roles/dataplex.aspectTypeOwner) -
Wenn Sie Aspekttypen beim Erstellen oder Ändern von Einträgen mit geringsten Berechtigungen für Datenkuratoren verwenden möchten:
Dataplex Aspect Type User (
roles/dataplex.aspectTypeUser) -
So hängen Sie wiederverwendbare Systemaspekttypen wie
schema,contactsundoverviewan Einträge und Eintragslinks an: Dataplex Entry and EntryLink Owner (roles/dataplex.entryOwner) -
Zum Aufrufen von Aspekttypen und ihren IAM-Richtlinien, ohne sie zu ändern:
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 Aspekttypen und Aspekten erforderlich sind. Maximieren Sie den Abschnitt Erforderliche Berechtigungen, um die notwendigen Berechtigungen anzuzeigen:
Erforderliche Berechtigungen
Die folgenden Berechtigungen sind erforderlich, um Aspekttypen und Aspekte zu erstellen und zu verwalten:
-
Aspekttypen erstellen, ansehen, auflisten, aktualisieren und löschen:
-
dataplex.aspectTypes.create -
dataplex.aspectTypes.get -
dataplex.aspectTypes.list -
dataplex.aspectTypes.update -
dataplex.aspectTypes.delete
-
-
Aspekttypen zum Anreichern von Einträgen verwenden:
dataplex.aspectTypes.use -
Einträge und ihre Aspekte erstellen, ansehen, aktualisieren und löschen:
-
dataplex.entries.create -
dataplex.entries.get -
dataplex.entries.list -
dataplex.entries.update -
dataplex.entries.delete
-
-
Eintragslinks und ihre Aspekte erstellen, ansehen, aktualisieren und löschen:
-
dataplex.entryLinks.create -
dataplex.entryLinks.get -
dataplex.entryLinks.list -
dataplex.entryLinks.update -
dataplex.entryLinks.delete
-
Sie können diese Berechtigungen auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.
Weitere Informationen finden Sie unter IAM-Rollen für Knowledge Catalog.
API aktivieren
Aktivieren Sie die Dataplex API in Ihrem Knowledge Catalog-Projekt. Wenn Sie ein neues Google Cloud -Projekt oder ein Projekt verwenden, in dem die BigQuery API aktiviert ist, ist die Dataplex API standardmäßig aktiviert.
Benutzerdefinierten Aspekttyp erstellen
Console
So erstellen Sie einen benutzerdefinierten Aspekttyp in der Google Cloud Console:
Grundlegende Details konfigurieren:
Rufen Sie in der Google Cloud Console die Seite Metadatentypen des Knowledge Catalog auf.
Klicken Sie auf den Tab Aspekttypen > Benutzerdefiniert und dann auf Aspekttyp erstellen.
Geben Sie im Abschnitt Details Folgendes ein:
- Optional: Anzeigename: Ein nutzerfreundlicher Name für den Aspekttyp.
- Aspekttyp-ID: Eine eindeutige Kennung für den Aspekttyp.
- Optional: Beschreibung: Eine Beschreibung des Aspekttyps und seines Zwecks.
- Standort: Wählen Sie einen Standort für den Aspekttyp aus. Sie können den Standort nach dem Erstellen nicht mehr ändern. Informationen zu den Vor- und Nachteilen globaler und regionaler Standorte finden Sie unter Benutzerdefinierte Aspekttypen.
Schemavorlage definieren:
Die Vorlage definiert das Format und das Schema der Metadatenfelder, die in Ihrem Aspekttyp gruppiert sind. Sie können Felder manuell definieren oder die Schemaerstellung beschleunigen, indem Sie eine Startvorlage aus der Vorlagengalerie auswählen, z. B. Datensensibilität, Data Governance oder Datenaufnahme. Wenn Sie beispielsweise die Vorlage Data Sensitivity auswählen, werden automatisch die booleschen Felder
Is EncryptedundHas PIIsowie das Enum-FeldPII Typehinzugefügt.So definieren Sie Felder manuell:
- Klicken Sie im Bereich Vorlage auf Feld hinzufügen.
- Geben Sie im Bereich Neues Feld Folgendes an:
- Name: Eine Kennung für das Feld.
- Optional: Anzeigename: Ein nutzerfreundliches Label.
- Optional: Beschreibung: Eine kurze Beschreibung des Felds.
- Typ: Wählen Sie den Felddatentyp aus. Zu den unterstützten Typen gehören Text, Ganzzahl, Boolesch, Datum und Uhrzeit, Double, Enum, Array, Map und Eintrag.
- Optional: Erforderlich: Aktivieren Sie dieses Kästchen, um das Feld als Pflichtfeld festzulegen, wenn Nutzer diesen Aspekt anhängen.
- Klicken Sie auf Fertig. Wenn Sie weitere Felder hinzufügen möchten, klicken Sie auf Feld hinzufügen und wiederholen Sie diese Schritte.
Ressourcenlabels hinzufügen und speichern:
Ressourcenlabels sind beliebige Schlüssel/Wert-Paare, mit denen Sie Ihre Google Cloud -Ressourcen organisieren und filtern können. Sie können Ressourcen beispielsweise nach Umgebung oder Teaminhaberschaft mit Labels wie
environment: productionoderteam: analyticsorganisieren.- Klicken Sie im Bereich Labels auf Label hinzufügen.
- Geben Sie den Schlüssel und den Wert für das Label ein.
- Klicken Sie auf Speichern.
gcloud
Verwenden Sie zum Erstellen eines benutzerdefinierten Aspekttyps den Befehl gcloud dataplex aspect-types
create.
C#
C#
Bevor Sie dieses Beispiel ausprobieren, folgen Sie der Einrichtungsanleitung für C# in der Knowledge Catalog-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der API-Referenzdokumentation zu Knowledge Catalog C#.
Richten Sie zur Authentifizierung bei Knowledge Catalog Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Go
Go
Bevor Sie dieses Beispiel ausprobieren, folgen Sie der Einrichtungsanleitung für Go in der Knowledge Catalog-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der API-Referenzdokumentation zu Knowledge Catalog Go.
Richten Sie zur Authentifizierung bei Knowledge Catalog Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Java
Java
Bevor Sie dieses Beispiel ausprobieren, folgen Sie der Einrichtungsanleitung für Java in der Knowledge Catalog-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der API-Referenzdokumentation zu Knowledge Catalog Java.
Richten Sie zur Authentifizierung bei Knowledge Catalog Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Node.js
Node.js
Bevor Sie dieses Beispiel ausprobieren, folgen Sie der Einrichtungsanleitung für Node.js in der Knowledge Catalog-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der API-Referenzdokumentation zu Knowledge Catalog Node.js.
Richten Sie zur Authentifizierung bei Knowledge Catalog Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Python
Python
Bevor Sie dieses Beispiel ausprobieren, folgen Sie der Einrichtungsanleitung für Python in der Knowledge Catalog-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der API-Referenzdokumentation zu Knowledge Catalog Python.
Richten Sie zur Authentifizierung bei Knowledge Catalog Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Ruby
Ruby
Bevor Sie dieses Beispiel ausprobieren, folgen Sie der Einrichtungsanleitung für Ruby in der Knowledge Catalog-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der API-Referenzdokumentation zu Knowledge Catalog Ruby.
Richten Sie zur Authentifizierung bei Knowledge Catalog Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
REST
Verwenden Sie zum Erstellen eines benutzerdefinierten Aspekttyps die Methode aspectType.create.
Nachdem Sie einen benutzerdefinierten Aspekttyp erstellt haben, können Sie Einträgen Aspekte hinzufügen.
Beispiel für die Verwendung der Felder „Datensatz-ID“ und „Datensatzreferenz“
Sie können die Felder Datensatz-ID und Datensatzreferenz für rekursive Referenzen verwenden. Das folgende Beispiel zeigt, wie diese Felder verwendet werden:
Betrachten Sie einen Aspekttyp namens Employee mit den folgenden Feldern:
- Name (Typ:
Text) - Startdatum (Typ:
Date & time) - Designation (Typ:
Text) - Aktuelle Adresse (Typ:
Record) - Ständige Anschrift (Typ:
Record)
Die beiden Adressfelder Current address und Permanent address haben denselben Datentyp Record. Um Duplikate zu vermeiden, können Sie beim Definieren dieser Felder die Werte Datensatz-ID und Datensatzreferenz festlegen.
Wenn Sie das Feld Aktuelle Adresse definieren, können Sie Eintrags-ID als address-field angeben. Für Ständige Adresse können Sie denselben Wert (address-field) für Eintragsreferenz angeben. Beispiel:
- Name (Typ:
Text) - Startdatum (Typ:
Date & time) - Designation (Typ:
Text) - Aktuelle Adresse (Typ:
Record, Eintrags-ID:address-field) - Ständige Anschrift (Typ:
Record, Datensatzreferenz:address-field)
So müssen Sie die Felder einer anderen Adresse nicht duplizieren.
Aspekte zu einem Eintrag hinzufügen
Nachdem Sie einen benutzerdefinierten Aspekttyp erstellt haben, können Sie Aspekte dieses Typs erstellen. Wenn Sie einem Eintrag Aspekte hinzufügen möchten, müssen Sie den Eintrag aktualisieren, da Aspekte in Einträgen gespeichert werden.
Beachten Sie die folgenden Beschränkungen:
- Sie können einem Eintrag oder den Spalten eines Eintrags Aspekte hinzufügen.
- Sie können die erforderlichen Aspekte nur für benutzerdefinierte Einträge bearbeiten. Die erforderlichen Aspekte können nicht gelöscht werden.
- Sie können die optionalen Aspekte sowohl für benutzerdefinierte Einträge als auch für Systemeinträge bearbeiten und löschen.
- Wenn Sie eine BigQuery-Tabelle mit einer
CREATE OR REPLACE TABLE-Anweisung, einerTRUNCATE TABLE-Anweisung oder einemWRITE_TRUNCATE-Job ersetzen oder neu laden, behält Knowledge Catalog die vom Nutzer angehängten Aspekte des Eintrags bei. Aspekte auf Spaltenebene werden auch für Spalten beibehalten, die im Schema verbleiben. Wenn Sie jedoch eine Tabelle mit einerDROP TABLE-Anweisung und einerCREATE TABLE-Anweisung löschen und neu erstellen, erstellt Knowledge Catalog einen neuen Eintrag ohne die vom Nutzer angehängten Aspekte der ursprünglichen Tabelle. Wenn Sie Aspekte beim Aktualisieren einer Tabelle beibehalten möchten, verwenden SieCREATE OR REPLACE TABLE,TRUNCATE TABLEoderWRITE_TRUNCATE. Alternativ können Sie eine BigQuery-Ansicht erstellen und Aspekte an die Ansicht anhängen.
Console
Rufen Sie in der Google Cloud Console die Seite Suchen im Knowledge Catalog auf.
Suchen Sie nach dem Eintrag, dem Sie Aspekte hinzufügen möchten, und klicken Sie darauf. Die Seite mit den Eintragsdetails wird geöffnet.
Klicken Sie auf der Seite mit den Eintragsdetails auf den Tab Details.
Klicken Sie im Abschnitt Aspekte im Bereich Erforderliche Aspekte oder Optionale Aspekte auf Hinzufügen. Sie können erforderliche Aspekte nur hinzufügen, wenn der Eintragstyp erforderliche Aspekte definiert.
Suchen Sie nach dem Aspekt, den Sie hinzufügen möchten, und wählen Sie ihn aus.
Geben Sie im Fenster Aspekt hinzufügen die Werte für die Felder ein.
Klicken Sie auf Speichern.
So fügen Sie einer Spalte des Eintrags Aspekte hinzu:
- Klicken Sie auf der Seite mit den Eintragsdetails auf den Tab Schema.
- Wählen Sie die Spalten aus, denen Sie Aspekte hinzufügen möchten.
- Klicken Sie auf Aspekt hinzufügen.
- Suchen Sie nach dem Aspekt, den Sie hinzufügen möchten, und wählen Sie ihn aus.
- Geben Sie im Fenster Aspekt hinzufügen die Werte für die Felder ein.
- Klicken Sie auf Speichern.
gcloud
Verwenden Sie den Befehl gcloud
dataplex entries update, um einem Eintrag oder einer Spalte eines Eintrags Aspekte hinzuzufügen.
C#
C#
Bevor Sie dieses Beispiel ausprobieren, folgen Sie der Einrichtungsanleitung für C# in der Knowledge Catalog-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der API-Referenzdokumentation zu Knowledge Catalog C#.
Richten Sie zur Authentifizierung bei Knowledge Catalog Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Informationen zum Hinzufügen von Aspekten zum Eintragsobjekt finden Sie unter Aspekte.
Go
Go
Bevor Sie dieses Beispiel ausprobieren, folgen Sie der Einrichtungsanleitung für Go in der Knowledge Catalog-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der API-Referenzdokumentation zu Knowledge Catalog Go.
Richten Sie zur Authentifizierung bei Knowledge Catalog Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Informationen zum Hinzufügen von Aspekten zum Eintragsobjekt finden Sie unter Eintrag.
Java
Java
Bevor Sie dieses Beispiel ausprobieren, folgen Sie der Einrichtungsanleitung für Java in der Knowledge Catalog-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der API-Referenzdokumentation zu Knowledge Catalog Java.
Richten Sie zur Authentifizierung bei Knowledge Catalog Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Node.js
Node.js
Bevor Sie dieses Beispiel ausprobieren, folgen Sie der Einrichtungsanleitung für Node.js in der Knowledge Catalog-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der API-Referenzdokumentation zu Knowledge Catalog Node.js.
Richten Sie zur Authentifizierung bei Knowledge Catalog Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Python
Python
Bevor Sie dieses Beispiel ausprobieren, folgen Sie der Einrichtungsanleitung für Python in der Knowledge Catalog-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der API-Referenzdokumentation zu Knowledge Catalog Python.
Richten Sie zur Authentifizierung bei Knowledge Catalog Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Ruby
Ruby
Bevor Sie dieses Beispiel ausprobieren, folgen Sie der Einrichtungsanleitung für Ruby in der Knowledge Catalog-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der API-Referenzdokumentation zu Knowledge Catalog Ruby.
Richten Sie zur Authentifizierung bei Knowledge Catalog Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Informationen zum Hinzufügen von Aspekten zum Eintragsobjekt finden Sie unter #required_aspects=.
REST
Verwenden Sie die Methode entry.patch, um einem Eintrag oder einer Spalte eines Eintrags Aspekte hinzuzufügen.
Das Erstellen und Verwenden von Aspekten in einem Eintrag, bei dem sich der jeweilige Aspekttyp und der Eintrag in verschiedenen Google Cloud -Organisationen befinden, wird nicht unterstützt.
Aspekte wiederverwendbarer Systemaspekttypen anhängen
Knowledge Catalog bietet vordefinierte Systemaspekttypen, die Sie an Einträge anhängen können, um standardisierte Metadaten zu erfassen. Mit diesen Aspekttypen können Sie beispielsweise Kontakte für die Eigentümerschaft, Schemadefinitionen, Nutzungsmesswerte und Ergebnisse zur Datenqualität erfassen.
Allgemeine Workflow- und Nutzlastregeln
Beachten Sie beim Anhängen von Aspekten wiederverwendbarer Systemaspekttypen die folgenden Regeln:
- Console im Vergleich zu CLI/REST: Für Aspekttypen ohne verschachtelte Felder, z. B.
generic, können Sie die Google Cloud Console, diegcloud-CLI oder die REST API verwenden. Für Aspekttypen mit komplexen oder verschachtelten Strukturen wiedata-quality-scorecard,contactsoderdata-profilemüssen Sie diegcloud-CLI oder die REST API verwenden. - Nutzlaststruktur:
gcloud-CLI: Übergeben Sie die Aspektzuordnung direkt, mit dem globalen Aspekttyp-ID als Schlüssel:{"dataplex-types.global.<ASPECT_TYPE>": {"data": { ... }}}.- REST API: Verpacken Sie die Aspektzuordnung in ein
"aspects"-Containerobjekt:{"aspects": {"dataplex-types.global.<ASPECT_TYPE>": {"data": { ... }}}}.
- Überschreibungsverhalten: Wenn Sie einen Aspekt aktualisieren, werden alle vorhandenen Daten für diesen bestimmten Aspekttyp im Zieleintrag oder in der Zielspalte ersetzt. Felder werden nicht zusammengeführt.
In den folgenden Abschnitten finden Sie Beispiele und Schemas zum Anhängen gängiger wiederverwendbarer Systemaspekte, beginnend mit der Datenqualitäts-Scorecard.
Scorecard zur Datenqualität
Eine Scorecard zur Datenqualität bietet eine Zusammenfassung der Datenqualität, die oft auf Datenqualitätsscans oder anderen Prozessen basiert. Sie können einem Eintrag eine Datenqualitäts-Scorecard hinzufügen, um benutzerdefinierte Informationen zur Datenqualität bereitzustellen. Hängen Sie dazu einen Aspekt des systemdefinierten Typs data-quality-scorecard an.
Das Feld data im Aspekt data-quality-scorecard kann die folgenden Felder enthalten:
job: Optional. Ein Eintrag mit Details zum Job, der die Übersicht generiert hat.name: Der Ressourcenname des Datenqualitätsjobs.runTime: Die Laufzeit des Datenqualitätsjobs.
score: Optional. Der allgemeine Datenqualitätsfaktor. Der Wert liegt zwischen [0, 100].status: erforderlich. Der Status der Datenqualitäts-Scorecard, der angibt, ob der Qualitätsschwellenwert erreicht wurde (PASSoderFAIL).dimensions: Optional. Ein Array von Dimensionsergebnissen. Jedes Ergebnis enthält Folgendes:name: Der Name der Dimension. Dies kannACCURACY,COMPLETENESS,CONSISTENCY,FRESHNESS,UNIQUENESS,VALIDITYoderVOLUMEoder ein benutzerdefinierter Dimensionsname sein. Namen benutzerdefinierter Dimensionen müssen Großbuchstaben enthalten und dürfen maximal 30 Zeichen lang sein.score: Der Gesamtpunktwert auf Dimensionsebene im Bereich von [0, 100].status: Der Status der Dimension, der angibt, ob sie den Qualitätsschwellenwert (PASSoderFAIL) erreicht hat oder nicht.
columns: Optional. Ein Array von Spaltenergebnissen. Jedes Ergebnis enthält Folgendes:name: Der Name der Spalte.score: Die Gesamtbewertung auf Spaltenebene im Bereich von [0, 100].status: Der Status der Spalte, der angibt, ob sie den Qualitätsschwellenwert erreicht hat oder nicht (PASSoderFAIL).dimensions: Ein Array von Dimensionswerten für die Spalte. Jede Dimensionsbewertung umfasst Folgendes:name: Der Name der Dimension.score: Der Wert für die Dimension im Bereich [0, 100].status: Der Status der Dimension für die Spalte, der angibt, ob sie den Qualitätsschwellenwert erreicht hat oder nicht (PASS,FAIL,UNKNOWNoderNOT_APPLICABLE).
details(optionale Zuordnung): Schlüssel/Wert-Paare, die zusätzlichen Kontext zur Bewertung liefern.evaluatedAssetCount(optionaler Ganzzahlwert): Die Anzahl der bewerteten Assets.
Wenn Sie den Befehl zum Anhängen eines Aspekts ausführen, werden alle vorhandenen Daten für diesen bestimmten Aspekt ersetzt. Wenn Sie beispielsweise eine Scorecard mit dem Wert 80 mit einer neuen Datei aktualisieren, die den Wert 90 hat, wird der Wert 80 überschrieben. Die Daten werden nicht zusammengeführt.
So hängen Sie eine Datenqualitäts-Scorecard an:
gcloud
Verwenden Sie den Befehl gcloud dataplex entries
update-aspects, um Aspekte für einen Eintrag zu aktualisieren.
Erstellen Sie eine JSON-Datei (
dq-aspect.json) mit folgendem Inhalt.{ "dataplex-types.global.data-quality-scorecard": { "data": { "score": 80, "status": "PASS", "dimensions": [ { "name": "completeness", "score": 90, "status": "PASS" }, { "name": "uniqueness", "score": 70, "status": "FAIL" } ], "columns": [ { "name": "col1", "score": 85, "status": "PASS" } ] } } }Führen Sie dazu diesen Befehl aus:
gcloud dataplex entries update-aspects ENTRY_ID \ --location=LOCATION \ --entry-group=ENTRY_GROUP_ID \ --project=PROJECT_ID \ --aspects=dq-aspect.json
Ersetzen Sie die folgenden Variablen:
ENTRY_ID: die ID des Eintrags, z. B.example-entryLOCATION: der Standort des Eintrags, z. B.us-central1ENTRY_GROUP_ID: die ID der Eintraggruppe, z. B.example-entry-groupPROJECT_ID: die ID des Projekts, z. B.example-project
REST
Verwenden Sie die Methode entry.patch, um Aspekte für einen Eintrag zu aktualisieren.
Erstellen Sie eine Datei mit dem Namen
payload.jsonund fügen Sie den JSON-Inhalt aus Ihrer Anfrage ein.{ "aspects": { "dataplex-types.global.data-quality-scorecard": { "data": { "score": 80, "status": "PASS", "dimensions": [ { "name": "completeness", "score": 90, "status": "PASS" }, { "name": "uniqueness", "score": 70, "status": "FAIL" } ], "columns": [ { "name": "col1", "score": 85, "status": "PASS" } ] } } } }Führen Sie diesen Befehl im Terminal aus:
curl -X PATCH \ -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ -d @payload.json \ "https://dataplex.googleapis.com/v1/projects/<var>PROJECT_ID</var>/locations/<var>LOCATION</var>/entryGroups/<var>ENTRY_GROUP_ID</var>/entries/<var>ENTRY_ID</var>?updateMask=aspects"Ersetzen Sie Folgendes:
PROJECT_ID: die ID des Projekts, z. B.example-projectLOCATION: der Standort des Eintrags, z. B.us-central1ENTRY_GROUP_ID: die ID der Eintraggruppe, z. B.example-entry-groupENTRY_ID: die ID des Eintrags, z. B.example-entry
Andere wiederverwendbare Aspekttypen
Die folgenden Systemaspekttypen sind ebenfalls für die Anreicherung von Einträgen verfügbar. Die Zusammenfassungen am Anfang sind in den folgenden Abschnitten aufgeführt. Klicken Sie auf die einzelnen maximierbaren Abschnitte, um Feldschemas und JSON-Beispielnutzlasten aufzurufen.
Kontakte (dataplex-types.global.contacts)
Verwenden Sie den Aspekttyp contacts, um Einträgen Eigentums-, Verwaltungs- oder Betriebsrollen zuzuweisen.
identities(Array): Eine Liste von Kontakten. Jeder Kontakt enthältrole(z. B.owner,steward,produceroderadmin),nameundid(E‑Mail-Adresse).
Beispielnutzlast (REST API):
{ "aspects": { "dataplex-types.global.contacts": { "data": { "identities": [ { "role": "steward", "name": "Jane Doe", "id": "jane.doe@example.com" } ] } } } }
Datenprofil (dataplex-types.global.data-profile)
Verwenden Sie den Aspekttyp data-profile, um statistische Profilergebnisse zu erfassen, die aus Scans von Quelldaten generiert wurden. Weitere Informationen finden Sie unter Datenprofilerstellung.
sourceDataInfo(Eintrag): Metadaten zum Scan, einschließlichscope(PREVIEW,SAMPLEDoderALL),scannedRowsundsamplingPercentage.fields(Zuordnung): Statistiken auf Spaltenebene, einschließlichnullness,uniquenessund typspezifischer Messwerte für numerische, String-, Datetime- und Array-Spalten.
Beispielnutzlast (REST API):
{ "aspects": { "dataplex-types.global.data-profile": { "data": { "sourceDataInfo": { "scope": "ALL", "scannedRows": 100 }, "fields": { "col1": { "nullness": 0.0, "uniqueness": 0.1, "string": { "length": { "min": 1, "max": 20, "avg": 12.54 } } } } } } } }
Allgemein (dataplex-types.global.generic)
Verwenden Sie den Aspekttyp generic, um Freiform-Eintragsinformationen und Metadaten des Quellsystems zu erfassen, ohne ein benutzerdefiniertes Aspektschema zu definieren.
type(String): Ein vom Nutzer angegebener String zur Kategorisierung des Eintrags.system(String): Die Quellsystem-ID des benutzerdefinierten Eintrags.
Beispielnutzlast (REST API):
{ "aspects": { "dataplex-types.global.generic": { "data": { "type": "custom-type", "system": "custom-system" } } } }
Übersicht (dataplex-types.global.overview)
Verwenden Sie den Aspekttyp overview, um menschenlesbare RTF-Dokumentation und hilfreiche externe Links bereitzustellen.
content(String): RTF-Beschreibung, die HTML-Formatierung unterstützt.links(Array): Externe Ressourcen und Dokumentlinks, die jeweilsurlundtitleenthalten.
Beispielnutzlast (REST API):
{ "aspects": { "dataplex-types.global.overview": { "data": { "content": "This is a rich text description.", "links": [ { "url": "https://example.com", "title": "Example Link" } ] } } } }
Schema (dataplex-types.global.schema)
Verwenden Sie den Aspekttyp schema, um das tabellarische Schema, die Spaltennamen, die Modi und die Datentypen von Daten-Assets zu beschreiben.
fields(Array): Liste der Spalten, die jeweilsname,dataType,metadataType(z. B.STRING,BOOLEAN),mode(NULLABLE,REQUIRED,REPEATED) und optionaldescriptionenthalten.
Beispielnutzlast (REST API):
{ "aspects": { "dataplex-types.global.schema": { "data": { "fields": [ { "name": "id", "dataType": "string", "metadataType": "STRING", "mode": "REQUIRED" } ] } } } }
Nutzung (dataplex-types.global.usage)
Verwenden Sie den Aspekttyp usage, um Verbrauchsmesswerte, Aufrufzahlen und Zeitreihen-Abfragemuster zu verfolgen.
metrics(Array): Verbrauchsmesswerte, die jeweilsname(z. B.viewsoderreads) undtimeSeries-Datenpunkte mit Aggregationsintervallen und Werten enthalten.refreshTime(datetime): Zeitstempel, der angibt, wann die Nutzungsmesswerte zuletzt berechnet wurden.
Beispielnutzlast (REST API):
{ "aspects": { "dataplex-types.global.usage": { "data": { "metrics": [ { "name": "views", "timeSeries": [ { "interval": "30d", "value": 100 } ] } ], "refreshTime": "2025-01-01T12:00:00Z" } } } }
Eintragslink erstellen
Sie können eine Beziehung zwischen zwei Einträgen herstellen, indem Sie einen Eintragslink erstellen.
Ein Eintragslink kann symmetrisch sein, z. B. ein synonym, oder asymmetrisch, z. B. ein definition.
C#
C#
Bevor Sie dieses Beispiel ausprobieren, folgen Sie der Einrichtungsanleitung für C# in der Knowledge Catalog-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der API-Referenzdokumentation zu Knowledge Catalog C#.
Richten Sie zur Authentifizierung bei Knowledge Catalog Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Go
Go
Bevor Sie dieses Beispiel ausprobieren, folgen Sie der Einrichtungsanleitung für Go in der Knowledge Catalog-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der API-Referenzdokumentation zu Knowledge Catalog Go.
Richten Sie zur Authentifizierung bei Knowledge Catalog Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Java
Java
Bevor Sie dieses Beispiel ausprobieren, folgen Sie der Einrichtungsanleitung für Java in der Knowledge Catalog-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der API-Referenzdokumentation zu Knowledge Catalog Java.
Richten Sie zur Authentifizierung bei Knowledge Catalog Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Node.js
Node.js
Bevor Sie dieses Beispiel ausprobieren, folgen Sie der Einrichtungsanleitung für Node.js in der Knowledge Catalog-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der API-Referenzdokumentation zu Knowledge Catalog Node.js.
Richten Sie zur Authentifizierung bei Knowledge Catalog Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Python
Python
Bevor Sie dieses Beispiel ausprobieren, folgen Sie der Einrichtungsanleitung für Python in der Knowledge Catalog-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der API-Referenzdokumentation zu Knowledge Catalog Python.
Richten Sie zur Authentifizierung bei Knowledge Catalog Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
REST
Wenn Sie einen Eintragslink mit dem erforderlichen Aspekt erstellen möchten, verwenden Sie die Methode entryLinks.create und fügen Sie die Aspektdaten in den Anfragetext ein.
Aspekte zu einem Eintragslink hinzufügen
Wenn Sie Metadaten mit Informationen zu Beziehungen zwischen den Einträgen anreichern möchten, fügen Sie den Eintragslinks Aspekte hinzu.
Sie können Eintragstypen so konfigurieren, dass ein bestimmter Aspekt erforderlich ist. Wenn Sie einen Eintragslink dieses Typs erstellen, müssen Sie den erforderlichen Aspekt angeben.
Sie können diese Aspekte hinzufügen, wenn Sie einen Eintragslink erstellen oder einen vorhandenen Eintragslink aktualisieren:
C#
C#
Bevor Sie dieses Beispiel ausprobieren, folgen Sie der Einrichtungsanleitung für C# in der Knowledge Catalog-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der API-Referenzdokumentation zu Knowledge Catalog C#.
Richten Sie zur Authentifizierung bei Knowledge Catalog Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Go
Go
Bevor Sie dieses Beispiel ausprobieren, folgen Sie der Einrichtungsanleitung für Go in der Knowledge Catalog-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der API-Referenzdokumentation zu Knowledge Catalog Go.
Richten Sie zur Authentifizierung bei Knowledge Catalog Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Java
Java
Bevor Sie dieses Beispiel ausprobieren, folgen Sie der Einrichtungsanleitung für Java in der Knowledge Catalog-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der API-Referenzdokumentation zu Knowledge Catalog Java.
Richten Sie zur Authentifizierung bei Knowledge Catalog Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Node.js
Node.js
Bevor Sie dieses Beispiel ausprobieren, folgen Sie der Einrichtungsanleitung für Node.js in der Knowledge Catalog-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der API-Referenzdokumentation zu Knowledge Catalog Node.js.
Richten Sie zur Authentifizierung bei Knowledge Catalog Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Python
Python
Bevor Sie dieses Beispiel ausprobieren, folgen Sie der Einrichtungsanleitung für Python in der Knowledge Catalog-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der API-Referenzdokumentation zu Knowledge Catalog Python.
Richten Sie zur Authentifizierung bei Knowledge Catalog Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
REST
Wenn Sie einen Eintragslink aktualisieren möchten, verwenden Sie die Methode entryLinks.patch und fügen Sie die Aspektdaten in den entryLink-Text ein.
Beachten Sie die folgenden Einschränkungen für die Verwendung von Aspekten mit Eintragslinks:
- Optionale Aspekte werden nicht unterstützt.
- Datenaspekte werden nicht unterstützt.
- Aspekte benutzerdefinierter Typen werden nicht unterstützt.
- Sie können nur erforderliche Aspekte verwalten, die durch Systemaspekttypen definiert sind, z. B.
schema-join. - Die Suche nach Eintragslinks anhand des Inhalts ihrer Aspekte wird nicht unterstützt.
- Das Importieren oder Exportieren von Eintragsverknüpfungsaspekten wird nicht unterstützt.
Vorhandene Aspekte für einen Eintrag verwalten
In diesem Abschnitt wird beschrieben, wie Sie die vorhandenen Aspekte für einen Eintrag aktualisieren und löschen.
Aspekt aktualisieren
Sie können die optionalen Aspekte sowohl für benutzerdefinierte Einträge als auch für Systemeinträge bearbeiten. Sie können die erforderlichen Aspekte nur für benutzerdefinierte Einträge bearbeiten.
Bei Erstanbieter-Systemeinträgen (1P) wie BigQuery-Tabellen können Sie Aspekte mit der modifyEntry API aktualisieren. So können Sie die Berechtigungen zum Aktualisieren von Metadaten des Quellsystems verwenden (z. B. BigQuery-Datenbearbeiter (roles/bigquery.dataEditor)).
Console
Rufen Sie in der Google Cloud Console die Seite Suchen im Knowledge Catalog auf.
Suchen Sie nach dem Eintrag, dessen Aspekte Sie aktualisieren möchten, und klicken Sie darauf.
Die Seite mit den Eintragsdetails wird geöffnet.
- Klicken Sie auf den Tab Details.
- Maximieren Sie im Abschnitt Aspekte den Aspekt, den Sie aktualisieren möchten, und klicken Sie auf Bearbeiten.
- Aktualisieren Sie im Fenster Aspekt bearbeiten die erforderlichen Felder.
- Klicken Sie auf Speichern.
gcloud
Wenn Sie Aspekte für einen Eintrag oder eine Spalte eines Eintrags aktualisieren möchten, verwenden Sie den gcloud
dataplex entries update-Befehl oder gcloud dataplex entries update-aspects.
So aktualisieren Sie Aspekte mithilfe einer JSON-Datei:
gcloud dataplex entries update-aspects ENTRY_ID \ --location=LOCATION \ --entry-group=ENTRY_GROUP_ID \ --project=PROJECT_ID \ --aspects=ASPECTS_JSON_FILE
Ersetzen Sie Folgendes:
ENTRY_ID: die ID des Eintrags.LOCATION: der Speicherort des Eintrags.ENTRY_GROUP_ID: die ID der Eintragsgruppe.PROJECT_ID: die ID des Projekts.ASPECTS_JSON_FILE: der Pfad zur JSON-Datei, die die Aspektzuordnung enthält.
C#
C#
Bevor Sie dieses Beispiel ausprobieren, folgen Sie der Einrichtungsanleitung für C# in der Knowledge Catalog-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der API-Referenzdokumentation zu Knowledge Catalog C#.
Richten Sie zur Authentifizierung bei Knowledge Catalog Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Go
Go
Bevor Sie dieses Beispiel ausprobieren, folgen Sie der Einrichtungsanleitung für Go in der Knowledge Catalog-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der API-Referenzdokumentation zu Knowledge Catalog Go.
Richten Sie zur Authentifizierung bei Knowledge Catalog Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Java
Java
Bevor Sie dieses Beispiel ausprobieren, folgen Sie der Einrichtungsanleitung für Java in der Knowledge Catalog-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der API-Referenzdokumentation zu Knowledge Catalog Java.
Richten Sie zur Authentifizierung bei Knowledge Catalog Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Node.js
Node.js
Bevor Sie dieses Beispiel ausprobieren, folgen Sie der Einrichtungsanleitung für Node.js in der Knowledge Catalog-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der API-Referenzdokumentation zu Knowledge Catalog Node.js.
Richten Sie zur Authentifizierung bei Knowledge Catalog Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Python
Python
Bevor Sie dieses Beispiel ausprobieren, folgen Sie der Einrichtungsanleitung für Python in der Knowledge Catalog-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der API-Referenzdokumentation zu Knowledge Catalog Python.
Richten Sie zur Authentifizierung bei Knowledge Catalog Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Ruby
Ruby
Bevor Sie dieses Beispiel ausprobieren, folgen Sie der Einrichtungsanleitung für Ruby in der Knowledge Catalog-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der API-Referenzdokumentation zu Knowledge Catalog Ruby.
Richten Sie zur Authentifizierung bei Knowledge Catalog Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
REST
Verwenden Sie die Methode entry.patch, um Aspekte für einen Eintrag oder eine Spalte eines Eintrags zu aktualisieren.
Aspekt löschen
Console
Rufen Sie in der Google Cloud Console die Seite Suchen im Knowledge Catalog auf.
Suchen Sie nach dem Eintrag, dessen Aspekte Sie löschen möchten, und klicken Sie darauf.
Die Seite mit den Eintragsdetails wird geöffnet.
- Klicken Sie auf den Tab Details.
- Maximieren Sie im Bereich Aspekte den Aspekt, den Sie löschen möchten, und klicken Sie auf Löschen.
- Klicken Sie auf Bestätigen.
gcloud
Wenn Sie einen Aspekt für einen Eintrag löschen möchten, verwenden Sie den Befehl gcloud dataplex entries update mit dem Flag --remove-aspects.
So löschen Sie einen Aspekt auf Einstiegsebene:
gcloud dataplex entries update ENTRY_ID \ --location=LOCATION \ --entry-group=ENTRY_GROUP_ID \ --project=PROJECT_ID \ --remove-aspects='ASPECT_TYPE'
So löschen Sie einen Aspekt auf Spaltenebene:
gcloud dataplex entries update ENTRY_ID \ --location=LOCATION \ --entry-group=ENTRY_GROUP_ID \ --project=PROJECT_ID \ --remove-aspects='ASPECT_TYPE@Schema.COLUMN_NAME'
Ersetzen Sie Folgendes:
ENTRY_ID: die ID des Eintrags.LOCATION: der Speicherort des Eintrags.ENTRY_GROUP_ID: die ID der Eintragsgruppe.PROJECT_ID: die ID des Projekts.ASPECT_TYPE: die vollständige Kennung des Aspekttyps, z. B.dataplex-types.global.genericoder<var>PROJECT_ID</var>.<var>LOCATION</var>.<var>ASPECT_TYPE_ID</var>.COLUMN_NAME: Der Name der Spalte
C#
C#
Bevor Sie dieses Beispiel ausprobieren, folgen Sie der Einrichtungsanleitung für C# in der Knowledge Catalog-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der API-Referenzdokumentation zu Knowledge Catalog C#.
Richten Sie zur Authentifizierung bei Knowledge Catalog Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Go
Go
Bevor Sie dieses Beispiel ausprobieren, folgen Sie der Einrichtungsanleitung für Go in der Knowledge Catalog-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der API-Referenzdokumentation zu Knowledge Catalog Go.
Richten Sie zur Authentifizierung bei Knowledge Catalog Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Java
Java
Bevor Sie dieses Beispiel ausprobieren, folgen Sie der Einrichtungsanleitung für Java in der Knowledge Catalog-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der API-Referenzdokumentation zu Knowledge Catalog Java.
Richten Sie zur Authentifizierung bei Knowledge Catalog Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Node.js
Node.js
Bevor Sie dieses Beispiel ausprobieren, folgen Sie der Einrichtungsanleitung für Node.js in der Knowledge Catalog-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der API-Referenzdokumentation zu Knowledge Catalog Node.js.
Richten Sie zur Authentifizierung bei Knowledge Catalog Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Python
Python
Bevor Sie dieses Beispiel ausprobieren, folgen Sie der Einrichtungsanleitung für Python in der Knowledge Catalog-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der API-Referenzdokumentation zu Knowledge Catalog Python.
Richten Sie zur Authentifizierung bei Knowledge Catalog Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Ruby
Ruby
Bevor Sie dieses Beispiel ausprobieren, folgen Sie der Einrichtungsanleitung für Ruby in der Knowledge Catalog-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der API-Referenzdokumentation zu Knowledge Catalog Ruby.
Richten Sie zur Authentifizierung bei Knowledge Catalog Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
REST
Wenn Sie einen Aspekt für einen Eintrag löschen möchten, verwenden Sie die Methode entry.patch.
Vorhandene Aspekte für einen Eintragslink verwalten
In diesem Abschnitt wird beschrieben, wie Sie die vorhandenen Aspekte für einen Eintragslink aktualisieren.
Aspekt aktualisieren
Bei Eintragslinks können Sie nur erforderliche Aspekte aktualisieren, die wiederverwendbare Systemaspekttypen verwenden.
Weitere Informationen finden Sie unter IAM-Berechtigungen für Vorgänge mit Eintragslinks.
REST
Wenn Sie einen Eintragslink mit dem erforderlichen Aspekt aktualisieren möchten, verwenden Sie die Methode entryLinks.patch und fügen Sie die Aspektdaten in den Anfragetext ein.
Aspekt löschen
Sie können den erforderlichen Aspekt für einen Eintragslink nicht löschen.
Aspekttypen verwalten
In diesem Abschnitt wird beschrieben, wie Sie Aspekttypen aufrufen und benutzerdefinierte Aspekttypen aktualisieren und löschen.
Liste der verfügbaren Aspekttypen ansehen
Console
Rufen Sie in der Google Cloud Console die Seite Metadatentypen des Knowledge Catalog auf.
Klicken Sie auf den Tab Aspekttypen.
Auf dieser Seite sind alle verfügbaren Knowledge Catalog-Aspekttypen aufgeführt.
- Klicken Sie auf den Tab Benutzerdefiniert, um benutzerdefinierte Aspekttypen aufzurufen. Auf dem Tab Benutzerdefiniert wird in der Spalte Katalogquelle angezeigt, wo sich die Ressource im Knowledge Catalog befindet.
Klicken Sie auf den Tab System, um die Systemaspekttypen aufzurufen.
Weitere Informationen zu benutzerdefinierten und Systemaspekttypen finden Sie im Abschnitt Kategorien von Aspekttypen in diesem Dokument.
- Optional: Wenn Sie die Liste der Aspekttypen in Ihrem ausgewählten Projekt aufrufen möchten, klicken Sie auf den Tab Benutzerdefiniert und deaktivieren Sie dann die Option Aus allen Projekten anzeigen.
Die Ein/Aus-Schaltfläche Aus allen Projekten anzeigen ist standardmäßig aktiviert und die Liste enthält Knowledge Catalog-Ressourcen aus der ausgewählten Organisation.
gcloud
Verwenden Sie den Befehl gcloud dataplex
aspect-types list, um alle verfügbaren Aspekttypen aufzulisten.
C#
C#
Bevor Sie dieses Beispiel ausprobieren, folgen Sie der Einrichtungsanleitung für C# in der Knowledge Catalog-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der API-Referenzdokumentation zu Knowledge Catalog C#.
Richten Sie zur Authentifizierung bei Knowledge Catalog Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Go
Go
Bevor Sie dieses Beispiel ausprobieren, folgen Sie der Einrichtungsanleitung für Go in der Knowledge Catalog-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der API-Referenzdokumentation zu Knowledge Catalog Go.
Richten Sie zur Authentifizierung bei Knowledge Catalog Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Java
Java
Bevor Sie dieses Beispiel ausprobieren, folgen Sie der Einrichtungsanleitung für Java in der Knowledge Catalog-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der API-Referenzdokumentation zu Knowledge Catalog Java.
Richten Sie zur Authentifizierung bei Knowledge Catalog Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Node.js
Node.js
Bevor Sie dieses Beispiel ausprobieren, folgen Sie der Einrichtungsanleitung für Node.js in der Knowledge Catalog-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der API-Referenzdokumentation zu Knowledge Catalog Node.js.
Richten Sie zur Authentifizierung bei Knowledge Catalog Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Python
Python
Bevor Sie dieses Beispiel ausprobieren, folgen Sie der Einrichtungsanleitung für Python in der Knowledge Catalog-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der API-Referenzdokumentation zu Knowledge Catalog Python.
Richten Sie zur Authentifizierung bei Knowledge Catalog Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Ruby
Ruby
Bevor Sie dieses Beispiel ausprobieren, folgen Sie der Einrichtungsanleitung für Ruby in der Knowledge Catalog-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der API-Referenzdokumentation zu Knowledge Catalog Ruby.
Richten Sie zur Authentifizierung bei Knowledge Catalog Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
REST
Verwenden Sie die Methode aspectTypes.list, um alle verfügbaren Aspekttypen aufzulisten.
Details eines Aspekttyps ansehen
Console
Rufen Sie in der Google Cloud Console die Seite Metadatentypen des Knowledge Catalog auf.
Klicken Sie auf den Tab Aspekttypen.
Wenn Sie die Details eines Knowledge Catalog-Aspekttyps aufrufen möchten, klicken Sie auf den Aspekttyp. Die Detailseite des Aspekttyps wird geöffnet. Dort können Sie auf Details wie Anzeigename, Aspekttyp-ID, Beschreibung, Projekt-ID, Standort, Labels, Erstellungsdatum und Datum der letzten Änderung zugreifen.
- Klicken Sie auf den Tab Vorlage, um die Struktur des ausgewählten Aspekttyps aufzurufen.
- Klicken Sie auf den Tab Beispieleinträge, um die Liste der 10 kürzlich erstellten zugehörigen Einträge aufzurufen.
- Wenn Sie nach allen zugehörigen Einträgen suchen möchten, klicken Sie auf Alle verwandten Einträge in der Suche anzeigen. Dieser Button wird nur angezeigt, wenn mindestens ein zugehöriger Eintrag vorhanden ist.
gcloud
Mit dem Befehl gcloud dataplex aspect-types
describe können Sie die Details eines Aspekttyps abrufen.
C#
C#
Bevor Sie dieses Beispiel ausprobieren, folgen Sie der Einrichtungsanleitung für C# in der Knowledge Catalog-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der API-Referenzdokumentation zu Knowledge Catalog C#.
Richten Sie zur Authentifizierung bei Knowledge Catalog Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Go
Go
Bevor Sie dieses Beispiel ausprobieren, folgen Sie der Einrichtungsanleitung für Go in der Knowledge Catalog-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der API-Referenzdokumentation zu Knowledge Catalog Go.
Richten Sie zur Authentifizierung bei Knowledge Catalog Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Java
Java
Bevor Sie dieses Beispiel ausprobieren, folgen Sie der Einrichtungsanleitung für Java in der Knowledge Catalog-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der API-Referenzdokumentation zu Knowledge Catalog Java.
Richten Sie zur Authentifizierung bei Knowledge Catalog Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Node.js
Node.js
Bevor Sie dieses Beispiel ausprobieren, folgen Sie der Einrichtungsanleitung für Node.js in der Knowledge Catalog-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der API-Referenzdokumentation zu Knowledge Catalog Node.js.
Richten Sie zur Authentifizierung bei Knowledge Catalog Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Python
Python
Bevor Sie dieses Beispiel ausprobieren, folgen Sie der Einrichtungsanleitung für Python in der Knowledge Catalog-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der API-Referenzdokumentation zu Knowledge Catalog Python.
Richten Sie zur Authentifizierung bei Knowledge Catalog Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Ruby
Ruby
Bevor Sie dieses Beispiel ausprobieren, folgen Sie der Einrichtungsanleitung für Ruby in der Knowledge Catalog-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der API-Referenzdokumentation zu Knowledge Catalog Ruby.
Richten Sie zur Authentifizierung bei Knowledge Catalog Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
REST
Verwenden Sie die Methode aspectTypes.get, um die Details eines Aspekttyps abzurufen.
Benutzerdefinierten Aspekttyp aktualisieren
Sie können den Anzeigenamen, die Beschreibung, die Vorlagenfelder und die Labels eines benutzerdefinierten Aspekttyps aktualisieren. Sie können ein vorhandenes Feld in einer Vorlage nicht löschen.
Sie können die ID und den Standort des Aspekttyps nach dem Erstellen des Aspekttyps nicht mehr aktualisieren.
Console
Rufen Sie in der Google Cloud Console die Seite Metadatentypen des Knowledge Catalog auf.
Klicken Sie auf den Tab Aspekttypen.
Klicken Sie auf den Aspekttyp, den Sie aktualisieren möchten.
Klicken Sie auf der Seite Aspekttypdetails auf Bearbeiten.
Bearbeiten Sie nach Bedarf den Anzeigenamen, die Beschreibung, die Vorlagenfelder und die Labels.
Optional: So markieren Sie ein Feld im Aspekttyp als veraltet:
- Maximieren Sie im Bereich Vorlage das Feld.
- Wählen Sie Is Deprecated aus.
- Geben Sie im Feld Grund für die Einstellung einen Grund für die Einstellung des ausgewählten Felds ein.
Klicken Sie auf Fertig.
Klicken Sie auf Speichern.
gcloud
Verwenden Sie den Befehl gcloud dataplex aspect-types
update, um einen benutzerdefinierten Aspekttyp zu aktualisieren.
C#
C#
Bevor Sie dieses Beispiel ausprobieren, folgen Sie der Einrichtungsanleitung für C# in der Knowledge Catalog-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der API-Referenzdokumentation zu Knowledge Catalog C#.
Richten Sie zur Authentifizierung bei Knowledge Catalog Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Go
Go
Bevor Sie dieses Beispiel ausprobieren, folgen Sie der Einrichtungsanleitung für Go in der Knowledge Catalog-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der API-Referenzdokumentation zu Knowledge Catalog Go.
Richten Sie zur Authentifizierung bei Knowledge Catalog Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Java
Java
Bevor Sie dieses Beispiel ausprobieren, folgen Sie der Einrichtungsanleitung für Java in der Knowledge Catalog-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der API-Referenzdokumentation zu Knowledge Catalog Java.
Richten Sie zur Authentifizierung bei Knowledge Catalog Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Node.js
Node.js
Bevor Sie dieses Beispiel ausprobieren, folgen Sie der Einrichtungsanleitung für Node.js in der Knowledge Catalog-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der API-Referenzdokumentation zu Knowledge Catalog Node.js.
Richten Sie zur Authentifizierung bei Knowledge Catalog Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Python
Python
Bevor Sie dieses Beispiel ausprobieren, folgen Sie der Einrichtungsanleitung für Python in der Knowledge Catalog-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der API-Referenzdokumentation zu Knowledge Catalog Python.
Richten Sie zur Authentifizierung bei Knowledge Catalog Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Ruby
Ruby
Bevor Sie dieses Beispiel ausprobieren, folgen Sie der Einrichtungsanleitung für Ruby in der Knowledge Catalog-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der API-Referenzdokumentation zu Knowledge Catalog Ruby.
Richten Sie zur Authentifizierung bei Knowledge Catalog Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
REST
Verwenden Sie die Methode aspectTypes.patch, um einen benutzerdefinierten Aspekttyp zu aktualisieren.
Benutzerdefinierten Aspekttyp löschen
Console
Rufen Sie in der Google Cloud Console die Seite Metadatentypen des Knowledge Catalog auf.
Klicken Sie auf den Tab Aspekttypen.
Klicken Sie auf den Aspekttyp, den Sie löschen möchten.
Klicken Sie auf der Seite Aspekttypdetails auf Löschen. Bestätigen Sie den Vorgang, wenn Sie dazu aufgefordert werden.
gcloud
Verwenden Sie zum Löschen eines benutzerdefinierten Aspekttyps den Befehl gcloud dataplex aspect-types
delete.
C#
C#
Bevor Sie dieses Beispiel ausprobieren, folgen Sie der Einrichtungsanleitung für C# in der Knowledge Catalog-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der API-Referenzdokumentation zu Knowledge Catalog C#.
Richten Sie zur Authentifizierung bei Knowledge Catalog Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Go
Go
Bevor Sie dieses Beispiel ausprobieren, folgen Sie der Einrichtungsanleitung für Go in der Knowledge Catalog-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der API-Referenzdokumentation zu Knowledge Catalog Go.
Richten Sie zur Authentifizierung bei Knowledge Catalog Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Java
Java
Bevor Sie dieses Beispiel ausprobieren, folgen Sie der Einrichtungsanleitung für Java in der Knowledge Catalog-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der API-Referenzdokumentation zu Knowledge Catalog Java.
Richten Sie zur Authentifizierung bei Knowledge Catalog Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Node.js
Node.js
Bevor Sie dieses Beispiel ausprobieren, folgen Sie der Einrichtungsanleitung für Node.js in der Knowledge Catalog-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der API-Referenzdokumentation zu Knowledge Catalog Node.js.
Richten Sie zur Authentifizierung bei Knowledge Catalog Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Python
Python
Bevor Sie dieses Beispiel ausprobieren, folgen Sie der Einrichtungsanleitung für Python in der Knowledge Catalog-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der API-Referenzdokumentation zu Knowledge Catalog Python.
Richten Sie zur Authentifizierung bei Knowledge Catalog Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
Ruby
Ruby
Bevor Sie dieses Beispiel ausprobieren, folgen Sie der Einrichtungsanleitung für Ruby in der Knowledge Catalog-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Informationen finden Sie in der API-Referenzdokumentation zu Knowledge Catalog Ruby.
Richten Sie zur Authentifizierung bei Knowledge Catalog Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für eine lokale Entwicklungsumgebung einrichten.
REST
Verwenden Sie zum Löschen eines vorhandenen benutzerdefinierten Aspekttyps die Methode aspectTypes.delete.
Nächste Schritte
- Weitere Informationen zum Suchen nach Ressourcen in Knowledge Catalog
- Einträge verwalten und benutzerdefinierte Quellen aufnehmen
- Metadaten in Knowledge Catalog importieren
- Weitere Informationen zu Metadaten in Knowledge Catalog
- Grundlegenden Datenkontext herstellen
- Knowledge Catalog-Anwendungsfälle ausprobieren