Abos verwalten

In diesem Dokument wird beschrieben, wie Sie Abos in BigQuery Sharing (früher Analytics Hub) verwalten. Es werden Aufgaben für Abonnenten und Publisher behandelt.

Abonnenten von BigQuery Sharing haben folgende Möglichkeiten:

  • Eintrag abonnieren
  • Aktuelle Abos in einem bestimmten Google Cloud Projekt auflisten
  • Ein Abo löschen

Publisher von BigQuery Sharing haben folgende Möglichkeiten:

  • Alle Abos Ihres Eintrags ansehen
  • Zugriff auf ein bestimmtes Abo widerrufen

Ein BigQuery Sharing-Abo ist eine regionalisierte Ressource, die sich im Projekt des Abonnenten befindet. Abos speichern relevante Informationen zum Abonnenten und stellen den Vertrag zwischen Publisher und Abonnent dar.

Hinweis

Damit Sie BigQuery Sharing (früher Analytics Hub) nutzen können, müssen Sie die Analytics Hub API in Ihrem Google Cloud Projekt aktivieren.

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:

Wählen Sie eine der folgenden Optionen aus, um die Analytics Hub API zu aktivieren:

Console

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

Analytics Hub API aktivieren

gcloud

Führen Sie den Bef0}gcloud services enable ehl aus:

gcloud services enable analyticshub.googleapis.com

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Analytics Hub Subscription Owner (roles/analyticshub.subscriptionOwner) für das Projekt zuzuweisen, damit Sie die Berechtigungen erhalten, die Sie zum Verwalten von Abos 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.

Abonnenten-Workflows zum Verwalten von Abos

In diesem Abschnitt wird beschrieben, wie Abonnenten von BigQuery Sharing Abos verwalten.

Einträge abonnieren

Führen Sie die Schritte unter Einträge und Datenpools ansehen und abonnierenaus, um Einträge zu abonnieren.

Abos auflisten

Verwenden Sie die projects.locations.subscriptions.list Methode, um Ihre aktuellen Abos in einem bestimmten Projekt aufzulisten:

GET https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/subscriptions

Ersetzen Sie Folgendes:

  • PROJECT_ID: die Google Cloud Projekt-ID für die Abos, die Sie auflisten möchten.
  • LOCATION: der Standort für die Abos, die Sie auflisten möchten.

Abos löschen

Verwenden Sie die projects.locations.subscriptions.delete Methode, um ein Abo zu löschen:

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

Ersetzen Sie Folgendes:

Der Anfragetext muss leer sein. Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Vorgangsinstanz.

Wenn ein Abonnent von BigQuery Sharing ein Abo löscht, wird auch das verknüpfte Dataset aus dem Projekt des Abonnenten gelöscht.

Wenn Sie ein Abo aus einem multiregionalen Eintrag löschen, werden auch alle primären und sekundären verknüpften Dataset-Replikate aus dem Projekt des Abonnenten gelöscht.

Weitere Informationen zum Verwalten von Abos mit der API finden Sie unter den projects.locations.subscriptions Methoden.

Publisher-Workflows zum Verwalten von Abos

In diesem Abschnitt wird beschrieben, wie Publisher von BigQuery Sharing Abos verwalten. Weitere Informationen zum Verwalten von Abos für Einträge finden Sie unter Einträge verwalten.

Abos auflisten

Wählen Sie eine der folgenden Optionen aus, um alle Abos aufzulisten.

Console

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

    Sharing (Analytics Hub) aufrufen

    Auf der Seite sind alle Datenpools aufgeführt, auf die Sie zugreifen können.

  2. Wählen Sie den Namen des Datenpools aus, in dem Sie Abos auflisten möchten.

  3. Wählen Sie den Tab Abos aus, um alle Abos für Einträge im Datenpool aufzurufen.

API

Verwenden Sie die projects.locations.dataExchanges.listSubscriptions Methode, um Abos für Einträge in einem bestimmten Datenpool aufzulisten.

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

Ersetzen Sie Folgendes:

  • PROJECT_ID: die Projekt-ID des Datenpools, für den Abos aufgelistet werden sollen.
  • LOCATION: der Standort des Datenpools, für den Abos aufgelistet werden sollen.
  • DATAEXCHANGE_ID: die ID des Datenpools, für den Abos aufgelistet werden sollen.

Abos stornieren

Wenn ein Publisher von BigQuery Sharing ein Abo storniert, kann der Abonnent das verknüpfte Dataset nicht mehr abfragen. Da diese Aktion vom Publisher für eine Ressource des Abonnenten initiiert wird, verbleibt das verknüpfte Dataset im Projekt des Abonnenten. Der Abonnent kann das Dataset entfernen, indem er es löscht.

Wenn ein Publisher ein Abo aus einem multiregionalen Eintrag storniert, können Abonnenten keine primären oder sekundären verknüpften Dataset-Replikate mehr abfragen.

Wählen Sie eine der folgenden Optionen aus, um ein Abo zu stornieren:

Console

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

    Sharing (Analytics Hub) aufrufen

    Auf der Seite sind alle Datenpools aufgeführt, auf die Sie zugreifen können.

  2. Wählen Sie den Namen des Datenpools aus, in dem Sie den Eintrag stornieren möchten.

  3. Wählen Sie den Tab Abos aus, um alle Abos für den Datenpool aufzurufen.

  4. Wählen Sie die Abos aus, die Sie stornieren möchten.

  5. Klicken Sie auf Abos stornieren.

API

Verwenden Sie die projects.locations.subscriptions.revoke Methode, um ein Abo zu stornieren.

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 storniert werden soll.
  • LOCATION: der Standort des Abos.
  • SUBSCRIPTION_ID: die ID des Abos, das storniert werden soll.

Beschränkungen

Für Abos gelten die folgenden Beschränkungen:

  • Sie können die API nur verwenden, um Abos zu verwalten, die nach dem 25. Juli 2023 erstellt wurden. Verknüpfte Datasets, die vor diesem Datum erstellt wurden, werden nicht unterstützt, da sie nicht die erforderliche Aboressource enthalten.

Nächste Schritte