Einträge verwalten

Als Datenpublisher in BigQuery Sharing (früher Analytics Hub) können Sie Einträge erstellen und verwalten, um Datasets sicher organisationsübergreifend mit Abonnenten zu teilen, ohne Daten zu kopieren.

Wenn Sie Einträge verwalten, haben Sie folgende Möglichkeiten:

  • Einträge in beliebigen Datenpools erstellen, aktualisieren, freigeben und löschen, auf die Sie Veröffentlichungszugriff haben.
  • Zugriff verwalten, indem Sie Administratoren, Abonnenten und Betrachtern BigQuery Sharing-Rollen zuweisen
  • Abonnenten in Ihren Einträgen ansehen, beobachten und entfernen
  • Messwerte zur Abonnementnutzung im Blick behalten:

Ein Eintrag ist ein Verweis auf ein freigegebenes Dataset, das ein Publisher in einem Datenaustausch auflistet. Abhängig von der IAM-Richtlinie (Identity and Access Management), die für den Eintrag festgelegt ist, und dem Typ des Datenaustauschs, der den Eintrag enthält, kann ein Eintrag zu einem der folgenden beiden Typen gehören:

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

Zum Verwalten von Einträgen und Abos benötigen Sie eine der folgenden IAM-Rollen (Identity and Access Management) für die BigQuery-Freigabe:

Weitere Informationen finden Sie unter IAM-Rollen für BigQuery Sharing. Informationen zum Zuweisen dieser Rollen für andere Nutzer finden Sie unter Eintragsadministrator erstellen.

Zum Erstellen von Einträgen oder Aktualisieren von Replikatregionen für einen Eintrag benötigen Sie die Berechtigungen bigquery.datasets.get und bigquery.datasets.update für die Quelldatasets. Die folgenden vordefinierten BigQuery-Rollen enthalten die Berechtigung bigquery.datasets.update:

Wenn Sie alle Datenaustausch zwischen Projekten in einer Organisation ansehen möchten, auf die Sie Zugriff haben, benötigen Sie die Berechtigung resourcemanager.organizations.get. Es gibt keine vordefinierten BigQuery-Rollen, die diese Berechtigung enthalten. Sie müssen also eine benutzerdefinierte IAM-Rolle verwenden.

Datenaustausch ansehen

Informationen zum Aufrufen der Liste der Datenpools in Ihrer Organisation, auf die Sie Zugriff haben, finden Sie unter Datenaustausch aufrufen. Wenn sich der Datenaustausch in einer anderen Organisation befindet, muss der BigQuery Sharing-Administrator einen Link zum Datenaustausch für Sie freigeben.

Eintrag erstellen

Ein Eintrag ist ein Verweis auf ein freigegebenes Dataset, das ein Publisher von BigQuery Sharing in einem Datenaustausch auflistet.

So erstellen Sie einen Eintrag:

Console

  1. Rufen Sie die Seite Sharing (Analytics Hub) auf.

    Sharing (Analytics Hub) aufrufen

    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 Eintrag erstellen.

  4. Wählen Sie im Abschnitt Daten konfigurieren im Menü Ressourcentyp die Option BigQuery-Dataset oder Pub/Sub-Thema aus.

    • Wenn Sie BigQuery-Dataset auswählen, gehen Sie so vor:

      1. Wählen Sie im Menü Freigegebenes Dataset ein vorhandenes Dataset aus oder klicken Sie auf Dataset erstellen, um ein Dataset zu erstellen. Das Dataset muss sich in derselben Region wie der Datenaustausch befinden. Sie können das freigegebene Dataset nach der Erstellung des Eintrags nicht mehr ändern. Wenn Abonnenten die Metadaten des verknüpften Datasets aufrufen, werden durch die BigQuery-Freigabe der Name des Quell-Datasets und die ID des Projekts zurückgegeben, das das Dataset enthält.
      2. Optional: Wenn Sie möchten, dass Abonnenten gespeicherte SQL-Prozeduren für mehrere Einträge freigeben können, wählen Sie Freigabe gespeicherter Prozeduren zulassen (Vorabversion) aus.
      3. Wenn Sie das freigegebene Dataset in weiteren Regionen verfügbar machen möchten, maximieren Sie das Menü Verfügbarkeit von Regionsdaten. Im Menü werden Regionen mit vorhandenen Dataset-Replikaten angezeigt, die als Einsatzbereit gekennzeichnet sind. Bevor Sie das Angebot für mehrere Regionen konfigurieren, müssen Sie die regionenübergreifende Dataset-Replikation für das freigegebene Dataset aktivieren. Sie können nur Regionen auswählen, in denen die regionsübergreifende Dataset-Replikation aktiviert ist. Alle anderen Regionen sind als Nicht verfügbar gekennzeichnet. Wenn Sie keine zusätzliche Region auswählen, wird für den Eintrag standardmäßig die primäre Region des freigegebenen Datasets verwendet, die als Primärer Anbieter gekennzeichnet ist.

      4. Wählen Sie in Steuerelemente für ausgehenden Traffic die entsprechende Option für ausgehenden Traffic aus:

        • Wenn Sie das Kopieren und Exportieren von weitergegebenen Daten in Ihrem freigegebenen Dataset einschränken, aber den Export von Abfrageergebnissen zulassen möchten, wählen Sie Kopieren und Exportieren von weitergegebenen Daten deaktivieren aus.
        • Wenn Sie das Kopieren und Exportieren von Daten sowohl für Ihr freigegebenes Dataset als auch für Abfrageergebnisse einschränken möchten, wählen Sie Kopieren und Exportieren von Abfrageergebnissen deaktivieren aus. Mit dieser Option wird auch Kopieren und Exportieren von weitergegebenen Daten deaktivieren ausgewählt.
        • Wenn Sie das Kopieren und Exportieren von Tabellen über APIs für Ihr freigegebenes Dataset einschränken möchten, wählen Sie Kopieren und Exportieren von Tabellen über APIs deaktivieren aus. Bei Auswahl dieser Option wird auch Kopieren und Exportieren von weitergegebenen Daten deaktivieren ausgewählt.

        Weitere Informationen zu Steuerelementen für ausgehenden Traffic, einschließlich Einschränkungen, finden Sie unter Optionen für ausgehenden Traffic (nur freigegebene BigQuery-Datasets).

    • Wenn Sie Pub/Sub-Thema auswählen, wählen Sie im Menü Gemeinsam genutztes Thema ein vorhandenes Pub/Sub-Thema aus oder klicken Sie auf Thema erstellen, um ein Thema zu erstellen.

  5. Geben Sie im Bereich Eintragsdetails unter Anzeigename einen Namen für den Eintrag ein.

  6. Geben Sie die folgenden optionalen Details ein:

    • Kategorie: Wählen Sie bis zu zwei Kategorien aus, die Ihren Eintrag am besten darstellen. Abonnenten können Einträge filtern, indem sie die von Ihnen ausgewählten Kategorien verwenden.
    • Datenaffinität: Geben Sie die Regionen an, die Sie für die Veröffentlichung von Daten verwenden. Mit dieser Standorteinstellung können Abonnenten die Kosten für ausgehenden Pub/Sub-Netzwerktraffic minimieren oder vermeiden, indem sie Daten aus derselben Region lesen. Weitere Informationen zu den Kosten für ausgehenden Traffic finden Sie unter Kosten für die Datenübertragung.
    • Symbol: Laden Sie ein Symbol für Ihren Eintrag hoch. Unterstützt werden die Dateiformate PNG und JPEG. Die Dateigröße der Symbole muss unter 512 KiB liegen und die Abmessungen dürfen 512 × 512 Pixel nicht überschreiten.
    • Beschreibung: Geben Sie eine kurze Beschreibung Ihres Eintrags ein. Abonnenten können anhand des Beschreibungstexts nach Einträgen suchen.

    • Öffentliche Sichtbarkeit: Aktivieren Sie diese Einstellung, damit Ihr Eintrag im BigQuery Sharing-Katalog öffentlich sichtbar ist. Wenn Sie diese Option aktivieren, weisen Sie allUsers oder allAuthenticatedUsers die Rolle „Analytics Hub-Betrachter“ (roles/analyticshub.viewer) zu. Weitere Informationen finden Sie unter Rolle für einen Eintrag zuweisen. Wenn die Anzeigenplattform bereits öffentlich ist, werden die Berechtigungen für den Eintrag übernommen und es sind keine weiteren Maßnahmen erforderlich.

      Öffentlich sichtbare Anzeigenplattformen können aufgrund der Übernahme von Berechtigungen keine privaten Einträge haben, private Anzeigenplattformen können jedoch öffentliche Einträge haben. Damit ein öffentlicher Eintrag erstellt werden kann, muss das Projekt, das den Eintrag enthält, eine zugehörige Organisation und ein zugehöriges Rechnungskonto haben. Wenn Sie einen kommerziellen Eintrag erstellen, der in den Cloud Marketplace eingebunden ist, empfehlen wir, die öffentliche Auffindbarkeit zu aktivieren.

    • Logging der E‑Mail-Adressen von Abonnenten: Aktivieren Sie diese Einstellung, um die Prinzipal-IDs aller Nutzer zu protokollieren, die Jobs und Abfragen für verknüpfte Datasets ausführen. Wenn Sie diese Option aktivieren, wird das Logging von Abonnenten-E‑Mails für alle zukünftigen Abos aktiviert, die über diesen Eintrag erstellt werden. Die protokollierten Daten sind in der Spalte job_principal_subject der INFORMATION_SCHEMA.SHARED_DATASET_USAGE-Ansicht verfügbar.

    • Dokumentation > Markdown: Geben Sie unterstützende Dokumentationen, Links oder Anleitungen im Markdown-Format ein, um Abonnenten bei der Verwendung Ihres Datasets zu helfen.

  7. Geben Sie im Abschnitt Kontaktdaten für Einträge die folgenden optionalen Details ein:

    • Primärer Kontakt: Geben Sie die E-Mail-Adresse oder URL des primären Kontakts für den Eintrag ein.
    • Kontakt für den Zugriff anfordern: Geben Sie die E-Mail-Adresse oder URL Ihres Aufnahmeformulars ein, damit Abonnenten Sie kontaktieren können, um Zugriff anzufordern.

    • Anbieter: Maximieren Sie den Abschnitt Anbieter und geben Sie in den folgenden Feldern Details an:

      • Name des Anbieters: der Name des Datenanbieters.
      • Primärer Kontakt des Anbieters: Die E-Mail-Adresse oder URL des primären Kontakts des Datenanbieters.

      Abonnenten können Einträge nach Datenanbieter filtern.

    • Publisher: Maximieren Sie den Abschnitt Publisher und geben Sie Details in den folgenden Feldern an:

      • Publisher-Name: Name des Publishers, der den Eintrag erstellt.
      • Primärer Kontakt des Publishers: Die E-Mail-Adresse oder URL des primären Kontakts des Publishers.

  8. Sehen Sie sich den Abschnitt Vorschau des Eintrags an.

  9. Klicken Sie auf Veröffentlichen, um den Eintrag zu veröffentlichen.

API

Verwenden Sie die Methode projects.locations.dataExchanges.listings.create:

POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/dataExchanges/DATAEXCHANGE_ID/listings?listingId=LISTING_ID

Ersetzen Sie Folgendes:

  • PROJECT_ID: die ID des Projekts, das den Datenaustausch enthält, in dem Sie den Eintrag erstellen möchten.
  • LOCATION: Der Standort Ihres Datenpools. Weitere Informationen zu Standorten, die BigQuery Sharing unterstützen, finden Sie unter Unterstützte Regionen.
  • DATAEXCHANGE_ID: die Datenpool-ID.
  • LISTING_ID: die ID des Eintrags.

Geben Sie im Anfragetext die Eintragsdetails an.

Wenn Sie ein Angebot in mehreren Regionen erstellen möchten, geben Sie diese Regionen im Feld bigqueryDataset.replicaLocations des Anfragetexts an. Bevor Sie das Angebot für mehrere Regionen konfigurieren, müssen Sie die regionenübergreifende Dataset-Replikation für das freigegebene Dataset aktivieren. Sie können nur Regionen auswählen, in denen die regionenübergreifende Dataset-Replikation aktiviert ist. Wenn Sie dieses optionale Feld weglassen, wird für den Eintrag die primäre Region des freigegebenen Datasets verwendet.

Wenn die Anfrage erfolgreich ist, werden im Antworttext die Eintragsdetails zurückgegeben. Wenn Sie das Logging von Abonnenten-E‑Mails aktivieren, indem Sie das Feld logLinkedDatasetQueryUserEmail auf true festlegen, wird in der Antwort des Eintrags log_linked_dataset_query_user_email: true zurückgegeben. Die protokollierten Daten sind in der Spalte job_principal_subject der INFORMATION_SCHEMA.SHARED_DATASET_USAGE-Ansicht verfügbar.

Weitere Informationen zu den Aufgaben, die Sie für Einträge mithilfe von APIs ausführen können, finden Sie unter projects.locations.dataExchanges.listings-Methoden.

Einen Eintrag aus einem Dataset erstellen

So erstellen Sie einen Eintrag direkt aus einem vorhandenen Dataset:

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

    BigQuery aufrufen

  2. Klicken Sie auf einen Dataset-Namen, um die Dataset-Details aufzurufen.

  3. Klicken Sie auf  Freigabe > Als Eintrag veröffentlichen.

    Das Dialogfeld Eintrag erstellen wird geöffnet.

  4. Wählen Sie einen Datenaustausch aus, in dem Sie den Eintrag veröffentlichen möchten. Der Datenaustausch muss sich in derselben Region wie das Dataset befinden. Weitere Informationen zum Erstellen eines Datenpools finden Sie unter Datenpool erstellen und Berechtigungen festlegen.

  5. Wählen Sie im Menü Freigegebenes Dataset ein vorhandenes Dataset aus oder klicken Sie auf Dataset erstellen, um ein Dataset zu erstellen. Das Dataset muss sich in derselben Region wie der Datenaustausch befinden. Sie können diese Auswahl nach dem Erstellen des Eintrags nicht mehr ändern.

    Wenn Abonnenten die Metadaten des verknüpften Datasets aufrufen, werden durch die BigQuery-Freigabe der Name des Quell-Datasets und die ID des Projekts zurückgegeben, das das Dataset enthält.

  6. Optional: Wenn Sie möchten, dass Abonnenten gespeicherte SQL-Prozeduren für mehrere Einträge freigeben können, wählen Sie Freigabe gespeicherter Prozeduren zulassen (Vorabversion) aus.

  7. Wenn Sie das freigegebene Dataset in weiteren Regionen verfügbar machen möchten, maximieren Sie das Menü Verfügbarkeit von Regionsdaten. Im Menü werden Regionen mit Dataset-Replikaten angezeigt, die als Einsatzbereit gekennzeichnet sind. Bevor Sie das Angebot für mehrere Regionen konfigurieren, müssen Sie die regionenübergreifende Dataset-Replikation für das freigegebene Dataset aktivieren. Sie können nur Regionen auswählen, in denen die regionsübergreifende Dataset-Replikation aktiviert ist. Alle anderen Regionen sind als Nicht verfügbar gekennzeichnet. Wenn Sie keine zusätzliche Region auswählen, wird für den Eintrag standardmäßig die primäre Region des freigegebenen Datasets verwendet, die als Primärer Anbieter gekennzeichnet ist.

  8. Wählen Sie unter Steuerelemente für ausgehenden Traffic die entsprechende Option für ausgehenden Traffic aus:

    • Wenn Sie das Kopieren und Exportieren für Ihr weitergegebenes Dataset einschränken, aber den Export von Abfrageergebnissen zulassen möchten, wählen Sie Kopieren und Exportieren von weitergegebenen Daten deaktivieren aus.
    • Wenn Sie das Kopieren und Exportieren sowohl für Ihr freigegebenes Dataset als auch für Abfrageergebnisse einschränken möchten, wählen Sie Kopieren und Exportieren von Abfrageergebnissen deaktivieren aus. Mit dieser Option wird auch Kopieren und Exportieren von weitergegebenen Daten deaktivieren ausgewählt.
    • Wenn Sie das Kopieren und Exportieren von Tabellen über APIs für Ihr freigegebenes Dataset einschränken möchten, wählen Sie Kopieren und Exportieren von Tabellen über APIs deaktivieren aus. Bei Auswahl dieser Option wird auch Kopieren und Exportieren von weitergegebenen Daten deaktivieren ausgewählt.

    Informationen zu Kontrollen und Einschränkungen für ausgehende Daten finden Sie unter Optionen für ausgehende Daten (nur freigegebene BigQuery-Datasets).

  9. Geben Sie im Abschnitt Eintragsdetails unter Anzeigename einen Namen für den Eintrag ein.

  10. Geben Sie die folgenden optionalen Details ein:

    • Kategorie: Wählen Sie bis zu zwei Kategorien aus, die Ihren Eintrag am besten darstellen. Abonnenten können Einträge filtern, indem sie die von Ihnen ausgewählten Kategorien verwenden.

    • Datenaffinität: Geben Sie die Regionen an, die Sie für die Veröffentlichung von Daten verwenden. Mit dieser Standorteinstellung können Abonnenten die Kosten für ausgehenden Pub/Sub-Netzwerktraffic minimieren oder vermeiden, indem sie Daten aus derselben Region lesen. Weitere Informationen zu den Kosten für ausgehenden Traffic finden Sie unter Kosten für die Datenübertragung.

    • Symbol: Laden Sie ein Symbol für Ihren Eintrag hoch. Unterstützt werden die Dateiformate PNG und JPEG. Die Dateigröße der Symbole muss unter 512 KiB liegen und die Abmessungen dürfen 512 × 512 Pixel nicht überschreiten.

    • Beschreibung: Geben Sie eine kurze Beschreibung Ihres Eintrags ein. Abonnenten können anhand des Beschreibungstexts nach Einträgen suchen.

    • Öffentliche Sichtbarkeit: Aktivieren Sie diese Einstellung, damit Ihr Eintrag im BigQuery Sharing-Katalog öffentlich sichtbar ist. Wenn Sie diese Option aktivieren, weisen Sie allUsers oder allAuthenticatedUsers die Rolle „Analytics Hub-Betrachter“ (roles/analyticshub.viewer) zu. Weitere Informationen finden Sie unter Rolle für einen Eintrag zuweisen. Wenn die Anzeigenplattform bereits öffentlich ist, werden die Berechtigungen für den Eintrag übernommen und es sind keine weiteren Maßnahmen erforderlich.

      Öffentlich sichtbare Anzeigenplattformen können aufgrund der Übernahme von Berechtigungen keine privaten Einträge haben, private Anzeigenplattformen können jedoch öffentliche Einträge haben. Damit ein öffentlicher Eintrag erstellt werden kann, muss das Projekt, das den Eintrag enthält, eine zugehörige Organisation und ein zugehöriges Rechnungskonto haben. Wenn Sie einen kommerziellen Eintrag erstellen, der in den Cloud Marketplace eingebunden ist, empfehlen wir, die öffentliche Auffindbarkeit zu aktivieren.

    • Logging der E‑Mail-Adressen von Abonnenten: Wenn Sie diese Option aktivieren, werden die Prinzipal-IDs von Abonnenten protokolliert, die Jobs und Abfragen für das verknüpfte Dataset dieses Eintrags ausführen. Das gilt für alle zukünftigen Abonnements. Wenn Sie diese Option aktivieren, werden nur für neu erstellte Abos Hauptkonto-IDs protokolliert. Die protokollierten Daten sind in der Spalte job_principal_subject der INFORMATION_SCHEMA.SHARED_DATASET_USAGE-Ansicht verfügbar.

    • Dokumentation > Markdown: Geben Sie unterstützende Dokumentationen, Links oder Anleitungen ein, die Abonnenten bei der Verwendung Ihres Datasets helfen.

  11. Geben Sie im Abschnitt Kontaktdaten für Einträge die folgenden optionalen Details ein:

    • Primärer Kontakt: Geben Sie die E-Mail-Adresse oder URL des primären Kontakts für den Eintrag ein.

    • Kontakt für den Zugriff anfordern: Geben Sie die E-Mail-Adresse oder URL Ihres Aufnahmeformulars ein, damit Abonnenten Sie kontaktieren können, um Zugriff anzufordern.

    • Anbieter: Maximieren Sie den Abschnitt Anbieter und geben Sie in den folgenden Feldern Details an:

      • Name des Anbieters: der Name des Datenanbieters.
      • Primärer Kontakt des Anbieters: Die E-Mail-Adresse oder eine URL des primären Kontakts des Datenanbieters.

      Abonnenten können Einträge nach Datenanbieter filtern.

    • Publisher: Maximieren Sie den Abschnitt Publisher und geben Sie Details in den folgenden Feldern an:

      • Publisher-Name: Name des Publishers, der den Eintrag erstellt.
      • Primärer Kontakt des Publishers: Die E-Mail-Adresse oder URL des primären Kontakts des Publishers.

  12. Sehen Sie sich den Abschnitt Vorschau des Eintrags an.

  13. Klicken Sie auf Veröffentlichen, um den Eintrag zu veröffentlichen.

Gespeicherte SQL-Prozedur für mehrere Einträge freigeben

Sie können gespeicherte SQL-Prozeduren freigeben, wenn Sie Einträge mit BigQuery-Datasets erstellen. Da mit gespeicherten Prozeduren Tabellen erstellt, gelöscht und bearbeitet sowie andere gespeicherte Prozeduren aufgerufen werden können, ist für die Freigabe gespeicherter Prozeduren eine zusätzliche Autorisierung erforderlich.

Abonnentenautorisierung

Nachdem ein Nutzer einen Eintrag abonniert hat, werden verknüpfte gespeicherte Prozeduren möglicherweise nicht sofort ausgeführt. Damit verknüpfte gespeicherte Prozeduren ausgeführt werden können, muss der Abonnent den Namen des verknüpften Datasets an den Anbieter senden, damit der Anbieter die verknüpfte gespeicherte Prozedur für die Ressourcen des Anbieters autorisiert. Außerdem muss der Abonnent das verknüpfte freigegebene gespeicherte Verfahren autorisieren und den Ressourcen des Abonnenten eine IAM-Rolle zuweisen, damit Daten aus diesen Ressourcen gelesen und in diese geschrieben werden können.

Anbieterautorisierung

Wenn ein Anbieter einen Eintrag mit einer gespeicherten Prozedur erstellt, muss er dem Abonnenten erlauben, über die verknüpfte gespeicherte Prozedur Daten aus den Tabellen des Anbieters zu lesen und in sie zu schreiben. Damit der Zugriff möglich ist, muss der Anbieter Folgendes tun:

Nutzern Zugriff auf einen Eintrag gewähren

Wenn Sie Zugriff auf einen privaten Eintrag gewähren möchten, müssen Sie die IAM-Richtlinie für diesen Eintrag so festlegen, dass sie bestimmte Personen oder Gruppen umfasst. Bei einem kommerziellen Eintrag muss Ihr Datenaustausch öffentlich sein. Einträge in einem öffentlichen Datenaustausch werden in BigQuery Sharing für alle Google Cloud -Nutzer (allAuthenticatedUsers) angezeigt. Damit Nutzer kommerzielle Einträge aufrufen und darauf zugreifen können, weisen Sie ihnen die Rolle „Analytics Hub-Betrachter“ (roles/analyticshub.viewer) zu. Damit Nutzer kommerzielle Einträge abonnieren können, weisen Sie ihnen die Rolle „Analytics Hub-Abonnent“ (roles/analyticshub.subscriber) zu. Bei kommerziellen Einträgen, die in Cloud Marketplace eingebunden sind}, wird die Rolle „Analytics Hub-Abonnent“ in BigQuery Sharing automatisch auf Grundlage von Cloud Marketplace-Bestellungen zugewiesen.

Wenn Sie Ihren Eintrag für alle Nutzer zugänglich machen möchten, auch für Personen ohneGoogle Cloud -Konto, weisen Sie allUsers die Rolle „Analytics Hub Viewer“ (roles/analyticshub.viewer) zu.

So gewähren Sie Nutzern Zugriff auf die Anzeige oder das Abonnieren Ihres Eintrags:

Console

  1. Rufen Sie die Seite Sharing (Analytics Hub) auf.

    Sharing (Analytics Hub) aufrufen

  2. Klicken Sie auf den Namen des Datenaustauschs, der den Eintrag enthält.

  3. Klicken Sie auf den Eintrag, den Sie teilen möchten.

  4. Klicken Sie auf Berechtigungen festlegen.

  5. Klicken Sie zum Hinzufügen von Hauptkonten auf  Hauptkonto hinzufügen.

  6. Geben Sie im Feld Neue Hauptkonten Hauptkonten basierend auf Ihrem Eintragstyp ein:

    • Geben Sie für einen privaten Eintrag die E-Mail-Adressen der Identitäten ein, denen Sie Zugriff gewähren möchten.

    • Geben Sie für einen öffentlichen Eintrag allAuthenticatedUsers ein.

    • Wenn ein öffentlicher Eintrag für alle Nutzer sichtbar sein soll, auch Nutzer ohneGoogle Cloud, geben Sie allUsers ein.

  7. Bewegen Sie den Mauszeiger im Menü Rolle auswählen auf Analytics Hub und wählen Sie dann eine Rolle basierend auf Ihrem Eintragstyp aus:

    • Wählen Sie für einen kommerziellen Eintrag (einschließlich in den Cloud Marketplace eingebundener Einträge) die Rolle Analytics Hub-Betrachter aus. Mit dieser Rolle können Nutzer den Eintrag ansehen und Zugriff anfordern.

    • Wählen Sie für einen privaten oder nicht kommerziellen öffentlichen Eintrag die Rolle Analytics Hub-Abonnent aus. Mit dieser Rolle können Nutzer Ihren Eintrag abonnieren.

    • Bei Einträgen, die in den Cloud Marketplace eingebunden sind, müssen Sie die Rolle „Analytics Hub-Abonnent“ (roles/analyticshub.subscriber) nicht zuweisen. Abos werden automatisch auf Grundlage der Cloud Marketplace-Bestellung verwaltet.

    Weitere Informationen finden Sie unter Analytics Hub-Abonnenten- und -Betrachterrollen.

  8. Klicken Sie auf Speichern, um die Berechtigungen zu speichern.

API

  1. Lesen Sie die vorhandene Richtlinie, indem Sie die Methode projects.locations.dataExchanges.listings.getIamPolicy aufrufen:

    POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/dataExchanges/DATAEXCHANGE_ID/listings/LISTING_ID:getIamPolicy

    Ersetzen Sie Folgendes:

    • PROJECT_ID: die Projekt-ID, z. B. my-project-1.
    • LOCATION: der Standort des Datenpools, der den Eintrag enthält.
    • DATAEXCHANGE_ID: die Datenpool-ID.
    • LISTING_ID: die ID des Eintrags.

    Die Freigabe gibt die aktuelle Richtlinie in der Antwort zurück.

  2. Wenn Sie Mitglieder und ihre zugehörigen Rollen hinzufügen oder entfernen möchten, bearbeiten Sie das Richtlinien-JSON mit einem Texteditor. Geben Sie Mitglieder mit den folgenden Formaten an:

    • user:test-user@gmail.com
    • group:admins@example.com
    • serviceAccount:test123@example.domain.com
    • domain:example.domain.com

    Fügen Sie der Richtlinie beispielsweise die folgende Bindung hinzu, um group:subscribers@example.com die Rolle roles/analyticshub.subscriber zuzuweisen:

    {
"members": [
 "group:subscribers@example.com"
],
"role":"roles/analyticshub.subscriber"
}

  3. Aktualisieren Sie die Richtlinie, indem Sie die Methode projects.locations.dataExchanges.listings.setIamPolicy aufrufen. Übergeben Sie im Anfragetext die aktualisierte IAM-Richtlinie aus dem vorherigen Schritt.

    POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/dataExchanges/DATAEXCHANGE_ID/listings/LISTING_ID:setIamPolicy

    Übergeben Sie im Anfragetext die Eintragsdetails. Wenn die Anfrage erfolgreich ist, enthält der Antworttext die Eintragsdetails mit der aktualisierten Richtlinie.

Weitere Informationen zu den Aufgaben, die Sie für Einträge mithilfe von APIs ausführen können, finden Sie unter projects.locations.dataExchanges.listings-Methoden.

Nicht authentifizierte URL für einen öffentlichen Eintrag erstellen

So erstellen Sie eine nicht authentifizierte BigQuery Sharing-Eintrags-URL, die Nutzer ohne Google Cloud -Konto aufrufen können:

  1. Rufen Sie die Seite Sharing (Analytics Hub) auf.

    Sharing (Analytics Hub) aufrufen

    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, der den Eintrag enthält.

  3. Klicken Sie auf den Anzeigenamen des Eintrags, um die Eintragsdetails aufzurufen. Für den Eintrag muss die öffentliche Sichtbarkeit aktiviert sein.

  4. Klicken Sie auf Öffentlichen Link kopieren. Damit externe Nutzer den Eintrag ansehen können, muss allUsers die Rolle „Analytics Hub-Betrachter“ (roles/analyticshub.viewer) zugewiesen sein.

Eintragadministrator erstellen

Damit Nutzer Einträge verwalten können, können Sie Eintragsadministratoren erstellen, indem Sie diesen Nutzern auf dem Eintrag die Rolle „Analytics Hub-Publisher“ oder „Analytics Hub-Eintragsadministrator“ zuweisen. Eine Anleitung zum Zuweisen von Rollen für einen Eintrag finden Sie unter Rolle für einen Eintrag zuweisen.

Alle Abos ansehen

Wählen Sie eine der folgenden Optionen aus, um alle aktuellen Abos Ihres Eintrags aufzurufen:

Console

  1. Rufen Sie die Seite Sharing (Analytics Hub) auf.

    Sharing (Analytics Hub) aufrufen

  2. Klicken Sie auf den Namen des Datenaustauschs, der den Eintrag enthält, für den Sie Abos verwalten möchten.

  3. Klicken Sie auf den Eintrag, für den Sie alle Abonnenten auflisten möchten.

  4. Wenn Sie alle Abonnenten Ihres Eintrags aufrufen möchten, klicken Sie auf Abos verwalten:

    Die hervorgehobene Option „Abos verwalten“ für einen Analytics Hub-Eintrag.

  5. Optional: Sie können die Ergebnisse nach Abonnentendetails filtern.

Wenn Sie Zugriff auf das gemeinsame Dataset haben, können Sie die Abonnenten auch so auflisten:

  1. Rufen Sie die Seite BigQuery auf.

    BigQuery aufrufen

  2. Klicken Sie im linken Bereich auf Explorer:

    Hervorgehobener Button für den Explorer-Bereich.

    Wenn das linke Steuerfeld nicht angezeigt wird, klicken Sie auf  Linkes Steuerfeld maximieren, um es zu öffnen.

  3. Maximieren Sie im Bereich Explorer den Namen Ihres Projekts, klicken Sie auf Datasets und dann auf den Namen des freigegebenen Datasets.

  4. Wählen Sie in der Liste Freigabe die Option Abos verwalten aus.

SQL

Im folgenden Beispiel wird die Ansicht INFORMATION_SCHEMA.SCHEMATA_LINKS verwendet, um alle verknüpften Datasets aufzulisten, die mit einem freigegebenen Dataset in myproject verknüpft sind und sich in der Region us befinden:

SELECT * FROM `myproject`.`region-us`.INFORMATION_SCHEMA.SCHEMATA_LINKS;

Die entsprechende Ausgabe sieht etwa so aus: Einige Spalten werden weggelassen, um die Ausgabe zu vereinfachen.

+----------------+-------------+----------------------------+------------------------------+--------------------+--------------------------------+
|  catalog_name  | schema_name | linked_schema_catalog_name | linked_schema_catalog_number | linked_schema_name | linked_schema_org_display_name |
+----------------+-------------+----------------------------+------------------------------+--------------------+--------------------------------+
| myproject      | myschema1   | subscriptionproject1       |                 974999999291 | subscriptionld1    | subscriptionorg                |
| myproject      | myschema2   | subscriptionproject2       |                 974999999292 | subscriptionld2    | subscriptionorg                |
| myproject      | myschema3   | subscriptionproject3       |                 974999999293 | subscriptionld3    | subscriptionorg                |
+----------------+-------------+----------------------------+------------------------------+--------------------+--------------------------------+

Bei einem Eintrag mit mehreren Regionen können Sie die Abos in verschiedenen Regionen aufrufen, indem Sie die Region us durch den gewünschten Replikatspeicherort ersetzen. Wenn Sie beispielsweise die verknüpften Datasets aufrufen möchten, die mit einem freigegebenen Dataset in myproject verknüpft sind und sich in der Region eu befinden, verwenden Sie die folgende Abfrage:

SELECT * FROM `myproject`.`region-eu`.INFORMATION_SCHEMA.SCHEMATA_LINKS;

API

Verwenden Sie die Methode projects.locations.dataExchanges.listings.listSubscriptions.

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

Ersetzen Sie Folgendes:

  • PROJECT_ID: die Projekt-ID des Eintrags, den Sie abonnieren möchten.
  • LOCATION: der Standort für Ihren Eintrag, den Sie abonnieren möchten.
  • DATAEXCHANGE_ID: die Datenaustausch-ID, die den Eintrag enthält, den Sie abonnieren möchten.
  • LISTING_ID: die ID des Eintrags, den Sie abonnieren möchten.

Abos entfernen

Wenn Sie ein vor dem 25. Juli 2023 erstelltes Abo aus Ihrem Eintrag entfernen, wird die Verknüpfung des verknüpften Datasets mit dem freigegebenen Dataset aufgehoben. Abonnenten können das Dataset weiterhin in ihren Projekten sehen, aber es ist nicht mehr mit Ihrem freigegebenen Dataset verknüpft.

So entfernen Sie ein Abo, das vor dem 25. Juli 2023 erstellt wurde, aus Ihrem Eintrag:

  1. Folgen Sie der Anleitung unter Alle Abos ansehen für die Google Cloud -Konsole, um die Abonnenten eines Eintrags aufzulisten.

  2. Wenn Sie einen Abonnenten aus einem Eintrag entfernen möchten, klicken Sie auf Löschen. Wenn Sie alle Abos entfernen möchten, klicken Sie auf Alle Abos entfernen.

  3. Bestätigen Sie im Dialogfeld Abo entfernen? den Löschvorgang, indem Sie remove eingeben.

  4. Klicken Sie auf Entfernen.

So entfernen Sie ein Abo, das nach dem 25. Juli 2023 erstellt wurde:

Console

  1. Folgen Sie der Anleitung unter Alle Abos ansehen für die Google Cloud -Konsole, um die Abonnenten eines Eintrags aufzulisten.

  2. Klicken Sie auf Abos.

  3. Wählen Sie die Abos aus, die Sie entfernen möchten, indem Sie die Kästchen neben den entsprechenden Abos anklicken. Klicken Sie dann auf  Abos entfernen.

  4. Bestätigen Sie im Dialogfeld Abo entfernen? den Vorgang, indem Sie remove eingeben.

  5. Klicken Sie auf Entfernen.

API

Rufen Sie die Methode projects.locations.subscriptions.revoke auf:

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

Eintrag aktualisieren

Wenn sich Ihre Anforderungen an den Datenaustausch ändern, können Sie die Metadaten, Kategorien, Einstellungen für die Auffindbarkeit und regionale Verfügbarkeit eines Eintrags aktualisieren, ohne das zugrunde liegende freigegebene Dataset zu ändern.

So aktualisieren Sie einen Eintrag:

Console

  1. Rufen Sie die Seite Sharing (Analytics Hub) auf.

    Sharing (Analytics Hub) aufrufen

  2. Klicken Sie auf den Namen des Datenaustauschs, der den Eintrag enthält.

  3. Klicken Sie auf den Eintrag, den Sie aktualisieren möchten.

  4. Klicken Sie auf Eintrag bearbeiten.

  5. Ändern Sie die Werte in den Feldern. Sie können alle Werte mit Ausnahme des freigegebenen Datasets des Eintrags ändern.

  6. Optional: Aktualisieren Sie die Einträge und die Verfügbarkeit:

    • Wenn Sie die öffentliche Sichtbarkeit aktivieren möchten, weisen Sie allUsers oder allAuthenticatedUsers die Rolle „Analytics Hub-Betrachter“ (roles/analyticshub.viewer) zu. Eine Anleitung zum Zuweisen von Rollen für einen Eintrag finden Sie unter Rolle für einen Eintrag zuweisen.
    • Wenn Sie die öffentliche Sichtbarkeit für einen Eintrag in einem privaten Exchange deaktivieren möchten, entfernen Sie die Rolle „Analytics Hub Viewer“ (roles/analyticshub.viewer) aus allUsers und allAuthenticatedUsers. Wenn die Anzeigenplattform bereits öffentlich ist, wurden die Berechtigungen für den Eintrag bereits übernommen und es sind keine weiteren Maßnahmen erforderlich.
    • Nachdem Sie das Logging der E‑Mail-Adressen von Abonnenten aktiviert und gespeichert haben, können Sie diese Einstellung nicht mehr bearbeiten. Wenn Sie das Logging von E‑Mail-Adressen deaktivieren möchten, löschen Sie den Eintrag und erstellen Sie ihn neu, ohne Logging der E‑Mail-Adressen von Abonnenten auszuwählen.
    • Wenn Sie Regionen hinzufügen oder entfernen möchten, aktualisieren Sie Ihre Auswahl. Bevor Sie mehrere Regionen hinzufügen, müssen Sie die regionenübergreifende Dataset-Replikation für das freigegebene Dataset aktivieren. Bevor Sie eine Region entfernen, müssen Sie das Replikat des freigegebenen Datasets in dieser Region löschen.

  7. Sehen Sie sich die Vorschau des Eintrags an.

  8. Klicken Sie auf Save (Speichern), um die Änderungen zu speichern. Wenn Sie einen Eintrag aktualisieren, der in den Cloud Marketplace eingebunden ist, werden Sie in einer Benachrichtigung aufgefordert, auch den Produkteintrag für das Cloud Marketplace-Datenprodukt zu aktualisieren.

API

Rufen Sie die Methode projects.locations.dataExchanges.listings.patch auf.

PATCH https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/dataExchanges/DATAEXCHANGE_ID/listings/LISTING_ID?updateMask=UPDATEMASK

Ersetzen Sie Folgendes:

  • PROJECT_ID: die ID des Projekts, das den Datenaustausch enthält, in dem Sie den Eintrag erstellen möchten.
  • LOCATION: der Standort des Datenpools.
  • DATAEXCHANGE_ID: die ID des Datenaustauschs.
  • LISTING_ID: Die ID des zu aktualisierenden Eintrags.
  • UPDATEMASK: Die Liste der Felder, die Sie aktualisieren möchten. Verwenden Sie zum Aktualisieren mehrerer Werte eine durch Kommas getrennte Liste. Geben Sie beispielsweise displayName,primaryContact ein, um den Anzeigenamen und den primären Kontakt für einen Datenaustausch zu aktualisieren.

Geben Sie im Anfragetext aktualisierte Werte für die Felder in Ihrer Aktualisierungsmaske an:

  • displayName
  • description
  • primaryContact
  • documentation
  • icon
  • categories[]
  • discoveryType
  • logLinkedDatasetQueryUserEmail
  • bigqueryDataset.replicaLocations

Weitere Informationen zu diesen Feldern finden Sie unter Ressource: Eintrag.

Wenn Sie die Replikatregionen für Ihren Eintrag aktualisieren, geben Sie alle zutreffenden Regionen an. Bevor Sie das Angebot aktualisieren, müssen Sie die regionenübergreifende Datensatzreplikation für den freigegebenen Datensatz aktivieren. Sie können nur Regionen hinzufügen, in denen das freigegebene Dataset ein Replikat hat. Bevor Sie eine Region aus dem Eintrag entfernen, löschen Sie das Replikat des freigegebenen Datasets in dieser Region. Sie können auch Einträge mit einer einzelnen Region in Einträge mit mehreren Regionen umwandeln.

Weitere Informationen zu den Aufgaben, die Sie für Einträge mithilfe von APIs ausführen können, finden Sie unter projects.locations.dataExchanges.listings-Methoden.

Um die Sichtbarkeit Ihres Eintrags im BigQuery Sharing-Katalog zu erhöhen, können Sie ihn im Abschnitt Angesagt anzeigen lassen. Die empfohlenen Einträge unterliegen der Google Cloud Partner Program Agreement.

Wenn Sie beantragen möchten, dass Ihr Eintrag im Abschnitt Angesagt erscheint, müssen Sie die folgenden Kriterien erfüllen:

Wenn Sie beantragen möchten, dass Ihr Eintrag im Abschnitt Angesagt erscheint oder daraus entfernt wird, reichen Sie das Aufnahmeformular für angesagte Einträge ein.

Eintrag löschen

Wenn Sie einen Eintrag löschen, können Abonnenten diesen Eintrag nicht mehr aufrufen. Wenn Sie einen Eintrag löschen, werden auch alle verknüpften Datasets gelöscht und alle Abos aus den Projekten der Abonnenten entfernt. Wenn ein Dataset weiterhin verknüpft ist, entfernen Sie es manuell. Klicken Sie dazu auf  Teilen > Abo verwalten. Entfernen Sie auf der Seite Abos bestimmte Abo-Datasets oder alle Abo-Datasets gleichzeitig.

Sie können keine Einträge, die in den Cloud Marketplace eingebunden sind, mit aktiven kommerziellen Abos löschen. Sie müssen alle kommerziellen Abos widerrufen, bevor Sie den Eintrag löschen.

Wenn Sie einen Eintrag für mehrere Regionen löschen, werden die Replikate des freigegebenen Datasets nicht gelöscht. Nachdem Sie einen Eintrag für mehrere Regionen gelöscht haben, können Abonnenten den Eintrag nicht mehr aufrufen oder die verknüpften Datasets abfragen. Wenn keine anderen Einträge auf die Replikate des freigegebenen Datasets verweisen, können Sie diese Replikate löschen.

Bevor Sie einen multiregionalen Eintrag löschen, prüfen Sie, ob für den Eintrag aktive Abos vorhanden sind. Wenn aktive Abos vorhanden sind, widerrufen Sie sie durch Aufrufen der Methode projects.locations.subscriptions.revoke. Nachdem alle aktiven Abos entfernt wurden, löschen Sie den Eintrag für mehrere Regionen.

So löschen Sie einen Eintrag:

Console

  1. Rufen Sie die Seite Sharing (Analytics Hub) auf.

    Sharing (Analytics Hub) aufrufen

  2. Klicken Sie auf den Namen des Datenaustauschs, der den Eintrag enthält.

  3. Klicken Sie auf den Eintrag, den Sie löschen möchten.

  4. Klicken Sie auf  Löschen.

  5. Bestätigen Sie im Dialogfeld Eintrag löschen? den Löschvorgang, indem Sie delete eingeben.

  6. Klicken Sie auf Löschen.

API

Rufen Sie die Methode projects.locations.dataExchanges.listings.delete auf:

DELETE https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/dataExchanges/DATAEXCHANGE_ID/listings/LISTING_ID

Ersetzen Sie Folgendes:

  • PROJECT_ID: die ID des Projekts, das den Datenaustausch enthält.
  • LOCATION: der Standort des Datenpools.
  • DATAEXCHANGE_ID: die ID des Datenaustauschs.
  • LISTING_ID: die ID des zu löschenden Eintrags.

Weitere Informationen zu den Aufgaben, die Sie für Einträge mithilfe von APIs ausführen können, finden Sie unter projects.locations.dataExchanges.listings-Methoden.

Nächste Schritte