Installieren und Konfigurieren des Snowflake Connector for Google Analytics Raw Data

Unter diesem Thema finden Sie Informationen zum Installieren und Konfigurieren des Snowflake Connector for Google Analytics Raw Data über Snowsight.

Installieren der Snowflake-Erweiterung für Visual Studio Code

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 der Rolle ACCOUNTADMIN an.

  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 erfasst Google Analytics-Daten in Tabellen dieses Schemas.

    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 erfassten Daten hat.

    Alternativ können Sie auch eine vorhandene Rolle auswählen.

    Es kann einige Zeit dauern, bis der Konfigurationsprozess abgeschlossen ist. Wenn der Konfigurationsprozess erfolgreich abgeschlossen ist, geht der Konfigurationsassistent zur Authentifizierung 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:

    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.

    Stellen Sie sicher, dass Sie die Symbole —–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.

    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 Datenerfassung für Ihren Snowflake Connector for Google Analytics Raw Data.

Konfigurieren des Snowflake Connector for Google Analytics Raw Data mit SQL-Anweisungen

Um den Konnektor mit SQL-Anweisungen zu konfigurieren, gehen Sie wie folgt vor:

Bemerkung

Um den Konnektor bereitzustellen und die Verbindung zu konfigurieren, müssen Sie gespeicherte Prozeduren verwenden, die im PUBLIC-Schema der Datenbank definiert sind, die als Instanz der Konnektor-Installationsdatenbank dient.

Bevor Sie diese gespeicherten Prozeduren aufrufen, wählen Sie diese Datenbank als die für die Sitzung zu verwendende Datenbank aus.

Wenn diese Datenbank beispielsweise snowflake_connector_for_google_analytics_raw_data heißt, führen Sie den folgenden Befehl aus:

USE DATABASE snowflake_connector_for_google_analytics_raw_data;
Copy

Warehouse, Dateneigentümerrolle und Zieldatenbank vorbereiten

  1. Erteilen Sie der Konnektor-Anwendung die Berechtigung zur Nutzung des angegebenen Warehouses und zum Ausführen von Aufgaben.

    USE ROLE accountadmin;
CREATE WAREHOUSE google_analytics_raw_data_warehouse with warehouse_size = 'X-Small';
GRANT USAGE ON WAREHOUSE google_analytics_raw_data_warehouse TO APPLICATION snowflake_connector_for_google_analytics_raw_data;
GRANT EXECUTE TASK ON ACCOUNT TO APPLICATION snowflake_connector_for_google_analytics_raw_data;
    Copy

  2. Erstellen Sie die Rolle des Dateneigentümers.

    USE ROLE accountadmin;
CREATE OR REPLACE ROLE google_analytics_raw_data_resources_provider;
GRANT CREATE DATABASE ON ACCOUNT TO ROLE google_analytics_raw_data_resources_provider;
GRANT USAGE ON WAREHOUSE google_analytics_raw_data_warehouse TO ROLE google_analytics_raw_data_resources_provider;
GRANT ROLE google_analytics_raw_data_resources_provider TO USER ADMIN;
    Copy

  3. Erstellen Sie die Zieldatenbank und das Zielschema.

    Sie können auch eine vorhandene Zieldatenbank und ein vorhandenes Schema verwenden, was besonders hilfreich ist, wenn Sie den Konnektor erneut installieren.

    USE ROLE google_analytics_raw_data_resources_provider;
CREATE DATABASE google_analytics_raw_data_dest_db;
CREATE SCHEMA google_analytics_raw_data_dest_db.google_analytics_raw_data_dest_schema;
    Copy

  4. Weisen Sie der Anwendung die erforderlichen Berechtigungen für die Zieldatenbank zu.

    USE ROLE accountadmin;
GRANT USAGE ON DATABASE google_analytics_raw_data_dest_db TO APPLICATION snowflake_connector_for_google_analytics_raw_data;
GRANT USAGE ON SCHEMA google_analytics_raw_data_dest_db.google_analytics_raw_data_dest_schema TO APPLICATION snowflake_connector_for_google_analytics_raw_data;

GRANT CREATE TABLE ON SCHEMA google_analytics_raw_data_dest_db.google_analytics_raw_data_dest_schema TO APPLICATION snowflake_connector_for_google_analytics_raw_data;
GRANT CREATE VIEW ON SCHEMA google_analytics_raw_data_dest_db.google_analytics_raw_data_dest_schema TO APPLICATION snowflake_connector_for_google_analytics_raw_data;
    Copy

Konnektor bereitstellen

  1. Rufen Sie die Prozedur PROVISION_CONNECTOR auf.

    Übergeben Sie den Namen des Warehouses, die Zieldatenbank und das Zielschema sowie die Dateneigentümerrolle. Bei diesen Werten wird zwischen Groß- und Kleinschreibung unterschieden.

    CALL PROVISION_CONNECTOR(
    'GOOGLE_ANALYTICS_RAW_DATA_WAREHOUSE',
    'GOOGLE_ANALYTICS_RAW_DATA_DEST_DB.GOOGLE_ANALYTICS_RAW_DATA_DEST_SCHEMA',
    'GOOGLE_ANALYTICS_RAW_DATA_RESOURCES_PROVIDER'
);
    Copy

Für Verbindung zur GCP erforderliche Snowflake-Objekte erstellen

  1. Erstellen Sie eine Sicherheitsintegration für Ihr Dienstkonto.

    Zuerst benötigen Sie eine Schlüsseldatei für das Dienstkonto. Weitere Informationen zum Erstellen dieser Datei finden Sie unter Konfigurieren der Dienstkonto-Authentifizierung für Google Cloud Platform (GCP).

    CREATE SECURITY INTEGRATION
snowflake_connector_for_google_analytics_raw_data_security_integration
type = api_authentication
auth_type = oauth2
oauth_client_id = '<value of client_id from the JSON key file>'
oauth_token_endpoint = 'https://oauth2.googleapis.com/token'
enabled = true
oauth_allowed_scopes = (
    'https://www.googleapis.com/auth/bigquery.readonly',
    'https://www.googleapis.com/auth/cloudplatformprojects.readonly'
)
oauth_assertion_issuer = '<value of client_email from the JSON key file>'
oauth_grant='JWT_BEARER'
oauth_client_secret = '<value of private_key from the JSON key file with no delimiters or newlines>';
    Copy

  2. Erstellen Sie mithilfe der Sicherheitsintegration ein Geheimnis.

    CREATE DATABASE google_analytics_raw_data_connector_secret;
CREATE SCHEMA google_analytics_raw_data_connector_secret.oauth;

USE SCHEMA google_analytics_raw_data_connector_secret.oauth;

CREATE OR REPLACE SECRET google_analytics_raw_data
type = oauth2
api_authentication = snowflake_connector_for_google_analytics_raw_data_security_integration;
    Copy

  3. Weisen Sie der Konnektoranwendung Geheimnis-bezogene Berechtigungen zu.

    GRANT USAGE ON DATABASE google_analytics_raw_data_connector_secret TO APPLICATION snowflake_connector_for_google_analytics_raw_data;
GRANT USAGE ON SCHEMA google_analytics_raw_data_connector_secret.oauth TO APPLICATION snowflake_connector_for_google_analytics_raw_data;
GRANT READ ON SECRET google_analytics_raw_data_connector_secret.oauth.google_analytics_raw_data TO APPLICATION snowflake_connector_for_google_analytics_raw_data;
    Copy

  4. Konfigurieren Sie den externen Zugriff.

    Beachten Sie, dass bei der an allowed_authentication_secrets übergebenen Pfadangabe zum Geheimnis die Groß-/Kleinschreibung unterschieden wird.

    USE SCHEMA google_analytics_raw_data_connector_secret.oauth;

CREATE NETWORK RULE
google_analytics_raw_data_allow_rule
mode = EGRESS
type = HOST_PORT
value_list = (
    'www.googleapis.com',
    'bigquery.googleapis.com',
    'bigquerystorage.googleapis.com',
    'cloudresourcemanager.googleapis.com',
    'oauth2.googleapis.com'
);

CREATE EXTERNAL ACCESS INTEGRATION
google_analytics_raw_data_external_access_integration
allowed_network_rules = (google_analytics_raw_data_allow_rule)
allowed_authentication_secrets = ('GOOGLE_ANALYTICS_RAW_DATA_CONNECTOR_SECRET.OAUTH.GOOGLE_ANALYTICS_RAW_DATA')
enabled = true;

GRANT USAGE ON INTEGRATION google_analytics_raw_data_external_access_integration TO APPLICATION snowflake_connector_for_google_analytics_raw_data;
    Copy

Verbindung zur GCP konfigurieren

  1. Rufen Sie die Prozedur CONFIGURE_CONNECTION auf.

    Übergeben Sie den Namen der Integration für den externen Zugriff und den vollständigen Pfad zum Geheimnis. Bei diesen Werten wird zwischen Groß- und Kleinschreibung unterschieden.

    CALL CONFIGURE_CONNECTION(
    'GOOGLE_ANALYTICS_RAW_DATA_EXTERNAL_ACCESS_INTEGRATION',
    'GOOGLE_ANALYTICS_RAW_DATA_CONNECTOR_SECRET.OAUTH.GOOGLE_ANALYTICS_RAW_DATA'
);
    Copy

  2. Überprüfen Sie den Verbindungsstatus.

    CALL CONNECTION_STATUS();
    Copy

    Wenn es keine Fehler gibt, können Sie mit Einrichten der Datenerfassung für Ihren Snowflake Connector for Google Analytics Raw Data fortfahren, um Ihre Google Analytics-Eigenschaften zu aktivieren.

Sprache: Deutsch