Configuration de l’ingestion de données pour votre Snowflake Connector for Google Analytics Raw Data¶

Modification de l’ingestion de données à l’aide de Snowsight¶

Pour modifier les tables Google Analytics à ingérer ou le calendrier de synchronisation des tables, 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 Data Sync.

5. Sélectionnez Edit properties.

6. Modifiez les tables que vous souhaitez ingérer :

   1. Recherchez la table que vous souhaitez ingérer.

   2. Cochez la case dans la colonne Status à côté de la table que vous souhaitez sélectionner ou désélectionner.

7. Sélectionnez Update data sync.

Liste des propriétés disponibles pour l’ingestion¶

Pour dresser la liste de toutes les propriétés disponibles dans un projet GCP donné, appelez la procédure stockée suivante :

CALL LIST_GA_PROPERTIES();

Copy

Le résultat affiche l’ensemble des projets et propriétés disponibles à ingérer par un compte autorisé. Si aucun résultat n’est renvoyé, vérifiez les points suivants :

• Si l’exportation de données de Google Analytics vers BigQuery est configurée.

• Si les données exportées sont visibles dans BigQuery.

• Si les rôles appropriés sont attribués au compte de service/à l’utilisateur authentifié utilisé.

Notez qu’il peut s’écouler jusqu’à 24 heures entre la configuration de l’exportation de données et le stockage des données dans BigQuery. Ce délai peut être à l’origine de l’absence de résultats de la procédure LIST_GA_PROPERTIES.

La désactivation de l’exportation Google Analytics ne signifie pas que la propriété est omise par LIST_GA_PROPERTIES. Même si l’exportation a été désactivée, les données peuvent encore persister dans BigQuery et être synchronisées par le connecteur.

Préparation de la base de données de destination¶

Avant d’activer l’ingestion, vous devez autoriser le connecteur à accéder à la création de tables et de vues dans votre base de données et votre schéma de destination.

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

Activation ou désactivation de l’ingestion d’une propriété¶

Pour activer ou désactiver la synchronisation de données d’une propriété spécifique dans Google Analytics, appelez la procédure stockée ENABLE_PROPERTIES avec les arguments suivants :

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

Copy

Où :

gcp_project

Spécifie le projet GCP des propriétés activées.

properties_to_configure

Spécifie une liste de noms de propriétés Google Analytics séparés par des virgules et placés entre guillemets simples.

Utilisez le nom de propriété sans le préfixe analytics_.

enable_initial_load

Une valeur booléenne indiquant s’il faut activer ou désactiver le chargement initial des données, qui ingère toutes les données historiques d’une propriété, puis passe à la synchronisation actuelle.

Il s’agit d’un argument facultatif dont la valeur par défaut est true.

Lorsqu’une propriété a été précédemment activée, cet indicateur est ignoré et l’ingestion reprend au point où elle s’est arrêtée lorsque la propriété a été désactivée.

exclude_nulls

Valeur booléenne facultative indiquant s’il faut exclure les champs contenant des valeurs nulles des données ingérées. La définition de ce paramètre sur true peut améliorer le débit d’ingestion de données. La valeur par défaut est false.

disable_auto_reloads

Valeur booléenne facultative indiquant s’il faut désactiver les rechargements automatiques. 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.

Par exemple, pour activer la synchronisation des propriétés nommées property1, property2 et property3 dans le projet gcp_example_project, exécutez la commande suivante :

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

Copy

Pour activer des propriétés sans le chargement de données initial, utilisez une requête ENABLE_PROPERITES similaire à la suivante :

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

Copy

Vous pouvez utiliser des arguments nommés pour préciser des arguments spécifiques et laisser le reste inchangé. Par exemple, pour activer les propriétés avec le chargement initial et exclure les champs contenant des valeurs nulles, exécutez la requête suivante :

 CALL ENABLE_PROPERTIES(
    PROJECT_ID => 'gcp_example_project',
    PROPERTY_IDS => ['property1', 'property2', 'property3'],
    INITIAL_LOAD => TRUE,
    EXCLUDE_NULLS => TRUE
);

Copy

Pour éviter l’ingestion de ces propriétés, exécutez la commande suivante :

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

Copy

La désactivation de la propriété arrête sa synchronisation. Lorsque la synchronisation des propriétés est désactivée, l’ingestion toute entière commencée, mais pas terminée, est supprimée de la base de données de destination.

La procédure ENABLE_PROPERTIES ajoute les noms de propriété spécifiés à la vue ENABLED_PROPERTIES.