Einrichten der Datenerfassung für Ihren Snowflake Connector for Google Analytics Raw Data

Unter diesem Thema wird beschrieben, wie Sie in Ihrem Snowflake-Konto auf den Snowflake Connector for Google Analytics Raw Data zugreifen.

Einrichten der Datenerfassung mit Snowsight

Um die Datenerfassung mit Snowsight einzurichten, 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. Suchen Sie nach dem Snowflake Connector for Google Analytics Raw Data, und wählen Sie dann die Kachel für den Konnektor aus.

  4. Navigieren Sie auf der Seite des Snowflake Connector for Google Analytics Raw Data zum Bereich Data Sync.

    Dadurch wird eine Liste aller Google Analytics-Eigenschaften angezeigt.

  5. Wählen Sie die Eigenschaften aus, die Sie erfassen möchten:

    1. Suchen Sie nach der Eigenschaft, die Sie erfassen möchten.

    2. Aktivieren Sie das Kontrollkästchen in der Spalte Status neben der Eigenschaft, die Sie auswählen möchten.

    3. Wiederholen Sie diese Schritte für jede Eigenschaft, die Sie in Snowflake erfassen möchten.

  6. Wählen Sie die Überschrift der Spalte Status aus, um die aktuell ausgewählten Eigenschaften anzuzeigen.

  7. Wählen Sie Start sync aus, um mit dem Erfassen von Daten in Ihr Snowflake-Konto zu beginnen.

Die ausgewählten Eigenschaften werden in der Eigenschaftenliste angezeigt.

Der Data Ingestion-Status wird in der rechten oberen Ecke des Bereichs Manage data synchronization angezeigt.

Die Datensynchronisierung jeder Eigenschaft beginnt mit einem erstmaligen Laden. Dabei werden alle historischen Daten einer Eigenschaft erfasst und dann mit der aktuellen Synchronisierung fortgefahren. Wenn Sie nur aktuelle Daten synchronisieren möchten, können Sie dies über ein Arbeitsblatt tun.

Ändern der Datenerfassung mit Snowsight

Um die zu erfassenden Google Analytics-Tabellen oder den Synchronisierungszeitplan für die Tabellen zu ändern, 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. Suchen Sie nach dem Snowflake Connector for Google Analytics Raw Data, und wählen Sie dann die Kachel für den Konnektor aus.

  4. Navigieren Sie auf der Seite des Snowflake Connector for Google Analytics Raw Data zum Bereich Data Sync.

  5. Wählen Sie Edit properties aus.

  6. Ändern Sie die Tabellen, die Sie erfassen möchten:

    1. Suchen Sie nach der Tabelle, die Sie erfassen möchten.

    2. Aktivieren Sie das Kontrollkästchen in der Spalte Status neben der Tabelle, die Sie auswählen oder Auswahl entfernen möchten.

  7. Wählen Sie Update data sync aus.

Einrichten der Datenerfassung mit SQL-Anweisungen

Um die Datenerfassung mit SQL-Anweisungen einzurichten, gehen Sie wie folgt vor:

Bemerkung

Um diese Einstellungen zu konfigurieren, verwenden Sie gespeicherte Prozeduren, die im PUBLIC-Schema der Datenbank definiert sind, die als Instanz der Konnektorinstallationsdatenbank 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

Anzeigen der für die Erfassung verfügbaren Eigenschaften

Um alle verfügbaren Eigenschaften in einem bestimmten GCP-Projekt aufzulisten, rufen Sie die folgende gespeicherte Prozedur auf:

CALL LIST_GA_PROPERTIES();
Copy

Das Ergebnis zeigt alle Projekte und Eigenschaften an, die für eine Erfassung durch ein autorisiertes Konto verfügbar sind. Wenn keine Ergebnisse zurückgegeben werden, überprüfen Sie Folgendes:

  • Der Datenexport von Google Analytics nach BigQuery ist konfiguriert.

  • Die exportierten Daten sind in BigQuery sichtbar.

  • Dem verwendeten Dienstkonto bzw. dem authentifizierten Benutzer sind die korrekten Rollen zugewiesen.

Beachten Sie, dass zwischen Einrichten des Datenexports und Speichern der Daten in BigQuery bis zu 24 Stunden vergehen können. Diese Verzögerung kann eine Ursache dafür sein, dass die Prozedur LIST_GA_PROPERTIES keine Ergebnisse zurückgibt.

Wenn Sie den Google Analytics-Export deaktivieren, bedeutet dies nicht, dass die Eigenschaft von LIST_GA_PROPERTIES ausgelassen wird. Auch wenn der Export deaktiviert wurde, können die Daten in BigQuery bestehen bleiben und vom Konnektor synchronisiert werden.

Vorbereiten der Zieldatenbank

Bevor Sie die Erfassung aktivieren, müssen Sie dem Konnektor Zugriff gewähren, um Tabellen und Ansichten in Ihrer Zieldatenbank und Ihrem Schema zu erstellen.

GRANT USAGE ON DATABASE <destination database> TO APPLICATION <application name>;

GRANT USAGE ON SCHEMA <destination database>.<destination schema> TO APPLICATION <application name>;

GRANT CREATE TABLE ON SCHEMA <destination database>.<destination schema> TO APPLICATION <application name>;

GRANT CREATE VIEW ON SCHEMA <destination database>.<destination schema> TO APPLICATION <application name>;
Copy

Aktivieren oder Deaktivieren der Erfassung einer Eigenschaft

Um das Synchronisieren von Daten für eine bestimmte Tabelle in Google Analytics zu aktivieren oder zu deaktivieren, rufen Sie die gespeicherte Prozedur ENABLE_PROPERTIES mit den folgenden Argumenten auf:

CALL ENABLE_PROPERTIES('<gcp_project>', ['<properties_to_configure>'], <enable_initial_load>);
Copy

Wobei:

gcp_project

Gibt das GCP-Projekt der aktivierten Eigenschaften an.

properties_to_configure

Gibt eine durch Komma getrennte Liste der Namen von Google Analytics-Eigenschaften in einfachen Anführungszeichen an.

Verwenden Sie den Eigenschaftsnamen ohne das Präfix analytics_.

enable_initial_load

Ein boolescher Wert, der angibt, ob das erstmalige Laden von Daten aktiviert oder deaktiviert werden soll, wobei alle historischen Daten einer Eigenschaft erfasst werden und dann mit der aktuellen Synchronisierung fortgefahren wird.

Dies ist ein optionales Argument. Der Standardwert dafür ist true.

Um beispielsweise die Synchronisierung der Eigenschaften mit den Namen property1, property2 und property3 im Projekt gcp_example_project zu aktivieren, führen Sie den folgenden Befehl aus:

CALL ENABLE_PROPERTIES('gcp_example_project', ['property1','property2','property3']);
Copy

Um das erstmalige Laden von Daten zu deaktivieren, verwenden Sie eine ENABLE_PROPERITES-Abfrage ähnlich wie diese:

CALL ENABLE_PROPERTIES('gcp_example_project', ['property1','property2','property3'], false);
Copy

Um zu verhindern, dass diese Eigenschaften erfasst werden, führen Sie den folgenden Befehl aus:

CALL DISABLE_PROPERTIES('gcp_example_project', ['property1','property2','property3']);
Copy

Durch das Deaktivieren der Eigenschaft wird die Synchronisierung gestoppt. Wenn die Eigenschaftssynchronisierung deaktiviert ist, wird die gesamte begonnene Datenerfassung aus der Zieldatenbank entfernt.

Die Prozedur ENABLE_PROPERTIES fügt die angegebenen Eigenschaftsnamen zur Ansicht ENABLED_PROPERTIES hinzu.

Erstmaliges Laden

Nach dem Aktivieren einer neuen Eigenschaft wechselt der Konnektor in den Modus für das erstmalige Laden. Dies bedeutet, dass erst alle in BigQuery gefundenen historischen Daten erfasst werden, bevor neue Ereignisse aufgenommen werden.

Umschalten des Google Analytics-Exports zu einem anderen Projekt

Solange der Konnektor Zugriff auf das Projekt hat, in dem die neuen Daten gespeichert werden, ist der Konnektor durchgehend aktiv und lädt die Daten herunter. Es sind keine weiteren Schritte erforderlich.