Einträge verwalten

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

• Einträge in einer Datenaustauschplattform erstellen, auf die Sie Veröffentlichungszugriff haben.
• Nutzungsmesswerte für Einträge aktualisieren, löschen, freigeben und ansehen.
• Verschiedene Rollen für Ihre Analytics Hub-Einträge verwalten, z. B. für Eintragsadministratoren, Abonnenten und Betrachter.
• Alle Abonnenten aufrufen, die Ihren Eintrag abonniert haben.
• Die Nutzung Ihrer Einträge überwachen.
• Abonnenten aus dem Eintrag entfernen.

Ein Eintrag ist ein Verweis auf ein freigegebenes Dataset, das ein Publisher in einem Datenaustausch auflistet. Ein Eintrag kann zu einem der folgenden beiden Typen gehören, basierend auf der IAM-Richtlinie (Identity and Access Management), die für den Eintrag festgelegt ist, und dem Typ des Datenaustauschs, der den Eintrag enthält:

• Öffentlicher Eintrag. Er kann von Google Cloud-Nutzern (allAuthenticatedUsers) gefunden und abonniert werden. Einträge in einer öffentlichen Datenaustauschplattform sind öffentliche Einträge. Diese Einträge können Verweise auf ein kostenloses öffentliches Dataset oder ein kommerzielles Dataset sein. Wenn der Eintrag ein kommerzielles Dataset betrifft, können Abonnenten Zugriff auf den Eintrag anfordern und der Datenanbieter kontaktiert diese Abonnenten dann direkt.

• Privater Eintrag. Dieser wird direkt für Einzelpersonen oder Gruppen freigegeben. Beispielsweise kann ein privater Eintrag auf Marketingmesswerte-Datasets verweisen, die Sie für andere interne Teams in Ihrer Organisation freigeben. Obwohl Sie allAuthenticatedUsers erlauben, Ihre Einträge zu abonnieren, bleibt der Eintrag privat und wird nicht als öffentlicher Eintrag auf der Analytics-Hub-Seite angezeigt. Wenn Sie solche Einträge für Nutzer freigeben möchten, geben Sie die URL des Eintrags für Nutzer frei. Damit ein privater Eintrag gefunden werden kann, müssen Sie Ihren Datenaustausch veröffentlichen.

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

Zum Verwalten von Einträgen und Abos benötigen Sie eine der folgenden Analytics Hub-Rollen:

• Rolle „Analytics Hub-Publisher“ (roles/analyticshub.publisher), mit der Sie IAM-Richtlinien für Ihre Einträge erstellen, aktualisieren, löschen und festlegen können.

• Rolle „Administrator für Analytics Hub-Einträge“ (roles/analyticshub.listingAdmin), mit der Sie IAM-Richtlinien für Ihre Einträge aktualisieren, löschen und festlegen können.

• Rolle „Analytics Hub-Administrator“ (roles/analyticshub.Admin), mit der Sie IAM-Richtlinien für alle Einträge in Ihrem Datenaustausch erstellen, aktualisieren, löschen und festlegen können.

Weitere Informationen finden Sie unter Nutzerrollen für Analytics Hub. Informationen zum Zuweisen dieser Rollen für andere Nutzer finden Sie unter Eintragsadministrator erstellen.

Zum Erstellen von Einträgen benötigen Sie außerdem die Berechtigungen bigquery.datasets.getund bigquery.datasets.update für die Datasets, für die Sie Einträge erstellen möchten. Folgende vordefinierte BigQuery-Rollen haben die Berechtigung bigquery.datasets.update:

• Rolle „BigQuery-Dateninhaber“ (roles/bigquery.dataOwner)
• BigQuery-Administratorrolle (roles/bigquery.admin)

Wenn Sie alle Datenaustausch zwischen Projekten in einer Organisation ansehen möchten, auf die Sie Zugriff haben, benötigen Sie die Berechtigung resourcemanager.organizations.get. Es gibt keine vordefinierten BigQuery-Rollen, die diese Berechtigung enthalten. Daher müssen Sie eine benutzerdefinierte IAM-Rolle verwenden.

Datenaustausch ansehen

Informationen zum Aufrufen der Datenaustauschliste in Ihrer Organisation, auf die Sie Zugriff haben, finden Sie unter Datenaustausch aufrufen. Wenn sich der Datenaustausch in einer anderen Organisation befindet, muss der Analytics Hub-Administrator einen Link zu diesem Datenaustausch für Sie freigeben.

Eintrag erstellen

Ein Eintrag ist ein Verweis auf ein freigegebenes Dataset, das ein Publisher in einem Datenaustausch auflistet.

Achtung: Wir empfehlen, dass Sie Ihre freigegebenen Datasets nicht in einem Projekt mit einem VPC Service Controls-Perimeter hinzufügen. In diesem Fall müssen Sie die entsprechenden Regeln für eingehenden und ausgehenden Traffic hinzufügen.

So erstellen Sie einen Eintrag:

Console

1. Rufen Sie die Seite Analytics Hub auf.

   Zum Analytics Hub

   Es wird eine Seite angezeigt, auf der alle Datenaustauschplattformen aufgeführt sind, auf die Sie zugreifen können.

2. Klicken Sie auf den Namen des Datenaustauschs, in dem Sie den Eintrag erstellen möchten.

3. Klicken Sie auf Eintrag erstellen.

4. Geben Sie auf der Seite Eintrag erstellen unter Anzeigename den Namen des Eintrags ein.

5. Wenn Sie ein kommerzielles Dataset erstellen, müssen Sie das Feld Zugriffskontakt anfordern ausfüllen. Sie müssen eine E-Mail-Adresse oder eine URL des Aufnahmeformulars eingeben, damit die Abonnenten Sie kontaktieren können.

6. Optional: Geben Sie die folgenden Informationen ein:

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

   • Kategorie: Wählen Sie bis zu zwei Kategorien aus, die Ihren Eintrag am besten darstellen. Abonnenten können nach diesen Kategorien Einträge filtern.

   • Anbieter: Maximieren Sie den Abschnitt Anbieter und geben Sie in den folgenden Feldern Details an:

     • Providername: der Name des Dataset-Anbieters.
     • Primärer Kontakt des Anbieters: Eine E-Mail-Adresse oder eine URL des primären Kontakts des Dataset-Anbieters.

     Abonnenten können Einträge basierend auf den Datenanbietern filtern.

   • Publisher: Maximieren Sie den Abschnitt Publisher und geben Sie Details in den folgenden Feldern an:

     • Publisher-Name: der Name des Publishers, der den Eintrag erstellt.
     • Primärer Kontakt des Publishers: Eine E-Mail-Adresse oder eine URL des primären Kontakts des Datasets-Publishers.

   • Symbol: Ein Symbol für Ihren Eintrag. PNG- und JPEG-Dateiformate werden unterstützt. Die Dateigröße der Symbole muss unter 512 KiB liegen und die Abmessungen dürfen 512 x 512 Pixel nicht überschreiten.

   • Beschreibung: Eine kurze Beschreibung Ihres Eintrags. Abonnenten können anhand der Beschreibung nach Einträgen suchen.

7. Wählen Sie unter Quell-Dataset das Dataset aus, das Sie im Datenaustausch auflisten möchten. Das Quell-Dataset muss sich in derselben Region wie der Datenaustausch befinden. Sie können dieses Feld nicht mehr aktualisieren, nachdem der Eintrag erstellt wurde.

   Wichtig: Der Name des Quell-Datasets und die ID des Projekts, das das Dataset enthält, werden zurückgegeben, wenn Abonnenten die Metadaten des verknüpften Datasets aufrufen.

8. Wählen Sie in Ausgehender Traffic (Vorschau) die entsprechende Ausgehender Traffic-Option. Nur Abonnenten mit Nicht versionsgebundenen Angeboten oder Enterprise Plus Version können Daten mit Einschränkungen für ausgehenden Traffic abfragen.

   • Um die Beschränkung des ausgehenden Traffics auf Ihr freigegebenes Dataset anzuwenden, aber nicht auf die Abfrageergebnisse Ihres freigegebenes Datasets, wählen Sie Kopieren und Exportieren von freigegebenen Daten deaktivieren.
   • Um die Einschränkungen für ausgehenden Traffic auf Ihr freigegebenes Dataset und die Abfrageergebnisse Ihres freigegebenen Datasets anzuwenden, wählen Sie Kopieren und Exportieren von Abfrageergebnissen deaktivieren, wodurch automatisch auch Kopieren und Exportieren von freigegebenen Daten deaktivieren festgelegt wird.

9. Optional: Im Abschnitt Dokumentation > Markdown können Sie zusätzliche Informationen eingeben, wie Beispielabfragen, die Sie für das Dataset ausführen können, oder Links zu relevanten Dokumentationen und zusätzliche Informationen, die Abonnenten bei der Verwendung Ihres Datasets unterstützen können.

10. Klicken Sie auf Speichern.

API

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

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

Dabei gilt:

• PROJECT_ID: die Projekt-ID, die den Datenaustausch enthält, in dem Sie den Eintrag 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 Datenpool-ID.
• LISTING_ID: die ID des Eintrags.

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

Weitere Informationen zu den Aufgaben, die Sie für Einträge mithilfe von APIs ausführen können, finden Sie unter projects.locations.dataExchanges.listings-Methoden.

Nutzern Zugriff auf einen Eintrag gewähren

Wenn Sie Nutzern Zugriff auf einen privaten Eintrag gewähren möchten, müssen Sie für diese Person eine IAM-Richtlinie oder eine Gruppe für diesen Eintrag festlegen. Bei einem kommerziellen Eintrag muss Ihr Datenaustausch öffentlich sein. Einträge in einem öffentlichen Datenaustausch werden im Analytics Hub für alle Google Cloud-NutzerallAuthenticatedUsers) angezeigt. Damit Nutzer Zugriff auf kommerzielle Einträge anfordern können, müssen Sie ihnen die folgende Berechtigung zuweisen: Rolle "Analytics Hub-Betrachter".

So gewähren Sie Nutzern Zugriff auf die Anzeige oder das Abonnieren Ihres Eintrags:

Console

1. Rufen Sie die Seite Analytics Hub auf.

   Zum Analytics Hub

2. Klicken Sie auf den Namen des Datenaustauschs, der den Eintrag enthält.

3. Klicken Sie auf den Eintrag, für den Sie Abonnenten hinzufügen möchten.

4. Klicken Sie auf Berechtigungen festlegen.

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

6. Fügen Sie im Feld Neue Hauptkonten die folgenden Details je nach Art des Eintrags hinzu:

   • Geben Sie für einen privaten Eintrag E-Mails der Identität ein, der Sie Zugriff gewähren möchten.

   • Fügen Sie für einen öffentlichen Eintrag allAuthenticatedUsers hinzu.

7. Halten Sie unter Rolle auswählen den Mauszeiger auf Analytics Hub. Wählen Sie dann abhängig vom Typ des Eintrags eine der folgenden Rollen aus:

   • Wählen Sie für einen kommerziellen Eintrag die Rolle Analytics Hub-Betrachter aus. Mit dieser Rolle können Nutzer den Eintrag ansehen und Zugriff anfordern.

   • Wählen Sie für einen privaten oder nicht kommerziellen öffentlichen Eintrag die Rolle Analytics Hub-Abonnent aus. Mit dieser Rolle können Nutzer Ihren Eintrag abonnieren.

   Weitere Informationen finden Sie unter Analytics Hub-Abonnenten- und -Betrachterrollen.

8. Klicken Sie auf Speichern.

API

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

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

   Ersetzen Sie Folgendes:

   • PROJECT_ID: die Projekt-ID, z. B. my-project-1.
   • LOCATION: der Standort des Datenpools, der den Eintrag enthält.
   • DATAEXCHANGE_ID: die Datenpool-ID.
   • LISTING_ID: die ID des Eintrags.

   Analytics Hub gibt die aktuelle Richtlinie in der Antwort zurück.

2. Wenn Sie Mitglieder und ihre zugehörigen Rollen hinzufügen oder entfernen möchten, bearbeiten Sie die Richtlinie in einem Texteditor. Verwenden Sie das folgende Format, um Mitglieder hinzuzufügen:

   • user:[e-mail]
   • group:[e-mail]
   • serviceAccount:[e-mail]
   • domain:example.domain.com

   Fügen Sie der Richtlinie beispielsweise die folgende Bindung hinzu, um group:[e-mail] die Rolle roles/analyticshub.subscriber zuzuweisen:

   {
    "members": [
      "group:[e-mail]"
    ],
    "role":"roles/analyticshub.subscriber"
   }
   

3. Verwenden Sie die Methode projects.locations.dataExchanges.listings.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/location/LOCATION/dataExchanges/DATAEXCHANGE_ID/listings/LISTING_ID:setIamPolicy
   

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

Weitere Informationen zu den Aufgaben, die Sie für Einträge mithilfe von APIs ausführen können, finden Sie unter projects.locations.dataExchanges.listings-Methoden.

Hinweis: Nachdem Sie Nutzern Lizenzen gewährt haben, um auf Ihren kommerziellen Eintrag zuzugreifen, haben Sie entweder die Möglichkeit, für diese Nutzer einen privaten Eintrag zu erstellen oder ihnen die Rolle Analytics Hub-Abonnent für Ihren kommerziellen Eintrag zuzuweisen.

Eintragadministrator erstellen

Damit Nutzer Einträge verwalten können, müssen Sie Analytics Hub-Eintragsadministratoren erstellen. Zum Erstellen von Eintragsadministratoren müssen Sie Nutzern auf Eintragsebene die Rolle "Analytics Hub-Publisher" oder "Analytics Hub-Eintragsadministrator" zuweisen. Weitere Informationen zum Zuweisen dieser Rollen für einen Eintrag finden Sie unter Rolle für einen Eintrag zuweisen.

Alle Abos ansehen

Wählen Sie eine der folgenden Optionen aus, um alle aktuellen Abos für Ihren Eintrag aufzurufen:

Console

1. Rufen Sie die Seite Analytics Hub auf.

   Zum Analytics Hub

2. Klicken Sie auf den Namen des Datenaustauschs, der den Eintrag enthält, für den Sie Abos verwalten möchten.

3. Klicken Sie auf den Eintrag, für den Sie alle Abonnenten auflisten möchten.

4. Klicken Sie auf Abos verwalten, um alle Abonnenten Ihres Eintrags aufzurufen.

   

5. Optional: Sie können die Ergebnisse nach Abonnentendetails filtern.

Wenn Sie Zugriff auf das freigegebene Dataset haben, können Sie alternativ die folgenden Schritte ausführen, um Abonnenten aufzulisten:

1. Rufen Sie die Seite BigQuery auf.

   BigQuery aufrufen

2. Maximieren Sie im Bereich Explorer Ihr Projekt und wählen Sie das freigegebene Dataset aus.

3. Wählen Sie in der Liste Freigabe die Option Abos verwalten aus.

SQL

Im folgenden Beispiel wird die Ansicht INFORMATION_SCHEMA.SCHEMATA_LINKS verwendet, um alle verknüpften Datasets mit einem freigegebenen Dataset in myproject aufzulisten, die sich in der Region us befinden:

SELECT * FROM `myproject`.`region-us`.INFORMATION_SCHEMA.SCHEMATA_LINKS;

Die entsprechende Ausgabe sieht etwa so aus: Einige Spalten werden weggelassen, um die Ausgabe zu vereinfachen.

+----------------+-------------+----------------------------+------------------------------+--------------------+--------------------------------+
|  catalog_name  | schema_name | linked_schema_catalog_name | linked_schema_catalog_number | linked_schema_name | linked_schema_org_display_name |
+----------------+-------------+----------------------------+------------------------------+--------------------+--------------------------------+
| myproject      | myschema1   | subscriptionproject1       |                 974999999291 | subscriptionld1    | subscriptionorg                |
| myproject      | myschema2   | subscriptionproject2       |                 974999999292 | subscriptionld2    | subscriptionorg                |
| myproject      | myschema3   | subscriptionproject3       |                 974999999293 | subscriptionld3    | subscriptionorg                |
+----------------+-------------+----------------------------+------------------------------+--------------------+--------------------------------+

API

Verwenden Sie die Methode projects.locations.dataExchanges.listings.listSubscriptions.

GET https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/dataExchanges/DATAEXCHANGE_ID/listings/LISTING_ID:listSubscriptions

Ersetzen Sie Folgendes:

• PROJECT_ID: die Projekt-ID des Eintrags, den Sie abonnieren möchten.
• LOCATION: der Standort für Ihren Eintrag, den Sie abonnieren möchten.
• DATAEXCHANGE_ID: die Datenaustausch-ID, die den Eintrag enthält, den Sie abonnieren möchten.
• LISTING_ID: die ID des Eintrags, den Sie abonnieren möchten.

Abos entfernen

Wenn Sie ein vor dem 25. Juli 2023 erstelltes Abo aus Ihren Listen entfernen, wird das verknüpfte Dataset vom freigegebenen Dataset getrennt. Abonnenten können die Datasets weiterhin in ihren Projekten sehen, sind aber nicht mehr mit dem freigegebenen Dataset verknüpft.

So entfernen Sie ein Abo, das vor dem 25. Juli 2023 erstellt wurde, aus Ihren Einträgen:

1. Folgen Sie der Anleitung in der Google Cloud Console unter Alle Abos ansehen, um alle Abonnenten eines Eintrags aufzulisten.

2. Klicken Sie auf Löschen, um einen Abonnenten aus einem Eintrag zu entfernen. Wenn Sie alle Abos entfernen möchten, klicken Sie auf Alle Abos entfernen.

3. Geben Sie im Dialogfeld Abo entfernen? remove ein, um den Vorgang zu bestätigen.

4. Klicken Sie auf Entfernen.

So entfernen Sie Abos, die nach dem 25. Juli 2023 erstellt wurden:

Console

1. Folgen Sie der Anleitung in der Google Cloud Console unter Alle Abos ansehen, um alle Abonnenten eines Eintrags aufzulisten.

2. Klicken Sie auf den Tab Abos.

3. Wählen Sie zum Entfernen eines Abonnenten aus dem Eintrag die zu entfernenden Abos aus und klicken Sie auf Abos entfernen.

4. Geben Sie im Dialogfeld Abo entfernen? remove ein, um den Vorgang zu bestätigen.

5. Klicken Sie auf Entfernen.

API

Verwenden Sie die Methode projects.locations.subscriptions.revoke (Vorschau).

POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/subscriptions/SUBSCRIPTION_ID:revoke

Ersetzen Sie Folgendes:

• PROJECT_ID: die Projekt-ID des Abos, das Sie entfernen möchten.
• LOCATION: der Standort des Abos, das Sie entfernen möchten.
• SUBSCRIPTION: die ID des Abos, das Sie entfernen möchten.

Eintrag aktualisieren

So aktualisieren Sie einen Eintrag:

Console

1. Rufen Sie die Seite Analytics Hub auf.

   Zum Analytics Hub

2. Klicken Sie auf den Namen des Datenaustauschs, der den Eintrag enthält.

3. Klicken Sie auf den Eintrag, den Sie aktualisieren möchten.

4. Klicken Sie auf Eintrag bearbeiten.

5. Ändern Sie die Werte in den Feldern. Sie können alle Werte mit Ausnahme des Quell-Datasets des Eintrags ändern.

6. Klicken Sie auf Vorschau, um eine Vorschau der Änderungen anzuzeigen.

7. Klicken Sie auf Save (Speichern), um die Änderungen zu speichern.

API

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

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

Ersetzen Sie UPDATEMASK durch die Liste der Felder, die Sie aktualisieren möchten. Verwenden Sie zum Aktualisieren mehrerer Werte eine durch Kommas getrennte Liste. Geben Sie im Anfragetext die aktualisierten Werte an.

Weitere Informationen zu den Aufgaben, die Sie für Einträge mithilfe von APIs ausführen können, finden Sie unter projects.locations.dataExchanges.listings-Methoden.

Eintrag löschen

Wenn Sie einen Eintrag löschen, können Abonnenten den Eintrag nicht mehr aufrufen. Wenn Sie einen Eintrag löschen, werden auch alle verknüpften Datasets und damit alle Abos aus den Projekten Ihrer Abonnenten gelöscht.

Wenn Sie einen Eintrag löschen, kann er nicht rückgängig gemacht werden. So löschen Sie einen Eintrag:

Console

1. Rufen Sie die Seite Analytics Hub auf.

   Zum Analytics Hub

2. Klicken Sie auf den Namen des Datenaustauschs, der den Eintrag enthält.

3. Klicken Sie auf den Eintrag, den Sie löschen möchten.

4. Klicken Sie auf Löschen.

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

6. Klicken Sie auf Löschen.

API

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

DELETE https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/dataExchanges/DATAEXCHANGE_ID/listings/LISTING_ID

Weitere Informationen zu den Aufgaben, die Sie für Einträge mithilfe von APIs ausführen können, finden Sie unter projects.locations.dataExchanges.listings-Methoden.

Nächste Schritte

• Mehr über die Analytics Hub-Architektur erfahren
• Informationen zum Aufrufen und Abonnieren von Einträgen
• Weitere Informationen zu Analytics Hub-Nutzerrollen
• Datasets erstellen
• Audit-Logging in Analytics Hub
• Einträge überwachen