BêtaAccédez à vos données HubSpot depuis Amazon Redshift

Utilisez Data Out for Amazon Redshift pour exporter les données CRM HubSpot sélectionnées vers des tableaux dans une base de données Amazon Redshift que vous possédez. Chaque exécution de synchronisation écrit un instantané complet des données sélectionnées et remplace l’instantané précédent. 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.

• Chaque synchronisation remplace les tables de destination par le dernier instantané. HubSpot ne conserve pas les instantanés précédents dans Redshift.
• HubSpot ne supprime pas les fichiers Parquet qu’il gère dans votre compartiment S3. Pour les supprimer automatiquement, configurez une stratégie de cycle de vie S3 sur le compartiment ou le préfixe.
• Chaque objet, chaque type d’événement ou chaque paire d’association peut être inclus dans une synchronisation récurrente des données Redshift par compte HubSpot.
• Les données sensibles ne sont pas encore prises en charge. Les propriétés sensibles peuvent être exclues des exports.
• Les tableaux spécifiques à un objet, tels que OBJECTS_CONTACTS, ne sont pas encore pris en charge.

Comprendre les données que vous pouvez exporter

Vous pouvez synchroniser les données suivantes de HubSpot vers Amazon Redshift :

• Objets : objets standards et personnalisés, tels que des contacts, des entreprises, des transactions, des tickets et des produits.
• Fiches d’informations : fiches d’informations individuelles pour les objets sélectionnés.
• 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 :

• La base de données Redshift et le cluster ou le groupe de travail sans serveur où HubSpot créera des tables.
• Le compartiment S3 utilisé par HubSpot pour préparer les données avant de les charger dans Redshift.
• Les sources de données à synchroniser : objets, événements, associations ou une combinaison de ces sources.
• Le planning de synchronisation.

HubSpot exporte les données sous forme de fichiers Parquet, les échelonne dans votre compartiment S3 et les charge dans des tableaux Redshift.

Remarque : HubSpot ne supprime pas les données du compartiment de préparation. Il est recommandé de définir une politique de cycle de vie de compartiment pour nettoyer automatiquement le seau.

Trouvez vos données dans Redshift

HubSpot crée un tableau par source de données dans un schéma géré par HubSpot qui porte le nom de votre destination :

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

Vous trouverez le nom du schéma sur la page de configuration de votre synchronisation Redshift. 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

Chaque synchronisation remplace le tableau par le dernier instantané. Si un tableau échoue pendant une synchronisation, ses données antérieures restent en place jusqu’à la prochaine synchronisation réussie.

HubSpot échelonne les fichiers Parquet dans votre compartiment S3 sous un préfixe géré par HubSpot, puis les charge dans Redshift :

s3://<bucket>/<prefix>/hubspot-dataout/<portal-id>/<destination-id>/<run-id>/<table-name>/

Ces fichiers de préparation restent dans votre compartiment jusqu’à ce que vous les supprimiez. Pour les supprimer automatiquement, configurez une stratégie de cycle de vie S3 sur le compartiment ou le préfixe.

Remarque : Les noms des tableaux et des colonnes proviennent des données exportées. Ils peuvent être raccourcis pour respecter la limite d’identification de 127 caractères de Redshift. Les types de colonnes suivent les données exportées.

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, seul un ensemble limité de fréquences de synchronisation peut être disponible, par exemple une, toutes les 6 heures, toutes les 12 heures, quotidiennement, hebdomadairement et mensuellement. 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 Amazon Redshift dans HubSpot. Une synchronisation peut avoir l’un des états suivants :

Lorsqu’une synchronisation échoue :

• HubSpot affiche un statut Échec avec des détails par tableau 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, de sorte que vous ne voyez jamais un tableau partiellement chargé.
• Si une table échoue, ses données précédentes restent en place jusqu’à la prochaine synchronisation réussie.
• La prochaine synchronisation planifiée retente automatiquement une synchronisation complète.
• Vous pouvez déclencher manuellement une resynchronisation à tout moment dans HubSpot.

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

FAQ

Comment interroger les données ?

Interrogez les tables dans votre schéma de destination avec SQL. Par exemple :

Lire toutes les fiches d’informations de contacts :

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 colonne JSON :

SELECT OBJECTID, JSON_EXTRACT_PATH_TEXT(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 Redshift ?

Chaque objet, chaque type d’événement ou chaque paire d’association peut être inclus dans une synchronisation récurrente des données Redshift par compte HubSpot. Par exemple, si les contacts sont déjà exportés vers une destination récurrente Redshift, vous ne pouvez pas ajouter de contacts à une autre synchronisation récurrente Redshift tant que vous n’avez pas archivé la première synchronisation.

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.

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

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

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

Non. Chaque synchronisation remplace la table de destination par le dernier instantané, de sorte que les instantanés précédents ne sont pas conservés dans Redshift. HubSpot ne supprime pas non plus les fichiers Parquet temporaires qu’il gère dans votre compartiment S3. Configurez une stratégie de cycle de vie S3 pour qu’elles expirent automatiquement.