Verwalten des Snowflake Connector for Google Analytics Raw Data¶
Der Snowflake Connector für Google Analytics Raw Data unterliegt den Nutzungsbedingungen für Konnektoren.
Unter diesem Thema werden typische Aufgaben beschrieben, die Sie nach Installation und Konfiguration des Konnektors durchführen müssen:
Ändern des Erfassungsintervalls für den Konnektor¶
Der Konnektor prüft BigQuery regelmäßig auf Daten und lädt diese dann herunter. Die Prüfung erfolgt standardmäßig alle 8 Stunden, dies kann aber geändert werden. Wenn Sie ein neues Intervall für das Prüfen auf und Herunterladen von Daten festlegen möchten, verwenden Sie die im PUBLIC
-Schema definierte Prozedur CONFIGURE_INGESTION_INTERVAL
:
CALL CONFIGURE_INGESTION_INTERVAL(<interval_configuration_name>)
Mögliche Intervallkonfigurationen zusammen mit Cron-Definitionen, die im Hintergrund verwendet werden:
EVERY_15_MINUTES - */15 * * * * UTC
EVERY_30_MINUTES - */30 * * * * UTC
EVERY_1_HOUR - 0 * * * * UTC
EVERY_4_HOURS - 0 3/4 * * * UTC
EVERY_8_HOURS - 0 3/8 * * * UTC
EVERY_1_DAY - 0 3 * * * UTC
Bemerkung
Es ist nicht möglich, einen eigenen Cron-Ausdruck einzustellen.
Nutzungsbeispiel
CALL CONFIGURE_INGESTION_INTERVAL('EVERY_1_HOUR')
Die Liste der unterstützten Intervalle kann auch mit der im Schema PUBLIC
definierten Prozedur LIST_SUPPORTED_INGESTION_INTERVALS
ausgedruckt werden:
CALL LIST_SUPPORTED_INGESTION_INTERVALS()
Einrichten von Alerts¶
Gehen Sie wie folgt vor, um Alerts einzurichten:
Melden Sie sich bei Snowsight als Benutzer mit der Rolle ACCOUNTADMIN an.
Wählen Sie im Navigationsmenü die Option Data Products » Apps aus.
Suchen Sie nach dem Snowflake Connector for Google Analytics Raw Data, und wählen Sie dann die Kachel für den Konnektor aus.
Gehen Sie auf der Seite für den Snowflake Connector for Google Analytics Raw Data zum Bereich Settings, und wählen Sie dann im Menü auf der linken Seite die Option Email alerts aus.
Eine Seite zum Konfigurieren der E-Mail-Alerts wird angezeigt.
Geben Sie im Feld Email Address eine verifizierte Snowflake-E-Mail-Adresse ein.
Bemerkung
Sie müssen eine E-Mail-Adresse angeben, die mit dem Snowflake-Konto verknüpft ist.
Wählen Sie im Feld Email Frequency, wie häufig Sie Alerts erhalten möchten:
Immediately – Sie erhalten Benachrichtigungen entsprechend den für die Tabellensynchronisierung eingestellten Werten.
Once per day – Sie erhalten einmal pro Tag um 12:00 UTC eine Benachrichtigung.
Bemerkung
Alerts werden nur gesendet, wenn eine ungültige Aktion (z. B. ein Fehler) auftritt.
Wählen Sie Save changes aus, um E-Mail-Alerts zu erhalten.
Deaktivieren von Alerts¶
Wenn Sie keine Alerts mehr erhalten möchten, wählen Sie auf der Konfigurationsseite für E-Mail-Alerts die Option Stop receiving alerts aus.
Aktualisieren des Konnektors¶
Upgrades des Konnektors werden automatisch vom Anbieter der Anwendung verwaltet.
Skalieren des Konnektors¶
Wenn Sie mit der Verwendung des Konnektors beginnen, sollten Sie zuerst X-Small
verwenden, da Sie damit höchstwahrscheinlich eine ausreichende Performance erzielen werden. Wenn Sie jedoch eine Verlangsamung des Konnektors feststellen, sollten Sie versuchen, die Warehouse-Größe schrittweise zu erhöhen und zu prüfen, ob Sie bei jedem Schritt eine Leistungsverbesserung feststellen. Ob der Konnektor von der Skalierung des Warehouse profitiert, hängt von einigen Faktoren ab, z. B. von der Anzahl der Eigenschaften oder der Menge der Daten, die jede einzelne Eigenschaft enthält.
Weitere Informationen zum Ändern der Größe eines Warehouses finden Sie unter Verwenden von Warehouses.
Ändern des Warehouses für den Konnektor¶
Es ist möglich, das Warehouse, das der Snowflake Connector for Google Analytics Raw Data für seine internen Aufgaben verwendet, zu ändern, ohne den Konnektor neu installieren zu müssen. Stellen Sie zuerst sicher, dass der Konnektor angehalten ist. Sie können dies entweder über die UI oder mit der Prozedur PAUSE_CONNECTOR
tun. Dann müssen Sie dem Konnektor Zugriff auf das neue Warehouse gewähren:
GRANT USAGE ON WAREHOUSE <new_warehouse_name> TO APPLICATION snowflake_connector_for_google_analytics_raw_data;
Nachdem der Zugriff gewährt wurde, führen Sie die Prozedur UPDATE_WAREHOUSE
aus, die im Schema PUBLIC
definiert ist:
CALL UPDATE_WAREHOUSE('<new_warehouse_name');
Erneute Authentifizierung des Konnektors¶
Um das Geheimnis, die Integration für den externen Zugriff oder die vom Konnektor verwendete Sicherheitsintegration ohne Neuinstallation zu ändern, müssen Sie die im Schema PUBLIC
definierte Prozedur UPDATE_CONNECTION
ausführen. Stellen Sie sicher, dass alle neuen Objekte wie unter Konfigurieren des Snowflake Connector for Google Analytics Raw Data mit SQL beschrieben definiert sind und dass der Konnektor über alle erforderlichen Berechtigungen verfügt.
CALL UPDATE_CONNECTION('<new external access integration>', '<new secret>', '<new security integration>');
Automatisches Deaktivieren bei fehlendem Zugriff auf Google Analytics-Eigenschaften¶
Der Konnektor verfügt über einen Mechanismus zum automatischen Deaktivieren von Google Analytics-Eigenschaften, auf die kein Zugriff möglich ist. Dies spart unnötige Kosten, die dadurch entstehen, dass versucht wird, Daten zu erfassen, die nicht unbegrenzt vorhanden sind, und Sie darüber zu informieren, dass keine Daten mehr erfasst werden. Die Eigenschaft gilt als unzugänglich und kann automatisch deaktiviert werden, wenn die Datenerfassung in den letzten 7 Tagen fehlgeschlagen ist.
Vorgehen bei Disaster Recovery und Failover¶
Wenn Sie sicherstellen möchten, dass der Konnektor die Datenerfassung während eines Ausfalls der Bereitstellung fortsetzen kann, müssen Sie das sink database failover zu einem Replikatkonto einrichten. Weitere Informationen dazu finden Sie unter Failover von Datenbanken über mehrere Konten.
Außerdem müssen Sie nach einem Ausfall den Snowflake Connector for Google Analytics Raw Data manuell in Ihrem Replikatkonto installieren, da der Konnektor selbst nicht repliziert werden kann. Nach der Installation wird sich der Konnektor selbst mit der replizierten Senkendatenbank synchronisieren.
Bemerkung
Um Datenverfälschungen zu vermeiden, können Sie keine zwei Konnektor-Instanzen im Primärkonto und im Replikatkonto haben, die gleichzeitig Daten in der Senkendatenbank erfassen.
Wenn es zu einem Ausfall der Bereitstellung kommt und Ihre Senkendatenbank ein Fail-over in ein Replikatkonto ausführt, führen Sie die folgenden Schritte aus:
Melden Sie sich bei Ihrem Sekundärkonto an, in das die Senkendatenbank repliziert wird.
Installieren Sie den Snowflake Connector for Google Analytics Raw Data in Ihrem Sekundärkonto. Der Konnektor wird sich selbst mit der replizierten Senkendatenbank synchronisieren. Die Instanz in Ihrem Primärkonto geht nach einem Ausfall in einen schreibgeschützten Zustand über, sodass die Daten zu diesem Zeitpunkt nicht beschädigt werden.
Wenn Sie zum Primärkonto zurückkehren möchten, nachdem die Bereitstellung wieder verfügbar ist, müssen Sie zunächst beide Konnektoren entfernen. Dies ist notwendig, um einen konsistenten Zustand des Konnektors sicherzustellen.
Replizieren Sie die Daten mithilfe des Replikationsmechanismus vom Sekundärkonto in das Primärkonto.
Installieren Sie den Konnektor erneut in einem Primärkonto, sobald die Daten in der Senkentabelle mit der Senktabelle in Ihrem Sekundärkonto synchronisiert sind.
Aktualisieren der Optionen für die Datenaufnahme¶
Sie können die im Schema PUBLIC
definierte Prozedur UPDATE_INGESTION_OPTIONS
verwenden, um die Standard-Datenaufnahmeoptionen für bestimmte Eigenschaften zu ändern. Mit dieser Prozedur können Sie Folgendes ändern:
EXCLUDE_NULLS
– Entfernen von Feldern mit Nullwerten aus den aufgenommenen Daten. Die Einstellung dieses Wertes aufTRUE
kann den Datenaufnahme-Durchsatz verbessern. Der Standardwert istFALSE
.
DISABLE_AUTO_RELOADS
– Deaktiviert das automatische Nachladen von Daten. Weitere Einzelheiten zum automatischen Nachladen finden Sie unter Datenaufnahmemodell des Snowflake Connector for Google Analytics Raw Data. Wenn Sie diesen Wert aufTRUE
einstellen, können Sie den Credit-Verbrauch reduzieren, aber verspätete Daten werden nicht in Snowflake aufgenommen. Der Standardwert istFALSE
.
CALL UPDATE_INGESTION_OPTIONS(
PROPERTY_IDS => ['<property_1>', '<property_2>'],
EXCLUDE_NULLS => <boolean>,
);
Bemerkung
Um eine Datenaufnahmeoption unverändert zu lassen, lassen Sie das Argument im Aufruf der Prozedur UPDATE_INGESTION_OPTIONS
weg.
Vereinfachte Ansichten auf Anfrage aktualisieren¶
Sie können die Prozedur REFRESH_VIEWS
verwenden, die im Schema PUBLIC
definiert ist, um eine bedarfsgesteuerte Aktualisierung der vereinfachten Ansichten auszulösen. Die vereinfachten Ansichten werden standardmäßig täglich automatisch aktualisiert. Weitere Einzelheiten zu den Ansichten finden Sie unter Zugriff auf Daten, die vom Snowflake Connector for Google Analytics Raw Data aufgenommen wurden.
CALL REFRESH_VIEWS();