Einträge und Datenpools ansehen und abonnieren

In diesem Dokument wird beschrieben, wie Sie Einträge und Datenpools in BigQuery Sharing (früher Analytics Hub) ansehen und abonnieren. Als Abonnent von BigQuery Sharing können Sie Einträge und Datenpools ansehen und abonnieren, auf die Sie Zugriff haben. Wenn Sie einen Eintrag oder einen Datenpool in BigQuery Sharing abonnieren, wird ein verknüpftes Dataset in Ihrem Cloud de Confiance Projekt erstellt.

Erforderliche Rollen

Bitten Sie Ihren BigQuery Sharing-Administrator, Ihnen die folgenden IAM-Rollen (Identity and Access Management) für das BigQuery Sharing-Abonnentenprojekt zuzuweisen, um die Berechtigungen zu erhalten, die Sie zur Verwendung von Einträgen benötigen:

Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Diese vordefinierten Rollen enthalten die Berechtigungen, die zum Ausführen der Aufgaben in diesem Dokument erforderlich sind. Erweitern Sie den Abschnitt Erforderliche Berechtigungen, um die genauen Berechtigungen aufzurufen, die zum Erstellen und Abfragen von Datasets erforderlich sind:

Erforderliche Berechtigungen

  • Neue Datasets erstellen: bigquery.datasets.create oder bigquery.datasets.* zum Ausführen zusätzlicher Aktionen für Datasets.
  • Datasets abfragen: bigquery.jobs.create oder bigquery.jobs.* zum Ausführen zusätzliche Aktionen für Jobs.

Sie können diese Berechtigungen auch mit benutzerdefinierten Rollen oder anderen vordefinierten Rollen erhalten.

Einträge finden

So finden Sie öffentliche und private Einträge:

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

    Sharing (Analytics Hub) aufrufen

  2. Klicken Sie auf Einträge suchen. Ein Dialogfeld mit den Einträgen, auf die Sie Zugriff haben, wird angezeigt.

  3. Wenn Sie Einträge nach Name oder Beschreibung filtern möchten, geben Sie den Namen oder die Beschreibung des Eintrags in das Feld Nach Einträgen suchen ein.

  4. Im Abschnitt Filter können Sie Einträge basierend auf den folgenden Feldern filtern:

    • Einträge: Wählen Sie aus, ob Sie private Einträge, öffentliche Einträge oder Einträge in Ihrer Organisation aufrufen möchten.

    • Kategorien: Wählen Sie eine oder mehrere Kategorien aus.

    • Standort: Wählen Sie einen Standort aus. Sie können nur nach dem Standort des Datenpools suchen. Weitere Informationen finden Sie unter Unterstützte Regionen.

    • Anbieter: Wählen Sie den Datenanbieter aus. Einige Datenanbieter verlangen, dass Sie Zugriff auf ihre kommerziellen Datasets anfordern. Nachdem Sie den Zugriff angefordert haben, kontaktiert Sie der Datenanbieter, um Ihre Datasets freizugeben.

  5. Durchsuchen Sie die gefilterten Einträge.

Datenpools finden

So finden Sie Datenpools:

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

    Sharing (Analytics Hub) aufrufen

  2. Klicken Sie auf Einträge suchen. Ein Dialogfeld mit Einträgen und Datenpools, die Sie abonnieren können, wird angezeigt.

  3. Wenn Sie Datenpools nach Name oder Beschreibung filtern möchten, geben Sie den Namen oder die Beschreibung des Data-Clean-Room-Austauschs in das Feld Nach Einträgen suchen ein.

  4. Im Abschnitt Filter können Sie Data-Clean-Room-Austausche basierend auf den folgenden Feldern filtern:

    • Einträge: Wählen Sie das Kästchen Data-Clean-Rooms aus, um die Data-Clean Rooms aufzurufen, die für Sie freigegeben wurden.

    • Kategorien: Wählen Sie eine oder mehrere Kategorien aus.

    • Standort: Wählen Sie einen Standort aus. Sie können nur nach dem Standort des Datenpools suchen. Weitere Informationen finden Sie unter Unterstützte Regionen.

  5. Durchsuchen Sie die gefilterten Data-Clean-Rooms.

Einträge abonnieren

Wenn Sie einen Eintrag abonnieren, erhalten Sie Lesezugriff auf die Daten im Eintrag. Dazu erstellen Sie ein verknüpftes Dataset in Ihrem Projekt.

So abonnieren Sie einen Eintrag:

Console

  1. Zum Aufrufen einer Liste der Einträge, auf die Sie Zugriff haben, führen Sie die Schritte unter Einträge finden aus.

  2. Gehen Sie die Einträge durch und klicken Sie auf einen Eintrag, den Sie abonnieren möchten. Ein Dialogfeld mit den Details des Eintrags wird angezeigt. Im Dialogfeld wird angezeigt, ob der Anbieter das Logging von Abonnenten-E‑Mails aktiviert hat. Im Abschnitt Zusätzliche Details sehen Sie die Regionen, in denen der Anbieter den Eintrag verfügbar gemacht hat.

  3. Wenn Sie keinen Zugriff für das Abonnieren eines Eintrags haben, z. B. ein Eintrag in einem kommerziellen Dataset, klicken Sie auf Zugriff anfordern oder Über Marketplace kaufen. Klicken Sie auf ein Dataset, das Sie abonnieren können, und dann auf Abonnieren , um das Dialogfeld Verknüpftes Dataset erstellen zu öffnen.

  4. Wenn die Analytics Hub API in Ihrem Projekt nicht aktiviert ist, wird eine Fehlermeldung mit einem Link zum Aktivieren der API angezeigt. Klicken Sie auf Analytics Hub API aktivieren.

  5. Geben Sie im Dialogfeld Verknüpftes Dataset erstellen die folgenden Details an:

    • Projekt: Geben Sie den Namen des Projekts an, dem Sie das Dataset hinzufügen möchten.
    • Name des verknüpften Datasets: Geben Sie den Namen des verknüpften Datasets an.

    • Primäre Region: Wählen Sie die Region aus, in der Sie das verknüpfte Dataset erstellen möchten.

    • Optional: Replikaregionen: Wählen Sie die Region oder Regionen aus, in denen Sie zusätzliche sekundäre Replikate des verknüpften Datasets erstellen möchten. Sie können Ihr verknüpftes Dataset in derselben Region wie Ihre anderen Daten platzieren, um den ausgehenden Traffic zu minimieren und Joins zwischen Datasets zu erleichtern. Zum Erstellen von Replikaten verknüpfter Datasets benötigen Sie die Berechtigung bigquery.datasets.update für das verknüpfte Dataset.

  6. Um die Änderungen zu speichern, klicken Sie auf Speichern. Das verknüpfte Dataset wird in Ihrem Projekt aufgeführt.

API

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

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

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 des Eintrags, den Sie abonnieren möchten.
  • LISTING_ID: die ID des Eintrags, den Sie abonnieren möchten.

Geben Sie im Anfragetext das Dataset an, in dem Sie das verknüpfte Dataset erstellen möchten.

Wenn Sie ein Abo mit Replikaten verknüpfter Datasets erstellen möchten, die in mehreren Regionen verfügbar sind, geben Sie die primäre Region des verknüpften Datasets mit dem Feld location im Anfragetext an. Für die sekundären Regionen, in denen Sie Replikate verknüpfter Datasets erstellen möchten, können Sie optional das Feld destinationDataset.replica_locations im Anfragetext verwenden und alle ausgewählten sekundären Replikaregionen auflisten. Achten Sie darauf, dass die in der location Eigenschaft und in dem destinationDataset.replica_locations Feld angegebenen Regionen Regionen sind, in denen der zugehörige Eintrag verfügbar ist.

Wenn die Anfrage erfolgreich ist, enthält der Antworttext das Aboobjekt.

Wenn Sie das Logging von Abonnenten-E‑Mails für den Datenpool oder Eintrag mit dem logLinkedDatasetQueryUserEmail Feld aktivieren, enthält die Aboantwort log_linked_dataset_query_user_email: true. Die protokollierten Daten sind in dem job_principal_subject Feld der INFORMATION_SCHEMA.SHARED_DATASET_USAGE Ansicht.

Wenn Sie die Freigabe gespeicherter Prozeduren (Vorschau) aktivieren, enthält die Eintragantwort stored_procedure_config: true.

Datenpools abonnieren

Wenn Sie einen Datenpool abonnieren, erhalten Sie Lesezugriff auf die Daten im Data-Clean-Room-Austausch. Dazu erstellen Sie ein verknüpftes Dataset in Ihrem Projekt.

So abonnieren Sie einen Data-Clean-Room-Austausch:

Console

  1. Zum Aufrufen einer Liste der Data-Clean-Room-Austausche, auf die Sie Zugriff haben, führen Sie die Schritte unter Datenpools finden aus.

  2. Gehen Sie die Data-Clean-Room-Austausche durch und klicken Sie auf einen Data-Clean-Room-Austausch, den Sie abonnieren möchten. Ein Dialogfeld mit den Details des Data-Clean-Room-Austauschs wird angezeigt.

  3. Klicken Sie auf einen Data-Clean-Room-Austausch, den Sie abonnieren können, und dann auf Abonnieren , um das Dialogfeld Data-Clean-Room zum Projekt hinzufügen zu öffnen.

  4. Wenn die Analytics Hub API in Ihrem Projekt nicht aktiviert ist, wird eine Fehlermeldung mit einem Link zum Aktivieren der API angezeigt. Klicken Sie auf Analytics Hub API aktivieren.

  5. Geben Sie im Dialogfeld Data-Clean-Room zum Projekt hinzufügen die folgenden Details an:

    • Ziel: Geben Sie den Namen des Projekts an, dem Sie das Dataset hinzufügen möchten.

  6. Um die Änderungen zu speichern, klicken Sie auf Speichern. Das verknüpfte Dataset wird in Ihrem Projekt aufgeführt.

API

Verwenden Sie die Methode projects.locations.dataExchanges.subscribe:

POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/dataExchanges/DATAEXCHANGE_ID:subscribe

Ersetzen Sie Folgendes:

  • PROJECT_ID: die Projekt-ID des Datenpools, den Sie abonnieren möchten.
  • LOCATION: der Standort für Ihren Datenpool, den Sie abonnieren möchten.
  • DATAEXCHANGE_ID: die Datenaustausch-ID, die Sie abonnieren möchten.

Geben Sie im Anfragetext das Dataset an, in dem Sie das verknüpfte Dataset erstellen möchten.

Wenn die Anfrage erfolgreich ist, enthält der Antworttext das Aboobjekt. Wenn Sie das Logging von Abonnenten-E‑Mails für den Datenpool aktiviert haben, enthält die Aboantwort log_linked_dataset_query_user_email: true.

Verknüpfte Datasets aufrufen

Verknüpfte Datasets werden zusammen mit anderen Datasets in der Cloud de Confiance Console angezeigt.

So rufen Sie verknüpfte Datasets in Ihrem Projekt auf:

Console

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

    BigQuery aufrufen

  2. Klicken Sie im Bereich Klassischer Explorer auf die Kategorie Klassischer Explorer:

    Hervorgehobener Button für den Bereich „Klassischer Explorer“.

    Wenn der Bereich Klassischer Explorer nicht angezeigt wird, klicken Sie auf Linken Bereich maximieren , um ihn zu öffnen.

  3. Klicken Sie im Bereich Klassischer Explorer auf den Projektnamen, der das Symbol für verknüpftes Dataset in Analytics Hub verknüpfte Dataset enthält.

Alternativ können Sie auch Data Catalog (eingestellt) oder Knowledge Catalog verwenden, um verknüpfte Datasets zu suchen und anzuzeigen. Verwenden Sie das Prädikat type=dataset.linked, um alle mit BigQuery Sharing verknüpften Datasets abzugleichen. Weitere Informationen finden Sie unter Data Catalog-Suchsyntax oder Knowledge Catalog-Suchsyntax.

Cloud Shell

Führen Sie dazu diesen Befehl aus:

PROJECT=PROJECT_ID \
for dataset in $(bq ls --project_id $PROJECT | tail +3); do [ "$(bq show -d --project_id $PROJECT $dataset | egrep LINKED)" ] && echo $dataset; done

Ersetzen Sie PROJECT_ID durch die Cloud de Confiance Projekt-ID Ihres Projekts.

Verknüpfte Datasets abfragen

Sie können Tabellen und Ansichten in Ihren verknüpften Datasets genauso wie alle anderen BigQuery-Tabellen abfragen.

Verknüpfte Datasets aktualisieren

Ressourcen in einem verknüpften Dataset sind schreibgeschützt. Sie können weder die Daten oder Metadaten für Ressourcen in verknüpften Datasets bearbeiten noch Berechtigungen für einzelne Ressourcen angeben.

Sie können nur die Beschreibung und die Labels von verknüpften Datasets aktualisieren. Änderungen an einem verknüpften Dataset wirken sich nicht auf die Quell-Datasets oder die freigegebenen Datasets aus.

So aktualisieren Sie die Beschreibung und die Labels eines verknüpften Datasets:

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

    BigQuery aufrufen

  2. Klicken Sie im Bereich Explorer auf Explorer:

    Hervorgehobener Button für den Explorer-Bereich.

  3. Maximieren Sie im Bereich Explorer den Projektnamen, klicken Sie auf Datasets und dann auf den Namen des verknüpften Datasets, um es zu öffnen.

  4. Klicken Sie im Bereich „Details“ auf Details bearbeiten und geben Sie folgende Details an:

    1. Informationen zum Hinzufügen von Labels finden Sie unter Label zu einem Dataset hinzufügen.

    2. Maximieren Sie zum Aktivieren der Sortierung, maximieren Sie den Abschnitt Erweiterte Optionen und führen Sie die folgenden Schritte aus:

      1. Klicken Sie auf Standardsortierung aktivieren.
      2. Wählen Sie in der Liste Standardsortierung eine Option aus.

  5. Klicken Sie auf Speichern.

Tabellenmetadaten abrufen

Fragen Sie die INFORMATION_SCHEMA.TABLES Ansicht ab, um die zugrunde liegenden Tabellenmetadaten aufzurufen:

SELECT * FROM `LINKED-DATASET.INFORMATION_SCHEMA.TABLES`

Ersetzen Sie LINKED-DATASET durch den Namen des verknüpften Datasets.

Abo für verknüpfte Datasets beenden oder verknüpfte Datasets löschen

Wenn Sie das Abo für ein Dataset beenden möchten, müssen Sie das verknüpfte Dataset löschen. Beim Löschen eines verknüpften Datasets wird nicht das Quell-Dataset gelöscht.

Sie können ein verknüpftes Dataset, das Sie gelöscht haben, nicht abrufen. Sie können das gelöschte verknüpfte Dataset jedoch neu erstellen, indem Sie den Eintrag noch einmal abonnieren und das Dataset sowie die verknüpften Datasets, die aus in Google Cloud Marketplace integrierten Einträgen erstellt wurden, zu Ihrem Projekt hinzufügen.

Wenn Ihr Abo von einem BigQuery Sharing-Publisher entfernt wird, wird die Verknüpfung Ihres verknüpften Datasets mit dem freigegebenen Datasetaufgehoben. Da dies eine vom Publisher initiierte Aktion für eine Ressource ist, die dem Abonnenten gehört, bleibt das verknüpfte Dataset im Projekt des BigQuery Sharing-Abonnenten im nicht verknüpften Zustand. Sie können das nicht verknüpfte Dataset entfernen, indem Sie es löschen.

So löschen Sie ein verknüpftes Dataset:

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

    BigQuery aufrufen

  2. Klicken Sie im Bereich Explorer auf Explorer:

    Hervorgehobener Button für den Explorer-Bereich.

  3. Maximieren Sie im Bereich Explorer den Projektnamen, klicken Sie auf Datasets und dann auf den Namen des verknüpften Datasets, um es zu öffnen.

  4. Klicken Sie auf Löschen.

  5. Bestätigen Sie im Dialogfeld Verknüpftes Dataset löschen? den Vorgang, indem Sie Löschen eingeben.

  6. Klicken Sie auf Löschen.

Nächste Schritte