Gestion du Snowflake Connector for Google Analytics Raw Data

Snowflake Connector for Google Analytics Raw Data est soumis aux Conditions de connecteur.

Ce chapitre décrit les tâches types que vous devrez peut-être effectuer après l’installation et la configuration du connecteur.

Modification de l’intervalle d’ingestion du connecteur

Le connecteur vérifie et télécharge périodiquement les données de BigQuery. Par défaut, le contrôle est effectué toutes les 8 heures, mais vous pouvez le modifier. Si vous souhaitez définir le nouvel intervalle de vérification et de téléchargement des données, utilisez la procédure CONFIGURE_INGESTION_INTERVAL définie dans le schéma PUBLIC :

CALL CONFIGURE_INGESTION_INTERVAL(<interval_configuration_name>)
Copy

Configurations d’intervalles possibles ainsi que définitions cron utilisées en arrière-plan :

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
Copy

Note

Il n’est pas possible de définir une expression cron personnalisée.

Exemple d’utilisation :

CALL CONFIGURE_INGESTION_INTERVAL('EVERY_1_HOUR')
Copy

La liste des intervalles pris en charge peut également être imprimée à l’aide de la procédure LIST_SUPPORTED_INGESTION_INTERVALS définie dans le schéma PUBLIC :

CALL LIST_SUPPORTED_INGESTION_INTERVALS()
Copy

Configuration d’alertes

Pour configurer des alertes, procédez comme suit :

  1. Connectez-vous à Snowsight en tant qu’utilisateur ayant le rôle ACCOUNTADMIN.

  2. Dans le menu de navigation, sélectionnez Data Products » Apps.

  3. Recherchez le Snowflake Connector for Google Analytics Raw Data, puis sélectionnez la vignette du connecteur.

  4. Sur la page du Snowflake Connector for Google Analytics Raw Data, accédez à la section Settings et sélectionnez Email alerts dans le menu de gauche.

    Une page apparaît, permettant de configurer des alertes par e-mail.

  5. Dans le champ Email Address, indiquez une adresse e-mail vérifiée par Snowflake.

Note

Vous devez spécifier une adresse e-mail associée au compte Snowflake.

  1. Dans le champ Email Frequency, sélectionnez la fréquence à laquelle vous souhaitez recevoir des alertes :

  • Immediately - vous recevrez des notifications en fonction des valeurs définies dans la synchronisation des tables.

  • Once per day - vous recevrez des notifications une fois par jour à 12PM UTC.

Note

Les alertes ne sont envoyées que lorsqu’une action non valide (telle qu’une erreur) se produit.

  1. Sélectionnez Save changes pour commencer à recevoir des alertes par e-mail.

Désactivation des alertes

Pour ne plus recevoir d’alertes, sélectionnez Stop receiving alerts sur la page de configuration des alertes par e-mail.

Mise à niveau du connecteur

Les mises à niveau du connecteur sont gérées automatiquement par le fournisseur de l’application.

Augmentation de la taille du connecteur

Vous devriez commencer à utiliser le connecteur à la taille X-Small, car cela vous permettra probablement d’obtenir des performances suffisantes. Toutefois, si vous constatez des ralentissements au niveau du connecteur, vous pouvez essayer d’augmenter progressivement la taille de l’entrepôt et voir si vous constatez une amélioration des performances à chaque étape. La question de savoir si l’augmentation de la taille de l’entrepôt est bénéfique ou non pour le connecteur dépend de plusieurs facteurs tels que le nombre de propriétés ou la quantité de données de chacune.

Pour savoir comment redimensionner l’entrepôt, voir Redimensionnement d’un entrepôt dans Utilisation des entrepôts.

Changement d’entrepôt pour le connecteur

Il est possible de changer l’entrepôt utilisé par Snowflake Connector for Google Analytics Raw Data pour ses tâches internes sans réinstaller le connecteur. Tout d’abord, assurez-vous que le connecteur est en pause. Vous pouvez le faire soit via l’UI, soit en utilisant la procédure PAUSE_CONNECTOR. Vous devez ensuite accorder au connecteur l’accès au nouvel entrepôt :

GRANT USAGE ON WAREHOUSE <new_warehouse_name> TO APPLICATION snowflake_connector_for_google_analytics_raw_data;
Copy

Une fois l’accès accordé, exécutez la procédure UPDATE_WAREHOUSE définie dans le schéma PUBLIC :

CALL UPDATE_WAREHOUSE('<new_warehouse_name');
Copy

Réauthentification du connecteur

Pour modifier le secret, l’intégration d’accès externe ou l’intégration de sécurité utilisé(e) par le connecteur sans réinstallation, vous devez exécuter la procédure UPDATE_CONNECTION définie dans le schéma PUBLIC. Assurez-vous que tous les nouveaux objets sont définis comme décrit dans Configuration de Snowflake Connector for Google Analytics Raw Data à l’aide de SQL et que le connecteur dispose de toutes les autorisations nécessaires.

CALL UPDATE_CONNECTION('<new external access integration>', '<new secret>', '<new security integration>');
Copy

Désactivation automatique des propriétés Google Analytics inaccessibles

Le connecteur dispose d’un mécanisme permettant de désactiver automatiquement les propriétés Google Analytics inaccessibles afin d’éviter les coûts inutiles causés par les tentatives d’ingestion de données qui n’existent pas indéfiniment et de vous alerter sur le fait que les données ne sont plus ingérées. La propriété est considérée comme inaccessible et peut être automatiquement désactivée si les ingestions de données échouent depuis 7 jours.

Marche à suivre lors de la reprise après sinistre et du basculement

Pour vous assurer que le connecteur pourra continuer à ingérer des données lors d’une coupure du déploiement, vous devez configurer sink database failover sur un compte de réplique. Pour des informations détaillées, voir Basculement de bases de données sur plusieurs comptes.

De plus, après une coupure, vous devez installer manuellement le Snowflake Connector for Google Analytics Raw Data sur votre compte de réplique, car le connecteur lui-même ne peut pas être répliqué. Après l’installation, il se synchronisera de lui-même avec la base de données réceptrice répliquée.

Note

Afin d’éviter la corruption des données, vous ne pouvez pas avoir deux instances de connecteur, l’une sur un compte principal et l’autre sur un compte de réplique, ingérant simultanément des données dans la base de données réceptrice.

En cas de coupure de déploiement et lorsque votre base de données réceptrice bascule sur un compte de réplique, procédez comme suit :

  1. Connectez-vous à votre compte secondaire sur lequel la base de données réceptrice est répliquée.

  2. Installez le Snowflake Connector for Google Analytics Raw Data sur votre compte secondaire. Le connecteur se synchronise de lui-même avec la base de données réceptrice répliquée. L’instance sur votre compte principal passe en lecture seule après une coupure, de sorte à empêcher la corruption des données à ce stade.

  3. Si vous souhaitez revenir au compte principal une fois que le déploiement est de nouveau disponible, vous devez commencer par supprimer les deux connecteurs. Il est nécessaire d’assurer un état de connecteur cohérent.

  4. Répliquez de nouveau les données du compte secondaire sur le compte principal à l’aide du mécanisme de réplication.

  5. Réinstallez le connecteur sur un compte principal une fois que les données de la table réceptrice sont synchronisées avec la table réceptrice de votre compte secondaire.

Mise à jour des options d’ingestion de données

Vous pouvez utiliser la procédure UPDATE_INGESTION_OPTIONS définie dans le schéma PUBLIC pour modifier les options d’ingestion par défaut de certaines propriétés. Cette procédure vous permet de modifier les éléments suivants :

  • EXCLUDE_NULLS- Retire les champs contenant des valeurs nulles des données ingérées. La définition de cette valeur sur TRUE peut améliorer le débit d’ingestion de données. La valeur par défaut est FALSE.

  • DISABLE_AUTO_RELOADS- Désactive le rechargement automatique des données. Pour plus de détails sur le rechargement automatique, voir Modèle d’ingestion de données du Snowflake Connector for Google Analytics Raw Data. La définition de cette valeur sur TRUE peut réduire la consommation de crédit, mais les données tardives ne seront pas ingérées dans Snowflake. La valeur par défaut est FALSE.

CALL UPDATE_INGESTION_OPTIONS(
    PROPERTY_IDS => ['<property_1>', '<property_2>'],
    EXCLUDE_NULLS => <boolean>,
 );
Copy

Note

Pour laisser une option d’ingestion inchangée, omettez l’argument de l’appel de la procédure UPDATE_INGESTION_OPTIONS.

Actualisation des vues aplaties à la demande

Vous pouvez utiliser la procédure REFRESH_VIEWS définie dans le schéma PUBLIC pour déclencher une actualisation à la demande des vues aplaties. Par défaut, les vues aplaties sont automatiquement actualisées une fois par jour. Pour plus d’informations sur les vues, voir Accès aux données ingérées par le Snowflake Connector for Google Analytics Raw Data.

CALL REFRESH_VIEWS();
Copy