Datenprodukte verwenden

Dieses Dokument richtet sich an Nutzer von Datenprodukten im Knowledge Catalog (ehemals 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 Informationen zu Datenprodukten.

Hinweis

  1. Aktivieren Sie die Dataplex API und die BigQuery API.

    Rollen, die zum Aktivieren von APIs erforderlich sind

    Zum Aktivieren von APIs benötigen Sie die Berechtigung serviceusage.services.enable. Wenn Sie das Projekt erstellt haben, haben Sie diese Berechtigung wahrscheinlich bereits über die Rolle „Inhaber“ (roles/owner). Andernfalls können Sie diese Berechtigung über die Rolle „Service Usage-Administrator“ (roles/serviceusage.serviceUsageAdmin) erhalten. Informationen zum Zuweisen von Rollen.

    APIs aktivieren

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:

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 die Metadaten eines Assets aufzurufen und auf das entsprechende Asset im Quellsystem zuzugreifen. 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.

Console

  1. Rufen Sie in der Google Cloud Console die Seite Suchen im Knowledge Catalog auf.

    Zur Suche

  2. Suchen Sie mit Keywords oder in natürlicher Sprache. Weitere Informationen finden Sie unter Nach Ressourcen suchen.

  3. Klicken Sie in den Suchergebnissen auf das Datenprodukt, dessen Details Sie aufrufen möchten. Sie können die Beschreibung, Assets, den Vertrag, Aspekte, Kontaktdaten und andere mit dem Datenprodukt verknüpfte Dokumentation aufrufen.

REST

Verwenden Sie die searchEntries Methode, 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' oder description:'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 keine IAM-Berechtigungen für den Zugriff auf ein Datenprodukt haben, können Sie über die integrierten Workflows für die Zugriffsgenehmigung Zugriff anfordern.

Zugriffsanfrage senden

Console

  1. Rufen Sie in der Google Cloud Console die Seite Datenprodukte im Knowledge Catalog auf.

    Zu den Datenprodukten

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

  3. Klicken Sie auf Zugriff anfordern.

  4. Geben Sie im Bereich Anfragedetails die folgenden Parameter an:

    • Zugriffsgruppen: Wählen Sie die funktionale Zugriffsgruppe aus, der Sie beitreten möchten.

    • Ich oder Dienstkonto: Wählen Sie den Hauptkontotyp aus:

      • Wenn Sie Zugriff für sich selbst anfordern, wählen Sie Ich aus.

      • Wenn Sie Zugriff für eine programmatische Identität anfordern, wählen Sie Dienstkonto aus. Diese Option ist nur verfügbar, wenn das Datenprodukt Dienstkonten unterstützt.

    • Begründung: Geben Sie eine geschäftliche Begründung für Ihre Anfrage ein.

  5. Klicken Sie auf Senden.

Für den Inhaber des Datenprodukts wird eine neue Änderungsanfrage generiert, die er überprüfen kann. Sie erhalten eine E‑Mail-Benachrichtigung mit dem endgültigen Status, sobald die Anfrage genehmigt oder abgelehnt wurde.

REST

Nutzer von Datenprodukten, die die Berechtigung dataplex.dataProducts.get haben, können Zugriff anfordern, indem sie eine ChangeRequest-Ressource erstellen. Senden Sie eine POST-Anfrage an den Endpunkt der Datenproduktressource mit der benutzerdefinierten Methode :requestAccess:

curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-d '{
  "parent": "projects/PROJECT_ID/locations/LOCATION/dataProducts/DATA_PRODUCT_ID",
  "change_request": {
    "justification": "JUSTIFICATION_TEXT",
    "data_product_access_request": {
      "parent": "projects/PROJECT_ID/locations/LOCATION/dataProducts/DATA_PRODUCT_ID",
      "access_group_id": "DATA_PRODUCT_ACCESS_GROUP_ID"
    }
  }
}' \
"https://dataplex.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/dataProducts/DATA_PRODUCT_ID:requestAccess"

Ersetzen Sie Folgendes:

  • PROJECT_ID: Die ID Ihres Google Cloud Projekts

  • LOCATION: Die Region, in der sich das Datenprodukt befindet (z. B. us-central1)

  • DATA_PRODUCT_ID: Die eindeutige ID des Zieldatenprodukts

  • JUSTIFICATION_TEXT: Die geschäftliche Begründung, die erklärt warum Zugriff erforderlich ist

  • DATA_PRODUCT_ACCESS_GROUP_ID: Die ID der spezifischen Zugriffsgruppe, der Sie beitreten möchten

Status von Zugriffsanfragen ansehen

Als Nutzer eines Datenprodukts können Sie den Fortschritt und Lebenszyklus Ihrer eingereichten Zugriffsanfragen verfolgen. Im Knowledge Catalog werden diese Anfragen mit unterschiedlichen Status angezeigt, je nachdem, ob Sie eine einheitliche Workflowliste oder eine Zugriffszusammenfassung für ein bestimmtes Produkt aufrufen.

Einheitliche Liste Ihrer Zugriffsanfragen ansehen

So rufen Sie eine umfassende Liste aller Ihrer eingereichten Zugriffsanfragen für alle Datenprodukte auf:

Console

  1. Rufen Sie in der Google Cloud Console die Seite Governance-Workflows im Knowledge Catalog auf.

    Zu den Governance-Workflows

  2. Klicken Sie auf den Tab Meine Anfragen.

  3. Sehen Sie sich die einheitliche Liste mit Ihren vergangenen und ausstehenden Anfragen sowie den aktuellen Workflowstatus an:

    • Neu: Die Zugriffsanfrage wurde erstellt und muss vom Genehmiger überprüft werden.

    • Genehmigt: Die Anfrage wurde genehmigt, aber die Backend-Systeme stellen den Zugriff noch bereit.

    • Abgelehnt: Die Anfrage wurde abgelehnt. Sehen Sie sich die Kommentare des Genehmigers an, um die Begründung für die Ablehnung zu erfahren.

REST

Senden Sie eine GET-Anfrage mit der benutzerdefinierten Sammlungsmethode :listMine:

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

Zugriffszusammenfassung für ein bestimmtes Datenprodukt ansehen

Neben der globalen Workflowliste können Sie auch Ihre Zugriffsposition für ein einzelnes Datenprodukt prüfen. So können Sie prüfen, ob Sie bereits geerbten Zugriff auf eine Asset-Gruppe haben, ohne eine neue Anfrage senden zu müssen.

So rufen Sie die Zugriffszusammenfassung für ein Datenprodukt auf:

Console

  1. Rufen Sie in der Google Cloud Console die Seite Datenprodukte im Knowledge Catalog auf.

    Zu den Datenprodukten

  2. Klicken Sie auf das Datenprodukt, das Sie prüfen möchten.

  3. Klicken Sie auf den Tab Zugriffszusammenfassung. Sehen Sie sich Ihren Status für alle Zugriffsgruppen für dieses Datenprodukt an.

    Auf dem Tab Zugriffszusammenfassung werden die folgenden Status verwendet:

    Status Beschreibung
    Kein Zugriff Sie haben keinen Zugriff auf die Zugriffsgruppe und haben noch keinen Zugriff angefordert.
    Wird überprüft Sie haben eine Zugriffsanfrage gesendet und die Anfrage muss von einem Genehmiger überprüft werden.
    Genehmigt Ihre Zugriffsanfrage wurde genehmigt, aber die Weitergabe der Mitgliedschaft an die zugrunde liegende Google-Gruppe wird noch verarbeitet.
    Zugriff gewährt Der Zugriff ist vollständig aktiv. Sie sind Mitglied der Zugriffsgruppe und können mit den Assets des Datenprodukts interagieren.
    Abgelehnt Ihre Zugriffsanfrage für diese Zugriffsgruppe wurde abgelehnt.

REST

Senden Sie eine GET-Anfrage mit der eindeutigen ID, die bei der ursprünglichen Erstellung der Anfrage zurückgegeben wurde:

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

Ersetzen Sie Folgendes:

  • PROJECT_ID: Die ID Ihres Google Cloud Projekts

  • LOCATION: Die Region, in der sich das Datenprodukt befindet (z. B. us-central1)

  • CHANGE_REQUEST_ID: Die eindeutige ID Ihrer eingereichten Änderungsanfrage

Zugriffsanfrage löschen

  1. Rufen Sie in der Google Cloud Console die Seite Governance-Workflows im Knowledge Catalog auf.

    Zu den Governance-Workflows

  2. Klicken Sie auf den Tab Meine Anfragen.

  3. Suchen Sie die Zeile mit Ihrer Anfrage für das Zieldatenprodukt. Wenden Sie bei Bedarf einen Filter an, um den Eintrag zu isolieren.

  4. Klicken Sie auf Aktionen und dann auf Löschen.

Datenprodukte nutzen

Wenn Sie ein Datenprodukt verwenden möchten, 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 erhalten, können Sie sie direkt in BigQuery abfragen, um Statistiken zu generieren.

Mit Nutzeranmeldedaten auf Assets zugreifen

Wenn Ihre Zugriffsanfrage für Ihre Nutzeranmeldedaten genehmigt wurde, führen Sie die folgenden Schritte aus, um auf die Assets zuzugreifen:

  1. Suchen Sie nach dem Datenprodukt.
  2. Klicken Sie in den Suchergebnissen auf das Datenprodukt, das Sie verwenden möchten.
  3. Klicken Sie auf den Tab Assets.

  4. 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 Datenherkunft zugreifen. Wenn das Asset eine BigQuery-Tabelle oder ‑Ansicht ist, können Sie auf In BigQuery öffnen klicken, um zum BigQuery-Studio zu wechseln und die Ergebnisse abzufragen.

Mit einem Dienstkonto auf Assets zugreifen

Wenn Ihre Zugriffsanfrage für ein Dienstkonto genehmigt wurde, erhalten Sie die IAM-Rolle „Dienstkonto-Token-Ersteller“ (roles/iam.serviceAccountTokenCreator) für das Dienstkonto des Datenproduzenten. So können Sie eine Identitätsübernahmekette erstellen, um auf die zugrunde liegenden Assets zuzugreifen.

So greifen Sie mit einem Dienstkonto auf Assets zu:

  1. Rufen Sie den Tab Daten-Assets auf der Detailseite des Datenprodukts auf, um die konfigurierten Dienstkonten für das Datenprodukt zu ermitteln.

  2. Erstellen Sie mit dem folgenden Google Cloud CLI-Befehl eine Identitätsübernahmekette für Ihr Dienstkonto, um die Identität des Dienstkontos des Datenproduzenten zu übernehmen:

    gcloud config set auth/impersonate_service_account CONSUMER_SERVICE_ACCOUNT,PRODUCER_SERVICE_ACCOUNT

    Ersetzen Sie Folgendes:

    • CONSUMER_SERVICE_ACCOUNT: Die vollständig qualifizierte E‑Mail-Adresse des Dienstkontos des Nutzers des Datenprodukts

    • PRODUCER_SERVICE_ACCOUNT: Die vollständig qualifizierte E‑Mail-Adresse des Dienstkontos, das der Zugriffsgruppe für das Datenprodukt zugeordnet ist

    Weitere Informationen finden Sie unter Identitätsübernahme des Dienstkontos verwenden.

Mit einem Remote-MCP-Server auf Datenprodukte zugreifen

Für Clientanwendungen und Entwicklungstools, die außerhalb des Google Cloud Ökosystems mit Ihren Daten produkten interagieren, können Sie einen Remote- Model Context Protocol (MCP) Server verwenden. Mit diesem Architekturmuster können externe Entwicklerclients katalogisierte Daten-Assets sicher abfragen und finden und gleichzeitig einheitliche Governance-Grenzen einhalten.

Informationen zum Bereitstellen und Herstellen einer Verbindung zu einem externen Server finden Sie unter Remote-MCP-Server des Knowledge Catalog verwenden.

Nächste Schritte