Dépanner le connecteur HubSpot

Apprenez à résoudre les problèmes courants avec le connecteur HubSpot géré dans Lakeflow Connect.

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

Erreur SCOPE lors de la création de la connexion ou de l'exécution du pipeline

Message d'erreur :

SCOPE Error

Cause :

Cette erreur se produit lorsque l'application HubSpot ne dispose pas des étendues OAuth requises.

Solutions:

Confirmez que l'application connectée dans HubSpot dispose des champs d'application OAuth requis :

1. Exécutez hs project open pour ouvrir votre application dans HubSpot.
2. Sous Project Components , sélectionnez votre application, puis cliquez sur l'onglet tab .
3. Confirmez que toutes les étendues requises sont sélectionnées. Pour la liste complète des étendues requises, consultez Configurer OAuth pour l’ingestion HubSpot.
4. Si vous modifiez des étendues, redéployez l'application avec hs project upload, puis créez une nouvelle connexion Unity Catalog dans Databricks.

Pour les détails de configuration de l'application, consultez Configurer OAuth pour l'ingestion de HubSpot.

Pour plus de détails sur la création de connexion, veuillez consulter Créer une connexion HubSpot.

Le pipeline s'exécute lentement

Symptôme :

Le pipeline prend beaucoup de temps à se terminer ou semble être bloqué.

Cause :

HubSpot applique des limites de débit d'API (par exemple, 100 requêtes toutes les 10 secondes pour les applications gratuites). Lorsque vous ingérez plusieurs tables simultanément, vous pourriez atteindre ces limites de débit, ce qui ralentit le processus d'ingestion. Le connecteur réessaie automatiquement les requêtes qui atteignent une limite de débit.

De plus, certaines tables peuvent prendre beaucoup de temps à ingérer en raison d'exigences élevées en matière d'appels d'API. Par exemple, la table marketing_campaign_asset nécessite 24 appels d'API distincts par campagne. Si vous avez 100 campagnes, vous avez besoin d'environ 2 400 appels d'API pour cette seule table, comparativement à environ 5 appels d'API pour des tables plus simples. Prévoyez des temps de synchronisation longs pour ces tables. Par exemple, une table avec 5 000 campagnes peut prendre environ quatre à six heures.

Pour la liste complète des tables applicables, consultez Tables qui ne prennent en charge que les mises à jour par batch.

Solutions:

Pour garantir des performances d'ingestion cohérentes :

• Limitez le nombre de tables que vous ingérez simultanément.
• Diviser les tables entre plusieurs pipelines et les planifier à des moments différents.
• Surveillez la progression de votre pipeline et ajustez votre stratégie de planification en fonction des temps de synchronisation réels.