Dépanner le connecteur Google analytique Aggregated

info

Bêta

Cette fonctionnalité est en version Bêta. Pour l’utiliser, un administrateur de Workspace doit activer Lakeflow Connect for Google analytique Aggregated à partir de la page Previews . Consultez Gérer les aperçus Databricks.

Résoudre les erreurs d'autorisation (403), de requête (400), de jeton expiré (401), de quota (429) et les erreurs temporaires de serveur du connecteur agrégé Google Analytics géré dans Lakeflow Connect.

Pour obtenir des conseils généraux de dépannage applicables à tous les pipelines d’ingestion gérés, consultez Dépannage des pipelines d’ingestion gérés.

Autorisation refusée (403)

Message d’erreur :

Le pipeline échoue avec une réponse HTTP 403, et l'erreur est classée comme une erreur de configuration.

Cause : L’identité authentifiée ne peut pas accéder à la propriété Google analytique 4 (GA4) ou l’API Google analytique Data n’est pas activée dans le projet Google Cloud qui possède les informations d’identification.

Solution :

1. Confirmez que l'API Google analytique Data est activée dans le projet Google Cloud. Voir Activer l'API Google analytique Data.
2. Confirmez que l’identité possède au moins le rôle Lecteur sur chaque propriété dans property_ids ou property_id:
   • Pour un compte de service qui utilise sa propre identité, ajoutez l'adresse e-mail du compte de service à chaque propriété. Voir Accorder au compte de service l'accès à vos propriétés.
   • Pour un compte de service utilisant la délégation à l’échelle du domaine, confirmez que l’utilisateur défini dans E-mail de l’utilisateur à usurper a accès à chaque propriété et que le périmètre https://www.googleapis.com/auth/analytics.readonly est autorisé pour l’ID client du compte de service.
   • Pour OAuth utilisateur à machine (U2M), confirmez que l'utilisateur connecté a accès à chaque propriété.

Pour mettre à jour les informations d'identification, modifiez la connexion dans l'explorateur de catalogues. Voir Créer une connexion analytique à Google Analytics.

Demande non valide (400)

Message d’erreur :

Le pipeline échoue avec une réponse HTTP 400 et l'erreur est classée comme une erreur de configuration.

Cause : L’API Google analytique Data a refusé la demande de rapport. Les causes courantes incluent un ID de propriété qui n’est pas numérique, ou un rapport personnalisé dont les dimensions et metrics incluent un nom d’API inconnu ou une combinaison incompatible.

Solution :

• Confirmez que chaque ID de propriété est l’ID de propriété numérique GA4. Voir ID de propriété dans la documentation Google.
• Pour un objet custom_report, confirmez que chaque valeur dans dimensions et metrics est un nom d'API valide listé dans les Dimensions et métriques de l'API. Vérifiez la combinaison avec la méthode : properties.checkCompatibility.
• Confirmez que dimensions, metrics et property_ids sont des chaînes de tableau JSON, par exemple '["country"]'. Voir Exemples.

Jeton d’accès expiré (401)

Message d’erreur :

Le pipeline échoue avec une réponse HTTP 401.

Cause : Le jeton d’accès utilisé par la connexion a expiré ou a été révoqué.

Solution :

Le connecteur refresh automatiquement le jeton d'accès et réessaie lorsqu'il reçoit une réponse 401. Si l'erreur persiste :

• Pour les connexions OAuth U2M, réauthentifiez-vous en modifiant la connexion dans l’Explorateur de catalogues et en effectuant à nouveau le flux de connexion. Si l’application OAuth utilise le type d’utilisateur Externe avec le statut de publication Test , les jetons refresh Google expirent après 7 jours. Consultez Configurer l’écran de consentement OAuth.
• Pour les connexions de compte de service, vérifiez dans la console Google Cloud que la clé de compte de service associée à la connexion existe. Si la clé a été supprimée, créez-en une et mettez à jour la connexion.

Quota épuisé (429)

Message d’erreur :

Le pipeline rapporte les réponses HTTP 429 de l’API Google analytique Data.

Cause : Le pipeline a utilisé l’un des quotas de l’API de données de la propriété, tels que les jetons par heure ou les demandes simultanées.

Solution :

Le connecteur ralentit et réessaie automatiquement les demandes limitées par le débit. Si le pipeline continue d'échouer, réduisez le nombre de tables ou de propriétés dans un seul pipeline, définissez un start_date ultérieur ou programmez des exécutions de pipeline moins fréquentes. Pour connaître les limites de quota, consultez Limites et quotas dans la documentation Google.

Erreurs de serveur transitoires (500, 502, 503, 504)

Message d’erreur :

Le pipeline échoue avec une réponse HTTP 500, 502, 503 ou 504.

Cause : L’API Google analytique Data a renvoyé une erreur temporaire du serveur qui n’est pas liée à vos informations d’identification ou à votre configuration de pipeline.

Solution :

Le connecteur réessaye automatiquement en cas d’erreurs temporaires avec un intervalle exponentiel. Si le pipeline continue d’échouer après les nouvelles tentatives, réexécutez le pipeline ultérieurement.