Ignorer et passer au contenu principal
Avertissement : cet article est le résultat de la traduction automatique, l'exactitude et la fidélité de la traduction ne sont donc pas garanties. Pour consulter la version originale de cet article, en anglais, cliquez ici.
Reports

Interroger les données HubSpot dans Snowflake

Dernière mise à jour: novembre 16, 2021

Disponible avec :

Operations Hub Entreprise

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

Les requêtes sont construites à l'aide de SQL, et peuvent être utilisées pour récupérer des données HubSpot telles que :

  • ObjetsObjets: objets standard et personnalisés, tels que contacts, entreprises, produits. 
  • Enregistrements : enregistrements individuels, tels qu'un contact individuel ou une entreprise
  • Associations: tous les types d'association disponibles et les enregistrements actuellement associés.
  • Propriétaires : utilisateurs de votre compte HubSpot, en relation avec les enregistrements dont ils sont les propriétaires.
  • Pipelines : pipelines de transactions et de tickets, y compris les étapes du pipeline.
  • PropriétésLes propriétés et leurs valeurs sur les enregistrements CRM, y compris l'historique des propriétés.
  • ÉvénementsLes données d'événement: les données d'événement pour les événements HubSpot standard, tels que l'ouverture des emails, et les événements comportementaux personnalisés.
  • Listes: Listes de contacts et de sociétés HubSpot (BETA).

En savoir plus sur Le modèle de données CRM de HubSpot  

Configurez 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 rangée supérieure de la feuille de calcul, cliquez sur la barre d' actions de la feuille de calcul

    feuille de travail flocon de neige - réglages0
  • Dans la fenêtre pop-up :
    • 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 Schema, puis sélectionnez le schéma que vous souhaitez utiliser :
      • V2_LIVE : le schéma en direct basé sur les vues sécurisées 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 table d'abord avec un processus ETL, puis d'interroger cette table. 
      • V2_DAILY (BETA) : 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 et est recommandée pour les requêtes effectuées directement dans Snowflake.

      feuille de calcul flocon de neige - réglages - fenêtre 0

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


SELECT objectTypeId, objectId
FROM hubspot_share_name.V2_LIVE.object_with_object_properties
WHERE objectTypeId = '0-1'

Aperçu des données

Les requêtes sont construites à l'aide de SQL, et peuvent être utilisées pour récupérer des données HubSpot telles que :

  • ObjetsObjets: objets standard et personnalisés, tels que contacts, entreprises, produits. 
  • Enregistrements : enregistrements individuels, tels qu'un contact individuel ou une entreprise
  • Associations: tous les types d'association disponibles et les enregistrements actuellement associés.
  • Propriétaires : utilisateurs de votre compte HubSpot, en relation avec les enregistrements dont ils sont les propriétaires.
  • Pipelines : pipelines de transactions et de tickets, y compris les étapes du pipeline.
  • Propriétésles propriétés et leurs valeurs sur les enregistrements CRM, y compris l'historique des propriétés.
  • ÉvénementsÉvénements: données d'événements pour les événements HubSpot standard, tels que l'ouverture des emails, et les événements comportementaux personnalisés.
  • Listes: listes de contacts et de sociétés HubSpot (BETA).

En savoir plus sur Le modèle de données CRM de HubSpot  

Limiter et ordonner les données retournées

Lorsque vous construisez des requêtes, vous pouvez contrôler la quantité de données retournées, ainsi que l'ordre dans lequel elles sont retourné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 par ID de contact, vous pouvez construire votre requête comme suit :


SELECT objectTypeId, objectId, propriétés
FROM object_with_object_properties
WHERE objectTypeId = '0-1' (en anglais)
ORDER BY objectId
LIMITE 10 ;

Requêtes d'objets

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

Vous pouvez utiliser les ID d'objets suivants lors de vos requêtes :

Nom de l'objet ObjectTypeId
Contacts 0-1
Entreprises 0-2
Transactions 0-3
Engagement 0-4
Tickets 0-5
Lignes de transaction 0-8

Lesobjets personnalisés se verront attribuer un ID au moment de leur création, et seront identifiés comme 2-unique_ID. Par exemple, 2-12345. En savoir plus sur les définitions des types d'objets et d'événements.

objet_avec_propriétés_d'objet

Cette vue contient les données de vos enregistrements HubSpot. Les requêtes dans cette table renvoient une ligne pour chaque enregistrement d'un objet (par exemple, tous les enregistrements de contacts dans l'objet Contacts). Toutes les propriétés sont stockées dans la colonne Propriétés, qui est une colonne de type Variante Snowflake / JSON colonne. 

Cette vue peut renvoyer les colonnes suivantes :

Nom de la colonne Type Description
OBJECTTYPEID Varchar L'ID du type d'objet (par exemple, les contacts sont 0-1).
OBJECTID Nombre L'ID de l'enregistrement (par exemple, un enregistrement de contact avec un ID de 123752).
PROPRIÉTÉS Variante Les valeurs de propriété de l'enregistrement.
UPDATEDAT Horodatage La date et l'heure de la dernière mise à jour de l'enregistrement dans HubSpot. En savoir plus sur les types de données des colonnes.
INGESTEDAT Horodatage La date et l'heure auxquelles les données ont été ingérées pour la dernière fois par Snowflake. 

Exemple n° 1

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

Une requête :


SELECT objectTypeId, objectId, propriétés
FROM object_with_object_properties
WHERE objectTypeId = '0-1' (en anglais)


Les retours :

OBJECTTYPEID OBJECTID PROPRIÉTÉS
0-1 38960439 {"createdate" : "1504656970152"...}
0-1 321740651 {"createdate" : "1590183081949"...} 
0-1 98392101 {"createdate" : "1533566477279"...}
... ... ...

Exemple 2

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

Une requête :


SELECT

objectId,
properties:dealname::string AS dealname,
properties:dealstage::string AS dealstage,
properties:amount::number AS dealamount
FROM object_with_object_properties
WHERE objectTypeId = '0-3' ; LIMIT 3; ;
LIMITE 3 ;


Les retours :

OBJECTID DEALNAME DEALSTAGE DEALAMOUNT
38960439 Nom de l'opération 1
2021-10-12 13:49:35.219
2021-10-12 13:49:35.219
321740651 Nom de l'opération 1
2021-10-12 13:49:35.219
2021-10-12 13:49:35.219
98392101 Nom de l'opération 1
2021-10-12 13:49:35.219
2021-10-12 13:49:35.219

objets

Cette vue est un sous-ensemble des données de la table object_with_object_properties. Chaque ligne retournée renvoie l'ID de l'objet pour chaque enregistrement. Cette vue ne renvoie que les enregistrements existants. Lorsqu'un enregistrement est supprimé dans HubSpot, il est supprimé de cette vue. 

Cette vue peut être utile si votre compte a une grande quantité de données, ce qui conduit à ce que object_with_object_properties fonctionne lentement. L'utilisation de cette table avec la table 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 retournées.

Cette vue peut renvoyer les colonnes suivantes :

Nom de la colonne Type Description
OBJECTTYPEID Varchar L'ID du type d'objet (par exemple, les contacts sont 0-1).
OBJECTID Nombre L'ID de l'enregistrement (par exemple, un enregistrement de contact avec un ID de 123752).
INGESTEDAT Horodatage La date et l'heure auxquelles les données ont été ingérées pour la dernière fois par Snowflake. En savoir plus sur les types de données des colonnes.

Exemple n° 1

Récupérer toutes les fiches de contact.

Une requête :


SELECT objectTypeId, objectId
FROM objects
WHERE objectTypeId = '0-1' (en anglais)


Les retours :

OBJECTTYPEID OBJECTID
0-1 36721864
0-1 103580363
0-1 56047670
... ...

propriétés de l'objet

Cette table est un sous-ensemble de la table 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.

Cette table peut être utile si votre compte a une grande quantité de données, ce qui conduit à ce que object_with_object_properties fonctionne lentement. L'utilisation de cette table avec la table object_properties permet de répliquer les données dans object_with_object_properties, tout en contrôlant quelles propriétés sont retournées.

Cette vue peut renvoyer les colonnes suivantes :

Nom de la colonne Type Description
OBJECTTYPEID Varchar L'ID du type d'objet (par exemple, les contacts sont 0-1).
OBJECTID Nombre L'ID de l'enregistrement (par exemple, un enregistrement de contact avec un ID de 123752).
NOM Varchar Le nom de la propriété.
VALEUR Horodatage La valeur du bien.
UPDATEDAT Horodatage La date et l'heure de la dernière mise à jour de l'enregistrement dans HubSpot. En savoir plus sur les types de données des colonnes.
INGESTEDAT Horodatage La date et l'heure auxquelles les données ont été ingérées pour la dernière fois par Snowflake. 

Exemple n° 1

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

Une requête :


SELECT objectTypeId, objectId, name, value
FROM object_properties
WHERE objectTypeId = '0-1' AND name IN ('firstname', 'lastname', 'city')
AND name IN ('firstname', 'lastname', 'city')
ORDER BY objectId ;


Les retours :

OBJECTTYPEID OBJECTID NOM VALEUR
0-1 10401 prénom Brian
0-1 10401 city Dublin
0-1 10401 Nom Gallagher
0-1 23451 prénom Fernando
0-1 23451 Nom Fierro
0-1 25751 prénom Charles
... ... ... ...

Exemple n° 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.

Une requête :


SELECT objectId, firstname, lastname, lifecyclestage
FROM
(
SELECT objectId, name, value
FROM object_properties
WHERE objectTypeId = '0-1' AND name IN ('firstname', 'lastname', 'lifecyclestage')
AND name IN ('firstname', 'lastname', 'lifecyclestage')
)
PIVOT(MAX(value) FOR name IN ('firstname', 'lastname', 'lifecyclestage')) AS p(objectId, firstname, lastname, lifecyclestage) ;

 

Les retours :

OBJECTTYPEID OBJECTID PRÉNOM NOM DE FAMILLE CYCLE DE VIE
0-1 54325098 Hobbes Baron lead
0-1 96805401 Milo Partenaire Gold lead
0-1 6922028 Henri Riley lead
... ... ... ... ...

historique des propriétés de l'objet

Cette vue contient les valeurs historiques des propriétés. Pour les contacts, il contient les 45 valeurs les plus récentes. Pour tous les autres objets, il contient les 20 valeurs les plus récentes. 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é.

Cette vue peut renvoyer les colonnes suivantes :

Nom de la colonne Type Description
OBJECTTYPEID Varchar L'ID du type d'objet (par exemple, les contacts sont 0-1).
OBJECTID Nombre L'ID de l'enregistrement (par exemple, un enregistrement de contact avec un ID de 123752).
NOM Varchar Le nom de la propriété.
VALEUR Horodatage La valeur du bien.
UPDATEDAT Horodatage La date et l'heure de la dernière mise à jour des données dans HubSpot. En savoir plus sur les types de données des colonnes.
INGESTEDAT Horodatage La date et l'heure auxquelles les données ont été ingérées pour la dernière fois par Snowflake. 

Exemple n° 1

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

Une requête :


SELECT objectId, name, value, timestamp
FROM object_properties_history
Where objectTypeId = '0-1'
AND objectId = 585
AND name = 'hs_predictivescoringtier'
ORDER BY timestamp DESC ;

   
Les retours :

OBJECTTYPEID OBJECTID PRÉNOM NOM DE FAMILLE CYCLE DE VIE
0-1 54325098 Hobbes Baron lead
0-1 96805401 Milo Partenaire Gold lead
0-1 6922028 Henri Riley lead
... ... ... ... ...

Exemple n° 2

Récupère le nom actuel de tous les contacts qui ont eu un stade de cycle de vie d' Abonné.

Une requête :


SELECT
objectId,
properties:firstname::string AS firstname,
properties:lastname::string AS lastname
FROM object_with_object_properties
WHERE object_with_object_properties.objectTypeId = '0-1'
AND objectId IN (
SELECT objectId
FROM object_properties_history
WHEREobject_properties_history.objectTypeId = '0-1'
AND object_properties_history.name = "lifecyclestage" (étape du cycle de vie)
AND object_properties_history.value = 'subscriber' (abonné)
) ;


Les retours :

OBJECTID PRÉNOM NOM DE FAMILLE
54325098 Hobbes Baron
96805401 Milo Partenaire Gold
6922028 Henri Riley
... ... ...

Requêtes des associations

Découvrez ci-dessous comment interroger les associations, notamment les types d'associations disponibles entre les objets et les enregistrements qui sont actuellement associés. 

définitions d'association

Cette vue contient des informations sur tous les types d'association disponibles entre les objets HubSpot, avec une ligne par type d'association. Vous pouvez joindre cette table à la table des associations pour obtenir des informations sur les associations spécifiques aux enregistrements.

Il peut y avoir plusieurs types d'associations 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 vrai.

Cette vue peut renvoyer les colonnes suivantes :

Nom de la colonne Type Description
COMBINÉ ASSOCIATION-TYPEID Varchar L'identifiant unique de la définition de l'association.
CATÉGORIE Varchar La source du type d'association. L'un de : HUBSPOT_DEFINED, USER_DEFINED, INTEGRATOR_DEFINED
Identifiant Nombre L'identifiant de la définition de l'association dans sa catégorie.
FROMOBJECTTYPEID Varchar L'ID de l'objet qui est la source de la définition de l'association.
TOOBJECTTYPEID Varchar L'ID de l'objet qui est la destination de la définition d'association.
NOM Varchar Le nom de la définition de l'association.
ÉTIQUETTE Varchar Le label de la définition de l'association.
DÉFINITION DE L'ASSOCIATION PRINCIPALE Booléen Si la définition de l'association est le type principal. Lorsqu'elle est vraie, la définition est celle qu'HubSpot affiche sur les enregistrements associés.
INGESTEDAT Horodatage La date et l'heure auxquelles les données ont été ingérées pour la dernière fois par Snowflake. En savoir plus sur les types de données des colonnes.

Exemple n° 1 

Récupérer les types d'associations disponibles dans votre compte.

Une requête :


SELECT combinedAssociationTypeId, fromObjectTypeId, toObjectTypeId, name
FROM association_definitions
ORDER BY category, id

  
Les retours :

TYPE D'ASSOCIATION COMBINÉE FROMOBJECTTYPEID TOOBJECTTYPEID NOM
0-1 0-1 0-2 CONTACT_À_L'ENTREPRISE
0-2 0-2 0-1 ENTREPRISE_À_CONTACT
0-3 0-3 0-1 DEAL_TO_CONTACT
0-4 0-1 0-3 CONTACT_POUR_L'AFFAIRE
0-5 0-3 0-2 DEAL_TO_COMPANY
... ... ... ...

Exemple n° 2

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

Une requête :


SELECTcombinedAssociationTypeId, fromObjectTypeId, toObjectTypeId, name
FROM association_definitions
WHERE fromObjectTypeId = '0-3' AND toObjectTypeId = '0-2'
AND isMainAssociationDefinition = true

ORDER BY category, id


Les retours :

TYPE D'ASSOCIATION COMBINÉE FROMOBJECTTYPEID TOOBJECTTYPEID NOM
0-5 0-3 0-2 DEAL_TO_COMPANY
0-271 0-3 0-2 DEAL_TO_PRIMARY_COMPANY
0-341 0-3 0-2 DEAL_TO_COMAPNY_UNLABELED

associations

Cette vue contient des informations sur les associations entre des enregistrements spécifiques. Chaque ligne représente une association d'un objet à un autre objet. Des lignes peuvent être présentes dans cette table même si les enregistrements référencés ont été supprimés. Vous pouvez vérifier si des enregistrements existent en faisant une jointure avec la table des objets.

Cette vue peut renvoyer les colonnes suivantes :

Nom de la colonne Type Description
COMBINÉ ASSOCIATION-TYPEID Varchar L'identifiant unique de la définition de l'association.
FROMOBJECTID Nombre L'ID de l'objet source.
TOOBJECTID Nombre L'ID de l'objet de destination.
INGESTEDAT Horodatage La date et l'heure auxquelles les données ont été ingérées pour la dernière fois par Snowflake. En savoir plus sur les types de données des colonnes.

Exemple n° 1

Récupérer tous les contrats et contacts associés.

Une requête :


SELECT combinedAssociationTypeId, fromObjectId, toObjectId
FROM associations
WHERE combinedAssociationTypeId = '0-5' (association combinée)

  
Les retours

TYPE D'ASSOCIATION COMBINÉE FROMOBJECTID TOOBJECTID
0-5 6626541373 233620335
0-5 6616436082 3866015468
0-5 6690805943 7132752747
... ... ...

Exemple n° 2 

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

Une requête :


SELECT combinedAssociationTypeId, fromObjectId, toObjectId
FROM associations
WHERE associationCategory = "HUBSPOT_DEFINED" (catégorie d'association)
AND combinedAssociationTypeId = '0-15' (en anglais)
AND fromObjectId = 3005 ;


Les retours :

TYPE D'ASSOCIATION COMBINÉE FROMOBJECTID TOOBJECTID
0-5 6626541373 233620335

Exemple 3 

Récupérer toutes les transactions associées à un contact spécifique (ID du contact : 4464). Au lieu de coder en dur combinedAssociationTypeId, cet exemple joint avec association_definitions.

Une requête :


SELECT combinedAssociationType, fromObjectId, toObjectId,
FROM associations
WHERE
combinedAssociationTypeId = (
SELECT combinedAssociationTypeId
FROM association_definitions
WHERE fromObjectTypeId = '0-1' AND toObjectTypeId = '0-3')
AND toObjectTypeId = "0-3
AND isMainAssociationDefinition)
AND fromObjectId = 4464 ;


Les retours :

TYPE D'ASSOCIATION COMBINÉE FROMOBJECTID TOOBJECTID
0-5 6626541373 233620335

propriétaires

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

Cette vue peut renvoyer les colonnes suivantes :

Nom de la colonne Type Description
OWNERID Nombre L'ID du propriétaire de l'utilisateur.
USERID Nombre L'ID utilisateur de l'utilisateur. Les utilisateurs avec NULL dans cette colonne ont été supprimés.
E-MAIL Varchar L'adresse électronique de l'utilisateur.
PRÉNOM Varchar Le prénom de l'utilisateur.
NOM DE FAMILLE Varchar Le nom de famille de l'utilisateur.
ISACTIVE Booléen Si l'utilisateur a été supprimé.
CREATEDAT Horodatage La date et l'heure auxquelles l'utilisateur a été créé dans HubSpot. Voir les types de données de colonne pour plus d'informations.
UPDATEDAT Horodatage La date et l'heure de la dernière mise à jour de l'utilisateur dans HubSpot. Voir les types de données de colonne pour plus d'informations.

Exemple n° 1 

Récupérer tous les utilisateurs. Le filtre WHERE isActive = true supprime les utilisateurs supprimés des données retournées.

Une requête :


SELECT ownerId, userId, email, firstname, lastname
FROM owners
WHERE isActive = true

  
Les retours

OWNERID ACTIVEUSERID EMAIL PRÉNOM NOM DE FAMILLE
29584574 4621126 233620335 Hobbes Baron
30532717 4874784 3866015468 Pablo Walters
30580321 925511 7132752747 Milo Partenaire Gold
... ... ... ... ...

Exemple n° 2

Recherche d'un propriétaire spécifique par son ID.

Une requête :


SELECT ownerId, userId, email, firstname, lastname
FROM propriétaires
WHERE ownerId = 29584574;


Retours

OWNERID ACTIVEUSERID EMAIL PRÉNOM NOM DE FAMILLE
29584574 4621126 233620335 Hobbes Baron

Exemple 3

Récupérer tous les contacts et leurs propriétaires. Cette requête joint les enregistrements aux propriétaires avec object_with_object_properties et la propriété de contact hubspot_owner_id.


SELECT
contact.objectId contact_id,
contact.properties:firstname::string contact_firstname,
contact.properties:lastname::string contact_lastname,
contact.properties:hubspot_owner_id::number contact_hubspot_owner_id,
owner.firstname owner_firstname,
nom de famille du propriétaire owner_lastname,
email propriétaire_email propriétaire_email
FROM object_with_object_properties contact
inner join owners owner on contact.properties:hubspot_owner_id::number = owner.ownerId
where objectTypeId = '0-1' ;


Retours

CONTACTID CONTACT_PRÉNOM CONTACT_PRÉNOM CONTACT_HUBSPOT_OWNER_ID PRÉNOM DU PROPRIÉTAIRE PROPRIÉTAIRE_NOM DE FAMILLE OWNER_EMAIL
113834202 Richard Greenfield 29584574 Hobbes Baron hobbes.b@business.com
53540801 Ford Karl 30241125 Milo Partenaire Gold milo.g@business.com
... ... ... ... ... ... ...

Requêtes sur les pipelines

Vous apprendrez ci-dessous comment interroger les données relatives au pipeline des transactions et des tickets, telles que les pipelines disponibles dans votre compte et leurs étapes. 

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_with_object_properties aux données pipelines.

aux pipelines

Cette vue 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 :

Nom de la colonne Type Description
PIPELINEID Varchar L'ID du pipeline.
OBJECTTYPEID Varchar L'ID de l'objet que le pipeline peut contenir (par exemple, des offres ou des tickets).
ÉTIQUETTE Varchar Le nom du pipeline dans HubSpot.
DISPLAYORDER Nombre L'ordre dans lequel le pipeline est affiché dans HubSpot.
ARCHIVÉ Booléen Si le pipeline a été supprimé.
CREATEDAT Horodatage Quand le pipeline a été créé.
UPDATEDAT Horodatage La date et l'heure de la dernière mise à jour des données dans HubSpot. En savoir plus sur les types de données des colonnes.
INGESTEDAT Horodatage La date et l'heure auxquelles les données ont été ingérées pour la dernière fois par Snowflake. 

Exemple n° 1

Récupérez tous les pipelines d'affaires disponibles, classés par leur ordre dans HubSpot.

Une requête :


SELECT objectTypeId, pipelineId, label
FROM pipelines
WHERE objectTypeId = '0-3' (où le type d'objet est indiqué)
AND not archived
ORDER BY displayorder ;

  
Les retours

OBJECTTYPEID PIPELINEID ÉTIQUETTE
0-3 1bed503c-37f7-4f51-9d40-7598902673f4 Pipeline de vente
0-3 12659678 Licences Pipeline
0-3 75e28846-ad0d-4be2-a027-5e1da6590b98 Nouvelle entreprise
... ... ...

Exemple n° 2

Récupérer les transactions dans un pipeline spécifique. Joint l' objet_avec_les_propriétés_de_l'objet et les pipelines.

Une requête :


SELECT

deals.objectId deal_id,
deals.properties:dealname::varchar deal_name,
pipelines.label nom_du_pipeline
FROM object_with_object_properties deals
INNER JOIN pipelines
ON deals.objectTypeId = pipelines.objectTypeId
AND deals.properties:pipeline::string = pipelines.pipelineid
WHERE deals.objecttypeId = '0-3'
AND pipelines.objectTypeId = '0-3' ;


Retours

DEAL_ID NOM_DEAL NOM_DU_PIPELINE
605140072 Meowmix Global Signup Pipeline de vente
605457408 Rebranding de Friskies Pipeline de vente
604362473 Fresh Step App Build Pipeline de vente

étapes_du_pipeline

Cette vue contient des informations sur les étapes individuelles d'un pipeline. Identifiez les étapes en combinant l'ID du type d'objet, l'ID du pipeline et l'ID de l'étape. Lorsque vous vous joignez à des pipelines, utilisez l'ID du type d'objet et l'ID du pipeline.

Ce tableau peut renvoyer les colonnes suivantes :

Nom de la colonne Type Description
PIPELINEID Varchar L'ID du pipeline.
OBJECTTYPEID Varchar L'ID de l'objet que le pipeline peut contenir (par exemple, des offres ou des tickets).
ÉTIQUETTE Varchar Le nom du pipeline dans HubSpot.
DISPLAYORDER Nombre L'ordre dans lequel le pipeline est affiché dans HubSpot.
ARCHIVÉ Booléen Si le pipeline a été supprimé.
UPDATEDAT Horodatage La date et l'heure de la dernière mise à jour des données dans HubSpot. En savoir plus sur les types de données des colonnes.
INGESTEDAT Horodatage La date et l'heure auxquelles les données ont été ingérées pour la dernière fois par Snowflake. 

Exemple n° 1 

Récupérer les étapes du pipeline d'une transaction nommée pipeline de vente.

Une requête :


SELECT pipelineid, stageId, label
FROM pipeline_stages
WHERE not archived
AND pipelineid = (
SELECT pipelineid
FROM pipelines
WHERE objectTypeId = '0-3')
AND not archived
AND label = 'Sales Pipeline' LIMIT 1)
ORDER BY displayorder ;

  
Les retours

PIPELINEID STAGEID ÉTIQUETTE
941650 941651 Contacté
941650 941652 Rendez-vous prévu
941650 941653 Facture envoyée
... ... ...

Exemple n° 2

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

Une requête :


SELECT

deals.objectId deal_id,
deals.properties:dealname::varchar deal_name,
pipelines.label nom_du_pipeline,
pipeline_stages.label pipeline_stage_name
FROM object_with_object_properties deals
INNER JOIN pipelines
ON deals.objectTypeId = pipelines.objectTypeId
AND deals.properties:pipeline::string = pipelines.pipelineid
INNER JOIN pipeline_stages
ON deals.objectTypeId = pipeline_stages.pipelineid
AND deals.properties:pipeline::string = pipeline_stages.pipelineid
AND deals.properties:dealstage::string = pipeline_stages.stageId
WHERE deals.objecttypeId = '0-3' ;


Retours

DEAL_ID NOM_DEAL NOM_DU_PIPELINE NOM DU PIPELINE_STAGE
605140072 Meowmix Global Signup Pipeline de vente Contrat envoyé
605457408 Rebranding de Friskies Pipeline de vente Rendez-vous prévu
604362473 Fresh Step App Build Pipeline de vente Contrat signé
... ... ... ...

définitions des propriétés

Cette vue contient des informations sur les propriétés des objets et des événements de votre compte HubSpot. Les propriétés des événements comprennent les événements standard, tels que l'ouverture et le clic des e-mails, et les propriétés des événements comportementaux personnalisés. Ces informations peuvent être utiles pour définir les valeurs trouvées dans les propriétés des objets et les données des événements.

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

Cette vue peut renvoyer les colonnes suivantes :

Nom de la colonne Type Description
OBJECTYPEID Varchar L'ID de l'objet auquel l'événement se rapporte.
NOM Varchar Le nom interne de la propriété.
ÉTIQUETTE Varchar L'étiquette de la propriété.
DESCRIPTION Varchar La description de la propriété.
TYPE Varchar Le type de la propriété (par exemple, chaîne, nombre, date).
FIELDTYPE Varchar Le type de champ de la propriété. Définit comment la propriété s'affiche dans HubSpot et sur les formulaires (par exemple, case à cocher, sélection).
DISPLAYORDER Nombre L'ordre d'affichage de la propriété.
NOM DU GROUPE Varchar Le nom du groupe de la propriété.
OPTIONS Variante Pour les propriétés de type énumération, un tableau des options de la propriété, y compris les attributs de chaque option (par exemple, ordre d'affichage, étiquette).
CREATEDUSERID Nombre L'ID de l'utilisateur qui a créé la propriété.
TYPE D'OBJET RÉFÉRENCÉ Varchar Le type d'objet auquel la propriété fait référence. Les propriétés de type propriétaire renverront une valeur de type OWNER.
CALCULÉ Booléen Si la propriété est une propriété calculée.
OPTIONS EXTERNES Booléen Si les options du bien sont définies dans un système externe.
A UNE VALEUR UNIQUE Booléen Si les valeurs de la propriété sont uniques. Ne peut être défini que lors de la création d'une propriété via l'API.
HIDDEN Booléen Si la propriété est cachée dans HubSpot.
SYMBOLE D'EXPOSITION Booléen Si la valeur d'une propriété numérique est formatée comme une devise.
FORMFIELD Booléen Si cette propriété peut être utilisée dans les formulaires.
DÉFINITION EN LECTURE SEULE Booléen Si la propriété peut être modifiée dans HubSpot.
READONLYVALUE Booléen Si la valeur de la propriété peut être modifiée dans HubSpot.
HUBSPOTDÉFINI Booléen Si le bien a été créé par HubSpot ou par un utilisateur.
ARCHIVÉ Booléen Si la propriété a été supprimée.
CREATEDAT Horodatage La date et l'heure auxquelles le bien a été créé dans HubSpot.
UPDATEDAT Horodatage La date et l'heure de la dernière mise à jour des données dans HubSpot. En savoir plus sur les types de données des colonnes.
INGESTEDAT Horodatage La date et l'heure auxquelles les données ont été ingérées pour la dernière fois par Snowflake. 

Exemple n° 1

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

Une requête :


SELECT nom, étiquette, description
FROM property_definitions
Où objectTypeId = '0-1'

   
Les retours :

NOM ÉTIQUETTE DESCRIPTION
étape_sql_entrée Entrée dans la phase SQL Compter les jours de l'étape SQL.
first_conversion_event_name
Première conversion Le premier formulaire que ce contact a soumis.
adresse Adresse postale L'adresse du contact.

Requêtes d'événements

Les événements comprennent les événements standard de HubSpot et les événements comportementaux personnalisés. Chaque événement a sa propre vue, étiquetée comme Events_eventname.

Les événements disponibles sont les suivants :

  • Événements de clics publicitaires(events_ad_clicked)
  • Ouvertures et clics d'e-mails(events_opened_email_V2, events_clicked_link_in_email_v2, etc.)
  • Analyse du Web(events_visited_page)

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é de l'événement. Tous les événements renverront les colonnes suivantes :

Nom de la colonne Type Description
EVENTTYPEID Varchar L'ID du pipeline.
Identifiant Varchar L'ID de l'objet que le pipeline peut contenir (par exemple, des offres ou des tickets).
OBJECTTYPEID Varchar Le type d'objet qui a réalisé l'événement. Par exemple, un clic sur le lien d'un courriel affichera 0-1 dans cette colonne, représentant l'objet contacts.
OBJECTID Nombre L'ID de l'enregistrement qui a terminé l'événement.
A EU LIEU À LA DATE INDIQUÉE SUR Nombre Un nombre représentant la date à laquelle l'événement s'est produit. Contient les mêmes données que la colonne OCCUREDAT, mais formatées comme un nombre et utilisées comme une partie de la clé de cluster de la table. Dans la plupart des cas, vous pouvez utiliser l'horodatage OCCUREDAT à la place de ce numéro.
OCCUREDAT Horodatage Quand l'événement s'est produit.
INGESTEDAT Horodatage La date et l'heure auxquelles les données ont été ingérées pour la dernière fois par Snowflake. En savoir plus sur les types de données des colonnes.
PROPRIÉTÉ_* Varchar Colonnes individuelles contenant les propriétés de l'événement.

Exemple n° 1

Récupérer les 50 événements de clics de courriel les plus récents.

Une requête :


SELECT eventTypeId, objectTypeId, objectId, occuredAt, hs_click_raw_url
FROM events_clicked_link_in_email_V2
ORDER BY occuredAt

LIMITE 50 ;


Retours

EVENTTYPEID OBJECTTYPEID OBJECTID OCCUREDAT HS_CLICK_RAW_URL
4-666288 0-1 45318579 2016-08-04 21:06:43.245 http://website.com?utm_campaign=Launch&utm_source=hs_email&utm_medium=email&utm_content=32520579
4-666288 0-1 80701 2016-08-29 13:31:28.622 https://cta-image-cms2.hubspot.com/ctas/v2/public/cs/ci/?pg=f0f6585a-08fc-4273-8422-49cfaddcf8d8&pid=1976760&ecid=ACsprvtkRbakerw4BiWlaDL7xFAqau1aW9m1_PAqSfQiWarY69X7Ds42zHGYTCfhHJLrXUP86Nxu
4-666288 0-1 26146013 2017-11-30 14:27:11.528 https://hubs.ly/H097a37a?utm_source=hs_email&utm_medium=email&utm_content=58251290
... ... ... ... ...

Exemple n° 2

Récupérer tous les événements de clics d'email par les contacts qui ont cliqué. Cette requête permet d'obtenir des données de contact en rejoignant l' objet_with_object_properties.

Une requête :


SELECT
click.timestamp click_timestamp,
click.property_hs_click_raw_url click_url,
contact.properties:firstname::varchar contact_firstname,
contact.properties:lastname::varchar contact_lastname
FROM events_clicked_link_in_email_V2 click
LEFT JOIN object_with_object_properties contact
ON click.objectTypeId = contact.objectTypeId
AND click.objectId = contact.objectId
LIMIT 3 ;


Retours

CLICK_TIMESTAMP CLICK_URL CONTACT_PRÉNOM CONTACT_PRÉNOM
2019-01-04 22:35:41.264 https://help.website.com/articles/tutorial/how-to-use-email-tool?utm_source=hs_automation&utm_medium=email&utm_content=68042217 Hobbes Baron
2018-11-08 09:37:41.400 https://www.website.net/webinar-case-study?utm_source=hs_automation&utm_medium=email&utm_content=55200164 Milo Partenaire Gold
2018-11-08 09:37:41.426 https://www.website.net/contact?utm_source=hs_automation&utm_medium=email&utm_content=55200164 Harlow Villari
... ... ... ...

définitions des types d'objets et d'événements

Cette vue contient les définitions de tous les objets et événements disponibles dans votre compte HubSpot.

Cette vue peut renvoyer les colonnes suivantes :

Nom de la colonne Type Description
OBJECTTYPEID Varchar L'ID de l'objet que le pipeline peut contenir (par exemple, des offres ou des tickets).
NOM COMPLET Varchar Le nom de l'objet ou de l'événement.
INGESTEDAT Horodatage La date et l'heure auxquelles les données ont été ingérées pour la dernière fois par Snowflake. En savoir plus sur les types de données des colonnes.

Exemple n° 1

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

Une requête :


SELECT objectTypeId, fullyQualifiedName
FROM object_and_event_type_definitions ;

  
Les retours

OBJECTTYPEID NOM COMPLET
0-1 CONTACT
0-2 ENTREPRISE
0-3 TRANSACTION
0-4 ENGAGEMENT
0-5 TICKET
0-8 LINE_ITEM
0-11 CONVERSATION
... ...

Listes de requêtes (BETA)

Vous apprendrez ci-dessous comment interroger vos listes, telles que les listes de contacts et de sociétés disponibles et les enregistrements inclus dans ces listes.

listes

Cette vue contient des informations sur les listes de contacts et d'entreprises 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 enregistrements qu'elle contient. Ne contient pas d'informations sur les enregistrements individuels de chaque liste (voir list_membership). 

Cette vue peut renvoyer les colonnes suivantes :

Nom de la colonne Type Description
OBJECTTYPEID Varchar Le type d'enregistrements dans la liste (par exemple, contact ou société).
LISTID Nombre L'ID de la liste. Jointure à la colonne LISTID de la table list-memberships.
CLASSICLISTID Nombre Un ID spécifique aux listes de contacts qui correspond à l'ID dans l'URL de la liste dans HubSpot.
LISTNAME Varchar Le nom de la liste.
LISTSIZE Nombre Le nombre d'enregistrements dans la liste.
CRÉÉ PAR L'UTILISATEUR Nombre L'ID de l'utilisateur qui a créé la liste.
CREATEDAT Horodatage Lorsque la liste a été créée dans HubSpot.
MIS À JOUR PAR L'IDENTIFIANT DE L'UTILISATEUR Nombre L'ID de l'utilisateur qui a le plus récemment mis à jour la liste.
UPDATEDAT Horodatage La date et l'heure auxquelles la date a été mise à jour pour la dernière fois dans HubSpot. En savoir plus sur les types de données des colonnes
INGESTEDAT Horodatage La date et l'heure auxquelles les données ont été ingérées pour la dernière fois par Snowflake.

Exemple n° 1

Récupérer toutes les listes de contacts.

Une requête :


SELECT listId, listName, listSize
FROM listes
WHERE objectTypeId = '0-1' ;

  
Les retours

LISTID LISTNAME LISTSIZE
118131 Sensibilisation hebdomadaire 103
66156 Abonnés au blog 455
771852 Principaux abonnés 2021 37
... ... ...

Exemple n° 2

Récupérer une liste de contacts spécifique nommée Top subscribers 2021

Une requête :


SELECT listId, listName, listSize
FROM listes
WHERE objectTypeId = '0-1'
AND
listName = 'Top subscribers 2021' ;


Retours

LISTID LISTNAME LISTSIZE
771852 Principaux abonnés 2021 37

liste_de_membres

Cette vue 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, le tableau renverra 500 lignes. 

Ne contient que les ID des listes et les ID des objets. Pour plus d'informations, rejoignez le tableau des listes.

Cette vue peut renvoyer les colonnes suivantes :

Nom de la colonne Type Description
LISTID Varchar L'ID de la liste. Jointure à la colonne HS_LIST_ID de la table des listes.
OBJECTID Varchar L'ID de l'enregistrement dans la liste.
UPDATEDAT Horodatage La date et l'heure de la dernière mise à jour des données dans HubSpot. En savoir plus sur les types de données des colonnes.
INGESTEDAT Horodatage La date et l'heure auxquelles les données ont été ingérées pour la dernière fois par Snowflake. 

Exemple n° 1

Récupérer les ID de tous les contacts de la liste Top subscribers 2021.

Une requête :


SELECT objectId
FROM list_memberships
INNER JOIN lists
ON list_memberships.listId = lists.listId
WHERE lists.objectTypeId = '0-1' ; AND lists.name = 'Top Subscribers 2021'
AND lists.name = 'Top Subscribers 2021' ;

  
Les retours

OBJECTID
54325098
96805401
6922028
...

Exemple n° 2

Récupérer les noms et prénoms des détails des contacts dans le Top abonnés 2021

Une requête :


SELECT
contact.objectId AS objectid,
contact.properties:firstname::string AS firstname,
contact.properties:lastname::string AS lastname
FROM objet_avec_propriétés_objet contact
INNER JOIN list_memberships ON contact.objectId = list_memberships.objectId
INNER JOIN lists ON list_memberships.listId = lists.listId
WHERE
contact.objectTypeId = '0-1' AND lists.objectTypeId = lists.listId
AND lists.objectTypeId = '0-1'
AND lists.listName = 'Top Subscribers 2021' (Les meilleurs abonnés 2021)


Retours

OBJECTID PRÉNOM NOM DE FAMILLE
54325098 Hobbes Baron
96805401 Milo Partenaire Gold
6922028 Henri Riley
... ... ...

Types de données des colonnes

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 une table ou une vue donnée dans Snowflake en sélectionnant la vue dans la barre latérale gauche.

snowflake-sidebar-view-column-details0


Pour obtenir une colonne spécifique, incluez cette colonne dans le champ SELECT de votre requête. Par exemple, la requête suivante renvoie uniquement les colonnes FROMOBJECTID et TOOBJECTID:


SELECT
fromObjectTypeId, toObjectTypeId
FROM association_definitions

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, voir 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 "sociétés" 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 identifiants d'objets et d'événements de votre compte en utilisant la vue object_and_event_type_definitions.
  • OBJECTID : un nombre BIGINT qui représente un enregistrement unique d'un type d'objet donné dans votre compte HubSpot. Pour identifier un enregistrement, vous devez utiliser à la fois l'ID du type d'objet et l'ID de l'objet.
  • INGESTEDAT : l'horodatage du moment où une ligne de données a été ajoutée à Snowflake, représenté par une valeur TIMESTAMP_NTZ. Sans rapport 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'un enregistrement 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.