Einträge verwalten

Als Analytics Hub-Publisher können Sie die folgenden Aufgaben ausführen:

• Einträge in einer Datenaustauschplattform erstellen, auf die Sie Veröffentlichungszugriff haben.
• Nutzungsmesswerte für Einträge aktualisieren, löschen, freigeben und ansehen.
• Verschiedene Rollen für Ihre BigQuery Sharing-Einträge (früher Analytics Hub) verwalten, z. B. für Eintragsadministratoren, Abonnenten und Betrachter.
• Alle Abonnenten aufrufen, die Ihren Eintrag abonniert haben.
• Die Nutzung Ihrer Einträge überwachen.
• Abonnenten aus dem Eintrag entfernen.

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

• Öffentlicher Eintrag. Er kann von Google Cloud -Nutzern (allAuthenticatedUsers) gefunden und abonniert werden. Einträge in einer öffentlichen Datenaustauschplattform sind öffentliche Einträge. Diese Einträge können Verweise auf ein kostenloses öffentliches Dataset oder ein kommerzielles Dataset sein. Wenn der Eintrag ein kommerzielles Dataset betrifft, können Abonnenten entweder direkt beim Datenanbieter Zugriff auf den Eintrag anfordern oder kommerzielle Einträge, die in den Google Cloud Marketplace eingebunden sind, durchsuchen und kaufen.

• Privater Eintrag. Dieser wird direkt für Einzelpersonen oder Gruppen freigegeben. Beispielsweise kann ein privater Eintrag auf Marketingmesswerte-Datasets verweisen, die Sie für andere interne Teams in Ihrer Organisation freigeben. Obwohl Sie allAuthenticatedUsers erlauben, Ihre Einträge zu abonnieren, bleibt der Eintrag privat und wird nicht als öffentlicher Eintrag auf der Seite „Teilen“ angezeigt. Wenn Sie solche Einträge für Nutzer freigeben möchten, teilen Sie die URL des Eintrags mit ihnen. Damit ein privater Eintrag gefunden werden kann, müssen Sie Ihren Datenaustausch veröffentlichen.

Hinweise

Damit Sie BigQuery Sharing (früher Analytics Hub) nutzen können, müssen Sie die Analytics Hub API in Ihrem Google Cloud -Projekt aktivieren.

Erforderliche Berechtigungen

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:

• roles/serviceusage.serviceUsageAdmin

Weitere Informationen zu IAM-Rollen in BigQuery finden Sie unter Vordefinierte Rollen und Berechtigungen.

Analytics Hub API aktivieren

So aktivieren Sie die Analytics Hub API:

gcloud services enable analyticshub.googleapis.com

Erforderliche Berechtigungen

Zum Verwalten von Einträgen und Abos benötigen Sie eine der folgenden Analytics Hub-Rollen:

• Rolle „Analytics Hub-Publisher“ (roles/analyticshub.publisher), mit der Sie IAM-Richtlinien für Ihre Einträge erstellen, aktualisieren, löschen und festlegen können.

• Rolle „Administrator für Analytics Hub-Einträge“ (roles/analyticshub.listingAdmin), mit der Sie IAM-Richtlinien für Ihre Einträge aktualisieren, löschen und festlegen können.

• Rolle „Analytics Hub-Administrator“ (roles/analyticshub.Admin), mit der Sie IAM-Richtlinien für alle Einträge in Ihrem Datenaustausch erstellen, aktualisieren, löschen und festlegen können.

Weitere Informationen finden Sie unter Nutzerrollen für Analytics Hub. Informationen zum Zuweisen dieser Rollen für andere Nutzer finden Sie unter Eintragsadministrator erstellen.

Zum Erstellen von Einträgen benötigen Sie außerdem die Berechtigungen bigquery.datasets.getund bigquery.datasets.update für die Datasets, für die Sie Einträge erstellen möchten. Folgende vordefinierte BigQuery-Rollen haben die Berechtigung bigquery.datasets.update:

• Rolle „BigQuery-Dateninhaber“ (roles/bigquery.dataOwner)
• BigQuery-Administratorrolle (roles/bigquery.admin)

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 Datenaustauschliste in Ihrer Organisation, auf die Sie Zugriff haben, finden Sie unter Datenaustausch aufrufen. Wenn sich der Datenaustausch in einer anderen Organisation befindet, muss der Analytics Hub-Administrator einen Link zu diesem Datenaustausch für Sie freigeben.

Eintrag erstellen

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

So erstellen Sie einen Eintrag:

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

Einen Eintrag aus einem Dataset erstellen

Sie können auch ein Unternehmensprofil aus einem Dataset erstellen. Gehen Sie dazu so vor:

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

   BigQuery aufrufen

2. Klicken Sie auf ein Dataset, um die zugehörigen Details aufzurufen.

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

   Das Dialogfeld Eintrag erstellen wird geöffnet.

4. Wählen Sie einen Datenaustausch aus, in dem dieser Eintrag veröffentlicht werden soll. Der Datenaustausch muss sich in derselben Region wie das Dataset befinden. Weitere Informationen zum Erstellen eines Datenaustauschs finden Sie unter Datenaustausch erstellen und Berechtigungen festlegen.

5. Wählen Sie im Menü Gemeinsames Dataset ein vorhandenes Dataset aus oder klicken Sie auf Dataset erstellen, um ein neues Dataset zu erstellen. Wählen Sie das Dataset aus, das Sie im Datenaustausch auflisten möchten. Das Dataset muss sich in derselben Region wie der Datenaustausch befinden. Sie können dieses Feld nicht mehr aktualisieren, nachdem der Eintrag erstellt wurde.

   Der Name des Quell-Datasets und die ID des Projekts, das das Dataset enthält, werden zurückgegeben, wenn Abonnenten die Metadaten des verknüpften Datasets aufrufen.

6. Wählen Sie in Ausgehender Traffic die entsprechende Ausgehender Traffic-Option.

   • Um die Beschränkung des ausgehenden Traffics auf Ihr freigegebenes Dataset anzuwenden, aber nicht auf die Abfrageergebnisse Ihres freigegebenes Datasets, wählen Sie Kopieren und Exportieren von freigegebenen Daten deaktivieren.
   • Um die Einschränkungen für ausgehenden Traffic auf Ihr freigegebenes Dataset und die Abfrageergebnisse Ihres freigegebenen Datasets anzuwenden, wählen Sie Kopieren und Exportieren von Abfrageergebnissen deaktivieren, wodurch automatisch auch Kopieren und Exportieren von freigegebenen Daten deaktivieren festgelegt wird.
   • Wählen Sie zum Anwenden der Daten-API-Kopier- und Exportbeschränkungen für ausgehenden Traffic auf Ihr freigegebenes Dataset Folgendes aus: Kopieren und Exportieren von Tabellen über APIs deaktivieren, wodurch automatisch auch das Kopieren und Exportieren freigegebener Daten deaktiviert wird.

7. Geben Sie im Abschnitt Eintragsdetails unter Anzeigename den Namen des Eintrags ein.

8. 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 nach diesen Kategorien Einträge filtern.

   • Datenaffinität: Region(en), die vom Publisher für die Veröffentlichung der Daten verwendet werden. Diese Informationen sind nützlich für Abonnenten, um die Kosten für ausgehenden Pub/Sub-Netzwerktraffic zu minimieren oder zu vermeiden, indem sie die Daten aus derselben Region lesen. Weitere Informationen zu den Kosten für ausgehenden Traffic finden Sie unter Kosten für die Datenübertragung.

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

   • Beschreibung: Eine kurze Beschreibung Ihres Eintrags. Abonnenten können anhand der Beschreibung nach Einträgen suchen.

   • Öffentliche Sichtbarkeit: Hier können Sie festlegen, ob Ihr Eintrag im BigQuery-Freigabekatalog öffentlich sichtbar sein soll. 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, wurden die Berechtigungen für den Eintrag bereits ü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 öffentliche Einträge erstellt werden können, muss das Projekt, in dem sich die Datenliste befindet, eine zugehörige Organisation und ein zugehöriges Rechnungskonto haben. Wenn Sie einen kommerziellen Eintrag mit Cloud Marketplace-Integration erstellen, empfehlen wir, ihn öffentlich auffindbar zu machen.

   • Logging der E‑Mail-Adressen von Abonnenten: E‑Mail-Adressen von Abonnenten für die Verwendung verknüpfter Datasets dieses Eintrags beibehalten. Wenn Sie das E‑Mail-Logging aktivieren und speichern, kann diese Einstellung nicht mehr bearbeitet werden. Wenn Sie das E‑Mail-Logging deaktivieren möchten, löschen Sie den Eintrag und erstellen Sie ihn neu, ohne auf den Schalter Logging der E‑Mail-Adressen von Abonnenten (Vorschau) zu klicken.

   • Dokumentation > Markdown: Zusätzliche Informationen wie Links zu relevanten Dokumentationen und zusätzliche Informationen, die Abonnenten bei der Verwendung Ihres Themas unterstützen können.

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

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

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

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

     • Providername: der Name des Themen-Anbieters.
     • Primärer Kontakt des Anbieters: Eine E‑Mail-Adresse oder eine URL des primären Kontakts des Themenanbieters.

     Abonnenten können Einträge basierend auf den Datenanbietern filtern.

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

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

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

11. Klicken Sie auf Veröffentlichen.

Nutzern Zugriff auf einen Eintrag gewähren

Wenn Sie Nutzern Zugriff auf einen privaten Eintrag gewähren möchten, müssen Sie für diese Person eine IAM-Richtlinie oder eine Gruppe für diesen Eintrag festlegen. Bei einem kommerziellen Eintrag muss Ihr Datenaustausch öffentlich sein. Einträge in einem öffentlichen Datenaustausch werden für alle Google Cloud -Nutzer (allAuthenticatedUsers) unter „Freigabe“ angezeigt. Damit Nutzer kommerzielle Einträge aufrufen und Zugriff darauf anfordern können, müssen Sie ihnen die Rolle „Analytics Hub-Betrachter“ zuweisen. Damit Nutzer kommerzielle Einträge abonnieren können, müssen Sie ihnen explizit die Rolle „Analytics Hub-Abonnent“ zuweisen. Bei kommerziellen Einträgen mit Cloud Marketplace-Integration wird die Rolle „Analytics Hub-Abonnent“ automatisch auf Grundlage der Cloud Marketplace-Bestellungen bereitgestellt.

Wenn Sie Ihren Eintrag für alle Nutzer zugänglich machen möchten, auch für Personen, die Google Cloudnicht verwenden, müssen Sie allUsers die Rolle „Analytics Hub-Betrachter“ (roles/analyticshub.viewer) zuweisen.

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

Nicht authentifizierte URL für einen öffentlichen Eintrag erstellen

So erstellen Sie eine nicht authentifizierte Freigabe-Eintrags-URL, die auch für Nutzer ohneGoogle Cloud sichtbar ist:

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

   Zur Datenfreigabe (Analytics Hub)

   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, um die Eintragsdetails aufzurufen. Für den Eintrag muss die öffentliche Sichtbarkeit aktiviert sein.

4. Klicken Sie auf Öffentlichen Link kopieren, um eine nicht authentifizierte URL für den Eintrag zu generieren. Durch diesen Eintrag muss allUsers die Rolle „Analytics Hub-Betrachter“ (roles/analyticshub.viewer) gewährt werden.

Eintragadministrator erstellen

Damit Nutzer Einträge verwalten können, müssen Sie Administratoren für die Freigabe von Einträgen erstellen. Zum Erstellen von Eintragsadministratoren müssen Sie Nutzern auf Eintragsebene die Rolle "Analytics Hub-Publisher" oder "Analytics Hub-Eintragsadministrator" zuweisen. Weitere Informationen zum Zuweisen dieser 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:

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

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

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

Abos entfernen

Wenn Sie ein vor dem 25. Juli 2023 erstelltes Abo aus Ihren Listen entfernen, wird das verknüpfte Dataset vom freigegebenen Dataset getrennt. Abonnenten können die Datasets weiterhin in ihren Projekten sehen, sind aber nicht mehr mit dem freigegebenen Dataset verknüpft.

So entfernen Sie ein Abo, das vor dem 25. Juli 2023 erstellt wurde, aus Ihren Einträgen:

1. Folgen Sie der Anleitung in der Google Cloud -Konsole unter Alle Abos ansehen, um alle Abonnenten eines Eintrags aufzulisten.

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

3. Geben Sie im Dialogfeld Abo entfernen? remove ein, um den Vorgang zu bestätigen.

4. Klicken Sie auf Entfernen.

So entfernen Sie Abos, die nach dem 25. Juli 2023 erstellt wurden:

POST https://analyticshub.googleapis.com/v1/projects/PROJECT_ID/location/LOCATION/subscriptions/SUBSCRIPTION_ID:revoke

Eintrag aktualisieren

So aktualisieren Sie einen Eintrag:

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

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 aus den Projekten Ihrer Abonnenten gelöscht (alle Abos werden entfernt).

Wenn Sie einen Eintrag löschen, kann er nicht rückgängig gemacht werden. So löschen Sie einen Eintrag:

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

Einen Eintrag im Abschnitt "Empfohlen" anzeigen

Um die Sichtbarkeit und Bekanntheit Ihres Eintrags im Freigabekatalog zu verbessern, können Einträge im Abschnitt Angesagt angezeigt werden. Die empfohlenen Einträge unterliegen der Google Cloud Partner Advantage-Vereinbarung.

Partner, die daran interessiert sind, dass ihre Einträge im Abschnitt Angesagt des Katalogs für das Teilen aufgeführt werden, müssen die folgenden Kriterien erfüllen:

• Freigegebene Daten müssen sich in BigQuery befinden.

• Sie müssen für das Partner Advantage-Programm mit der Build-Kennzeichnung angemeldet sein.

• Der Eintrag muss erstellt werden und die öffentliche Sichtbarkeit muss aktiviert sein.

Wenn Sie beantragen möchten, dass Ihr Eintrag im Abschnitt Angesagt erscheint, füllen Sie das Aufnahmeformular aus und reichen Sie es ein. Wenn Sie beantragen möchten, dass Ihr Eintrag aus dem Abschnitt entfernt wird, reichen Sie dasselbe Aufnahmeformular ein.

Nächste Schritte

• Architektur für die gemeinsame Nutzung
• Informationen zum Aufrufen und Abonnieren von Einträgen
• Weitere Informationen zu Analytics Hub-Nutzerrollen
• Datasets erstellen
• Weitere Informationen zum Audit-Logging für die Freigabe
• Einträge überwachen