Abos verwalten

Sie können Ihre Abos in BigQuery Sharing (früher Analytics Hub) verwalten, um den Datenzugriff und die Datenfreigabe zu steuern. Als Abonnent können Sie Einträge abonnieren, Ihre Abos ansehen und sie löschen. Als Publisher können Sie beobachten, wer Zugriff auf Ihre Einträge hat, und Abos bei Bedarf widerrufen. Ein BigQuery Sharing-Abo ist eine regionalisierte Ressource, die sich im Projekt des Abonnenten befindet. Abos speichern Informationen zum Abonnenten und stellen den Vertrag zwischen dem Publisher und dem Abonnenten 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.

Beschränkungen

Für Abos gelten die folgenden Beschränkungen:

  • Sie können die Analytics Hub 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.

Abos als Abonnent verwalten

In den folgenden Abschnitten 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

Rufen Sie die projects.locations.subscriptions.list Methode auf, um Ihre Abos in einem Projekt aufzulisten:

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

Ersetzen Sie Folgendes:

  • PROJECT_ID: die Google Cloud Projekt-ID des Projekts, das die Abos enthält, die Sie auflisten möchten.
  • LOCATION: der Standort der Abos, die Sie auflisten möchten. Weitere Informationen zu Standorten, die die Freigabe unterstützen, finden Sie unter Unterstützte Regionen.

Abos löschen

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

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

Ersetzen Sie Folgendes:

  • PROJECT_ID: die Google Cloud Projekt-ID des Projekts, das das Abo enthält, das Sie löschen möchten.
  • LOCATION: der Standort des Abos, das Sie löschen möchten.
  • SUBSCRIPTION_ID: die ID des Abos, das Sie löschen möchten.

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

Wenn Sie ein Abo löschen, wird auch das verknüpfte Dataset aus Ihrem Projekt gelöscht.

Wenn Sie ein Abo aus einem Eintrag in einer Multiregion löschen, werden auch alle primären und sekundären Replikate des verknüpften Datasets aus Ihrem Projekt gelöscht.

Weitere Informationen zum Verwalten von Abos mit der Analytics Hub API, siehe die projects.locations.subscriptions Methoden.

Abos als Publisher verwalten

In den folgenden Abschnitten 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 werden alle Datenpools aufgelistet, auf die Sie zugreifen können.

  2. Klicken Sie in der Liste der Datenpools auf den Namen des Datenpools, der die Abos enthält, die Sie auflisten möchten.

  3. Klicken Sie auf den Tab Abos.

API

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

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

Ersetzen Sie Folgendes:

  • PROJECT_ID: die Google Cloud Projekt-ID des Projekts, das den Datenpool enthält.
  • LOCATION: der Standort des Datenpools, der die Abos enthält, die Sie auflisten möchten.
  • DATAEXCHANGE_ID: die ID des Datenpools, für den Abos aufgelistet werden sollen.

Abos stornieren

Wenn Sie als Publisher von BigQuery Sharing ein Abo widerrufen, kann der Abonnent das verknüpfte Dataset nicht mehr abfragen. Da Sie diese Aktion für eine Ressource auslösen, die dem Abonnenten gehört, verbleibt das verknüpfte Dataset im Projekt des Abonnenten. Der Abonnent kann das Dataset entfernen, indem er es löscht.

Wenn Sie ein Abo aus einem Eintrag in einer Multiregion widerrufen, können Abonnenten keine primären oder sekundären Replikate des verknüpften Datasets mehr abfragen.

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

Console

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

    Sharing (Analytics Hub) aufrufen

    Auf der Seite werden alle Datenpools aufgelistet, auf die Sie zugreifen können.

  2. Klicken Sie in der Liste der Datenpools auf den Namen des Datenpools, der das Abo enthält, das Sie widerrufen möchten.

  3. Klicken Sie auf den Tab Abos.

  4. Klicken Sie das Kästchen neben jedem Abo an, das Sie widerrufen möchten.

  5. Klicken Sie auf Abos widerrufen.

API

Rufen Sie die projects.locations.subscriptions.revoke Methode auf, um ein Abo zu widerrufen:

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

Ersetzen Sie Folgendes:

  • PROJECT_ID: die Google Cloud Projekt-ID des Projekts, das das Abo enthält, das Sie widerrufen möchten.
  • LOCATION: der Standort des Abos, das Sie widerrufen möchten.
  • SUBSCRIPTION_ID: die ID des Abos, das Sie widerrufen möchten.

Nächste Schritte