Abos verwalten

Sie können Ihre Abonnements 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 nachvollziehen, 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 Cloud de Confiance by S3NS 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 Cloud de Confiance 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, 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 Einschränkungen:

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

Abos als Abonnent verwalten

In den folgenden Abschnitten wird beschrieben, wie Abonnenten von BigQuery-Freigaben Abos verwalten.

Einträge abonnieren

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

Abos auflisten

Rufen Sie die Methode projects.locations.subscriptions.list 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 Cloud de Confiance 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.

Abo aktualisieren

Ein Data Exchange oder Data-Clean-Room kann veraltet sein, wenn ein Publisher oder Dateninhaber Daten hinzufügt oder entfernt. In diesem Fall wird das vorhandene verknüpfte Dataset nicht automatisch aktualisiert. Sie müssen Ihr Abo aktualisieren, um auf die neuen Ressourcen zugreifen zu können.

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

Console

  1. Rufen Sie in der Cloud de Confiance Console die Seite BigQuery auf.

    BigQuery aufrufen

  2. Klicken Sie im Bereich Explorer auf Daten hinzufügen.

  3. Wählen Sie Sharing (Analytics Hub) aus. Eine Seite zum Entdecken wird geöffnet.

  4. Suchen Sie den Data-Clean-Room oder die Datenaustauschplattform, die Sie abonniert haben, und klicken Sie darauf.

  5. Klicken Sie auf Abonnieren. Da Sie bereits ein aktives Abo haben, wird in der Konsole die Option Aktualisieren angezeigt.

  6. Klicken Sie auf Aktualisieren, um das verknüpfte Dataset mit den neuesten Ressourcen zu aktualisieren.

API

Verwenden Sie zum Aktualisieren eines Abos die Methode projects.locations.subscriptions.refresh:

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

Ersetzen Sie Folgendes:

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

Der Anfragetext muss leer sein. Bei Erfolg enthält der Antworttext eine Vorgangsinstanz.

Abos löschen

Rufen Sie zum Löschen eines Abos die Methode projects.locations.subscriptions.delete auf:

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

Ersetzen Sie Folgendes:

  • PROJECT_ID: die Cloud de Confiance 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. Bei Erfolg 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 mit mehreren Regionen löschen, werden auch alle primären und sekundären Replikate verknüpfter Datasets aus Ihrem Projekt gelöscht.

Weitere Informationen zum Verwalten von Abos mit der Analytics Hub API finden Sie unter den 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 Cloud de Confiance -Console die Seite Sharing (Analytics Hub) auf.

    Sharing (Analytics Hub) aufrufen

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

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

  3. Klicken Sie auf den Tab Abos.

API

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

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

Ersetzen Sie Folgendes:

  • PROJECT_ID: Die Cloud de Confiance Projekt-ID des Projekts, das den Datenaustausch enthält.
  • LOCATION: der Standort des Datenaustauschs, 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 BigQuery Sharing-Publisher ein Abo widerrufen, kann der Abonnent das verknüpfte Dataset nicht mehr abfragen. Da Sie diese Aktion für eine Ressource ausführen, die dem Abonnenten gehört, verbleibt das verknüpfte Dataset im Projekt des Abonnenten. Der Abonnent kann den Datensatz entfernen, indem er ihn löscht.

Wenn Sie ein Abo aus einem Multiregionen-Eintrag widerrufen, können Abonnenten keine primären oder sekundären Replikate verknüpfter Datasets mehr abfragen.

Wählen Sie eine der folgenden Optionen aus, um ein Abo zu kündigen:

Console

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

    Sharing (Analytics Hub) aufrufen

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

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

  3. Klicken Sie auf den Tab Abos.

  4. Setzen Sie ein Häkchen neben jedem Abo, das Sie widerrufen möchten.

  5. Klicken Sie auf Abos widerrufen.

API

Rufen Sie die Methode projects.locations.subscriptions.revoke 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 Cloud de Confiance 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