Dieses Dokument richtet sich an Nutzer von Knowledge Catalog-Datenprodukten (früher Dataplex Universal Catalog), die Datenprodukte für ihre Anwendungsfälle finden und verwenden möchten.
Weitere Informationen zur Architektur und zu den wichtigsten Konzepten von Datenprodukten finden Sie unter Datenprodukte.
Hinweis
-
Aktivieren Sie die Dataplex- und BigQuery APIs.
Rollen, die zum Aktivieren von APIs erforderlich sind
Zum Aktivieren von APIs benötigen Sie die IAM-Rolle „Service Usage-Administrator“ (
roles/serviceusage.serviceUsageAdmin), die die Berechtigungserviceusage.services.enableenthält. Weitere Informationen zum Zuweisen von Rollen
Erforderliche Rollen
Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für das Datenprodukt oder das Projekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Suchen, Aufrufen und Verwenden von Datenprodukten benötigen:
-
Nach Datenprodukten suchen:
Dataplex Catalog Viewer (
roles/dataplex.catalogViewer) -
Nach Daten-Assets suchen und Zugriff anfordern:
Dataplex Data Products Consumer (
roles/dataplex.dataProductsConsumer) -
Schreibgeschützter Zugriff zum Aufrufen von Datenproduktdefinitionen und ‑metadaten:
Dataplex Data Products Viewer (
roles/dataplex.dataProductsViewer)
Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.
Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.
Als Nutzer eines Datenprodukts benötigen Sie die Berechtigung viewer, um auf das entsprechende Asset im Quellsystem zugreifen zu können, damit Sie die Metadaten eines Assets aufrufen können. Wenn Sie beispielsweise nach Metadaten für ein Dataset oder eine Tabelle in einem Datenprodukt suchen möchten, benötigen Sie die Rolle „BigQuery-Metadatenbetrachter“ (roles/bigquery.metadataViewer). Weitere Informationen finden Sie unter Erforderliche Rollen für den Zugriff auf Suchergebnisse.
Nach Datenprodukten suchen
Console
Rufen Sie in der Google Cloud Console die Seite Suchen im Knowledge Catalog auf.
Suchen Sie mithilfe von Keywords oder natürlicher Sprache. Weitere Informationen finden Sie unter Nach Ressourcen suchen.
Klicken Sie in den Suchergebnissen auf das Datenprodukt, dessen Details Sie sich ansehen möchten. Sie können die Beschreibung, Assets, den Vertrag, die Aspekte und andere Dokumentationen, die mit dem Datenprodukt verknüpft sind, einsehen.
REST
Verwenden Sie die Methode searchEntries, um nach einem Datenprodukt zu suchen.
Senden Sie beispielsweise die folgende POST-Anfrage:
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-d \
'{
"query": "ADDITIONAL_KEYWORDS (type=(DATA_PRODUCT))",
"pageSize": 10
}' \
"https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/global:searchEntries"
Ersetzen Sie Folgendes:
- ADDITIONAL_KEYWORDS (optional): zusätzliche Keywords oder Suchkriterien, um die Ergebnisse einzugrenzen (z. B.
displayName:'My Data Product'oderdescription:'sales') - PROJECT_ID: die ID Ihres Google Cloud-Projekts, in dem das Datenprodukt erstellt wird
Zugriff auf Datenprodukte anfordern
Wenn Sie als Nutzer eines Datenprodukts keinen Zugriff darauf haben, können Sie den Zugriff mit den folgenden Schritten anfordern:
Rufen Sie in der Google Cloud Console die Seite Datenprodukte des Knowledge Catalog auf.
Klicken Sie auf das Datenprodukt, auf das Sie zugreifen möchten.
Klicken Sie auf Zugriffsanfrage.
Geben Sie im Bereich Anfragedetails Folgendes an:
- Zugriffstyp: Wählen Sie aus, welchen Zugriff Sie erhalten möchten.
- Nachricht: Geben Sie eine Begründung für die Zugriffsanfrage an.
Klicken Sie auf Senden. Ein neuer E‑Mail-Entwurf wird automatisch in Ihrer Standard-E‑Mail-Anwendung (z. B. Gmail oder Outlook) geöffnet. Die Adresse des Empfängers sowie eine vorab ausgefüllte Betreffzeile und ein vorab ausgefüllter Nachrichtentext sind bereits enthalten.
Sehen Sie sich den automatisch generierten E‑Mail-Inhalt mit den Details Ihrer Anfrage an.
Klicken Sie auf Senden, um die Zugriffsanfrage zur Genehmigung an den Inhaber des Datenprodukts zu senden.
Der Eigentümer des Datenprodukts erhält Ihre E-Mail und prüft Ihre Anfrage. Warten Sie auf eine E‑Mail-Benachrichtigung, in der bestätigt wird, dass Ihre Zugriffsanfrage genehmigt oder abgelehnt wurde.
Nach der Genehmigung erhalten Sie Zugriff auf das Datenprodukt und können es in Knowledge Catalog verwenden.
Datenprodukte nutzen
Damit Sie ein Datenprodukt verwenden können, müssen Ihnen die erforderlichen Berechtigungen gewährt werden. Weitere Informationen finden Sie unter Zugriff auf Datenprodukte anfordern.
Nachdem der Inhaber des Datenprodukts Ihnen die Berechtigung erteilt hat, können Sie auf das Datenprodukt und seine Assets zugreifen. Wenn Sie beispielsweise Berechtigungen für den Zugriff auf eine BigQuery-Tabelle haben, können Sie sie direkt in BigQuery abfragen, um Statistiken zu generieren.
So greifen Sie auf ein Datenprodukt zu und verwenden es:
- Nach dem Datenprodukt suchen
- Klicken Sie in den Suchergebnissen auf das Datenprodukt, das Sie verwenden möchten.
- Klicken Sie auf den Tab Assets.
- Klicken Sie auf das Asset, dessen Details Sie aufrufen möchten. Dadurch wird die Detailseite des Eintrags geöffnet. Sie können auf Details wie Schema, Statistiken und Herkunft zugreifen. Wenn es sich bei dem Asset um eine BigQuery-Tabelle oder -Ansicht handelt, können Sie auf In BigQuery öffnen klicken, um zu BigQuery Studio zu wechseln und die Ergebnisse abzufragen.
Nächste Schritte
- Wichtige Konzepte von Datenprodukten
- Informationen zum Erstellen eines Datenprodukts
- Weitere Informationen zum Verwalten von Datenprodukten