Abos verwalten

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

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

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

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

Ein 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.

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.

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:

Konsole

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-Workflow

Abonnenten können für Abos die folgenden Aktionen ausführen.

Einträge abonnieren

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

Abos auflisten

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

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

Ersetzen Sie Folgendes:

  • PROJECT_ID: die Projekt-ID, die die Abos enthält, die Sie auflisten möchten.

  • LOCATION: der Standort, für den Sie die vorhandenen Abos 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, die das Abo enthält, das Sie löschen möchten.
  • LOCATION: der Standort des Abos, das Sie löschen möchten. Weitere Informationen zu Standorten, die die BigQuery-Freigabe unterstützen, finden Sie unter Unterstützte Regionen.
  • SUBSCRIPTION_ID: die ID des Abos, das Sie löschen möchten.

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

Wenn ein Abonnent ein Abo löscht, wird das verknüpfte Dataset aus seinem Projekt gelöscht.

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

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

Publisher-Workflow

Publisher können für Abos die folgenden Aktionen ausführen. 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.

    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 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 von Einträgen in einem bestimmten Data Exchange 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 Sie die Abos auflisten möchten, die Sie entfernen möchten.
  • LOCATION: der Standort des Datenpools, für den Sie die Abos auflisten möchten.
  • DATAEXCHANGE_ID: die ID des Datenaustauschs, für den Sie die Abos auflisten möchten.

Abos stornieren

Wenn ein Publisher ein Abo widerruft, kann der Abonnent das verknüpfte Dataset nicht mehr abfragen. Da es sich um eine vom Publisher initiierte Aktion für eine Ressource handelt, die dem Abonnenten gehört, bleibt das verknüpfte Dataset im Projekt des Abonnenten bestehen. Der Abonnent kann das verwaiste Dataset entfernen, indem er es löscht.

Wenn ein Publisher ein Abo aus einem Eintrag für mehrere Regionen widerruft (Vorschau), 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.

    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 den Tab Abos, um alle Abos für die Datenaustauschplattform aufzurufen.

  4. Klicken Sie auf das Kästchen neben den Abos, die Sie widerrufen möchten, oder wählen Sie alle Abos aus.

  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 Sie widerrufen möchten.
  • LOCATION: der Standort des Abos.
  • SUBSCRIPTION_ID: die ID des Abos, das Sie widerrufen möchten.

Beschränkungen

Abos unterliegen den folgenden Beschränkungen:

  • Verknüpfte Datasets, die vor dem 25. Juli 2023 erstellt wurden, werden nicht per Backfill ausgefüllt. Nur Abos, die nach dem 25. Juli 2023 erstellt wurden, funktionieren mit den API-Methoden.

Nächste Schritte