Résolution des problèmes du Snowflake Connector for Google Analytics Raw Data

Ce chapitre fournit des lignes directrices pour la résolution des problèmes liés au Snowflake Connector for Google Analytics Raw Data.

Vérification d’une connexion à l’instance Google Cloud Platform (GCP)

Pour vérifier que le Snowflake Connector for Google Analytics Raw Data peut accéder à l’instance Google Cloud Platform (GCP), appelez la procédure stockée CONNECTION_STATUS, qui est définie dans le schéma PUBLIC de la base de données d’installation du connecteur :

CALL CONNECTION_STATUS();
Copy

Pour vérifier le statut de la connexion dans Snowsight, 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. Sélectionnez Snowflake Connector for Google Analytics Raw Data.

La couleur de l’icône à la section Authentifier Google Cloud Platform indique si la connexion à GCP est établie. Si l’icône est rouge, la tentative de connexion à GCP a échoué. Pour lancer une nouvelle tentative de connexion, sélectionnez Reauthenticate.

Si l’icône est verte, le connecteur est prêt à ingérer des données.

Vérification du statut du connecteur

Pour examiner le statut du connecteur, utilisez la procédure stockée GET_CONNECTOR_STATUS, comme indiqué :

CALL PUBLIC.GET_CONNECTOR_STATUS()
Copy

Vérification du statut de l’ingestion actuelle

S’il vous manque des données pour un jour spécifique, vous pouvez interroger la vue CONNECTOR_STATS pour voir s’il y a eu des erreurs lors de tentative d’ingestion de la table ce jour-là depuis BigQuery :

SELECT * FROM CONNECTOR_STATS WHERE PROPERTY_ID = '<property_name>' AND BIG_QUERY_TABLE = 'events_<date>' ORDER BY RUN_START_TIME DESC;
Copy

Le résultat affichera toutes les tentatives de téléchargement d’une table spécifique de l’ensemble de données de BigQuery pour une propriété donnée, la plus récente apparaissant en tête de liste. La colonne STATUS indique le résultat et, en cas d’échec de la tentative, la colonne ERROR_MESSAGES détaille ce qui s’est passé.

Téléchargement des journaux du connecteur

Si vous rencontrez des problèmes avec le connecteur, vous pouvez appeler la procédure stockée GET_TROUBLESHOOTING_DATA, qui est définie dans le schéma PUBLIC de la base de données d’installation du connecteur :

CALL GET_TROUBLESHOOTING_DATA(7);
Copy

Ce paramètre définit le nombre de jours écoulés depuis aujourd’hui qui devraient être inclus dans les journaux. Utilisez la valeur 7 par défaut, sauf si l’équipe d’assistance vous demande d’utiliser une autre valeur.

Ainsi, vous obtenez les journaux complets du connecteur. Vous pouvez télécharger les journaux, les filtrer et les partager avec le fournisseur d’applications.

Partage des journaux du connecteur d’une table d’événements avec un fournisseur d’applications

Il est possible de partager les journaux du connecteur stockés dans la table d’événements avec le fournisseur d’applications. Le fournisseur peut s’en servir pour enquêter sur les problèmes rencontrés avec le connecteur. Cliquez sur ce lien pour en savoir plus sur la journalisation activée par le consommateur.

Note

Cette fonctionnalité n’est pas opérationnelle si les tables d’événements ne sont pas activées sur le compte.

Pour permettre le partage des événements de l’application à partir de la table d’événements, exécutez :

ALTER APPLICATION <GARD APPLICATION NAME> SET SHARE_EVENTS_WITH_PROVIDER = TRUE;
Copy

Pour arrêter le partage, exécutez :

ALTER APPLICATION <GARD APPLICATION NAME> SET SHARE_EVENTS_WITH_PROVIDER = FALSE;
Copy

Le statut actuel peut être vérifié si vous exécutez :

DESC APPLICATION <GARD APPLICATION NAME>;
Copy

Comparaison du nombre de lignes dans Google Cloud Platform (GCP) et dans Snowflake

Pour vérifier si l’ingestion s’est effectuée correctement, vous pouvez comparer le nombre de lignes dans Snowflake et dans Google Cloud Platform (GCP).

Pour vérifier le nombre de lignes dans Snowflake, exécutez la requête suivante :

SELECT COUNT(*) FROM analytics_<property_name> WHERE source_table_date = '<date>';
Copy

Pour vérifier le nombre de lignes dans GCP, exécutez la requête suivante :

SELECT COUNT(*) FROM '<project_id>.analytics_<property_name>.events_<date>';
Copy