Interroger les données HubSpot dans Snowflake

Après avoir connecté Snowflake à votre compte HubSpot, vous pouvez utiliser le partage de données de Snowflake pour interroger les données HubSpot depuis votre compte Snowflake.

Le décalage des données et la région de votre compte Snowflake

Vous aurez accès au schéma V2_LIVE qui est mis à jour toutes les 15 minutes, et au schéma V2_DAILY qui est mis à jour tous les jours.

Veuillez noter : les vues suivantes du schéma V2_LIVE ne sont mises à jour que quotidiennement : association_definitions, owners, pipelines, et pipeline_stages.

Configurer votre environnement Snowflake

Pour interroger vos données HubSpot dans Snowflake, vous devez sélectionner l'entrepôt, la base de données et le schéma à partir desquels vous souhaitez effectuer l'interrogation. Vous pouvez soit les définir au niveau de la feuille de calcul pour les inclure automatiquement dans vos requêtes, soit les ajouter manuellement.

Pour sélectionner votre entrepôt, votre base de données et votre schéma au niveau de la feuille de calcul :

• Dans la ligne supérieure de la feuille de calcul, cliquez sur la barre d'actions de la feuille de calcul.
  
  
• Dans la fenêtre contextuelle :
  • Cliquez sur le menu déroulant Entrepôt, puis sélectionnez votre entrepôt.
  • Cliquez sur le menu déroulant Base de données, puis sélectionnez votre base de données HubSpot.
  • Cliquez sur le menu déroulant Schéma, puis sélectionnez le schéma que vous souhaitez utiliser:
    • V2_DAILY : le schéma quotidien pour interroger les données basées sur les tables. Les données de ce schéma sont mises à jour une fois par jour. L'utilisation de ce schéma permet d'obtenir des requêtes plus rapides. Elle est recommandée pour les requêtes effectuées directement dans Snowflake.
    • V2_LIVE : le schéma live basé sur les Secure Views des données HubSpot. Les données de ce schéma sont mises à jour toutes les 15 minutes au maximum. Si vous interrogez un grand ensemble de données, les requêtes peuvent être lentes. Dans ce cas, il est recommandé de copier les données dans votre propre tableau d'abord via un processus ETL, puis d'interroger ce tableau.
    
    
    

Une fois votre environnement configuré, vous pouvez effectuer des requêtes sur vos données HubSpot sans avoir besoin d'ajouter manuellement votre base de données ou votre type de schéma aux requêtes.

Pour ajouter manuellement votre base de données et votre type de schéma aux requêtes, ajoutez le nom de la base de données suivi du schéma au début du champ FROM au début du champ Par exemple :

Présentation des données

Les requêtes sont construites en utilisant SQL, et peuvent être utilisées pour récupérer des données HubSpot telles que :

• Objets: objets standard et personnalisés, tels que les contacts, les entreprises et les produits. 
• Enregistrements: enregistrements individuels, tels qu'un contact individuel ou une entreprise. 
• Associations: tous les types d'associations disponibles et les enregistrements actuellement associés.
• E-mails: données d'événements pour les événements HubSpot standard, tels que les ouvertures d'e-mails, et les événements comportementaux personnalisés.
• Listes: Listes de contacts et d'entreprisesHubSpot.
• Propriétaires : utilisateurs de votre compte HubSpot, en relation avec les fiches d'informations dont ils sont les propriétaires.
• Pipelines : pipelines de transactions et de tickets, y compris les phases du pipeline.
• Propriétés: propriétés et leurs valeurs sur les enregistrements CRM, y compris l'historique des propriétés.

Découvrez-en davantage sur le modèle de données CRM de HubSpot. 

Remarque : . Au fur et à mesure de l'évolution du partage des données, nous introduirons des changements, dont certains seront radicaux. Il est fortement recommandé de s'abonner au journal des changements des développeurs de HubSpot. Ces modifications seront toujours publiées dans le journal des modifications avant toute mise à jour.

Limiter et ordonner les données renvoyées

Lorsque vous créez des requêtes, vous pouvez contrôler la quantité de données renvoyées, ainsi que l'ordre dans lequel elles sont renvoyées, en incluant LIMIT et ORDER BY dans votre requête. Par exemple, pour interroger tous les contacts avec leurs propriétés, mais ne renvoyer que trois résultats et les classer selon l'ID de contact, vous pouvez construire votre requête comme suit :

Types de données de colonne

Lorsque vous interrogez des données dans Snowflake, les colonnes qui sont renvoyées dépendent des données que vous interrogez. Vous pouvez afficher les colonnes disponibles pour un tableau ou une vue en question dans Snowflake en sélectionnant la vue dans la barre latérale gauche.

Remarque :pour le reste de ce document, nous utilisons le terme objet de base de données lorsque le contexte s'applique à la fois aux tables et aux vues.

Pour obtenir une colonne spécifique, incluez cette colonne dans le champ SELECT de votre requête. Par exemple, la requête suivante ne renverra que les éléments suivants OBJECTID et UpdatedAt :


SELECTobjectId, updatedAt
FROM objects_contacts



Vous trouverez ci-dessous des définitions générales des colonnes qu'une requête peut renvoyer. Pour d'autres définitions non incluses ci-dessous, consultez les définitions des vues individuelles dans l'article ci-dessus.

• OBJECTTYPEID : une valeur VARCHAR qui représente le type d'un objet. Par exemple, 0-1 représente l'objet Contacts, 0-2 représente l'objet Entreprises et 2-1232 peut représenter un objet personnalisé dans votre compte. Dans les listes, il s'agit du type de liste (par exemple, contact ou entreprise). Vous pouvez interroger tous les ID d'objet et d'événement de votre compte en utilisant la vue object_and_event_type_definitions.
• OBJECTID : un nombre BIGINT qui représente un seul enregistrement d'un type d'objet donné dans votre compte HubSpot. Pour identifier une fiche d'informations, vous devez utiliser à la fois l'ID du type d'objet et l'ID de l'objet.
• INGESTEDAT : l'heure à laquelle une ligne de données a été ajoutée à Snowflake, représentée par une valeur TIMESTAMP_NTZ. Cela n'a aucun lien avec l'horodatage logique d'une opération de création ou de mise à jour dans HubSpot.
  • En raison du traitement interne de HubSpot, l'horodatage d'ingestion d'une ligne peut être mis à jour même si aucune autre colonne de la ligne n'a changé.
  • Lors de la création de processus ETL qui copient des données récemment modifiées, il est recommandé de baser vos requêtes sur l'horodatage d'ingestion. En outre, si votre flux copie les données quotidiennement, il est recommandé de copier les données des deux jours précédents pour tenir compte des délais.
• CREATEDAT et UPDATEDAT : l'horodatage logique de la création ou de la mise à jour des données dans HubSpot, représenté par une valeur TIMESTAMP_NTZ . Ces horodatages correspondront aux horodatages de HubSpot. Par exemple, l'heure affichée dans HubSpot pour la date de création d'une fiche d'informations sera la même que l'horodatage de la colonne CREATEDAT dans Snowflake. Elles ne sont pas directement liées à l'horodatage d'ingestion, et il n'est pas recommandé de baser les processus ETL sur ces propriétés.
• COMBINEDASSOCIATIONTYPE : une valeur VARCHAR qui identifie de manière unique une définition d'association.

Transformation des types de données

Il arrive que des données soient renvoyées par une requête avec des colonnes VARCHAR alors qu'il serait souhaitable qu'elles soient d'un autre type. Dans des cas comme celui-ci, il est recommandé de convertir le type de données VARCHAR dans les types souhaités en utilisant les fonctions Snowflake. Par exemple, les propriétés d'un enregistrement d'objet sont stockées sous le type de données VARCHAR dans la plupart des objets de base de données, mais elles contiennent parfois des valeurs numériques et des dates. Des fonctions telles que :
try_to_number, try_to_timestamp_ntz peuvent être utilisées pour convertir ces données VARCHAR en types NUMBER et DATETIME respectivement :


SELECT objectid, value AS amount_str, try_to_number(value) AS amount
FROM object_properties
WHERE objecttypeid='0-3' AND name='amount'
LIMIT 1



Requêtes d'objets

Découvrez ci-dessous comment interroger des données à partir d'objets et de fiches d'informations HubSpot spécifiques ainsi que les données qui sont renvoyées. 

Les données d'objets de différents types sont organisées et disponibles de deux manières : 

• Individuel : Chaque type d'objet est stocké dans sa propre vue et ne contient que des enregistrements du même type d'objet, par exemple, objects_contacts ne contient que des enregistrements de contacts. Ainsi, il n'est pas nécessaire de spécifier un objecttypeid lors de l'interrogation. Ces vues sont plus faciles à interroger car vous n'avez pas besoin de connaître les ObjectTypeIds. Ils renvoient également des données dans un format plus exploitable, chaque ligne correspondant à un objet et à la version actuelle de ses propriétés. Tant que les requêtes ne sont pas lentes, il est conseillé d'utiliser ces vues pour récupérer les données des objets. Pour en savoir plus, consultez les vues d'Objects_X ci-dessous. 
• Combiné : Tous les enregistrements de tous les types d'objets sont combinés en un seul objet de base de données. Ainsi, lors de l'interrogation, vous devez spécifier un filtre comme "WHERE objectTypeId='0-1'. Par exemple, vous pouvez utiliser les objecttypeids suivants lors de vos requêtes :

Un ID sera attribué aux objets personnalisés au moment de leur création. Ceux-ci seront identifiés comme 2-unique_ID. Par exemple, 2-12345. Découvrez-en davantage sur les définitions des types d'objets et d'événements.

Ces objets de base de données conviennent généralement si vous souhaitez obtenir de meilleures performances de requête que celles obtenues avec les vues objets_x. Voir plus de détails dans object_with_object_properties, object_properties, objects et object_properties_history ci-dessous.

objets_x vues

Dans cet objet de base de données, chaque type d'objet disponible, y compris les objets personnalisés, possède sa propre vue spécifique, chaque vue ne contenant que les enregistrements des objets de ce type spécifique. Ces vues sont nommées selon le format OBJECTS_<object type name> où <object type name> est le libellé de la forme plurielle dutype d'objet (si le type d'objet n'a pas de forme plurielle, <object type name> sera simplement le libellé de la forme singulière du nom du type d'objet concaténé avec "S").

Les requêtes adressées à cette vue renvoient une ligne pour chaque enregistrement d'un objet, chaque propriété de l'objet étant disponible dans une colonne distincte.

Vous trouverez ci-dessous la liste complète des types d'objets HubSpot (c'est-à-dire non personnalisés) disponibles, une brève description des données qu'ils représentent et les vues correspondantes :

Chaque objet de la base de données renvoie les colonnes suivantes :

Exemple 1

Récupérez le prénom, le nom et l'étape du cycle de vie de tous les contacts.

Requête :


SELECT objectId, property_firstname AS firstname, property_lastname AS lastname,property_lifecyclestage AS lifecyclestage
FROM objects_contact



Les retours :

Exemple 2

Récupérez le nom et le stade de l'opération pour un maximum de trois opérations.

Requête :


SELECT objectId, property_dealName, property_dealStage,
property_amount AS dealAmount

FROM objects_deals

LIMIT 3

Renvoie :

Exemple 3

Récupérez le nom de l'opération et l'étape des trois premières opérations par montant.

Requête :

Les données relatives au montant de l'opération étant disponibles sous la forme d'un type de données numérique, elles peuvent être utilisées pour le classement sans qu'il soit nécessaire d'effectuer une conversion ou un moulage.


SELECT objectId, property_dealName, property_dealStage,
property_amount AS dealAmount

FROM objects_deals
ORDER BY property_amount DESC
LIMIT 3




Renvoie :

object_with_object_properties

Cet objet de base de données contient les données de vos enregistrements HubSpot. Les requêtes sur cet objet de base de données renvoient une ligne pour chaque enregistrement d'un type d'objet (par exemple, tous les enregistrements de contact du type d'objet Contacts). Toutes les propriétés sont stockées dans la colonne Propriétés, qui est une colonne Snowflake Variant / JSON. 

Cette vue peut renvoyer les colonnes suivantes :

Remarque : Le 25 janvier 2022, la colonne timestamp de la table et de la vue object_with_object_properties, qui représente la date et l'heure de la dernière mise à jour de l'enregistrement de l'objet dans HubSpot, sera mise à jour. Ceci afin de s'aligner sur la façon dont les données de type date-heure sont représentées dans lereste du partage de données .

Comme il s'agit d'un changement de rupture, la nouvelle colonne, updatedat, a été ajoutée à la table et à la vue. Pendant les 90 prochains jours, ces deux nouvelles colonnes coexisteront avec timestamp, les colonnes qu'elles cherchent à remplacer. Cela vous donne l'occasion de passer à l'utilisation des nouvelles colonnes.

Après 90 jours, le 25 janvier 2022, l'horodatage de la colonne sera supprimé de la table et de la vue. Après cette date, toute tentative d'interroger la table ou la vue object_with_object_properties en utilisant les colonnes timestamp échouera.

Exemple 1

Récupérez tous les contacts et leurs propriétés.

Requête :

Renvoie :

Exemple 2

Récupérer le nom de l'affaire et l'étape de trois affaires au maximum.

Requête :

Renvoie :

objects

Cet objet de base de données est un sous-ensemble des données de l'objet de base de données object_with_object_properties. Chaque ligne retournée renvoie l'ID d'objet pour chaque fiche d'informations. Cet objet de base de données ne renvoie que les enregistrements existants. Lorsqu'un enregistrement est supprimé dans HubSpot, il est supprimé de cet objet de base de données. Cet objet de base de données est un sous-ensemble des données de la table object_with_object_properties. Chaque ligne retournée renvoie l'ID d'objet pour chaque fiche d'informations. Cette vue renvoie uniquement les fiches d'informations existantes. Lorsqu'une fiche d'informations est supprimée dans HubSpot, elle est supprimée de cette vue. 

Cet objet de base de données peut être utile si votre compte contient une grande quantité de données, ce qui entraîne une lenteur des vues object_with_object_properties et object_x. L'utilisation de cet objet de base de données avec l'objet de base de données object_properties permet de répliquer les données dans object_with_object_properties, tout en gardant le contrôle sur les propriétés qui sont retournées.

Cet objet de base de données peut renvoyer les colonnes suivantes :

Exemple 1

Récupérez toutes les fiches d'informations de contact.

Requête :

Renvoie :

object_properties

Cet objet de base de données est un sous-ensemble de l'objet de base de données object_with_object_properties. Chaque ligne contient la valeur actuelle de la propriété définie sur un enregistrement donné. Par exemple, un contact aura une ligne pour sa propriété Prénom et une ligne pour sa propriété Nom. Si un enregistrement n'a pas de valeur pour une propriété, la ligne apparaîtra avec une chaîne vide ou n'apparaîtra pas du tout.

Cet objet de base de données peut renvoyer les colonnes suivantes :

Exemple 1

Récupérez les propriétés du prénom, du nom et de la ville pour tous les contacts.

Requête :

Renvoie :

Exemple 2

Récupérez le prénom, le nom et l'étape du cycle de vie de tous les contacts, et combinez-les en une seule ligne par contact. Cet exemple utilise la syntaxe SQL PIVOT.

Requête :

Renvoie :

object_properties_history

Cet objet de base de données contient les valeurs historiques des propriétés. Pour les contacts, elle contient les 45 valeurs les plus récentes. Pour tous les autres objets, elle contient les 20 valeurs les plus récentes. Elle affiche une ligne pour chaque valeur de propriété historique. La valeur actuelle d'une propriété est déterminée par l'horodatage UPDATEDAT le plus récent dans l'historique de la propriété.

Cet objet de base de données peut renvoyer les colonnes suivantes :

Exemple 1

Récupérez l'historique d'une seule propriété pour un seul contact.

Requête :

 
Renvoie :

Exemple 2

Récupérez le nom actuel de tous les contacts qui ont eu une phase du cycle de vie Abonné.

Requête :

Renvoie :

Requêtes d'associations

Comme les données relatives aux objets, les données relatives aux associations sont organisées de deux manières :

• Individuel : Chaque type d'association est stocké dans sa propre vue et ne contient que les enregistrements de ce type. Par exemple, les associations_contacts_to_deals ne contiennent que les enregistrements d'association entre les objets contact et deal. Il n'est donc pas nécessaire de spécifier un numéro d'association lors de l'interrogation. Ces vues sont assez faciles à interroger car il n'est pas nécessaire de connaître le modèle de données du CRM pour les utiliser. Ils renvoient également une description enrichie de l'enregistrement de l'association entre deux objets qui peut être facilement utilisée dans les jointures avec les vues objets_x. Tant que les requêtes ne sont pas lentes, il est conseillé d'utiliser ces vues pour récupérer les données d'association. Pour en savoir plus, consultez les vues d'associations_x_to_y ci-dessous. 
• Combiné : Tous les enregistrements de tous les types d'association sont combinés en un seul objet de base de données. Ainsi, lors de l'interrogation, vous devez spécifier un filtre comme "WHERE combinedassociationtypeid='0-32'". Pour en savoir plus, consultez les sections associations et associations_definitions ci-dessous.

associations_x_to_y views

Chaque type d'association a sa propre vue, étiquetée associations_<association type name>, par exemple associations_contacts_to_deals. Chaque vue est un sous-ensemble des données de l'objet de base de données des associations et ne contient que les enregistrements d'un combinedassociationtypeid spécifique.

Chaque objet de la base de données renvoie les colonnes suivantes :

Exemple 1

Récupérer tous les contrats associés à un contact spécifique.

Requête :

Les retours :

Exemple 2

Récupérez tous les contacts basés dans le fuseau horaire de Bogota et leurs transactions.

Exemple 3

Récupérez tous les contacts et la somme totale du montant de l'affaire conclue pour chaque contact.

Renvoie :

association_definitions

Cet objet de base de données contient des informations sur tous les types d'association disponibles entre les objets HubSpot, avec une ligne par type d'association. Vous pouvez joindre cet objet de base de données à l'objet de base de données des associations pour obtenir des informations d'association spécifiques aux enregistrements.

Il peut y avoir plusieurs types d'association entre les mêmes objets. Le type d'association principal, qui est le type affiché dans HubSpot lorsque des enregistrements sont associés, utilise l'association où ISMAINASSOCIATIONDEFINITION est true.

Cet objet de base de données peut renvoyer les colonnes suivantes :

Exemple 1 

Récupérez les types d'association disponibles dans votre compte.

Requête :

 
Renvoie :

Exemple 2

Récupérez les types d'association disponibles entre les transactions et les entreprises.

Requête :

Renvoie :

associations

Cet objet de base de données contient des informations sur les associations entre des enregistrements spécifiques. Chaque ligne représente une association d'un objet à un autre objet. Des rangées peuvent être présentes dans cet objet de base de données même si les enregistrements référencés ont été supprimés. Vous pouvez vérifier si des fiches d'informations existent en faisant une association avec le tableau objects.

Cet objet de base de données peut être utile si votre compte contient une grande quantité de données, ce qui entraîne une lenteur des vues associations_x_to_y.

Cet objet de base de données peut renvoyer les colonnes suivantes :

Exemple 1

Récupérez tous les contacts et transactions associés.

Requête :

 
Renvoie :

Exemple 2 

Récupérez tous les tickets associés à un contact spécifique (ID du contact : 3005).

Requête :

Renvoie :

Exemple 3 

Récupérez toute les transactions associées à un contact spécifique (ID du contact : 4464). Au lieu d'un codage en dur combinedAssociationTypeId, une association avec association_definitions est réalisée dans cet exemple.

Requête :

Renvoie :

Requêtes du propriétaire

owners

Cet objet de base de données contient des informations sur les utilisateurs de votre compte HubSpot. Les utilisateurs peuvent être définis comme des propriétaires de fiches d'informations et contiennent à la fois un ID d'utilisateur et un ID de propriétaire, selon le contexte. Les deux identifiants peuvent être utilisés pour identifier le même utilisateur. 

Cet objet de base de données peut renvoyer les colonnes suivantes :

Exemple 1 

Récupérez tous les utilisateurs. Le filtre WHERE archived = false supprime les utilisateurs supprimés des données renvoyées.

Requête :

 
Renvoie :

Exemple 2

Récupérez un propriétaire spécifique avec son ID.

Requête :

Renvoie :

Exemple 3

Récupérez tous les contacts et leurs propriétaires. Cette requête associe les fiches d'informations aux propriétaires avec object_with_object_properties et la propriété de contact hubspot_owner_id.

Renvoie :

Questions de l'équipe

Équipes

Dans HubSpot, les équipes vous permettent de regrouper les utilisateurs afin de faciliter leur gestion et le reporting. Vous pouvez avoir une équipe principale et des équipes supplémentaires.

Cet objet de base de données contient des informations sur les équipes de votre compte HubSpot. 

Cet objet de base de données peut renvoyer les colonnes suivantes :

Exemple 1

Récupérez toutes les équipes.

Requête :

Renvoie :

owner_team

Cet objet de base de données contient des informations sur les propriétaires correspondant à chaque équipe dans votre compte HubSpot. 

Cet objet de base de données peut renvoyer les colonnes suivantes :

Exemple 1

Récupérez tous les propriétaires dans une équipe donnée.

Requête :

SELECT teamId, ownerId, isTeamPrimary
FROM teams
WHERE teamId = 29584574

Retours

Requêtes sur les pipelines

Découvrez ci-dessous comment interroger les données de sur le pipeline de transactions et de tickets, telles que les pipelines disponibles dans votre compte et leurs phases.

Vous pouvez joindre ces données à celles des objets pour obtenir une vue complète de vos pipelines. Par exemple, vous pouvez interroger les transactions et leurs pipelines en joignant les données object_deals_view ou object_with_object_properties aux données pipelines.

pipelines

Cet objet de base de données contient des informations sur les pipelines de transactions et de tickets dans votre compte. Chaque ligne retournée représente un seul pipeline.

Ce tableau peut renvoyer les colonnes suivantes :

Exemple 1

Récupérez tous les pipelines de transactions disponibles, classés selon l'ordre dans HubSpot.

Requête :

 
Renvoie :

Exemple 2

Récupérez les transactions dans un pipeline spécifique. Associez object_with_object_properties et pipelines.

Requête :

Renvoie :

Exemple 3

Comme l'exemple 2 ci-dessus, récupérer les transactions dans un pipeline spécifique. Mais au lieu d'utiliser objects_deals dans les jointures, utilisez object_with_object_properties.

Renvoie : 

pipeline_stages

Cette vue contient des informations sur les phases individuelles d'un pipeline. Identifiez les phases en combinant l'ID du type d'objet, l'ID du pipeline et l'ID de la phase. Lorsque vous associez pipelines, utilisez l'ID du type d'objet et l'ID du pipeline.

Cet objet de base de données peut renvoyer les colonnes suivantes :

Exemple 1 

Récupérez les phases d'un pipeline de transactions intitulé Pipeline de vente.

Requête :

 
Renvoie :

Exemple 2

Récupérez toutes les transactions et leurs phases respectives dans le pipeline.

Requête :

Renvoie :

Demandes de renseignements sur la propriété

property_definitions

Cet objet de base de données contient des informations sur les propriétés de l'objet et les propriétés des événements de votre compte HubSpot. Les propriétés d'événement comprennent des événements standards, tels que les ouvertures d'e-mails et les clics ainsi que des propriétés sur des événements comportementaux personnalisés. Ces informations peuvent être utiles pour définir les valeurs trouvées dans les données object_properties et events.

Vous pouvez identifier des propriétés spécifiques en combinant l'ID du type d'objet et le nom. Vous pouvez récupérer des informations similaires via l'API des propriétés.

Cet objet de base de données peut renvoyer les colonnes suivantes :

Exemple 1

Récupérez les noms et les descriptions de toutes les propriétés de contact.

Requête :

 
Renvoie :

Requêtes d'événement

Les événements comprennent les événements standards de HubSpot ainsi que des événements comportementaux personnalisés. Chaque événement possède son propre objet de base de données, libellé comme suit events_eventname.

Vous pouvez identifier les événements en combinant leur ID de type d'événement et leur ID. Les colonnes qui sont retournées dépendent de l'événement, avec une colonne pour chaque propriété d'événement. Tous les événements renverront les colonnes suivantes :

Exemple 1

Récupérez les 50 événements de clics d'e-mails les plus récents.

Requête :

Renvoie :

Exemple 2

Récupérez tous les événements de clics d'emails en fonction des contacts qui ont cliqué. Cette requête permet d'obtenir des données de contact en associant objet_with_object_properties.

Requête :

Renvoie :

Requêtes de type objet et événement

object_and_event_type_definitions

Cet objet de base de données contient les définitions de tous les objets et événements disponibles dans votre compte HubSpot.

Cet objet de base de données peut renvoyer les colonnes suivantes :

Exemple 1

Récupérez tous les objets et événements disponibles dans votre compte HubSpot.

Requête :

 
Renvoie :

Listes de requêtes

Découvrez ci-dessous comment interroger vos listes, telles que les listes de contacts et d'entreprises disponibles ainsi que les fiches d'informations incluses dans ces listes.

lists

Cet objet de base de données contient des informations sur les listes de contacts et de sociétés de HubSpot. Renvoie une ligne par liste, et les colonnes comprennent les détails de la liste tels que son nom, sa taille et le type d'objet des fiches d'informations qu'elle contient. Ne contient pas d'informations sur les fiches d'informations individuelles de chaque liste (voir list_membership). 

Cet objet de base de données peut renvoyer les colonnes suivantes :

Exemple 1

Récupérez toutes les listes de contacts.

Requête :

 
Renvoie :

Exemple 2

Récupérez une liste de contacts spécifique nommée Principaux abonnés 2021. 

Requête :

Renvoie :

list_membership

Cet objet de base de données contient des informations sur les enregistrements qui sont membres de telle ou telle liste, avec une ligne par enregistrement dans la liste. Par exemple, si vous avez une liste d'abonnés à un blog contenant 500 contacts, l'objet de base de données renverra 500 lignes. 

Seuls les ID de liste et d'objet sont inclus. Pour plus d'informations, rejoignez l'objet de la base de données des listes.

Cet objet de base de données peut renvoyer les colonnes suivantes :

Exemple 1

Récupérez les ID de tous les contacts de la liste Principaux abonnés 2021.

Requête :

 
Renvoie :

Exemple 2

Récupérer les noms et prénoms des détails des contacts de la liste Top subscribers 2021.

Requête :

Renvoie :

FAQ

Je souhaite générer des données similaires à un rapport de l'application HubSpot, comment dois-je procéder ?

En règle générale, il convient d'examiner les colonnes présentes dans le rapport avec lequel vous effectuez la comparaison. Si la visualisation du rapport n'est pas tabulaire, sa conversion en tableau permettra d'afficher les colonnes que le rapport contient. Ces colonnes sont généralement des propriétés d'un type d'objet ou d'un type d'événement. L'étape suivante consiste à déterminer à quelle propriété de type d'objet correspond une colonne. Vous pouvez le faire en interrogeant les property_definitions :

Il se peut qu'il n'y ait pas toujours une correspondance exacte, car certains noms de propriétés sont généralement remplacés par un nom plus descriptif dans l'application. Dans ce cas, une recherche floue utilisant l'opérateur LIKE sur la colonne label (ou même description) dans property_definitions peut être utile.

Après avoir déterminé à quel type d'objet appartient la colonne, il est trivial de déterminer ce qu'il faut interroger. Vous pouvez simplement rechercher la vue object_x qui correspond au type.

Comment lier ce type de données à un autre, par exemple comment récupérer des formulaires pour une campagne ?

Si vous devez relier deux ou plusieurs enregistrements différents les uns aux autres, jetez un coup d'œil aux associations. Les associations représentent les relations entre les objets dans le CRM HubSpot. Toutes les différentes associations possibles entre deux types sont répertoriées dans association_definitions. Dans l'exemple ci-dessus, pour connaître tous les formulaires auxquels une campagne est liée, vous devez interroger ASSOCIATIONS_CAMPAIGNS_TO_FORMS :

Comment puis-je connaître l'état de l'intégration HubSpot-Snowflake ?

Pour recevoir des mises à jour en temps réel sur les pannes et les problèmes de l'intégration HubSpot-Snowflake, interrogez la vue data_share_status :

SELECT * FROM hubspot.public.data_share_status
LIMIT 1

Les résultats s'affichent comme suit :

Cette vue fournit des mises à jour sur l'état de l'intégration dans l'ordre chronologique inverse. L'intégration des résultats de cette requête dans un tableau de bord vous aidera à suivre les performances de l'intégration et à détecter les temps d'arrêt ou les pannes.