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: juillet 25, 2022

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 via SQL et peuvent être utilisées pour récupérer des données HubSpot telles que :

  • Objets : objets standards et personnalisés, tels que des contacts, des entreprises et des produits. 
  • Fiches d'informations : fiches d'informations individuelles, telles qu'un contact ou une entreprise
  • Associations : tous les types d'association disponibles et les fiches d'informations actuellement associées.
  • 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 : les propriétés et leurs valeurs sur les enregistrements CRM, y compris l'historique des propriétés.
  • Événements : données d'événements pour les événements HubSpot standards, tels que les ouvertures d'e-mail et les événements comportementaux personnalisés.
  • Listes : Contacts HubSpot et listes d'entreprises (BÊTA).

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

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.

    snowflake-worksheet-settings0
  • 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_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 tableau d'abord via un processus ETL, puis d'interroger ce tableau.

      Remarque : ce schéma n'est actuellement disponible que si la région de votre compte Snowflake correspond à celle du compte Snowflake de HubSpot. Pour les comptes HubSpot se trouvant dans le centre de données de l'UE, cela signifie EU_CENTRAL_1_AWS. Pour tous les autres comptes HubSpot, cela signifie US_EAST_1_AWS.

      • V2_DAILY (bêta) : le schéma quotidien pour interroger les données basées sur les tableaux. 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.

      snowflake-worksheet-settings-window0

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'

Présentation des données

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

  • Objets : objets standards et personnalisés, tels que des contacts, des entreprises et des produits. 
  • Fiches d'informations : fiches d'informations individuelles, telles qu'un contact ou une entreprise
  • Associations : tous les types d'association disponibles et les fiches d'informations actuellement associées.
  • 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 : les propriétés et leurs valeurs sur les enregistrements CRM, y compris l'historique des propriétés.
  • Événements : données d'événements pour les événements HubSpot standards, tels que les ouvertures d'e-mail et les événements comportementaux personnalisés.
  • Listes : Contacts HubSpot et listes d'entreprises (BÊTA).

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

Limiter et ordonner les données renvoyées

Lorsque vous construisez des requêtes, vous pouvez contrôler la quantité de données renvoyé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 selon l'ID de contact, vous pouvez construire votre requête comme suit :


SELECT objectTypeId, objectId, properties
FROM object_with_object_properties
WHERE objectTypeId = '0-1'
ORDER BY objectId
LIMIT 10;

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. 

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

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.

object_with_object_properties

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

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 Numéro L'ID de la fiche d'informations (par exemple, une fiche d'informations de contact avec l'ID 123752).
PROPERTIES Variante Les valeurs de propriété de la fiche d'informations.
UPDATEDAT Horodatage La date et l'heure de la dernière mise à jour de la fiche d'informations dans HubSpot. Découvrez-en davantage 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 1

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

Requête :


SELECT objectTypeId, objectId, properties
FROM object_with_object_properties
WHERE objectTypeId = '0-1'


Renvoie :

OBJECTTYPEID OBJECTID PROPERTIES
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 la transaction pour un maximum de trois transactions.

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;


Renvoie :

OBJECTID DEALNAME DEALSTAGE DEALAMOUNT
38960439 Nom de la transaction 1
2021-10-12 13:49:35.219
2021-10-12 13:49:35.219
321740651 Nom de la transaction 1
2021-10-12 13:49:35.219
2021-10-12 13:49:35.219
98392101 Nom de la transaction 1
2021-10-12 13:49:35.219
2021-10-12 13:49:35.219

objects

Cette vue est un sous-ensemble des données du tableau 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. 

Cette vue peut être utile si votre compte dispose d'une grande quantité de données, ce qui conduit à une exécution lente de object_with_object_properties. L'utilisation de ce tableau avec le tableau 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 Numéro L'ID de la fiche d'informations (par exemple, une fiche d'informations de contact avec l'ID 123752).
INGESTEDAT Horodatage La date et l'heure auxquelles les données ont été ingérées pour la dernière fois par Snowflake. Découvrez-en davantage sur les types de données des colonnes.

Exemple 1

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

Requête :


SELECT objectTypeId, objectId
FROM objects
WHERE objectTypeId = '0-1'


Renvoie :

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

object_properties

Ce tableau est un sous-ensemble du tableau object_with_object_properties. Chaque ligne contient la valeur actuelle de la propriété définie sur une fiche d'informations donnée. Par exemple, un contact aura une ligne pour sa propriété Prénom et une ligne pour sa propriété Nom. Si une fiche d'informations 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.

Ce tableau peut être utile si votre compte dispose d'une grande quantité de données, ce qui conduit à une exécution lente de object_with_object_properties. L'utilisation de ce tableau avec le tableau 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 Numéro L'ID de la fiche d'informations (par exemple, une fiche d'informations de contact avec l'ID 123752).
NAME Varchar Le nom de la propriété.
VALUE Horodatage La valeur de la propriété.
UPDATEDAT Horodatage La date et l'heure de la dernière mise à jour de la fiche d'informations dans HubSpot. Découvrez-en davantage 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 1

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

Requête :


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


Renvoie :

OBJECTTYPEID OBJECTID NAME VALUE
0-1 10401 firstname Brian
0-1 10401 city Dublin
0-1 10401 lastname Gallagher
0-1 23451 firstname Fernando
0-1 23451 lastname Fierro
0-1 25751 firstname Charles
... ... ... ...

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 :


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

 

Renvoie :

OBJECTTYPEID OBJECTID FIRSTNAME LASTNAME LIFECYCLESTAGE
0-1 54325098 Hobbes Baron lead
0-1 96805401 Milo Gold lead
0-1 6922028 Henry Riley lead
... ... ... ... ...

object_properties_history

Cette vue 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é.

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 Numéro L'ID de la fiche d'informations (par exemple, une fiche d'informations de contact avec l'ID 123752).
NAME Varchar Le nom de la propriété.
VALUE Horodatage La valeur de la propriété.
UPDATEDAT Horodatage La date et l'heure de la dernière mise à jour des données dans HubSpot. Découvrez-en davantage 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 1

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

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;

   
Renvoie :

OBJECTTYPEID OBJECTID FIRSTNAME LASTNAME LIFECYCLESTAGE
0-1 54325098 Hobbes Baron lead
0-1 96805401 Milo Gold lead
0-1 6922028 Henry Riley lead
... ... ... ... ...

Exemple 2

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

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'
AND object_properties_history.value = 'subscriber'
);


Renvoie :

OBJECTID FIRSTNAME LASTNAME
54325098 Hobbes Baron
96805401 Milo Gold
6922028 Henry Riley
... ... ...

Requêtes d'associations

Découvrez ci-dessous comment interroger les associations, notamment les types d'association disponibles entre les objets et les fiches d'informations actuellement associées. 

association_definitions

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 ce tableau au tableau associations pour obtenir des informations sur les associations spécifiques aux fiches d'informations.

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

Cette vue peut renvoyer les colonnes suivantes :

Nom de la colonne Type Description
CombinéASSOCIATIONTYPEID Varchar L'identifiant unique de la définition d'association.
CATÉGORIE Varchar La source du type d'association. L'un des éléments suivants : HUBSPOT_DEFINED, USER_DEFINED, INTEGRATOR_DEFINED
Identifiant Numéro L'identifiant de la définition d'association dans sa catégorie.
FROMOBJECTTYPEID Varchar L'ID de l'objet qui est la source de la définition d'association.
TOOBJECTTYPEID Varchar L'ID de l'objet qui est la destination de la définition d'association.
NAME Varchar Le nom de la définition d'association.
LABEL Varchar Le libellé de la définition d'association.
ISMAINASSOCIATIONDEFINITION Booléen Indique si la définition d'association est le type principal. Lorsque la valeur est true, la définition est celle affichée par HubSpot sur les fiches d'informations associées.
INGESTEDAT Horodatage La date et l'heure auxquelles les données ont été ingérées pour la dernière fois par Snowflake. Découvrez-en davantage sur les types de données des colonnes.

Exemple 1 

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

Requête :


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

  
Renvoie :

COMBINEDASSOCIATIONTYPE FROMOBJECTTYPEID TOOBJECTTYPEID NAME
0-1 0-1 0-2 CONTACT_TO_COMPANY
0-2 0-2 0-1 COMPANY_TO_CONTACT
0-3 0-3 0-1 DEAL_TO_CONTACT
0-4 0-1 0-3 CONTACT_TO_DEAL
0-5 0-3 0-2 DEAL_TO_COMPANY
... ... ... ...

Exemple 2

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

Requête :


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

ORDER BY category, id


Renvoie :

COMBINEDASSOCIATIONTYPE FROMOBJECTTYPEID TOOBJECTTYPEID NAME
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 fiches d'informations spécifiques. Chaque ligne représente une association d'un objet à un autre objet. Des lignes peuvent être présentes dans ce tableau, même si les fiches d'informations mentionnées ont été supprimées. Vous pouvez vérifier si des fiches d'informations existent en faisant une association avec le tableau objects.

Cette vue peut renvoyer les colonnes suivantes :

Nom de la colonne Type Description
CombinéASSOCIATIONTYPEID Varchar L'identifiant unique de la définition d'association.
FROMOBJECTID Numéro L'ID de l'objet source.
TOOBJECTID Numéro 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. Découvrez-en davantage sur les types de données des colonnes.

Exemple 1

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

Requête :


SELECT combinedAssociationTypeId, fromObjectId, toObjectId
FROM associations
WHERE combinedAssociationTypeId = '0-5'

  
Renvoie :

COMBINEDASSOCIATIONTYPE FROMOBJECTID TOOBJECTID
0-5 6626541373 233620335
0-5 6616436082 3866015468
0-5 6690805943 7132752747
... ... ...

Exemple 2 

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

Requête :


SELECT combinedAssociationTypeId, fromObjectId, toObjectId
FROM associations
WHERE associationCategory = 'HUBSPOT_DEFINED'
AND combinedAssociationTypeId = '0-15'
AND fromObjectId = 3005;


Renvoie :

COMBINEDASSOCIATIONTYPE FROMOBJECTID TOOBJECTID
0-5 6626541373 233620335

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 :


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


Renvoie :

COMBINEDASSOCIATIONTYPE FROMOBJECTID TOOBJECTID
0-5 6626541373 233620335

Requêtes du propriétaire

owners

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

Cette vue peut renvoyer les colonnes suivantes :

Nom de la colonne Type Description
OWNERID Numéro L'ID du propriétaire de l'utilisateur.
USERID Numéro L'ID d'utilisateur de l'utilisateur. Les utilisateurs avec la valeur NULL dans cette colonne ont été supprimés.
EMAIL Varchar L'adresse e-mail de l'utilisateur.
FIRSTNAME Varchar Le prénom de l'utilisateur.
LASTNAME Varchar Le nom de l'utilisateur.
ISACTIVE Booléen Indique si l'utilisateur a été supprimé.
CREATEDAT Horodatage La date et l'heure auxquelles l'utilisateur a été créé dans HubSpot. Consultez 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. Consultez les types de données de colonne pour plus d'informations.

Exemple 1 

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

Requête :


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

  
Renvoie :

OWNERID ACTIVEUSERID EMAIL FIRSTNAME LASTNAME
29584574 4621126 233620335 Hobbes Baron
30532717 4874784 3866015468 Pablo Walters
30580321 925511 7132752747 Milo Gold
... ... ... ... ...

Exemple 2

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

Requête :


SELECT ownerId, userId, email, firstname, lastname
FROM owners
WHERE ownerId = 29584574;


Renvoie :

OWNERID ACTIVEUSERID EMAIL FIRSTNAME LASTNAME
29584574 4621126 233620335 Hobbes Baron

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.


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,
owner.lastname owner_lastname,
owner.email owner_email
FROM object_with_object_properties contact
inner join owners owner on contact.properties:hubspot_owner_id::number = owner.ownerId
where objectTypeId = '0-1';


Renvoie :

CONTACTID CONTACT_FIRSTNAME CONTACT_LASTNAME CONTACT_HUBSPOT_OWNER_ID OWNER_FIRSTNAME OWNER_LASTNAME OWNER_EMAIL
113834202 Richard Greenfield 29584574 Hobbes Baron hobbes.b@business.com
53540801 Ford Karl 30241125 Milo Gold milo.g@business.com
... ... ... ... ... ... ...

Requêtes de pipeline

Découvrez ci-dessous comment interroger les données relatives aux pipelines de transactions et des ticket, comme 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 associant les données object_with_object_properties aux données pipelines.

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 transactions ou des tickets).
LABEL Varchar Le nom du pipeline dans HubSpot.
DISPLAYORDER Numéro L'ordre dans lequel le pipeline est affiché dans HubSpot.
ARCHIVÉ Booléen Indique si le pipeline a été supprimé.
CREATEDAT Horodatage La date de création du pipeline.
UPDATEDAT Horodatage La date et l'heure de la dernière mise à jour des données dans HubSpot. Découvrez-en davantage 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 1

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

Requête :


SELECT objectTypeId, pipelineId, label
FROM pipelines
WHERE objectTypeId = '0-3'
AND not archived
ORDER BY displayorder;

  
Renvoie :

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

Exemple 2

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

Requête :


SELECT

deals.objectId deal_id,
deals.properties:dealname::varchar deal_name,
pipelines.label pipeline_name
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';


Renvoie :

DEAL_ID DEAL_NAME PIPELINE_NAME
605140072 Meowmix Global Signup Pipeline de vente
605457408 Friskies Rebrand Pipeline de vente
604362473 Fresh Step App Build Pipeline de vente

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.

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 transactions ou des tickets).
LABEL Varchar Le nom du pipeline dans HubSpot.
DISPLAYORDER Numéro L'ordre dans lequel le pipeline est affiché dans HubSpot.
ARCHIVÉ Booléen Indique si le pipeline a été supprimé.
UPDATEDAT Horodatage La date et l'heure de la dernière mise à jour des données dans HubSpot. Découvrez-en davantage 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 1 

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

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;

  
Renvoie :

PIPELINEID STAGEID LABEL
941650 941651 Contacté
941650 941652 Rendez-vous planifié
941650 941653 Facture envoyée
... ... ...

Exemple 2

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

Requête :


SELECT

deals.objectId deal_id,
deals.properties:dealname::varchar deal_name,
pipelines.label pipeline_name,
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';


Renvoie :

DEAL_ID DEAL_NAME PIPELINE_NAME PIPELINE_STAGE_NAME
605140072 Meowmix Global Signup Pipeline de vente Contrat envoyé
605457408 Friskies Rebrand Pipeline de vente Rendez-vous planifié
604362473 Fresh Step App Build Pipeline de vente Contrat signé
... ... ... ...

Requêtes de propriété

property_definitions

Cette vue contient des informations sur les propriétés des objets et les propriétés d'événement dans 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.

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.
NAME Varchar Le nom interne de la propriété.
LABEL Varchar Le libellé 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 l'affichage de la propriété dans HubSpot et sur les formulaires (par exemple, case à cocher, sélection).
DISPLAYORDER Numéro L'ordre d'affichage de la propriété.
NOM DU GROUPE Varchar Le nom de groupe de la propriété.
OPTIONS Variante Pour les propriétés d'énumération, un tableau des options de la propriété, y compris les attributs de chaque option (par exemple, ordre d'affichage, libellé).
CREATEDUSERID Numéro L'ID de l'utilisateur qui a créé la propriété.
REFERENCEDOBJECTTYPE Varchar Le type d'objet auquel la propriété fait référence. Les propriétés de propriétaire renverront une valeur de type OWNER.
CALCUL Booléen Indique si la propriété est une propriété calculée.
EXTERNALOPTIONS Booléen Indique si les options de la propriété sont définies dans un système externe.
HASUNIQUEVALUE Booléen Indique 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.
CACHÉ Booléen Indique si la propriété est masquée dans HubSpot.
SHOWCURRENCYSYMBOL Booléen Indique si la valeur d'une propriété numérique est formatée comme une devise.
FORMFIELD Booléen Indique si cette propriété peut être utilisée dans les formulaires.
READONLYDEFINITION Booléen Indique si la propriété peut être modifiée dans HubSpot.
READONLYVALUE Booléen Indique si la valeur de la propriété peut être modifiée dans HubSpot.
HUBSPOTDEFINED Booléen Indique si la propriété a été créée par HubSpot ou par un utilisateur.
ARCHIVÉ Booléen Indique si la propriété a été supprimée.
CREATEDAT Horodatage La date et l'heure de création de la propriété dans HubSpot.
UPDATEDAT Horodatage La date et l'heure de la dernière mise à jour des données dans HubSpot. Découvrez-en davantage 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 1

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

Requête :


SELECT name, label, description
FROM property_definitions
WHERE objectTypeId = '0-1'

   
Renvoie :

NAME LABEL DESCRIPTION
entered_sql_stage Phase SQL saisie Début de la phase SQL.
first_conversion_event_name
Première conversion Le premier formulaire soumis par ce contact.
address Adresse postale L'adresse du contact.

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 sa propre vue, appelée 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.)
  • Analytics 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é d'événement. Tous les événements renverront les colonnes suivantes :

Remarque : HubSpot a ajouté deux nouvelles colonnes à toutes les tables et vues d'événements :

  • survenu à
  • occuratdateint

Ces colonnes remplaceront les colonnes occuredat et occuredatdateint le 24 avril 2022. À cette date, les anciennes colonnes ne seront plus disponibles, et les tentatives d'interrogation d'une table ou d'une vue contenant des événements utilisant ces colonnes échoueront. Découvrez-en plus sur les changements de rupture pour les partages de données Snowflake.



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 transactions 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 e-mail affichera 0-1 dans cette colonne, représentant l'objet Contacts.
OBJECTID Numéro L'ID de la fiche d'informations qui a terminé l'événement.
OCCURREDAT Horodatage Date à laquelle l'événement s'est produit.

OCCURREDATDATEINT

 

Numéro Un nombre représentant la date à laquelle l'événement s'est produit. Contient les mêmes données que la colonne OCCURREDAT, mais formaté comme un nombre et utilisé comme une partie de la clé de cluster du tableau. Dans la plupart des cas, vous pouvez utiliser l'horodatage OCCURREDAT à la place de ce numéro.

OCCUREDATDATEINT

Numéro

Un nombre représentant la date à laquelle l'événement s'est produit. Contient les mêmes données que la colonne OCCURREDAT, mais formaté comme un nombre et utilisé comme une partie de la clé de cluster du tableau. Dans la plupart des cas, vous pouvez utiliser l'horodatage OCCURREDAT à la place de ce numéro.

Remarque : cette colonne sera obsolète le 24 avril 2022 et remplacée par OCCURREDATDATEINT.

OCCUREDAT Horodatage

Date à laquelle l'événement s'est produit.

Remarque : cette colonne sera obsolète le 24 avril 2022 et remplacée par OCCURREDAT.

INGESTEDAT Horodatage La date et l'heure auxquelles les données ont été ingérées pour la dernière fois par Snowflake. Découvrez-en davantage sur les types de données des colonnes.
PROPRIÉTÉ Varchar Colonnes individuelles contenant les propriétés de l'événement.

Exemple 1

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

Requête :


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

LIMIT 50;


Renvoie :

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


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;


Renvoie :

CLICK_TIMESTAMP CLICK_URL CONTACT_FIRSTNAME CONTACT_LASTNAME
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 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
... ... ... ...

object_and_event_type_definitions

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 transactions ou des tickets).
FULLYQUALIFIEDNAME 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. Découvrez-en davantage sur les types de données des colonnes.

Exemple 1

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

Requête :


SELECT objectTypeId, fullyQualifiedName
FROM object_and_event_type_definitions;

  
Renvoie :

OBJECTTYPEID FULLYQUALIFIEDNAME
0-1 COÛT DE
0-2 ENTREPRISE
0-3 DEAL
0-4 ENGAGEMENT
0-5 TICKET
0-8 LINE_ITEM
0-11 CONVERSATION
... ...

Requêtes de liste (bêta)

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

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 fiches d'informations qu'elle contient. Ne contient pas d'informations sur les fiches d'informations individuelles de chaque liste (voir list_membership). 

Cette vue peut renvoyer les colonnes suivantes :

Nom de la colonne Type Description
OBJECTTYPEID Varchar Le type de fiches d'informations dans la liste (par exemple, contact ou entreprise).
LISTID Numéro L'ID de la liste. Associe la colonne LISTID dans le tableau list-memberships.
CLASSICLISTID Numéro 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 Numéro Le nombre de fiches d'informations dans la liste.
CREATEDBYUSERID Numéro L'ID de l'utilisateur qui a créé la liste.
CREATEDAT Horodatage La date de création de la liste dans HubSpot.
UPDATEDBYUSERID Numéro L'ID de l'utilisateur qui a mis à jour la liste le plus récemment.
UPDATEDAT Horodatage La date et l'heure auxquelles la date a été mise à jour pour la dernière fois dans HubSpot. Découvrez-en davantage 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 1

Récupérez toutes les listes de contacts.

Requête :


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

  
Renvoie :

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

Exemple 2

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

Requête :


SELECT listId, listName, listSize 
FROM lists
WHERE objectTypeId = '0-1'
AND
listName = 'Principaux abonnés 2021';


Renvoie :

LISTID LISTNAME LISTSIZE
771852 Principaux abonnés 2021 37

list_membership

Cette vue contient des informations sur les fiches d'informations membres d'une liste, avec une ligne par fiche d'informations dans la liste. Par exemple, si vous avez une liste d'abonnés à un blog contenant 500 contacts, le tableau renverra 500 lignes. 

Seuls les ID de liste et d'objet sont inclus. Pour plus d'informations, associez le tableau lists.

Cette vue peut renvoyer les colonnes suivantes :

Nom de la colonne Type Description
LISTID Varchar L'ID de la liste. Associe la colonne HS_LIST_ID dans le tableau lists.
OBJECTID Varchar L'ID de la fiche d'informations dans la liste.
UPDATEDAT Horodatage La date et l'heure de la dernière mise à jour des données dans HubSpot. Découvrez-en davantage 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 1

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

Requête :


SELECT objectId
FROM list_memberships
INNER JOIN lists
ON list_memberships.listId = lists.listId
WHERE lists.objectTypeId = '0-1' ; AND lists.name = 'Principaux abonnés 2021'
AND lists.name = 'Principaux abonnés 2021' ;

  
Renvoie :

OBJECTID
54325098
96805401
6922028
...

Exemple 2

Récupérer le prénom et le nom des coordonnées des contacts dans la liste des meilleurs abonnés 2021.

Requête :


SELECT
contact.objectId AS objectid,
contact.properties:firstname::string AS firstname,
contact.properties:lastname::string AS lastname
FROM object_with_object_properties 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 = '0-1'
AND lists.listName = 'Principaux abonnés 2021'


Renvoie :

OBJECTID PRÉNOM NOM
54325098 Hobbes Baron
96805401 Milo Gold
6922028 Henry Riley
... ... ...

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.

snowflake-sidebar-view-column-details0


Pour renvoyer 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, 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 une fiche d'informations unique 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'horodatage du moment où une ligne de données a été ajoutée à Snowflake, représenté 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. Cela n'est pas directement lié à 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.
Was this article helpful?
This form is used for documentation feedback only. Learn how to get help with HubSpot.