BêtaExporter des données HubSpot vers Microsoft Fabric

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

Utilisez les données sortantes pour exporter certaines données du CRM HubSpot vers des tableaux natifs dans un entrepôt Microsoft Fabric que vous possédez. Vous pouvez synchroniser des données d’objets, d’associations et d’événements avec des tableaux de votre entrepôt, puis interroger ces données avec SQL ou les utiliser avec vos outils d’intelligence commerciale et d’analytics.

Chaque synchronisation crée un instantané complet des données sélectionnées. Lorsqu’une synchronisation réussit, elle remplace l’instantané précédent dans les tables de destination.

Avant de commencer

Compréhension des exigences

Pour exporter des données vers Microsoft Fabric, vous aurez besoin de :

• Un espace de travail Microsoft Fabric avec un entrepôt Fabric
• Un principal de service Microsoft Entra ID ajouté à l’espace de travail Fabric avec le rôle de contributeur
• L’ID de locataire, l’ID de client et le secret client du principal du service
• Votre chaîne de connexion SQL Fabric Warehouse (adresse du serveur, sans le numéro de port) et le nom de l’entrepôt

Le principal du service Microsoft Entra ID doit avoir l’autorisation de créer et de gérer des objets appartenant à HubSpot dans l’entrepôt de fabric de destination. Lors de la validation et des synchronisations des connexions, HubSpot crée des schémas et des tables, insère des données, renomme les tables intermédiaires et supprime les objets temporaires. Accordez au principal de service le rôle Contributeur sur l’espace de travail Fabric pour permettre à HubSpot de :

• Créer des schémas
• Créer des tableaux
• Insérer des lignes
• Renommer ou modifier les tableaux appartenant à HubSpot
• Supprimer les tableaux et schémas détenus par HubSpot

Votre point de terminaison SQL Fabric Warehouse doit être accessible par HubSpot sur le port TCP 1433. HubSpot utilise TLS pour toutes les connexions et valide le certificat du serveur.

Si votre espace de travail Fabric restreint l’accès au réseau, ajoutez les adresses IP de sortie de HubSpot pour la région de votre compte à la liste d’inclusion.

Comprendre les limites et les considérations

• Microsoft Fabric Data Out prend uniquement en charge les entrepôts Fabric. Les maisons lacustres ne sont pas prises en charge.
• Chaque synchronisation crée un instantané complet des données sélectionnées. Une synchronisation réussie remplace l’instantané précédent dans les tables de destination. HubSpot ne conserve pas les instantanés précédents. Si une table échoue pendant une synchronisation, ses données antérieures restent disponibles jusqu’à la prochaine synchronisation réussie.
• Chaque type d’objet, type d’événement ou paire d’association peut être inclus dans une synchronisation récurrente de Microsoft Fabric par compte.
• Chaque synchronisation remplace le tableau de destination. Les attributions au niveau de la table ou les paramètres ajoutés dans votre Fabric Warehouse ne sont pas conservés entre les synchronisations.
• La reconnexion avec un autre principal de service nécessite l’ajout de ce principal de service à l’espace de travail Fabric avec le rôle de contributeur avant que le test de connexion ou la synchronisation puisse réussir.

Connecter HubSpot à Microsoft Fabric

Il est recommandé d’ouvrir votre compte HubSpot et les consoles Microsoft Fabric dans des onglets distincts.

1. Dans votre compte HubSpot, cliquez sur Plus, puis accédez à Gestion des données > Data Studio. Si l'option Plus n'apparaît pas dans votre compte, accédez directement à Gestion des données > Data Studio.
2. Dans l’angle supérieur droit, cliquez sur Connecter une source de données externe.
3. Dans le panneau Ajouter une source de données , recherchez ou accédez à Microsoft Fabric.
4. Cliquez sur Installer, puis sur Suivant.
5. Saisissez l’ID de locataire, l’ID de client et le secret de client de votre principal de service.
6. Saisissez les détails suivants concernant la destination :
   • Chaîne de connexion SQL : l’adresse du serveur pour votre Fabric Warehouse, sans le numéro de port.
   • Nom de l’entrepôt : nom de l’entrepôt de tissus vers lequel exporter.
7. Cliquez sur Tester la connexion. Si le test de connexion est concluant, cliquez sur Suivant.

Remarque : Dans votre espace de travail Fabric, confirmez que le principal du service HubSpot a le rôle de contributeur avant d’exécuter le test de connexion. Aucun script SQL n’est requis pour configurer l’accès.

Configurer la synchronisation

1. Sélectionnez les sources de données à exporter :
   • Objets
   • Associations
   • Évènements
2. Sélectionnez les objets, les propriétés, les associations ou les événements à inclure.
3. Choisissez la fréquence d’exécution de la synchronisation et le moment auquel la commencer.
4. Cliquez sur Commencer la synchronisation.

Les fréquences de synchronisation disponibles peuvent varier pendant la version bêta. Les options peuvent inclure une, toutes les 6 heures, toutes les 12 heures, quotidiennement, hebdomadairement ou mensuellement.

Accéder à vos données exportées

HubSpot crée un schéma géré par HubSpot pour chaque destination. Les tableaux utilisent le format suivant :

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

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

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

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.

Types de colonnes

La PROPERTIES colonne dans OBJECT_WITH_OBJECT_PROPERTIES est stockée en tant que chaîne au format JSON dans , et VARCHAR(MAX)non en tant que type de colonne JSON natif. Consultez les exemples de requêtes dans les FAQ ci-dessous.

Tables d’objets

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

OBJECT_PROPERTIES

Ce tableau contient une ligne pour chaque valeur de propriété d’objet.

OBJECT_WITH_OBJECT_PROPERTIES

Ce tableau contient une ligne pour chaque fiche d’informations d’objet. Les valeurs des propriétés sélectionnées sont regroupées dans la PROPERTIES colonne.

Les données d’objets de différents types d’objets sont combinées dans ce tableau. Filtrer par OBJECTTYPEID pour lire les fiches d’informations pour un type d’objet spécifique :

• Contacts : 0-1
• Objets personnalisés : 2-{unique_id}, tels que 2-12345

OBJECT_PROPERTIES_HISTORY

Ce tableau contient l’historique des modifications de propriétés. Il comprend une ligne pour chaque valeur historique d’une propriété.

Pour afficher l’historique complet d’une fiche d’informations et d’une propriété spécifiques, classez les résultats par UPDATEDAT.

Tableaux d’association

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 pour chaque association sélectionnée entre deux fiches d’informations.

ASSOCIATION_DEFINITIONS

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

Tableaux d’association spécifiques aux paires

Pour les paires d’associations sélectionnées, HubSpot peut également exporter des tableaux au format suivant :

ASSOCIATIONS_<FROM_OBJECT_TYPE>_TO_<TO_OBJECT_TYPE>

Par exemple : ASSOCIATIONS_CONTACTS_TO_COMPANIES

Ces tableaux contiennent des fiches d’informations d’association et des métadonnées de définition d’association.

Tables d’événements

Si vous sélectionnez Données d’événements, HubSpot exporte un tableau pour chaque type d’événement. Les noms des tableaux d’événements utilisent le format suivant :

EVENTS_<EVENT_NAME>

Par exemple : 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.

Suivre la synchronisation

1. Dans votre compte HubSpot, cliquez sur Plus, puis accédez à Gestion des données > Data Studio. Si l'option Plus n'apparaît pas dans votre compte, accédez directement à Gestion des données > Data Studio.
2. Sur la gauche, cliquez sur Synchronisations d’applications.
3. Recherchez ou sélectionnez la synchronisation Microsoft Fabric .

Sur la page des détails de la synchronisation, vous pouvez afficher l’état de la synchronisation, l’heure de la dernière synchronisation, les erreurs, l’activité de synchronisation et l’historique de synchronisation. Vous pouvez également suspendre, archiver ou exécuter manuellement la synchronisation.

Synchroniser les statuts

Résoudre les échecs de synchronisation

Lorsqu’une synchronisation échoue :

• L’interface utilisateur de HubSpot affiche le statut Échec et des détails au niveau des tableaux indiquant les tables qui ont réussi ou échoué.
• Un tableau n’est mis à jour qu’une fois que HubSpot a fini de charger toutes ses données. Si une table échoue, ses données précédentes restent en place jusqu’à la prochaine synchronisation réussie.
• La prochaine synchronisation planifiée retentera automatiquement la synchronisation complète.
• Vous pouvez exécuter une synchronisation manuellement à partir de la page de détails de synchronisation.

FAQ

Comment interroger les données exportées ?

Interrogez les tables dans le schéma de destination avec SQL.

-- Read all contact records
SELECT *
FROM [your_database].[hubspot_data_out_456].[OBJECT_WITH_OBJECT_PROPERTIES]
WHERE [OBJECTTYPEID] = '0-1'; -- Read a specific property from the PROPERTIES JSON string
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 type d’objet, type d’événement ou paire d’association peut être inclus dans une synchronisation récurrente de Microsoft Fabric par compte HubSpot. Celle-ci est indépendante des autres fournisseurs de sortie de données.

Par exemple, si les contacts sont déjà exportés vers une destination Fabric récurrente, vous ne pouvez pas ajouter de contacts à une autre configuration Fabric récurrente tant que vous n’avez pas archivé la première configuration. 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 ?

Les tableaux spécifiques à un objet, tels que OBJECTS_CONTACTS, ne sont pas pris en charge actuellement. À utiliser OBJECT_WITH_OBJECT_PROPERTIES et filtrez par OBJECTTYPEID pour récupérer les fiches d’informations d’un type d’objet spécifique.

Les données sensibles sont-elles prises en charge ?

Les données sensibles ne sont actuellement pas prises en charge pour les données sortantes. Les propriétés sensibles peuvent être exclues des exports.

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

Non. Chaque synchronisation réussie remplace la table de destination par le dernier instantané. HubSpot ne conserve pas les instantanés précédents. Si un tableau échoue pendant une synchronisation, ses données antérieures restent en place jusqu’à ce que ce tableau soit correctement mis à jour.

HubSpot utilise-t-il un compartiment de préparation que je gère ?

Non. HubSpot crée un export Parquet temporaire dans un stockage géré par HubSpot et écrit les résultats dans votre entrepôt Fabric. Vous n’avez pas besoin de fournir ou de gérer un compartiment intermédiaire.

Que se passe-t-il si je reprends contact avec un autre principal de service ?

Si vous vous reconnectez à l’aide d’un autre principal de service, vous devez ajouter ce principal de service à l’espace de travail Fabric avec le rôle de contributeur avant que le test de connexion ou la synchronisation puisse réussir.