Einträge ansehen und abonnieren

Als Analytics Hub-Abonnent können Sie Einträge ansehen und abonnieren, auf die Sie Zugriff haben. Wenn Sie einen Eintrag abonnieren, wird ein verknüpftes Dataset in Ihrem Projekt erstellt.

Erforderliche Rollen

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

• Einträge finden: Analytics Hub-Betrachter (roles/analyticshub.viewer)

• Einträge abonnieren: BigQuery-Nutzer (roles/bigquery.user)

  • Wenn Sie Einträge abonnieren möchten, müssen Sie auch den Publisher des Eintrags bitten, Ihnen die Rolle „Analytics Hub-Abonnent“ (roles/analyticshub.subscriber) für seinen Eintrag, seine Datenaustausch oder sein Projekt zuzuweisen, je nachdem, welcher Bereich für den jeweiligen Anwendungsfall am besten geeignet ist.

• Verknüpfte Datasets aufrufen: BigQuery-Datenbetrachter (roles/bigquery.dataViewer)

• Verknüpfte Datasets abfragen: BigQuery-Datenbetrachter (roles/bigquery.dataViewer)

• Verknüpfte Datasets aktualisieren: BigQuery Data Owner (roles/bigquery.dataOwner)

• Tabellenmetadaten ansehen: BigQuery-Datenbetrachter (roles/bigquery.dataViewer)

• Verknüpfte Datasets löschen: BigQuery-Administrator (roles/bigquery.admin)

Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff 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. Öffnen Sie in der Google Cloud Console die Seite BigQuery.

   BigQuery aufrufen

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

3. Klicken Sie im Dialogfeld Daten hinzufügen auf Analytics Hub. Das Dialogfeld Analytics Hub wird angezeigt. Es enthält Einträge, auf die Sie zugreifen können. Für Salesforce Data Cloud-Einträge befindet sich eine Schaltfläche im Bereich Explorer, mit der zugehörige Einträge automatisch gefiltert werden.
   

   Alternativ können Sie zum Öffnen des Dialogfelds "Analytics Hub" auch Analytics Hub aufrufen und auf Einträge suchen klicken.

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

5. 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 die gewünschten Kategorien aus.

   • Speicherort: Wählen Sie den gewünschten Standort aus. 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.

6. Durchsuchen Sie die gefilterten Einträge.

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.

Achtung: Wir empfehlen, keine Daten in ein Projekt zu verschieben, das sich in einem VPC Service Controls-Perimeter befindet. In diesem Fall müssen Sie die entsprechenden Regeln für eingehenden und ausgehenden Traffic hinzufügen.

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

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. Klicken Sie auf ein Dataset, das Sie abonnieren können, und dann auf Dataset zum Projekt hinzufügen, 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.

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

Dabei gilt:

• 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 der Vorgang erfolgreich ist, ist der Antworttext leer.

Verknüpfte Datasets aufrufen

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

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

Console

1. Öffnen Sie in der Google Cloud Console die Seite BigQuery.

   BigQuery aufrufen

2. Klicken Sie im Bereich Explorer auf den Namen des Projekts, in dem das verknüpfte Dataset enthalten ist.

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

Cloud Shell

Führen Sie dazu diesen Befehl aus:

PROJECT=<your 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

Hinweis: Wenn ein Publisher das Abo entfernt, wird auf der Detailseite des verknüpften Datasets angezeigt, dass die Verknüpfung des Datasets aufgehoben wurde. Sie können ein nicht verknüpftes Dataset löschen, da Sie kein Dataset ohne Verknüpfung abfragen können.

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. Öffnen Sie in der Google Cloud Console die Seite BigQuery.

   BigQuery aufrufen

2. Klicken Sie im Bereich Explorer auf den Namen Ihres Projekts und dann auf das verknüpfte Dataset.

3. Maximieren Sie die Option Aktionen und klicken Sie auf Ö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 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 Ansicht INFORMATION_SCHEMA.TABLES 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.

Hinweis: Regionsbasierte INFORMATION_SCHEMA-Abfragen geben keine Metadaten von verknüpften Tabellen zurück. Weitere Informationen zu INFORMATION_SCHEMA-Ansichten, die keine Dataset-Qualifier für verknüpfte Datasets unterstützen, finden Sie unter Einschränkungen.

Verknüpfte Datasets löschen

Wenn Ihr Abo von einem Analytics Hub-Publisher entfernt wird, wird die Verknüpfung Ihres verknüpften Datasets mit dem freigegebenen Dataset aufgehoben. Sie können ein nicht verknüpftes Dataset löschen, da Sie kein Dataset ohne Verknüpfung abfragen können.

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 es jedoch neu erstellen, indem Sie den Eintrag noch einmal abonnieren und das Dataset zu Ihrem Projekt hinzufügen.

So löschen Sie ein verknüpftes Dataset:

1. Öffnen Sie in der Google Cloud Console die Seite BigQuery.

   BigQuery aufrufen

2. Klicken Sie im Bereich Explorer auf den Namen Ihres Projekts und dann auf das verknüpfte Dataset.

3. Maximieren Sie die Option Aktionen und klicken Sie auf Löschen.

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

5. Klicken Sie auf Löschen.

Nächste Schritte

• Weitere Informationen zu Analytics Hub
• Einträge verwalten
• Datenaustausche verwalten
• Audit-Logging in Analytics Hub