Einträge und Data Exchanges ansehen und abonnieren

In BigQuery Sharing (früher Analytics Hub) können Sie Einträge und Datenpools finden und abonnieren, um freigegebene Daten direkt in BigQuery abzufragen, ohne Daten zu replizieren oder Speicherkosten zu verursachen. Wenn Sie einen Eintrag abonnieren, werden in Ihrem Projekt verknüpfte Datasets mit Lesezugriff erstellt, mit denen Sie freigegebene Tabellen und Ansichten zusammen mit Ihren vorhandenen Ressourcen analysieren können.

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen 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 für die Verwendung von Einträgen erforderlich sind. Maximieren Sie den Abschnitt Erforderliche Berechtigungen, um die notwendigen Berechtigungen anzuzeigen:

Erforderliche Berechtigungen

Die folgenden Berechtigungen sind für die Verwendung von Einträgen erforderlich:

  • Neue Datasets erstellen: bigquery.datasets.create für das Abonnentenprojekt
  • Datasets abfragen: bigquery.jobs.create für das Abonnentenprojekt

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 Google Cloud -Console die Seite Sharing (Analytics Hub) auf.

    Sharing (Analytics Hub) aufrufen

  2. Klicken Sie auf Einträge durchsuchen. Es wird ein Dialogfeld mit Einträgen angezeigt, auf die Sie zugreifen können.

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

  4. Filtern Sie im Abschnitt Filter Einträge mithilfe der folgenden Felder:

    • 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 Datenaustauschs suchen. Weitere Informationen finden Sie unter Unterstützte Regionen.

    • Anbieter: Wählen Sie einen 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 entdecken

So finden Sie Datenpools:

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

    Sharing (Analytics Hub) aufrufen

  2. Klicken Sie auf Einträge durchsuchen. Es wird ein Dialogfeld mit Einträgen und Datenaustauschplattformen angezeigt, die Sie abonnieren können.

  3. Wenn Sie Datenaustauschplattformen nach Name oder Beschreibung filtern möchten, geben Sie den Text in das Feld Nach Einträgen suchen ein.

  4. Im Abschnitt Filter können Sie Data-Clean-Room-Austausche mithilfe der folgenden Felder filtern:

    • Einträge: Klicken Sie das Kästchen Data-Clean-Rooms an, um freigegebene Data-Clean-Rooms aufzurufen.

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

    • Standort: Wählen Sie einen Standort aus. Sie können nur nach dem Standort des Datenaustauschs 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 entdecken aus.

  2. Klicken Sie in der Liste der Einträge auf den 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. Außerdem werden die Regionen aufgeführt, in denen der Eintrag verfügbar ist.

  3. Wenn für den Eintrag eine Genehmigung oder ein Kauf erforderlich ist (z. B. ein kommerzielles Dataset), klicken Sie auf Zugriff anfordern oder Über Marketplace kaufen. Klicken Sie andernfalls auf Abonnieren, um das Dialogfeld Verknüpftes Dataset erstellen zu öffnen.

  4. Wenn die Analytics Hub API in Ihrem Projekt nicht aktiviert ist, klicken Sie in der angezeigten Meldung 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 ein, dem Sie das Dataset hinzufügen möchten.
    • Name des verknüpften Datasets: Geben Sie einen Namen für das verknüpfte Dataset ein.

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

    • Optional: Replikatregionen: Wählen Sie die Regionen aus, in denen Sie verknüpfte Dataset-Replikate erstellen möchten. Wenn Sie Ihr verknüpftes Dataset mit anderen Daten am selben Ort speichern, wird der ausgehende Traffic minimiert und es werden Dataset-übergreifende Joins ermöglicht. Zum Erstellen von Replikaten benötigen Sie die Berechtigung bigquery.datasets.update für das verknüpfte Dataset.

  6. Klicken Sie auf Speichern, um das verknüpfte Dataset zu erstellen.

API

Rufen Sie die Methode projects.locations.dataExchanges.listings.subscribe auf, um einen Eintrag zu abonnieren:

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

Ersetzen Sie Folgendes:

  • PROJECT_ID: die Google Cloud Projekt-ID des Projekts, das den Eintrag enthält, den Sie abonnieren möchten.
  • LOCATION: der Standort des Eintrags.
  • DATAEXCHANGE_ID: die Datenpool-ID des Eintrags.
  • LISTING_ID: die ID des Eintrags, den Sie abonnieren möchten.
  • SUBSCRIBER_PROJECT_ID: Die Google Cloud Projekt-ID Ihres Abonnentenprojekts, in dem Sie das verknüpfte Dataset erstellen möchten.
  • LINKED_DATASET_ID: die ID, die Sie dem verknüpften Dataset zuweisen möchten.
  • PRIMARY_REGION: die primäre geografische Region, in der Sie das verknüpfte Dataset erstellen möchten.

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

{
"destinationDataset": {
  "datasetReference": {
    "projectId": "SUBSCRIBER_PROJECT_ID",
    "datasetId": "LINKED_DATASET_ID"
  },
  "location": "PRIMARY_REGION"
}
}

Wenn Sie ein Abo mit verknüpften Dataset-Replikaten in mehreren Regionen erstellen möchten, geben Sie die primäre Region im Feld location an. Wenn Sie sekundäre Replikatregionen angeben möchten, fügen Sie die Regionen dem Feld destinationDataset.replica_locations hinzu. Achten Sie darauf, dass alle angegebenen Regionen Regionen sind, in denen der 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 Feld logLinkedDatasetQueryUserEmail aktivieren, enthält die Aboantwort log_linked_dataset_query_user_email: true. Die protokollierten Daten sind im Feld job_principal_subject der INFORMATION_SCHEMA.SHARED_DATASET_USAGE-Ansicht verfügbar.

Wenn Sie die Freigabe gespeicherter Prozeduren (Vorabversion) aktivieren, enthält die Antwort des Eintrags stored_procedure_config: true.

Datenpools abonnieren

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

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

Console

  1. Wenn Sie eine Liste der Data-Clean-Room-Austausche aufrufen möchten, auf die Sie Zugriff haben, folgen Sie der Anleitung unter Datenaustausch entdecken.

  2. Klicken Sie in der Liste der Data-Clean-Rooms auf den Data-Clean-Room-Austausch, den Sie abonnieren möchten. Ein Dialogfeld mit den Details zum Datenaustausch im Data-Clean-Room wird angezeigt.

  3. Klicken Sie auf Abonnieren, um das Dialogfeld Data-Clean-Room zu Projekt hinzufügen zu öffnen.

  4. Wenn die Analytics Hub API in Ihrem Projekt nicht aktiviert ist, klicken Sie in der angezeigten Meldung auf Analytics Hub API aktivieren.

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

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

  6. Klicken Sie auf Speichern, um das verknüpfte Dataset zu erstellen.

API

Rufen Sie die Methode projects.locations.dataExchanges.subscribe auf, um einen Data-Clean-Room-Austausch zu abonnieren:

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

Ersetzen Sie Folgendes:

  • PROJECT_ID: die Google Cloud Projekt-ID des Projekts, das den Datenaustausch enthält, den Sie abonnieren möchten.
  • LOCATION: der Standort des Datenpools.
  • DATAEXCHANGE_ID: die Datenpool-ID.
  • SUBSCRIBER_PROJECT_ID: Die Google Cloud Projekt-ID Ihres Abonnentenprojekts, in dem Sie das verknüpfte Dataset erstellen möchten.
  • SUBSCRIPTION_ID: der Name des Abos, das erstellt werden soll.
  • LINKED_DATASET_ID: die ID, die Sie dem verknüpften Dataset zuweisen möchten.
  • PRIMARY_REGION: die primäre geografische Region, in der Sie das verknüpfte Dataset erstellen möchten.

Geben Sie im Anfragetext den Zielspeicherort, den Abonnementnamen und das Dataset an, in dem Sie das verknüpfte Dataset erstellen möchten:

{
"destination": "projects/SUBSCRIBER_PROJECT_ID/locations/LOCATION",
"subscription": "SUBSCRIPTION_ID",
"destinationDataset": {
  "datasetReference": {
    "projectId": "SUBSCRIBER_PROJECT_ID",
    "datasetId": "LINKED_DATASET_ID"
  },
  "location": "PRIMARY_REGION"
}
}

Wenn die Anfrage erfolgreich ist, enthält der Antworttext das Vorgangsobjekt. Wenn Sie das Logging von Abonnenten-E‑Mails für den Datenaustausch 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 derGoogle Cloud Console angezeigt.

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

Console

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

    BigQuery aufrufen

  2. Klicken Sie im Bereich Klassischer Explorer auf category Klassischer Explorer:

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

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

  3. Klicken Sie im Bereich Klassischer Explorer auf den Namen des Projekts, in dem das verknüpfte Dataset Symbol für die Freigabe eines verknüpften Datasets. enthalten ist.

Alternativ können Sie mit Knowledge Catalog nach verknüpften Datasets suchen und diese ansehen. Verwenden Sie das Prädikat type=dataset.linked, um alle mit BigQuery-Freigaben verknüpften Datasets in Ihrer Suchanfrage abzugleichen. Weitere Informationen finden Sie unter Knowledge Catalog-Suchsyntax.

Cloud Shell

Führen Sie den folgenden Befehl in Cloud Shell aus, um verknüpfte Datasets in Ihrem Projekt mit dem bq-Befehlszeilentool aufzulisten:

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 dabei PROJECT_ID durch die ID Ihres Projekts in Google Cloud .

Verknüpfte Datasets abfragen

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

Wenn Sie eine Tabelle in einem verknüpften Dataset abfragen möchten, führen Sie eine SELECT-Abfrage aus, die auf Ihre Projekt-ID, die ID des verknüpften Datasets und den Tabellennamen verweist:

SELECT * FROM `PROJECT_ID`.`LINKED_DATASET_ID`.`TABLE_NAME`
LIMIT 10;

Ersetzen Sie Folgendes:

  • PROJECT_ID: Projekt-ID in Google Cloud .
  • LINKED_DATASET_ID: die ID des verknüpften Datasets.
  • TABLE_NAME: der Name der Tabelle oder Ansicht, die Sie abfragen möchten.

Weitere Informationen finden Sie unter Interaktive Abfragen ausführen.

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 Google Cloud 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 Detailbereich auf Details bearbeiten und konfigurieren Sie die folgenden Optionen:

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

    2. Maximieren Sie zum Aktivieren der Sortierung die Erweiterten 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. Um die Änderungen zu speichern, klicken Sie auf Speichern.

Tabellenmetadaten abrufen

Fragen Sie die Ansicht INFORMATION_SCHEMA.TABLES ab, um die Tabellenmetadaten für ein verknüpftes Dataset aufzurufen:

SELECT * FROM `LINKED_DATASET_ID`.INFORMATION_SCHEMA.TABLES;

Ersetzen Sie LINKED_DATASET_ID durch die ID des verknüpften Datasets.

Verknüpfte Datasets abbestellen oder löschen

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

Sie können ein verknüpftes Dataset nicht abrufen, nachdem Sie es gelöscht haben. Sie können das gelöschte verknüpfte Dataset jedoch jederzeit neu erstellen, indem Sie den Eintrag noch einmal abonnieren.

Wenn ein Publisher Ihr Abo entfernt, wird die Verknüpfung Ihres verknüpften Datasets mit dem freigegebenen Dataset aufgehoben. Da es sich um eine vom Publisher initiierte Aktion für eine Ressource im Besitz des Abonnenten handelt, verbleibt das verknüpfte Dataset in Ihrem Projekt, ist aber nicht mehr verknüpft. 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 Google Cloud 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 delete eingeben.

  6. Klicken Sie auf Löschen.

Nächste Schritte