Installieren und Konfigurieren des Snowflake Connector for Google Analytics Raw Data¶

Snowflake Connector for Google Analytics Raw Data installieren¶

Gehen Sie wie folgt vor, um den Konnektor zu installieren:

1. Melden Sie sich bei Snowsight als Benutzer mit der Rolle ACCOUNTADMIN an.

2. Wählen Sie im Navigationsmenü die Option Data Products » Marketplace aus.

3. Suchen Sie nach dem Snowflake Connector for Google Analytics Raw Data, und wählen Sie dann die Kachel für den Konnektor aus.

4. Wählen Sie auf der Seite für den Snowflake Connector for Google Analytics Raw Data die Option Get aus.

   Daraufhin wird ein Dialogfeld angezeigt, mit dem Sie den ersten Teil des Installationsvorgangs beginnen können.

   Konfigurieren Sie im Dialogfeld die folgenden Einstellungen:

   1. Geben Sie im Feld Options->Application name die Datenbank an, die für die Konnektorinstanz verwendet werden soll. Diese Datenbank wird automatisch für Sie erstellt.

   2. Wählen Sie im Feld Warehouse used for installation das Warehouse aus, das Sie für die Installation des Konnektors verwenden möchten.

      Bemerkung

      Dies ist nicht dasselbe Warehouse, das vom Konnektor zum Synchronisieren der Daten aus Google Analytics verwendet wird. In einem späteren Schritt werden Sie für diesen Zweck ein eigenes Warehouse erstellen.

   3. Wählen Sie Get aus.

5. Wählen Sie Open aus.

   Das Dialogfeld wird geschlossen, und auf der Seite Snowflake Connector for Google Analytics Raw Data wird die UI zum Konfigurieren und Verwalten des Konnektors angezeigt.

Konfigurieren des Snowflake Connector for Google Analytics Raw Data¶

Um den Konnektor zu konfigurieren, gehen Sie wie folgt vor:

1. Melden Sie sich bei Snowsight als Benutzer mit entweder der ACCOUNTADMIN-Rolle oder einer anderen Rolle an, die die folgenden Anforderungen erfüllt:

   • Sie müssen über die folgenden Berechtigungen auf Kontoebene verfügen:

     • EXECUTE TASK mit der Grant-Option

     • EXECUTE MANAGED TASK mit der Grant-Option

   • EVENT_TABLE muss für das Konto aktiviert sein.

   • Für den Zugriff auf Warehouses müssen Sie mindestens über eine der folgenden Berechtigungen verfügen:

     • Die Berechtigung CREATE WAREHOUSE für das Konto

     • Die Berechtigung OWNERSHIP für das Warehouse

     • Die Berechtigung USAGE für das Warehouse (mit der Grant-Option)

   • Für den Datenbankzugriff müssen Sie mindestens über eine der folgenden Berechtigungen verfügen:

     • Die Berechtigung CREATE DATABASE für das Konto

     • Die Berechtigung OWNERSHIP für die Datenbank

     • Die Berechtigung USAGE für die Datenbank (mit der Grant-Option)

   • Für den Zugriff auf das Schema müssen Sie mindestens über eine der folgenden Berechtigungen verfügen:

     • Die Berechtigung CREATE DATABASE für das Konto

     • Die Berechtigung OWNERSHIP für die Datenbank

     • Die Berechtigung USAGE für die Datenbank (mit der Grant-Option)

     • Die Berechtigung CREATE SCHEMA für die Datenbank

     • Die Berechtigungen USAGE, CREATE TABLE, CREATE VIEW für das Schema (mit der Grant-Option)

   • Optional: Für den Rollenzugriff können Sie eine neue Rolle erstellen oder eine bestehende Rolle auswählen, der die DATA_READER-Anwendungsrolle zugewiesen werden soll. Wenn Sie eine neue Rolle erstellen möchten, benötigen Sie die Berechtigung CREATE ROLE für Ihr Konto. Dies ist jedoch nicht erforderlich, um die Konfiguration abzuschließen.

2. Wählen Sie im Navigationsmenü die Option Data Products » Apps aus.

3. Wählen Sie den Snowflake Connector for Google Analytics Raw Data aus.

   Der Konfigurationsassistent wird gestartet.

4. Voraussetzungen

   1. Vergewissern Sie sich, dass alle Voraussetzungen aus der Liste erfüllt sind, und markieren Sie sie als erfüllt.

   2. Klicken Sie auf Start configuration.

5. Konfigurieren Sie Warehouse, Datenbank, Schema und Rolle.

   Bemerkung

   Standardmäßig werden die Felder auf die Namen der Objekte gesetzt, die bei der Konfiguration des Konnektors erstellt werden. Snowflake empfiehlt die Verwendung neuer Objekte für diese Felder. Sie können jedoch bei Bedarf die Namen vorhandener Objekte angeben (z. B. wenn Sie den Konnektor neu installieren).

   Füllen Sie die folgenden Felder aus, und wählen Sie am unteren Rand des Bildschirms Configure aus:

   Feld	Beschreibung
   Warehouse	Geben Sie den Bezeichner für ein neues, dediziertes virtuelles Warehouse für den Konnektor ein, oder wählen Sie ein bestehendes aus. Geben Sie einen Namen an, der für Ihr Konto eindeutig ist. Der Name des Warehouses muss ein gültiger Objektbezeichner sein. Bemerkung Geben Sie nicht das gleiche Warehouse an, das Sie zu Beginn der Installation des Konnektors ausgewählt haben. Der Konfigurationsprozess erstellt ein neues Warehouse der Größe X-Small mit dem angegebenen Namen. Alternativ können Sie auch ein bestehendes Warehouse auswählen.
   Destination Database	Bezeichner für eine neue Datenbank, die das Schema mit den Tabellen für die Google Analytics-Daten in Snowflake enthält. Die von Google Analytics heruntergeladenen Daten werden hier gespeichert. Geben Sie einen Namen an, der für Ihr Konto eindeutig ist. Der Name der Datenbank muss ein gültiger Objektbezeichner sein. Der Konfigurationsprozess erstellt eine neue Datenbank mit dem angegebenen Namen. Alternativ können Sie auch eine vorhandene Datenbank auswählen.
   Destination Schema	Bezeichner für ein neues Schema, das die Google Analytics-Daten in Snowflake enthalten wird. Der Snowflake Connector for Google Analytics Raw Data nimmt Google Analytics-Daten in Tabellen dieses Schemas auf. Der Name des Schemas muss ein gültiger Objektbezeichner sein. Der Konfigurationsprozess erstellt ein neues Schema mit dem angegebenen Namen. Alternativ können Sie auch ein vorhandenes Schema auswählen.
   Role	Bezeichner für eine neue kundenspezifische Rolle für den Konnektor. Geben Sie einen Namen an, der für Ihr Konto eindeutig ist. Der Name der Rolle muss ein gültiger Objektbezeichner sein. Die Rolle ist eine Rolle auf Kontoebene, die Lesezugriff auf die aufgenommenen Daten hat. Alternativ können Sie auch eine vorhandene Rolle auswählen.

   Wenn eine bestehende Zieldatenbank und ein Zielschema angegeben wurden, wird die Eigentümerschaft an den bestehenden regulären Tabellen und Ansichten an Snowflake Connector for Google Analytics Raw Data übertragen. Das schließt z. B. externe Tabellen und materialisierte Ansichten aus. Außerdem wird nichts in verwaltete Schemas übertragen.

   Es kann einige Zeit dauern, bis der Konfigurationsprozess abgeschlossen ist. Wenn der Konfigurationsprozess erfolgreich abgeschlossen ist, geht der Konfigurationsassistent zu Authentication weiter.

6. Authentifizierung konfigurieren

   Der Snowflake Connector for Google Analytics Raw Data unterstützen zwei Authentifizierungsmethoden: OAuth und Dienstkonten. Jede Methode erfordert eine zusätzliche Konfiguration in Ihrem GCP-Projekt.

   Weitere Informationen zum Konfigurieren der jeweiligen Authentifizierungsmethoden finden Sie unter:

   • Konfigurieren der Dienstkonto-Authentifizierung für Google Cloud Platform (GCP)

   • Konfigurieren der OAuth-Authentifizierung für Google Cloud Platform (GCP)

   Wenn Sie die Authentifizierungsmethode Dienstkonto verwenden, geben Sie eine JSON-Datei an, die die Anmeldeinformationen für das Dienstkonto enthält.

   Alternativ können Sie auch die folgenden Felder ausfüllen:

   Feld	Beschreibung
   Client email	Die E-Mail-Adresse des Google-Dienstkontos, die während des Erstellungsprozesses des Dienstkontos im Google Cloud Platform-Projekt generiert wurde.
   Private key	Privater Schlüssel, der während des Erstellungsprozesses des Dienstkontos im Google Cloud Platform-Projekt generiert wurde.

   Vergewissern Sie sich, dass Sie -----BEGIN PRIVATE KEY-----, -----END PRIVATE KEY----- und \\n entfernt haben.

   Wenn Sie die Authentifizierungsmethode Oauth2 verwenden, füllen Sie die folgenden Felder aus:

   Feld	Beschreibung
   Client id	Client-ID, die in Google Cloud Platform-Projekt generiert wurde.
   Client secret	Client-Geheimnis-ID, die in Google Cloud Platform-Projekt generiert wurde.

   Wenn Sie nicht als Benutzer mit der Rolle ACCOUNTADMIN angemeldet sind, müssen Sie sicherstellen, dass Sie die folgenden Anforderungen erfüllen:

   • Sie müssen über die Berechtigung CREATE INTEGRATION verfügen.

   • Wenn Integrationen zuvor von anderen Rollen erstellt wurden, muss die Eigentümerschaft dieser Integrationen auf Ihre Rolle übertragen werden.

   • Wenn die CONNECTORS_SECRET-Datenbank nicht existiert, dann benötigen Sie die Berechtigung CREATE DATABASE.

   • Wenn die CONNECTORS_SECRET-Datenbank existiert, aber von einer anderen Rolle erstellt wurde, dann benötigen Sie diese Berechtigungen:

     • USAGE WITH GRANT OPTION

     • CREATE SCHEMA WITH GRANT OPTION

   • Wenn das Schema CONNECTORS_SECRET.APP_NAME existiert, aber von einer anderen Rolle erstellt wurde, dann benötigen Sie diese Berechtigungen:

     • USAGE WITH GRANT OPTION

     • CREATE SECRET

     • CREATE NETWORK RULE

   • Wenn CONNECTORS_SECRET.APP_NAME.SECRET existiert, aber von einer anderen Rolle erstellt wurde, dann muss die Eigentümerschaft daran auf Ihre Rolle übertragen werden.

   • Wenn CONNECTORS_SECRET.APP_NAME.NETWORK_RULE existiert, aber von einer anderen Rolle erstellt wurde, dann muss die Eigentümerschaft daran auf Ihre Rolle übertragen werden.

   Wählen Sie Connect aus.

   Wenn Sie die Oauth2-Authentifizierung ausgewählt haben, wird Ihnen der Google OAuth2-Authentifizierungsdialogablauf angezeigt.

   Melden Sie sich im Dialogfeld bei Google an, um den Google-OAuth2-Authentifizierungsablauf abzuschließen.

   Es kann einige Zeit dauern, bis der Authentifizierungsprozess abgeschlossen ist.

7. Quelle validieren

Nach erfolgreichem Herstellen einer Verbindung prüft der Konnektor, ob er auf die Google Analytics-Daten zugreifen kann. Beim Auftreten von Fehlern erhalten Sie vom Konnektor zusätzliche Anweisungen.

Wenn der Prozess erfolgreich abgeschlossen wurde, können Sie mit der Konfiguration der Datenerfassung beginnen. Weitere Informationen dazu finden Sie unter Einrichten der Datenaufnahme für Ihren Snowflake Connector for Google Analytics Raw Data.