BêtaAccédez à vos données HubSpot à partir de Microsoft Azure Synapse Analytics

Utilisez Data Out for Azure Synapse pour exporter certaines données du CRM HubSpot vers des tables dans un pool SQL dédié Azure Synapse que vous possédez. HubSpot actualise chaque tableau de résultats à partir d’une exportation complète des données sélectionnées. Après la synchronisation, vous pouvez interroger les tableaux avec SQL ou avec vos outils d’intelligence commerciale et d’analytics préférés pour combiner les données HubSpot avec d’autres données commerciales.

Remarque : Si vous êtes un super administrateur, inscrivez votre compte à la version bêta de Data Studio pour utiliser cette fonctionnalité.

Compréhension des limites et des considérations

Avant de commencer à utiliser cette fonctionnalité, assurez-vous de bien comprendre les étapes à suivre à l'avance, ainsi que les limites de la fonctionnalité et les conséquences potentielles de son utilisation.

• HubSpot met à jour les tableaux séparément. Si vous interrogez plusieurs tableaux pendant qu’une synchronisation est en cours, certains tableaux peuvent être mis à jour avant d’autres.
• La sortie des données ne permet pas de conserver les instantanés historiques. Après une actualisation réussie, le tableau de destination contient le dernier instantané.
• Chaque objet, type d’événement ou paire d’association peut être inclus dans une synchronisation récurrente Azure Synapse par compte HubSpot. Cette limite est indépendante des autres fournisseurs de sortie de données.
• Les tableaux spécifiques à un objet, tels que OBJECTS_CONTACTS, ne sont pas encore pris en charge.
• Si deux noms de tableau entrent en collision après que HubSpot les ait normalisés, l’export affecté échoue. Pour plus d’informations, consultez les règles de nom des tableaux et des colonnes.

Comprendre les données que vous pouvez exporter

Vous pouvez synchroniser les données suivantes de HubSpot vers Azure Synapse Analytics :

• Objets et fiches d’informations : certains objets standards et personnalisés ainsi que leurs fiches d’informations, tels que des contacts, des entreprises, des transactions, des tickets et des produits.
• Propriétés : valeurs de propriété sélectionnées et historique des propriétés dans les fiches d’informations.
• Associations : relations sélectionnées entre les fiches d’informations, y compris les définitions d’association.
• Événements : événements standards HubSpot sélectionnés et événements comportementaux personnalisés, y compris les propriétés d’événement sélectionnées.

Les données de différents objets sont combinées dans les tableaux d’objets. Lorsque vous lisez un tableau d’objets, utilisez OBJECTTYPEID pour filtrer un objet spécifique. Par exemple, les contacts utilisent 0-1. Un ID est attribué aux objets personnalisés lors de leur création et sont identifiés comme , 2-{unique_id}comme . 2-12345

Comprendre le format d’exportation

Lors de la configuration, vous choisissez :

• Le point de terminaison et la base de données SQL dédiés Azure Synapse de destination.
• Les sources de données à synchroniser : objets, événements, associations ou une combinaison de ces sources.
• Le planning de synchronisation.

HubSpot crée un export Parquet temporaire dans un stockage géré par HubSpot et écrit les résultats dans des tables de votre pool SQL dédié Azure Synapse. Vous n’avez pas besoin de fournir ou de gérer un compartiment intermédiaire.

Trouver vos données dans Azure Synapse

HubSpot crée des tables de résultats dans un schéma géré par HubSpot pour votre destination. HubSpot exporte les données d’objets vers les trois tableaux d’objets décrits dans cet article. HubSpot crée également un tableau par type d’événement sélectionné et, le cas échéant, un tableau spécifique à une paire par paire d’associations sélectionnée.

<database>.hubspot_data_out_<destination-id>.<table-name>

Vous trouverez le nom exact du schéma sur la page de configuration de votre synchronisation. Par exemple :

• your_database.hubspot_data_out_456.OBJECT_WITH_OBJECT_PROPERTIES
• your_database.hubspot_data_out_456.EVENTS_VISITED_PAGE
• your_database.hubspot_data_out_456.ASSOCIATIONS_CONTACTS_TO_COMPANIES

Noms des tableaux et des colonnes

HubSpot normalise les noms des tableaux et des colonnes exportés en lettres majuscules, nombres et traits de soulignement :

• Les espaces et les traits d’union deviennent des traits de soulignement.
• Les autres caractères non alphanumériques sont supprimés.
• Les noms de plus de 128 caractères sont raccourcis.
• Les noms de colonnes qui entrent en collision reçoivent un suffixe.
• Les noms de tableaux qui entrent en collision échouent à l’exportation affectée.

Utilisez des crochets lorsque vous interrogez des identifiants, en particulier si vous construisez des requêtes dynamiques. La sensibilité à la casse de l’identificateur dépend de votre classement de base de données Synapse. Par exemple :

SELECT *
FROM [your_database].[hubspot_data_out_456].[OBJECT_WITH_OBJECT_PROPERTIES]
WHERE [OBJECTTYPEID] = '0-1';

Types de colonnes

Les types de colonnes suivent les données exportées et correspondent aux types Azure Synapse comme suit :

Remarque : La PROPERTIES colonne dans OBJECT_WITH_OBJECT_PROPERTIES est exportée sous forme de chaîne au format JSON. Elle est stockée en tant que , et non en tant que NVARCHAR(MAX)type de colonne JSON. Pour obtenir des exemples de requêtes, consultez la FAQ.

Examiner les tableaux d’objets

Si vous sélectionnez Données d’objet, HubSpot exporte les tableaux suivants.

OBJECT_PROPERTIES

Ce tableau contient une ligne par valeur de propriété. Pour lire un objet spécifique, filtrez par OBJECTTYPEID.

OBJECT_WITH_OBJECT_PROPERTIES

Ce tableau contient une ligne par fiche d’informations, les valeurs des propriétés sélectionnées étant regroupées dans une seule PROPERTIES colonne. Pour lire un objet spécifique, filtrez par OBJECTTYPEID.

OBJECT_PROPERTIES_HISTORY

Ce tableau contient l’historique des modifications de propriétés. Contrairement à OBJECT_PROPERTIES, qui ne contient que la valeur actuelle, ce tableau comporte une ligne pour chaque valeur historique d’une propriété. Pour afficher la chronologie complète d’une fiche d’informations et d’une propriété, commandez par UPDATEDAT.

Examiner les tableaux d’associations

Si vous sélectionnez Données d’association, HubSpot exporte les fiches d’informations et les définitions d’association.

ASSOCIATIONS

Ce tableau contient une ligne par association sélectionnée entre deux fiches d’informations.

ASSOCIATION_DEFINITIONS

Ce tableau contient une ligne par définition d’association sélectionnée.

ASSOCIATIONS_<FROM_OBJECT>_TO_<TO_OBJECT>

Pour les paires d’associations sélectionnées, HubSpot peut également exporter des tableaux d’association spécifiques aux paires, tels que ASSOCIATIONS_CONTACTS_TO_COMPANIES. Ces tableaux comprennent les fiches d’informations d’association ainsi que les métadonnées de définition d’association.

Examiner les tableaux d’événements

Si vous sélectionnez Données d’événement, HubSpot exporte un tableau par type d’événement. Les noms des tableaux utilisent le format EVENTS_<EVENT_NAME>, tel que EVENTS_VISITED_PAGE.

Chaque tableau d’événement contient des colonnes d’événement standard et une colonne pour chaque propriété d’événement sélectionnée.

Gérer le planning de synchronisation

Vous configurez le calendrier de synchronisation lors de la configuration dans HubSpot. Vous pouvez également déclencher manuellement une resynchronisation à partir de HubSpot. Chaque cycle de synchronisation génère un instantané complet des données sélectionnées. Pour contrôler le volume de données, choisissez les objets, les événements, les associations et les propriétés à inclure.

Remarque : pendant la version bêta, les fréquences de synchronisation disponibles peuvent être limitées. Des options de fréquence supplémentaires pourront être ajoutées dans les prochaines versions.

Surveiller les synchronisations et gérer les erreurs

Vous pouvez surveiller les synchronisations Azure Synapse dans HubSpot. Une synchronisation peut avoir l’un des états suivants :

Lorsqu’une synchronisation échoue :

• HubSpot affiche un statut Échec avec des détails sur les tables qui ont réussi ou échoué.
• Si un tableau ne peut pas être mis à jour, les données précédentes réussies restent généralement disponibles.
• Pour les synchronisations récurrentes, la prochaine synchronisation planifiée retente automatiquement une synchronisation complète.
• Vous pouvez déclencher manuellement une resynchronisation à tout moment dans HubSpot.

FAQ

Comment interroger les données ?

Interrogez les tables dans votre schéma de destination avec SQL. Par exemple, lisez toutes les fiches d’informations de contact :

SELECT *
FROM [your_database].[hubspot_data_out_456].[OBJECT_WITH_OBJECT_PROPERTIES]
WHERE [OBJECTTYPEID] = '0-1';

Lisez une propriété spécifique à partir de la PROPERTIES chaîne JSON :

SELECT
  [OBJECTID],
  JSON_VALUE([PROPERTIES], '$.email') AS [email]
FROM [your_database].[hubspot_data_out_456].[OBJECT_WITH_OBJECT_PROPERTIES]
WHERE [OBJECTTYPEID] = '0-1';

Puis-je exporter un type de données dans plusieurs synchronisations ?

Chaque objet, type d’événement ou paire d’association peut être inclus dans une synchronisation récurrente Azure Synapse par compte HubSpot. Cette limite est indépendante des autres fournisseurs de sortie de données.

Par exemple, si des contacts sont déjà exportés vers une destination Azure Synapse récurrente, vous ne pouvez pas ajouter de contacts à une autre synchronisation récurrente Azure Synapse tant que vous n’avez pas archivé la première synchronisation. Vous pouvez toujours exporter des contacts vers un autre fournisseur de sortie de données pris en charge en même temps.

Les tableaux spécifiques à un objet sont-ils pris en charge ?

Non. Les tableaux spécifiques à un objet, tels que OBJECTS_CONTACTS, ne sont pas encore pris en charge. Utilisez OBJECT_WITH_OBJECT_PROPERTIES et filtrez par OBJECTTYPEID pour obtenir des fiches d’informations pour un objet spécifique.

HubSpot conserve-t-il les instantanés précédents ?

Non. La sortie des données ne permet pas de conserver les instantanés historiques. Après une actualisation réussie, le tableau de destination contient le dernier instantané. Si un tableau ne peut pas être mis à jour, les données précédentes réussies restent généralement disponibles.