Exporter des données HubSpot vers PostgreSQL ou MySQL

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

Récapitulatif

Utilisez Data Out pour exporter certaines données du CRM de HubSpot vers une base de données PostgreSQL ou MySQL que vous gérez. Vous pouvez synchroniser des données d’objets, d’associations et d’événements avec des tableaux de votre base de données, puis interroger les données avec SQL ou les utiliser avec votre intelligence commerciale et vos outils d’analyse.

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

• Votre base de données PostgreSQL ou MySQL doit être accessible depuis les plages d’adresses IP HubSpot pour la région de votre compte.
• Votre serveur de base de données doit prendre en charge les connexions SSL.
• Un utilisateur de la base de données doit disposer des autorisations requises :
  • PostgreSQL : CREATE Droit d’autorisation et d’écriture sur le schéma cible.
  • MySQL : CREATE des autorisations sur la base de données et des droits d’écriture.
• Assurez-vous que votre utilisateur de base de données peut créer des tables et écrire des données.
• Gardez votre compte HubSpot et les consoles de base de données ouverts dans des onglets séparés.

Autoriser les adresses IP HubSpot

Ajoutez la plage d’adresses IP HubSpot pour la région de votre compte à la liste d’inclusion de votre serveur de base de données.

Comprendre les limites et les considérations

• 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 PostgreSQL et une synchronisation récurrente MySQL par compte.
• Chaque synchronisation remplace le tableau de destination. Les octrois au niveau de la table ou les paramètres ajoutés dans votre fournisseur de base de données ne sont pas conservés entre les synchronisations.
• Si vous vous reconnectez en utilisant un autre utilisateur de base de données, vous devez accorder à cet utilisateur l’accès aux schémas, aux bases de données ou aux tables gérés par HubSpot existants.

Connecter HubSpot à PostgreSQL ou MySQL

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 au fournisseur de base de données.
4. Cliquez sur PostgreSQL ou MySQL.
5. Entrez les détails de connexion à la base de données :
   • Animateur
   • Port
   • SSL
   • Nom d'utilisateur
   • Mot de passe
6. Pour PostgreSQL, saisissez le nom de la base de données où HubSpot doit créer le schéma.
7. Cliquez sur Se connecter à PostgreSQL ou Se connecter à MySQL.

HubSpot utilise l’utilisateur connecté à la base de données pour créer des tables et charger des données dans votre base de données.

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 ou une base de données gérée par HubSpot pour chaque destination.

PostgreSQL

Les tableaux PostgreSQL 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"

MySQL

Les tableaux MySQL utilisent le format suivant :

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

Par exemple :

hubspot_data_out_456.OBJECT_WITH_OBJECT_PROPERTIES
hubspot_data_out_456.EVENTS_VISITED_PAGE
hubspot_data_out_456.ASSOCIATIONS_CONTACTS_TO_COMPANIES

Vous trouverez le schéma ou le nom de la base de données exacte sur la page de configuration de la synchronisation.

Noms des tableaux et des colonnes

Les noms des tableaux et des colonnes s’appuient sur les données exportées. Les identifiants PostgreSQL peuvent contenir jusqu’à 63 caractères. Les identifiants MySQL peuvent contenir jusqu’à 64 caractères. Les noms plus longs sont abrégés pour s’adapter à la limite applicable.

HubSpot crée des tables et des colonnes PostgreSQL avec des noms entre guillemets et en casse. Lorsque vous interrogez PostgreSQL, utilisez des guillemets doubles et faites correspondre la capitalisation indiquée dans le nom du tableau et le nom de la colonne.

Pour MySQL, utilisez les apostrophes inversées et faites correspondre la majuscule affichée. La sensibilité à la casse du nom de table peut varier en fonction de la configuration de votre serveur MySQL.

Types de colonnes

La PROPERTIES colonne du tableau est stockée sous la OBJECT_WITH_OBJECT_PROPERTIES forme d’une chaîne au format JSON. Il est stocké comme TEXT dans PostgreSQL et LONGTEXT dans MySQL, et non comme un type de colonne JSON natif.

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. Filtrez par OBJECTTYPEID pour lire les fiches d’informations pour un type d’objet spécifique.

• Personnes-ressources : 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 > Intégration des données. Si Plus n'apparaît pas dans votre compte, accédez directement à Gestion des données > Intégration des données.
2. Sur la gauche, cliquez sur Synchronisations d’applications.
3. Recherchez ou sélectionnez la synchronisation PostgreSQL ou MySQL.

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.

Les tables qui ont réussi lors d’une exécution précédente ne sont pas modifiées en cas d’échec d’une exécution ultérieure.

FAQ

Comment interroger les données exportées ?

Interrogez les tables du schéma ou de la base de données de destination avec SQL.

PostgreSQL

-- Read all contact records
SELECT *
FROM your_database.hubspot_data_out_456."OBJECT_WITH_OBJECT_PROPERTIES"
WHERE "OBJECTTYPEID" = '0-1';

-- Read a property from the PROPERTIES column
SELECT
  "OBJECTID",
  json_extract_path_text("PROPERTIES"::json, 'email') AS email
FROM your_database.hubspot_data_out_456."OBJECT_WITH_OBJECT_PROPERTIES"
WHERE "OBJECTTYPEID" = '0-1';

MySQL

-- Read all contact records
SELECT *
FROM `hubspot_data_out_456`.`OBJECT_WITH_OBJECT_PROPERTIES`
WHERE `OBJECTTYPEID` = '0-1';

-- Read a property from the PROPERTIES column
SELECT
  `OBJECTID`,
  JSON_EXTRACT(`PROPERTIES`, '$.email') AS email
FROM `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 PostgreSQL et une synchronisation récurrente MySQL par compte HubSpot.

Par exemple, si les contacts sont déjà exportés vers une destination PostgreSQL récurrente, vous ne pouvez pas ajouter de contacts à une autre configuration récurrente PostgreSQL tant que vous n’avez pas archivé la première configuration. Vous pouvez toujours exporter des contacts vers une configuration MySQL récurrente 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 exporte les données en tant que Parquet et gère la préparation en interne. Vous n’avez pas besoin de fournir un groupe intermédiaire appartenant au client pour PostgreSQL ou MySQL.

Que se passe-t-il si je change d’utilisateur de la base de données ?

Si vous vous reconnectez en utilisant un autre utilisateur de base de données, vous devez accorder au nouvel utilisateur l’accès aux schémas, aux bases de données ou aux tableaux gérés par HubSpot existants.