Datenaustausch verwalten

Als Analytics Hub-Nutzer können Sie die folgenden Aufgaben ausführen:

  • Datenpools erstellen, aktualisieren, anzeigen, freigeben und löschen.
  • Einträge erstellen, aktualisieren, löschen und freigeben.
  • Verwalten Sie Analytics Hub-Administratoren, Eintragsadministratoren, Publisher, Abonnenten und Betrachter.

Standardmäßig ist ein Datenpool privat. Nur Nutzer oder Gruppen, die Zugriff darauf haben, können die Daten aufrufen oder abonnieren. Wenn die Listen jedoch von Google Cloud-Nutzern (allAuthenticatedUsers) erkannt und abonniert werden sollen, können Sie anfordern, dass der Datenaustausch öffentlich gemacht wird.

Hinweis

Damit Sie Analytics Hub nutzen können, müssen Sie die Analytics Hub API in Ihrem Google Cloud-Projekt aktivieren.

Erforderliche Berechtigungen

Zum Aktivieren der Analytics Hub API benötigen Sie die folgenden IAM-Berechtigungen (Identity and Access Management):

  • serviceUsage.services.get
  • serviceUsage.services.list
  • serviceUsage.services.enable

Die folgende vordefinierte IAM-Rolle enthält die Berechtigungen, die Sie zum Aktivieren der Analytics Hub API benötigen:

  • roles/serviceusage.serviceUsageAdmin

Weitere Informationen zu IAM-Rollen in BigQuery finden Sie unter Vordefinierte Rollen und Berechtigungen.

Analytics Hub API aktivieren

So aktivieren Sie die Analytics Hub API:

Console

Rufen Sie die Analytics Hub API für Ihr Google Cloud-Projekt auf und aktivieren Sie sie.

Analytics Hub API aktivieren

gcloud

Führen Sie den Befehl gcloud services enable aus:

gcloud services enable analyticshub.googleapis.com

Erforderliche Berechtigungen

Sie benötigen die Rolle „Analytics Hub-Administrator“ (roles/analyticshub.admin), um den Datenaustausch zu verwalten. Weitere Informationen finden Sie unter Rolle „Analytics Hub-Administrator“. Informationen zum Zuweisen dieser Rolle an andere Nutzer finden Sie unter Analytics Hub-Administratoren erstellen.

Datenaustausch erstellen

So erstellen Sie einen Datenaustausch:

Console

  1. Rufen Sie die Seite Analytics Hub auf.

    Zum Analytics Hub

  2. Klicken Sie auf Austausch erstellen.

  3. Wählen Sie im Dialogfeld Exchange erstellen ein Projekt und eine Region für den Datenaustausch aus. Sie können das Projekt und die Region nicht aktualisieren, nachdem Sie den Datenaustausch erstellt haben.

  4. Geben Sie unter Anzeigename einen Namen für den Datenaustausch ein.

  5. Optional: Geben Sie Werte in die folgenden Felder ein:

    • Primärer Kontakt: Geben Sie die URL oder die E-Mail-Adresse des primären Kontakts für den Datenaustausch ein.
    • Beschreibung: Geben Sie eine Beschreibung für den Datenaustausch ein.

  6. Klicken Sie auf die Ein-/Aus-Schaltfläche Öffentliche Sichtbarkeit, um die öffentliche Sichtbarkeit zu aktivieren. Sobald eine Anzeigenplattform öffentlich sichtbar ist, werden alle Einträge in der Anzeigenplattform angezeigt und im Katalog durchsucht. Wenn Sie die öffentliche Sichtbarkeit aktivieren, müssen Sie die Austauschberechtigungen konfigurieren. Aufgrund der Übernahme von Berechtigungen werden für alle Einträge standardmäßig derselbe öffentliche Sichtbarkeitstyp der Anzeigenplattform festgelegt. Daher können öffentliche Anzeigenplattformen keine privaten Einträge haben, aber private Anzeigenplattformen können öffentliche Einträge haben (z. B. können Sie den Typ der öffentlichen Sichtbarkeit auf der Ebene einzelner Einträge festlegen). Das Projekt, in dem Sie den Datenpool erstellen, muss eine Organisation und ein Rechnungskonto haben.

  7. Klicken Sie auf Austausch erstellen.

  8. Optional: Führen Sie im Abschnitt Austausch-Berechtigungen die folgenden Schritte aus:

    1. Geben Sie die E-Mail-Adressen in die folgenden Felder ein, um die Analytics Hub-Nutzerrollen zuzuweisen:

    2. Klicken Sie zum Speichern von Berechtigungen auf Berechtigungen festlegen.

  9. Wenn Sie keine Berechtigungen für den Datenaustausch festgelegt haben, klicken Sie auf Überspringen.

API

Verwenden Sie die Methode projects.locations.dataExchanges.create.

POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/dataExchanges?dataExchangeId=DATAEXCHANGE_ID

Dabei gilt:

  • PROJECT_ID: Die ID des Projekts, in dem Sie den Datenaustausch erstellen möchten.
  • LOCATION: Der Standort für Ihren Datenaustausch. Weitere Informationen zu Standorten, die Analytics Hub unterstützen, finden Sie unter Unterstützte Regionen.
  • DATAEXCHANGE_ID: die ID für Ihren Datenaustausch.

Geben Sie im Anfragetext die Details zum Datenaustausch an. Wenn die Anfrage erfolgreich ist, enthält der Antworttext Details zum Datenaustausch.

Weitere Informationen zu den Aufgaben, die Sie für den Datenaustausch mit APIs ausführen können, finden Sie unter projects.locations.dataExchanges-Methoden.

Datenaustausch aktualisieren

So aktualisieren Sie einen Datenaustausch:

Console

  1. Rufen Sie die Seite Analytics Hub auf.

    Zum Analytics Hub

  2. Klicken Sie in der Liste der Datenaustausche auf einen Datenaustausch, den Sie aktualisieren möchten.

  3. Klicken Sie auf Austausch bearbeiten.

  4. Aktualisieren Sie im Dialogfeld Austausch bearbeiten die folgenden Felder:

    • Anzeigename
    • Primärer Kontakt
    • Beschreibung
    • Öffentliche Sichtbarkeit
      • Wenn Sie die öffentliche Sichtbarkeit aktivieren, weisen Sie allUsers oder allAuthenticatedUsers die Rolle „Analytics Hub-Betrachter“ (roles/analyticshub.viewer) zu.
      • Wenn Sie die öffentliche Sichtbarkeit deaktivieren, entfernen Sie die Rolle „Analytics Hub-Betrachter“ (roles/analyticshub.viewer) aus allUsers oder allAuthenticatedUsers. Öffentliche Anzeigenplattformen können keine privaten Einträge haben, private Anzeigenplattformen können jedoch öffentliche Einträge haben.

  5. Klicken Sie auf Speichern.

API

Verwenden Sie die Methode projects.locations.dataExchanges.patch.

PATCH https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/dataExchanges/DATAEXCHANGE_ID?updateMask=UPDATEMASK

Ersetzen Sie UPDATEMASK durch die Liste der Felder, die Sie aktualisieren möchten. Verwenden Sie eine durch Kommas getrennte Liste, um mehrere Werte zu aktualisieren. Geben Sie beispielsweise displayName,primaryContact ein, um den Anzeigenamen und den primären Kontakt für einen Datenaustausch zu aktualisieren.

Geben Sie im Anfragetext die aktualisierten Werte für die folgenden Felder an:

  • Anzeigename
  • Beschreibung
  • Dokumentation
  • Symbol
  • Primärer Kontakt
  • Öffentliche Sichtbarkeit

Weitere Informationen zu den Aufgaben, die Sie für den Datenaustausch mit APIs ausführen können, finden Sie unter projects.locations.dataExchanges-Methoden.

Datenpools ansehen

So rufen Sie alle Datenpools in Ihrer Organisation auf, auf die Sie Zugriff haben:

Console

  1. Rufen Sie die Seite Analytics Hub auf.

    Zum Analytics Hub

  2. Sehen Sie sich die Liste der Datenpools in Ihrer Google Cloud-Organisation an.

API

Verwenden Sie die Methode organizations.locations.dataExchanges.list.

GET https://analyticshub.googleapis.com/v1/organizations/ORGANIZATION_ID/location/LOCATION/dataExchanges

Dabei gilt:

  • ORGANIZATION_ID: die Organisations-ID. Weitere Informationen finden Sie unter Organisations-ID abrufen.
  • LOCATION: der Standort, für den Sie die vorhandenen Datenpools auflisten möchten.

Datenpools freigeben

Wenn der Analytics Hub-Publisher zu einer anderen Organisation gehört als die Organisation, die den Datenpool enthält, kann der Publisher Ihren Datenpool in Analytics Hub nicht aufrufen. Sie müssen einen Link zum Datenpool mit dem Publisher teilen.

  1. Rufen Sie die Seite Analytics Hub auf.

    Zum Analytics Hub

  2. Klicken Sie in der Liste der Datenpools auf Weitere Optionen.

  3. Klicken Sie auf Link zur Freigabe kopieren.

Nutzern Zugriff auf einen Datenaustausch gewähren

Damit Nutzer auf einen Datenaustausch zugreifen können, müssen Sie die IAM-Richtlinie für diesen Datenaustausch festlegen. Informationen zu vordefinierten IAM-Nutzerrollen finden Sie unter Analytics-Hub-Nutzerrollen. Führen Sie dazu die folgenden Schritte aus:

Console

  1. Rufen Sie in der Google Cloud Console die Seite Analytics-Hub auf.

    Zum Analytics Hub

  2. Klicken Sie auf den Namen des Datenpools, für den Sie Berechtigungen festlegen möchten.

  3. Klicken Sie auf Berechtigungen festlegen.

  4. Klicken Sie zum Hinzufügen von Hauptkonten auf Hauptkonto hinzufügen.

  5. Fügen Sie im Feld Neue Hauptkonten die E-Mail-Adressen hinzu, für die Sie den Zugriff gewähren möchten.

  6. Halten Sie unter Rolle auswählen den Mauszeiger auf Analytics Hub und wählen Sie dann eine der folgenden IAM-Rollen (Identity and Access Management) aus:

    • Analytics Hub-Administrator
    • Analytics Hub-Publisher
    • Administrator von Analytics Hub-Einträgen
    • Analytics Hub-Abonnent
    • Analytics Hub-Betrachter

  7. Klicken Sie auf Speichern.

API

  1. Lesen Sie die vorhandene Richtlinie mit der Eintragsmethode getIamPolicy. Verwenden Sie dazu die Methode projects.locations.dataExchanges.getIamPolicy:

    POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/dataExchanges/DATAEXCHANGE_ID:getIamPolicy

    Dabei gilt:

    • PROJECT_ID: die Projekt-ID, z. B. my-project-1.
    • LOCATION: der Standort für Ihren Datenpool.
    • DATAEXCHANGE_ID: die Datenpool-ID.

    Analytics Hub gibt die aktuelle Richtlinie zurück.

  2. Bearbeiten Sie die Richtlinie mit einem Texteditor, um Mitglieder und ihre zugehörigen IAM-Rollen (Identity and Access Management) hinzuzufügen oder zu entfernen. Verwenden Sie das folgende Format, um Mitglieder hinzuzufügen:

    • user:test-user@gmail.com
    • group:admins@example.com
    • serviceAccount:test123@example.domain.com
    • domain:example.domain.com

    Fügen Sie der Richtlinie beispielsweise die folgende Bindung hinzu, um group:subscribers@example.com die Rolle roles/analyticshub.subscriber zuzuweisen:

    {
 "members": [
   "group:subscribers@example.com"
 ],
 "role":"roles/analyticshub.subscriber"
}

  3. Verwenden Sie die Methode projects.locations.dataExchanges.setIamPolicy, um die aktualisierte Richtlinie zu schreiben. Geben Sie im Anfragetext die aktualisierte IAM-Richtlinie aus dem vorherigen Schritt an.

    POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/dataExchanges/DATAEXCHANGE_ID:setIamPolicy

    Geben Sie im Anfragetext die Eintragsdetails an. Wenn die Anfrage erfolgreich ist, enthält der Antworttext Details zum Eintrag.

Analytics Hub-Administratoren erstellen

Zum Verwalten von Datenaustauschen müssen Sie Analytics Hub-Administratoren erstellen. Zum Erstellen von Exchange-Administratoren müssen Sie Nutzern die Rolle „Analytics Hub-Administrator“ (roles/analyticshub.admin) auf Projekt- oder Datenaustauschebene zuweisen.

Wenn Sie möchten, dass Administratoren alle Datenaustausche in einem Projekt verwalten, weisen Sie die Rolle „Analytics Hub-Administrator” für dieses Projekt zu. Wenn Sie möchten, dass Administratoren einen bestimmten Datenaustausch verwalten, weisen Sie die Rolle „Analytics Hub-Administrator” für diesen Datenaustausch zu.

Datenaustausch veröffentlichen

Standardmäßig ist ein Datenpool privat. Nur Nutzer oder Gruppen, die Zugriff darauf haben, können die Einträge aufrufen oder abonnieren. Sie können jedoch einen Datenpool öffentlich machen. Einträge in öffentlichen Datenaustauschen können von Google Cloud-Nutzern (allAuthenticatedUsers) gefunden und abonniert werden.

So machen Sie einen Datenaustausch öffentlich:

  1. Damit allAuthenticatedUsers Einträge ansehen kann, müssen Sie ihm auf Datenaustauschebene die Rolle „Analytics Hub-Betrachter“ zuweisen.

  2. Damit allAuthenticatedUsers Einträge abonnieren kann, müssen Sie ihm auf Datenaustauschebene die Rolle „Analytics Hub-Abonnent“ zuweisen.

  3. Aktivieren Sie die öffentliche Sichtbarkeit, wenn Sie einen Datenaustausch erstellen oder aktualisieren. Geben Sie die entsprechenden Berechtigungen an, wenn Sie einen Datenaustausch öffentlich machen.

Datenaustausch löschen

Wenn ein Datenaustausch gelöscht wird, werden auch alle darin enthaltenen Einträge gelöscht. Die freigegebenen Datasets und verknüpften Datasets werden jedoch nicht gelöscht. Außerdem werden die darin enthaltenen Daten nicht gelöscht, wenn ein Projekt gelöscht wird. Sie müssen diese Datenpools manuell löschen, bevor Sie das Projekt löschen. Wenn Sie einen Datenaustausch löschen, können Sie ihn nicht rückgängig machen.

So löschen Sie einen Datenaustausch:

Console

  1. Rufen Sie die Seite Analytics Hub auf.

    Zum Analytics Hub

  2. Klicken Sie in der Liste der Datenaustausche auf den Datenaustausch, den Sie löschen möchten.

  3. Klicken Sie auf Austausch löschen.

  4. Bestätigen Sie im Dialogfeld Austausch löschen? den Löschvorgang, indem Sie Löschen eingeben.

  5. Klicken Sie auf Löschen.

API

Verwenden Sie die Methode projects.locations.dataExchanges.delete.

DELETE https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/dataExchanges/DATAEXCHANGE_ID

Weitere Informationen zu den Aufgaben, die Sie für den Datenaustausch mit APIs ausführen können, finden Sie unter projects.locations.dataExchanges-Methoden.

Nächste Schritte