Abos verwalten

In diesem Dokument wird beschrieben, wie Sie Ihre BigQuery-Freigabeabos verwalten. Es werden Aufgaben für Abonnenten und Publisher behandelt.

Als BigQuery Sharing-Abonnent haben Sie folgende Möglichkeiten:

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

Als BigQuery-Sharing-Publisher haben Sie folgende Möglichkeiten:

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

Ein BigQuery-Abo zum Teilen 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.

Hinweise

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 Seite Analytics Hub API auf und aktivieren Sie die Analytics Hub API für Ihr Google Cloud Projekt.

Analytics Hub API aktivieren

gcloud

Führen Sie den Befehl gcloud services enable 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, um die Berechtigungen zu 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 für die Verwaltung von Abos

In den folgenden Abschnitten wird beschrieben, was BigQuery-Abonnenten mit Abos tun können.

Einträge abonnieren

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

Abos auflisten

Verwenden Sie die Methode projects.locations.subscriptions.list, 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

Wenn Sie ein Abo löschen möchten, verwenden Sie die Methode projects.locations.subscriptions.delete:

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

Ersetzen Sie Folgendes:

  • PROJECT_ID: die Projekt-ID des Abos, das gelöscht werden soll.
  • LOCATION: der Standort des zu löschenden Abos. Weitere Informationen zu Standorten, die die Freigabe unterstützen, finden Sie unter Unterstützte Regionen.
  • SUBSCRIPTION_ID: die ID des zu löschenden Abos.

Der Anfragetext muss leer sein. Bei erfolgreicher Ausführung enthält der Antworttext eine Vorgangsinstanz.

Wenn ein Abonnent, der BigQuery-Daten freigibt, ein Abo löscht, wird auch das verknüpfte Dataset aus dem Projekt des Abonnenten gelöscht.

Wenn Sie ein Abo aus einem Multi-Region-Eintrag (Vorschau) löschen, werden auch alle primären und sekundären Replikate des verknüpften Datasets aus dem Projekt des Abonnenten gelöscht.

Weitere Informationen zu den Aufgaben, die Sie mit Abos über die API ausführen können, finden Sie unter projects.locations.subscriptions-Methoden.

Publisher-Workflows für die Verwaltung von Abos

In den folgenden Abschnitten wird beschrieben, was Verlage und Webpublisher, die BigQuery-Daten freigeben, mit Abos tun können. 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 Freigabe (Analytics Hub) auf.

    Zur Freigabe (Analytics Hub)

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

  2. Klicken Sie auf den Namen der Datenaustauschplattform, in der Sie die Abos auflisten möchten.

  3. Klicken Sie auf den Tab Abos, um alle Abos für Einträge in der Datenaustauschplattform aufzurufen.

API

Verwenden Sie die projects.locations.dataExchanges.listSubscriptions-Methode, um Abos für Einträge in einem bestimmten Datenaustausch 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 Datenaustauschs, für den Abos aufgelistet werden sollen.
  • LOCATION: der Standort des Datenpools, für den Abos aufgeführt werden sollen.
  • DATAEXCHANGE_ID: die ID des Datenaustauschs, für den Abos aufgelistet werden sollen.

Abos stornieren

Wenn ein BigQuery-Freigabe-Publisher ein Abo widerruft, 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 (Vorschau) widerruft, 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 kündigen:

Console

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

    Zur Freigabe (Analytics Hub)

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

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

  3. Klicken Sie auf den Tab Abos, um alle Abos für die Datenaustauschplattform aufzurufen.

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

  5. Klicken Sie auf Abos widerrufen.

API

Wenn Sie ein Abo widerrufen möchten, verwenden Sie die Methode projects.locations.subscriptions.revoke.

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

Beschränkungen

Für Abos gelten die folgenden Einschränkungen:

  • Sie können die API nur zum Verwalten von Abos verwenden, die nach dem 25. Juli 2023 erstellt wurden. Verknüpfte Datasets, die vor diesem Datum erstellt wurden, werden nicht unterstützt, da die erforderliche Aboressource fehlt.

Nächste Schritte