Aller au contenu principal

Limitations du connecteur HubSpot

Découvrez les limitations connues lors de l'utilisation du connecteur HubSpot géré dans Lakeflow Connect.

Limitations générales

  • Lorsque vous exécutez un pipeline planifié, les alertes ne se Trigger pas immédiatement. Au lieu de cela, ils Trigger lors de l’exécution de la prochaine mise à jour.
  • Lorsqu’une table source est supprimée, la table de destination n’est pas automatiquement supprimée. Vous devez supprimer la table de destination manuellement. Ce comportement n'est pas cohérent avec le comportement de Spark Declarative Pipelines sur Lakeflow.
  • Pendant les périodes de maintenance de la source, Databricks pourrait ne pas être en mesure d'accéder à vos données.
  • Si un nom de table source entre en conflit avec un nom de table de destination existant, la mise à jour du pipeline échoue.
  • La prise en charge des pipelines multi-destination est uniquement via l'API.
  • Vous pouvez éventuellement renommer une table que vous ingérez. Si vous renommez une table dans votre pipeline, il devient un pipeline API uniquement, et vous ne pouvez plus modifier le pipeline dans l'interface utilisateur.
  • Si vous sélectionnez une colonne après qu'un pipeline a déjà start, le connecteur ne renseigne pas automatiquement les données historiques pour la nouvelle colonne. Pour ingérer des données historiques, exécutez manuellement un refresh complet sur la table.
  • Databricks ne peut pas ingérer deux tables ou plus portant le même nom dans le même pipeline, même si elles proviennent de schémas sources différents.
  • Le système source suppose que les colonnes du curseur augmentent de façon monotone.
  • Le connecteur ingère des données brutes sans transformations. Utilisez les Spark Declarative Pipelines en aval sur les Lakeflow Pipelines pour les transformations.

Hubs pris en charge

Le connecteur HubSpot ne prend en charge que l'ingestion depuis HubSpot Marketing Hub. Si vous êtes intéressé(e) par l'ingestion depuis d'autres hubs, veuillez contacter l'équipe de votre compte Databricks.

Limites de débit de l'API

HubSpot applique des limites de débit d'API (par exemple, 100 requêtes toutes les 10 secondes pour les applications gratuites). Lorsque le connecteur atteint une limite de débit, les requêtes sont automatiquement retentées. Pour des recommandations de performance, consultez Le pipeline s'exécute lentement.

Temps de synchronisation longs pour les tables complexes

Certaines tables peuvent prendre beaucoup de temps à ingérer en raison des 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 prennent en charge uniquement les mises à jour par batch. Pour des recommandations de performance, consultez Pipeline s'exécute lentement.

Champs imbriqués représentés sous forme de chaînes

Certains champs du schéma HubSpot sont imbriqués dans des structures complexes, et les champs de niveau interne peuvent inclure des attributs personnalisés. Pour garantir la compatibilité et la cohérence, ces champs sont représentés sous forme de chaînes de caractères.

Par exemple, la table forms a un champ avec displayOptions. Chaque formulaire a des configurations d'affichage variables, ce champ est donc stocké sous forme de chaîne de caractères pour s'adapter aux différentes structures.

Prise en charge incrémentielle limitée

Certaines tables ne prennent pas en charge les mises à jour incrémentielles car l'API HubSpot ne fournit pas un moyen de filtrer les enregistrements en fonction d'un curseur. Ces tables sont actualisées à chaque mise à jour du pipeline.

Pour une liste des tables prises en charge et de leurs modèles de mise à jour, consultez la référence du connecteur HubSpot.