Datenprodukte verwalten

Vorschau

Dieses Produkt oder diese Funktion unterliegt den Bedingungen für Pre‑GA-Angebote im Abschnitt „Allgemeine Dienstbedingungen“ der dienstspezifischen Nutzungsbedingungen. Pre-GA-Produkte und ‑Funktionen stehen in der vorliegenden Form zur Verfügung und bieten möglicherweise nur eingeschränkten Support. Weitere Informationen finden Sie in den Beschreibungen der Produkteinführungsphasen.

Dieses Dokument richtet sich an Inhaber von Datenprodukten, die Datenprodukte in Dataplex Universal Catalog aktualisieren, löschen und Zugriff darauf gewähren möchten.

Weitere Informationen zur Architektur und zu den wichtigsten Konzepten von Datenprodukten finden Sie unter Datenprodukte.

Hinweise

1. Enable the Dataplex, BigQuery APIs.

   Roles required to enable APIs

   To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

   Enable the APIs

Hinweis :In diesem Leitfaden wird davon ausgegangen, dass Sie bereits Datenprodukte haben, die Sie verwalten müssen. Weitere Informationen zum Erstellen und Konfigurieren von Datenprodukten finden Sie unter Datenprodukte erstellen.

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für das Projekt zuzuweisen, damit Sie die nötigen Berechtigungen zum Verwalten von Datenprodukten haben:

• Volle Berechtigungen zum Erstellen, Aktualisieren, Löschen und Verwalten von Berechtigungen für Datenprodukte: Dataplex Data Products Admin (roles/dataplex.dataProductAdmin)
• Vorhandene Datenprodukte aktualisieren und verwalten: Dataplex Data Products Editor (roles/dataplex.dataProductEditor)
• Fügen Sie Aspekte wie schema, overview und contacts hinzu: Dataplex Entry and EntryLink Owner (roles/dataplex.entryOwner)
• Assets suchen und hinzufügen: Dataplex Catalog Viewer (roles/dataplex.catalogViewer)
• Systemaspekttypen wie Dokumentation und Vertragsaspekt der Aktualisierungshäufigkeit bearbeiten: Dataplex Catalog-Bearbeiter (roles/dataplex.catalogEditor)

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

Diese vordefinierten Rollen enthalten die Berechtigungen, die zum Verwalten von Datenprodukten erforderlich sind. Maximieren Sie den Abschnitt Erforderliche Berechtigungen, um die notwendigen Berechtigungen anzuzeigen:

Erforderliche Berechtigungen

Die folgenden Berechtigungen sind erforderlich, um Datenprodukte zu verwalten:

• Bearbeiten Sie den Systemaspekttyp overview: dataplex.entryGroups.useOverviewAspect
• Bearbeiten Sie den Systemaspekttyp refresh cadence: dataplex.entryGroups.useRefreshCadenceAspect

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

Zugriff auf ein Datenprodukt gewähren

Inhaber von Datenprodukten müssen ihre Produkte auffindbar machen und die erforderlichen Rollen zuweisen, damit Nutzer nach Datenprodukten suchen, sie ansehen und Zugriff darauf anfordern können.

Um Nutzern von Datenprodukten die Berechtigungen zu gewähren, die sie für die Interaktion mit dem Datenprodukt benötigen, weisen Sie ihnen die folgenden IAM-Rollen für die Datenproduktressource zu:

• Nach Datenprodukten suchen und darauf zugreifen in der Dataplex Universal Catalog-Suche: Dataplex Data Product Consumer (dataplex.dataProductsConsumer)
• Schreibgeschützter Zugriff zum Aufrufen von Datenproduktdefinitionen und ‑metadaten: Dataplex Data Product Viewer (dataplex.dataProductViewer)
• Zugriff auf Datenprodukte anfordern: Dataplex Data Product Consumer (dataplex.dataProductsConsumer)

Wenn ein Nutzer eines Datenprodukts Zugriff auf ein Datenprodukt anfordert, erhält der Inhaber des Datenprodukts eine E‑Mail-Benachrichtigung.

So gewähren Sie Zugriff:

1. Rufen Sie in der Google Cloud Console die Seite Gruppen auf.

   Zur Seite "Gruppen"

2. Suchen Sie nach der Gruppe, die mit der angeforderten Berechtigungsstufe verknüpft ist, und wählen Sie sie aus.

3. Klicken Sie auf  Mitglieder hinzufügen.

4. Fügen Sie das Hauptkonto hinzu.

5. Klicken Sie auf Speichern.

Weitere Informationen finden Sie unter Google-Gruppen in der Google Cloud Console erstellen und verwalten.

Datenprodukt aktualisieren

Sie können die grundlegenden Details (z. B. Name des Datenprodukts, Beschreibung, Inhaberdetails), Assets, Zugriffsgruppen, Berechtigungen, Vertrag, Aspekte und zusätzliche Dokumentation für ein vorhandenes Datenprodukt aktualisieren.

Grundlegende Details eines Datenprodukts aktualisieren

Console

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

   Zu den Datenprodukten

2. Klicken Sie auf das Datenprodukt, das Sie aktualisieren möchten.

3. Klicken Sie auf Datenprodukt bearbeiten.

4. Aktualisieren Sie nach Bedarf den Namen des Datenprodukts, das Symbol, die Beschreibung, die Kontakte des Inhabers und die Labels.

5. Klicken Sie auf Datenprodukt aktualisieren.

REST

Verwenden Sie zum Aktualisieren der grundlegenden Details eines Datenprodukts die Methode dataProducts.patch.

Wenn Sie beispielsweise die Beschreibung eines Datenprodukts aktualisieren möchten, senden Sie die folgende PATCH-Anfrage:

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-d '{"description": "NEW_DESCRIPTION"}' \
https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/ LOCATION/dataProducts/DATA_PRODUCT_ID?update_mask="description"

Ersetzen Sie Folgendes:

• NEW_DESCRIPTION: eine neue Beschreibung für das Datenprodukt
• PROJECT_ID: die ID Ihres Google Cloud-Projekts
• LOCATION: die Region, in der das Datenprodukt vorhanden ist
• DATA_PRODUCT_ID: die ID Ihres Datenprodukts

Assets eines Datenprodukts aktualisieren

Console

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

   Zu den Datenprodukten

2. Klicken Sie auf das Datenprodukt, dessen Assets Sie aktualisieren möchten.

3. Klicken Sie auf den Tab Assets.

4. So fügen Sie ein neues Asset hinzu:

   1. Klicken Sie auf Hinzufügen.

   2. Suchen Sie nach den Assets, die Sie Ihrem Datenprodukt hinzufügen möchten, und wählen Sie sie aus. Die von Ihnen ausgewählten Assets müssen sich in derselben Region wie das Datenprodukt befinden.

      Wenn Sie die erforderlichen Berechtigungen haben, können Sie die Metadaten von Assets aufrufen, indem Sie auf das Asset klicken.

   3. Verwenden Sie Filter, um die Suchergebnisse einzugrenzen.

   4. Klicken Sie nach der Auswahl der Assets auf Hinzufügen.

5. So entfernen Sie ein Asset aus dem Datenprodukt:

   1. Klicken Sie für das Asset, das Sie entfernen möchten, auf  > Entfernen.

   2. Klicken Sie zur Bestätigung auf Entfernen.

REST

Wenn Sie dem Datenprodukt ein neues Daten-Asset hinzufügen möchten, verwenden Sie die Methode dataAssets.create. Ein Codebeispiel finden Sie unter Optional: Add assets.

Wenn Sie ein Daten-Asset aus dem Datenprodukt löschen möchten, verwenden Sie die Methode dataAssets.delete. Senden Sie beispielsweise die folgende DELETE-Anfrage:

curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/dataProducts/DATA_PRODUCT_ID/dataAssets/DATA_ASSET_ID"

Ersetzen Sie Folgendes:

• PROJECT_ID: die ID Ihres Google Cloud-Projekts
• LOCATION: die Region, in der Sie das Datenprodukt erstellen möchten
• DATA_PRODUCT_ID: Eine eindeutige ID für Ihr Datenprodukt.
• DATA_ASSET_ID: die ID des Daten-Assets, das Sie aus dem Datenprodukt entfernen möchten

Zugriffsgruppen und Asset-Berechtigungen aktualisieren

Console

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

   Zu den Datenprodukten

2. Klicken Sie auf das Datenprodukt, für das Sie die Zugriffsgruppen und Berechtigungen aktualisieren möchten.

3. Klicken Sie auf den Tab Zugriffsgruppen und ‑berechtigungen.

4. So aktualisieren Sie eine Zugriffsgruppe:

   1. Klicken Sie auf  Bearbeiten.

   2. Aktualisieren Sie den Namen, die Beschreibung und die Kennung der Zugriffsgruppe nach Bedarf.

   3. Wenn Sie eine neue Zugriffsgruppe hinzufügen möchten, klicken Sie auf Zugriffsgruppe hinzufügen und folgen Sie dieser Anleitung:

      1. Geben Sie im Feld Name der Zugriffsgruppe einen Namen für die neue Zugriffsgruppe ein. Beispiel: Analyst.

      2. Geben Sie im Feld Beschreibung der Zugriffsgruppe eine Beschreibung für die Zugriffsgruppe ein.

      3. Geben Sie im Feld Kennung der Zugriffsgruppe die E‑Mail-Adresse einer Google-Gruppe ein, die Sie dieser Zugriffsgruppe zuweisen möchten. Datenproduktnutzer, die Zugriff auf diese Zugriffsgruppe anfordern, können der zugeordneten Google-Gruppe als Mitglieder hinzugefügt werden.

         Sie können einem Datenprodukt maximal drei Zugriffsgruppen hinzufügen.

   4. Klicken Sie auf Hinzufügen.

5. So entfernen Sie eine Zugriffsgruppe:

   1. Klicken Sie für die Zugriffsgruppe, die Sie entfernen möchten, auf  > Entfernen.

   2. Klicken Sie zur Bestätigung auf Entfernen.

6. Wenn für das ausgewählte Datenprodukt keine Zugriffsgruppen konfiguriert sind, können Sie eine neue Zugriffsgruppe hinzufügen, indem Sie auf Zugriffsgruppe hinzufügen klicken.

7. So aktualisieren Sie die Asset-Berechtigungen:

   1. Klicken Sie für das Asset, dessen Berechtigungen Sie aktualisieren möchten, auf  > Berechtigungen.

   2. Aktualisieren Sie die erforderlichen Zugriffsgruppen und IAM-Rollen.

   3. Klicken Sie auf Konfigurieren.

REST

Mit der Methode dataProducts.patch können Sie die mit einem Datenprodukt verknüpften Zugriffsgruppen aktualisieren. Ein Codebeispiel finden Sie unter Zugriffsgruppen konfigurieren.

Verwenden Sie die Methode dataAssets.patch, um die Asset-Berechtigungen zu aktualisieren. Ein Codebeispiel finden Sie unter Asset-Berechtigungen konfigurieren.

Vertrag für das Datenprodukt aktualisieren

Hinweis :Die Aktualisierungshäufigkeit kann nicht mehr bearbeitet werden, nachdem Sie sie dem Vertrag hinzugefügt haben. Wenn Sie versuchen, diesen Wert zu ändern, wird der folgende Fehler angezeigt: You don't have permission to change contract values.

Console

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

   Zu den Datenprodukten

2. Klicken Sie auf das Datenprodukt, für das Sie den Vertrag aktualisieren möchten.

3. Klicken Sie auf den Tab Vertrag.

4. So aktualisieren Sie den bestehenden Vertrag:

   1. Klicken Sie auf  Bearbeiten.

   2. Aktualisieren Sie die erforderlichen Felder.

   3. Klicken Sie auf Speichern.

5. Wenn dem ausgewählten Datenprodukt kein Vertrag angehängt ist, können Sie einen hinzufügen, indem Sie auf Vertrag hinzufügen klicken.

REST

Verwenden Sie zum Aktualisieren eines Vertrags die Methode entries.patch. Ein Codebeispiel finden Sie unter Vertrag hinzufügen.

Aspekte eines Datenprodukts aktualisieren

Console

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

   Zu den Datenprodukten

2. Klicken Sie auf das Datenprodukt, für das Sie die Aspekte aktualisieren möchten.

3. Klicken Sie auf den Tab Aspekte.

4. So aktualisieren Sie einen Aspekt:

   1. Klicken Sie auf den Aspekt, den Sie aktualisieren möchten.

   2. Klicken Sie auf  Bearbeiten.

   3. Aktualisieren Sie bei Bedarf Aspekttyp, Land und Region.

   4. Klicken Sie auf Speichern.

5. So fügen Sie dem Datenprodukt einen neuen Aspekt hinzu:

   1. Klicken Sie auf + Aspekt hinzufügen.

   2. Suchen Sie im Feld Aspekttyp auswählen nach einem Aspekttyp und wählen Sie ihn aus der Liste aus. Beispiel: Geo context.

   3. Wählen Sie im Feld Land das Land aus, zu dem das Asset gehört.

   4. Wählen Sie im Feld Region die Geschäftsregion aus, zu der das Asset gehört.

   5. Klicken Sie auf Speichern.

6. So löschen Sie einen Aspekt:

   1. Klicken Sie auf den Aspekt, den Sie löschen möchten.

   2. Klicken Sie auf .

   3. Klicken Sie auf Bestätigen, um die Aktion zu bestätigen.

REST

Verwenden Sie die Methode entries.patch, um einen beliebigen Aspekt des Datenprodukteintrags zu aktualisieren.

Dokumentation des Datenprodukts aktualisieren

Console

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

   Zu den Datenprodukten

2. Klicken Sie auf das Datenprodukt, für das Sie die Dokumentation aktualisieren möchten.

3. Klicken Sie auf den Tab Übersicht.

4. Klicken Sie neben Dokumentation auf  Bearbeiten.

5. Aktualisieren Sie das Nutzerhandbuch, Beispielabfragen und andere Dokumentationen nach Bedarf.

6. Klicken Sie auf Speichern.

REST

Die Dokumentation ist Teil des Aspekts overview. Verwenden Sie zum Aktualisieren der Dokumentation des Datenprodukts die Methode entries.patch.

Datenprodukt löschen

Wenn Sie ein Datenprodukt löschen möchten, müssen Sie zuerst alle Assets daraus entfernen.

Console

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

   Zu den Datenprodukten

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

3. Klicken Sie auf den Tab Assets.

4. Klicken Sie für jedes aufgeführte Asset auf  > Entfernen. Bestätigen Sie die Aktion, indem Sie auf Entfernen klicken.

5. Nachdem Sie alle Assets entfernt haben, löschen Sie das Datenprodukt, indem Sie auf  Löschen klicken.

6. Geben Sie im Bestätigungsdialogfeld delete ein und klicken Sie auf Löschen.

REST

Wenn Sie ein Datenprodukt löschen möchten, verwenden Sie die Methode dataProducts.delete.

Senden Sie beispielsweise die folgende DELETE-Anfrage:

curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/ LOCATION/dataProducts/DATA_PRODUCT_ID

Ersetzen Sie Folgendes:

• PROJECT_ID: die ID Ihres Google Cloud-Projekts
• LOCATION: die Region, in der das Datenprodukt vorhanden ist
• DATA_PRODUCT_ID: die ID des Datenprodukts, das Sie löschen möchten

Nächste Schritte

• Weitere Informationen zum Suchen nach Datenprodukten
• Zugriff auf Datenprodukte anfordern