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.

Interroger les données HubSpot dans Snowflake

Dernière mise à jour: 24 septembre 2026

Disponible avec le ou les abonnements suivants, sauf mention contraire :

Data Hub Enterprise

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.

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:

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 :

SELECT objectTypeId, objectId, updatedAt

DE hubspot_share_name. V2_LIVE.objets

WHERE objectTypeId = '0-3'

LIMITE 1 ;

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’association disponibles et les fiches d’informations actuellement associées.
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.
Segments : contacts HubSpot et segments d’entreprise.
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.

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

Veuillez noter : . 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 :

SELECT objectTypeId, updatedAt, ingestedAt

Objets FROM

WHERE objectTypeId = '0-1'

ORDER BY objectId

LIMITE 10 ;

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.

Veuillez noter :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.

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 OBJECTID colonnes et UpdatedAt

SELECT objectTypeId, updatedAt, ingestedAt

Objets FROM

WHERE objectTypeId = '0-1'

ORDER BY objectId

LIMITE 10 ;

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 segments, il s’agit du type de segment (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. Celles-ci 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’objet sont disponibles dans les objets de base de données partagés. Filtrez par objectTypeId pour récupérer un type d’objet spécifique. À utiliser OBJECT_WITH_OBJECT_PROPERTIES lorsque vous avez besoin des propriétés actuelles pour chaque fiche d’informations. Les valeurs des propriétés sont stockées dans la propertiescolonne JSON. À utiliser OBJECTS pour les attributs des fiches d’informations principales et OBJECT_PROPERTIES /ou OBJECT_PROPERTIES_HISTORY pour les données par propriété.

Nom de l'objet	ObjectTypeId
Contacts	0-1
Entreprises	0-2
Lignes de transaction	0-8

Un ID sera attribué aux objets personnalisés au moment de leur création. Ils 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.

Voir plus de détails dans object_with_object_properties, object_properties, objects et object_properties_history ci-dessous.

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 :

Nom de la colonne	Type	Description
`OBJECTTYPEID`	Varchar	L'ID du type d'objet (par exemple, contacts est `0-1`).
`OBJECTID`	Numéro	L'ID de l'enregistrement (par exemple, un enregistrement de contact avec un ID de `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.

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 :

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

Renvoie :

ID DE TYPE D’OBJET	ID D’OBJET	PROPRIÉTÉS
0-1	38960439	{"createdate": "1504656970152"...}
0-1	321740651	{"createdate" : "1590183081949"...}
0-1	98392101	{"createdate" : "1533566477279"...}
...	...	...

Exemple 2

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

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 :

ID D’OBJET	DEALNAME	DEALSTAGE	DEALAMOUNT
38960439	Nom de l'opération 1	fermé-perdu	7488939
321740651	Nom de l'opération 1	ferméwon	9292029
98392101	Nom de l'opération 1	fermé-perdu	62626528

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 contient des données d’objet actuelles sans valeurs de propriété. Utilisez-le lorsque vous avez besoin uniquement des attributs de l’enregistrement principal ou associez-le à OBJECT_PROPERTIES lorsque vous avez besoin de propriétés sélectionnées. 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 :

Nom de la colonne	Type	Description
`OBJECTTYPEID`	Varchar	L'ID du type d'objet (par exemple, contacts est `0-1`).
`OBJECTID`	Numéro	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. 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 :

ID DE TYPE D’OBJET	ID D’OBJET
0-1	36721864
0-1	103580363
0-1	56047670
...	...

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 :

Nom de la colonne	Type	Description
`OBJECTTYPEID`	Varchar	L'ID du type d'objet (par exemple, contacts est `0-1`).
`OBJECTID`	Numéro	L'ID de l'enregistrement (par exemple, un enregistrement de contact avec un ID de `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 :

ID DE TYPE D’OBJET	ID D’OBJET	NOM	VALEUR
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 :

ID DE TYPE D’OBJET	ID D’OBJET	PRÉNOM	NOM	LIFECYCLESTAGE
0-1	54325098	Hobbes	Baron	lead
0-1	96805401	Milo	Gold	lead
0-1	6922028	Henry	Riley	lead
...	...	...	...	...

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 :

Nom de la colonne	Type	Description
`OBJECTTYPEID`	Varchar	L'ID du type d'objet (par exemple, contacts est `0-1`).
`OBJECTID`	Numéro	L'ID de l'enregistrement (par exemple, un enregistrement de contact avec un ID de `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, updatedAt
FROM object_properties_history
WHERE objectTypeId = '0-1'
AND objectId = 136493192
AND name = 'hs_predictivescoringtier'
ORDER BY UPDATEDAT DESC;

Renvoie :

ID D’OBJET	NOM	VALEUR	MIS À JOUR À
136493192	hs_predictivescoringtier	tier_1	2022-06-22 22:45:05.931
136493192	hs_predictivescoringtier	tier_2	2021-09-18 08:20:56.622
136493192	hs_predictivescoringtier	tier_3	2019-11-31 18:20:22.851
...	...	...	...

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 :

ID D’OBJET	PRÉNOM	NOM
54325098	Hobbes	Baron
96805401	Milo	Gold
6922028	Henry	Riley
...	...	...

Requêtes d'associations

Les données d’association sont disponibles dans . ASSOCIATIONS Filtrez par combinedAssociationTypeId pour récupérer un type d’association spécifique. Joignez ASSOCIATIONS avec ASSOCIATION_DEFINITIONS pour identifier les types d’objets associés et la définition de l’association.

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 :

Nom de la colonne	Type	Description
`COMBINEDASSOCIATIONTYPEID`	Varchar	L'identifiant unique de la définition d'association.
`CATEGORY`	Varchar	La source du type d'association. L'un d'entre eux : `HUBSPOT_DEFINED`, `USER_DEFINED`, `INTEGRATOR_DEFINED`
`ID`	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	NOM
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	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

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 contient des fiches d’informations d’association pour tous les types d’association. Filtrez selon et combinedAssociationTypeId rejoignez avec lorsque ASSOCIATION_DEFINITIONS vous avez besoin de métadonnées d’association.

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

Nom de la colonne	Type	Description
`COMBINEDASSOCIATIONTYPEID`	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 :

TYPE D'ASSOCIATION COMBINÉ	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 combinedAssociationTypeId, 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 :

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

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 :

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.
`ARCHIVED`	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.
`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 utilisateurs. Le filtre WHERE archived = false supprime les utilisateurs supprimés des données renvoyées.

Requête :

SELECT ownerId, userId, email, firstname, lastname FROM owners WHERE archived = false

Renvoie :

ID DE PROPRIÉTAIRE	USERID	EMAIL	PRÉNOM	NOM
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 :

ID DE PROPRIÉTAIRE	USERID	EMAIL	PRÉNOM	NOM
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.

SÉLECTIONNER

contact.objectId AS contact_id,

contact.properties :firstname ::string AS contact_firstname,

contact.properties :lastname ::string AS contact_lastname,

contact.properties :hubspot_owner_id ::number AS contact_hubspot_owner_id,

owner.firstname AS owner_firstname,

owner.lastname AS owner_lastname,

owner.email COMME owner_email

DE object_with_object_properties EN TANT QUE CONTACT

JOINDRE LES PROPRIÉTAIRES EN TANT QUE PROPRIÉTAIRE

ON contact.properties :hubspot_owner_id ::number = owner.ownerId

OÙ contact.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
...	...	...	...	...	...	...

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 :

Nom de la colonne	Type	Description
TEAMID	Numéro	L'ID de l'équipe.
TEAMNAME	Varchar	Le nom de l'équipe.
PARENTTEAMID	Numéro	L'identifiant de l'équipe parent.
CHILDTEAMIDS	Tableau	Les ID des équipes enfants.
PRIMARYOWNERMEMBERS	Varchar	Les ID de propriétaire des membres principaux de l'équipe.
SECONDARYOWNERMEMBERS	Booléen	Les ID de propriétaire des membres secondaires de l'équipe.
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 équipes.

Requête :

SELECT teamId,teamName, primaryOwnerMembers

FROM teams

Renvoie :

TEAMID	TEAMNAME	PRIMARYOWNERMEMBERS
29584574	Équipe secondaire	[233620335, 1234553]
30532717	Super équipe	[3866015468, 126221873]
3058032	Équipe A	[7132752747]

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 :

Nom de la colonne	Type	Description
TEAMID	Numéro	L'ID de l'équipe.
OWNERID	Numéro	L'ID du propriétaire de l'utilisateur.
ISTEAMPRIMARY	Booléen	Si cette équipe est l'équipe principale de ce propriétaire.
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 propriétaires dans une équipe donnée.

Requête :

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

Retours

TEAMID	TEAMNAME	ISTEAMPRIMARY
29584574	233620335	TRUE
29584574	1234553	TRUE

Requêtes sur les pipelines

Découvrez ci-dessous comment interroger les données relatives aux pipelines de transactions et de tickets, 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 joignant . object_with_object_properties 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 :

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.
`ARCHIVED`	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 :

ID DE TYPE D’OBJET	ID DE PIPELINE	ÉTIQUETTE
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 en utilisant object_with_object_properties.

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.

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

Nom de la colonne	Type	Description
`PIPELINEID`	Varchar	L'ID du pipeline.
`STAGEID`	Varchar	L'identification de la scène.
`LABEL`	Varchar	Le nom de l'étape dans HubSpot.
`DISPLAYORDER`	Numéro	L'ordre dans lequel le pipeline est affiché dans HubSpot.
`METADATA`	Variante	Une description au format JSON de l'étape, indiquant si elle est ouverte ou fermée
`ARCHIVED`	Booléen	Si l'étape du pipeline a été supprimée.
`CREATEDAT`	Horodatage	Quand l'étape du pipeline a été créée.

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 :

ID DE PIPELINE	STAGEID	ÉTIQUETTE
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é
...	...	...	...

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 d’événement comportemental personnalisé . 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 :

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é.
`GROUPNAME`	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.
`CALCULATED`	Booléen	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.
`HIDDEN`	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.
`ARCHIVED`	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 :

NOM	ÉTIQUETTE	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 son propre objet de base de données, libellé comme suit events_eventname.

Nom
ÉVÉNEMENTS_AD_INTERACTION	Détails d'une annonce et des contacts qui ont interagi avec elle en cliquant sur l'annonce ou en soumettant un formulaire après y avoir participé.
ÉVÉNEMENTS_AD_METRICS_IMPORTED_V0	Détails d'une annonce et de ses mesures de performance.
APPEL_ÉVÉNEMENTS_MOT_CLÉ MENTIONNÉ	Détails des mots-clés mentionnés par tous les participants aux appels.
EVENTS_CLICKED_LINK_IN_EMAIL_V2	Liens cliqués par les contacts dans les e-mails de marketing.
EVENTS_CLICKED_LINK_IN_TRACKED_INBOX_EMAIL_V8	Liens cliqués dans les e-mails de la boîte de réception des conversations par les contacts.
ÉVÉNEMENTS_COOKIE_BANNER_CLICKED	Contacts qui ont cliqué sur les cookies.
ÉVÉNEMENTS_COOKIE_BANNER_VIEWED	Contacts qui ont consulté les cookies.
ÉVÉNEMENTS_DOCUMENT_PARTAGÉS_V2	Documents de vente partagés avec les contacts via un lien externe.
ÉVÉNEMENTS_DOCUMENT_VIEWED_V2	Documents de vente et contacts qu'ils ont consultés en ouvrant le lien externe.
ÉVÉNEMENTS_DOCUMENT_COMPLÉTÉ_V2	Documents de vente et contacts qui les ont clôturés.
ÉVÉNEMENTS_HS_SCHEDULED_EMAIL_V2	Les e-mails soumis aux serveurs de messagerie de HubSpot pour être envoyés.
ÉVÉNEMENTS_MTA_MAIL_DÉLIVRÉ_V2	Emails délivrés avec succès aux destinataires par les serveurs de messagerie HubSpot.
EVENTS_MTA_BOUNCED_EMAIL_V2	Tentatives de livraison d'e-mails qui ont été rejetées par le serveur de messagerie du destinataire.
ÉVÉNEMENTS_OUVERTS_EMAIL_V2	Ouverture des e-mails par les contacts.
ÉVÉNEMENTS_REPORTÉS_SPAM_EMAIL_V2	Emails marqués comme spam par les destinataires.
EVENTS_UPDATED_EMAIL_SUBSCRIPTION_STATUS_V2	Modifications des abonnements aux e-mails par les destinataires.
ÉVÉNEMENTS_OUVERTS_TRAÇÉS_BOÎTE_EMAIL_V8	Ouverture de la boîte de réception des conservations par les contacts.
ÉVÉNEMENTS_MB_MEDIA_PLAYED	Activité de lecture vidéo par contacts.
EVENTS_V2_CONTACT_BOOKED_MEETING_THROUGH_SEQUENCE	Le contact a réservé une réunion par le biais de la séquence.
EVENTS_V2_CONTACT_ENROLLED_IN_SEQUENCE	Contact inscrit à partir de la séquence.
ÉVÉNEMENTS_V2_CONTACT_FINISHED_SEQUENCE	Séquence terminée.
EVENTS_V2_CONTACT_REPLIED_SEQUENCE_EMAIL	Le contact a répondu à l'e-mail (ou à l'e-mail entrant qui a désinscrit la séquence) envoyé par la séquence.
ÉVÉNEMENTS_V2_CONTACT_NON INSCRITS_DE_LA_SÉQUENCE	Contact non inscrit dans la séquence.
EVENTS_V2_CONTACT_UNENROLLED_MANUALLY_FROM_SEQUENCE	L'utilisateur a manuellement désinscrit le contact.
EVENTS_V2_CONTACT_UNSUBSCRIBED_SEQUENCE_EMAIL	Le contact s'est désinscrit, désinscrivant la séquence.
ÉVÉNEMENTS_V2_SÉQUENCE_EMAIL_ANNONCÉ	L'email de la séquence a rebondi.
ÉVÉNEMENTS_V2_SÉQUENCE_ERRORED	Séquence erronée causant une désinscription.
ÉVÉNEMENTS_V2_SÉQUENCE_ÉTAPE_EXÉCUTÉE	Étape de la séquence exécutée.
ÉVÉNEMENTS_VISITÉS_PAGE	Visites de pages du site web par les contacts.
EVENEMENTS_<INTEGRATION_EVENT_NAME>_<UNIQUE_IDENTIFIER>	Événements d’intégration (API Chronologie V3)

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 :

Veuillez noter : HubSpot a ajouté deux nouvelles colonnes à tous les tableaux et vues d'événements :

occurredat
occurredatdateint

Ces colonnes remplaceront les colonnes occuredat et occuredatdateint le 24 novembre 2022. À cette date, les anciennes colonnes ne seront plus disponibles, et les tentatives d'interrogation d'un objet de base de données ou d'une vue contenant des événements utilisant ces colonnes échoueront. Découvrez-en davantage sur les modifications de dernière minute pour les partages de données Snowflake.

Nom de la colonne	Type	Description
`EVENTTYPEID`	Varchar	L'ID du type d'événement, similaire à OBJECTTYPEID Vous pouvez interroger tous les ID des types d'événements dans votre compte en utilisant la vue object_and_event_type_definitions.
`ID`	Varchar	Ceci est unique par type d'événement. Il n'y aura pas deux enregistrements ayant le même ID pour un type d'événement donné.
`OBJECTTYPEID`	Varchar	Le type d'objet qui a réalisé l'événement. Par exemple, un clic sur un lien d'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ées sous forme de nombre et utilisées comme partie de la clé de cluster de la table. Dans la plupart des cas, vous pouvez utiliser l'horodatage `OCCURREDAT` au lieu de ce nombre.
`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ées sous forme de nombre et utilisées comme partie de la clé de cluster de la table. Dans la plupart des cas, vous pouvez utiliser l'horodatage `OCCURREDAT` au lieu de ce nombre. Remarque : cette colonne deviendra obsolète le 24 novembre 2022 et sera remplacée par . `OCCURREDATDATEINT`
`OCCUREDAT`	Horodatage	Date à laquelle l'événement s'est produit. Veuillez noter que cette colonne sera obsolète le 24 novembre 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.
`PROPERTY_*`	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, property_hs_click_raw_url AS hs_click_raw_url
FROM events_clicked_link_in_email_V2 ORDER BY occuredAtLIMIT 50;

Renvoie :

EVENTTYPEID	ID DE TYPE D’OBJET	ID D’OBJET	SURVENU	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.occuredat 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
...	...	...	...

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 :

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 :

ID DE TYPE D’OBJET	FULLYQUALIFIEDNAME
0-1	COÛT DE
0-8	LINE_ITEM
0-11	CONVERSATION
...	...

Requêtes de segments

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

Segments

Cet objet de base de données contient des informations sur les segments de contacts et d’entreprises HubSpot. Renvoie une ligne par segment, et les colonnes comprennent les détails du segment tels que son nom, sa taille et le type d’objet des fiches d’informations qu’il contient. Ne contient pas d’informations sur les fiches d’informations individuelles de chaque segment (voir segment_membership).

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

Nom de la colonne	Type	Description
`OBJECTTYPEID`	Varchar	Le type de fiche d’informations dans le segment (par exemple, contact ou entreprise).
`SEGMENTID`	Numéro	L’ID du segment. Associe la colonne ID de segment dans le tableau segmentation memberships .
`CLASSICSEGMENTID`	Numéro	Un ID spécifique aux segments de contacts qui correspond à l’ID dans l’URL du segment dans HubSpot.
`NAME`	Varchar	Le nom du segment.
`SIZE`	Numéro	Le nombre de fiches d’informations dans le segment.
`CREATEDBYUSERID`	Numéro	L’ID de l’utilisateur qui a créé le segment.
`CREATEDAT`	Horodatage	La date à laquelle le segment a été créé dans HubSpot.
`UPDATEDBYUSERID`	Numéro	L’ID de l’utilisateur qui a mis à jour le segment 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 tous les segments de contact.

Requête :

SELECT segmentId, name, size
FROM segments
WHERE objectTypeId = '0-1';

Renvoie :

SEGMENTSID	NOM	TAILLE
118131	Prise de contact hebdomadaire	103
66156	Abonnés au blog	455
771852	Principaux abonnés 2021	37
...	...	...

Exemple 2

Récupérez un segment de contact spécifique nommé Principaux abonnés 2021.

Requête :

SELECT segmentId, name, size
FROM segments
WHERE objectTypeId = '0-1' ANDsegmentName = 'Top subscribers 2021';

Renvoie :

SEGMENTID	NOM	TAILLE
771852	Principaux abonnés 2021	37

segment_membership

Cet objet de base de données contient des informations sur les fiches d’informations membres de quels segments, avec une ligne par fiche d’informations dans le segment. Par exemple, si vous avez un segment Abonnés au blog avec 500 contacts, l’objet base de données renverra 500 lignes.

Seuls les ID de segment et d’objet sont inclus. Pour plus d’informations, associez l’objet de base de données Segments .

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

Nom de la colonne	Type	Description
`SEGMENTID`	Varchar	L’ID du segment. Associe la colonne HS_SEGMENT_ID dans le tableau des segments .
`OBJECTID`	Varchar	L’ID de la fiche d’informations dans le segment.
`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 dans le segment Principaux abonnés 2021 .

Requête :

SELECT objectId
FROM segment_memberships
INNER JOIN segments
ON segment_memberships.segmentId = segments.segmentId
WHERE segments.objectTypeId = '0-1'
AND segments.name = 'Top Subscribers 2021';

Renvoie :

ID D’OBJET

54325098

96805401

6922028

...

Exemple 2

Récupérez les noms et prénoms des détails des contacts dans le segment Principaux abonnés 2021 .

Requête :

SÉLECTIONNER

contact.objectId AS object_id,

contact.properties :firstname ::string AS firstname,

contact.properties :lastname ::string AS lastname

DE object_with_object_properties EN TANT QUE CONTACT

JOINT INTERNE segment_memberships COMME contrôle d'accès

ON contact.objectId = contrôle d’accès.objectId

Segments INNER JOIN

ON contrôle d’accès.segmentId = segments.segmentId

OÙ contact.objectTypeId = '0-1'

AND segments.objectTypeId = '0-1'

ET segments.name = 'Principaux abonnés 2021' ;

Renvoie :

ID D’OBJET	PRÉNOM	NOM
54325098	Hobbes	Baron
96805401	Milo	Gold
6922028	Henry	Riley
...	...	...

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 est préférable d’examiner les colonnes du rapport avec lequel vous effectuez une 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 :

SELECT * FROM property_definitions

WHERE label = [column_name]

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. Recherchez object_with_object_properties et filtrez les données en fonction de objectTypeId pour ce type. Lisez les valeurs de propriété nécessaires à partir de la colonne JSON des propriétés.

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

Pour récupérer les formulaires associés à chaque campagne, joignez OBJECT_WITH_OBJECT_PROPERTIES, ASSOCIATIONSet ASSOCIATION_DEFINITIONS.

SÉLECTIONNER DISTINCT

campagnes.properties :hs_name ::string AS campaign_name,

forms.properties :hs_form_id ::string AS form_id

DE object_with_object_properties COMME campagnes

JOINDRE DES ASSOCIATIONS EN TANT QU’ASSOCIATION

ON association.fromObjectId = campagnes.objectId

JOINDRE association_definitions EN TANT que définition

ON definition.combinedAssociationTypeId =

association.combinedAssociationTypeId

JOINDRE object_with_object_properties EN TANT que formulaires

ON forms.objectId = association.toObjectId

OÙ campagnes.objectTypeId = '0-35'

AND forms.objectTypeId = '0-28'

AND definition.fromObjectTypeId = '0-35'

AND definition.toObjectTypeId = '0-28' ;

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 :

STATUT	MESSAGE	MIS À JOUR À
OK	AUCUN INCIDENT CONNU POUR LE MOMENT	2023-04-10 09:21:20.123

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.

Cet article vous a-t-il été utile ?

Ce formulaire n'est utilisé que pour recueillir du feedback sur la documentation. Découvrez comment obtenir de l'aide sur HubSpot.

Interroger les données HubSpot dans Snowflake

Disponible avec le ou les abonnements suivants, sauf mention contraire :

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

Configurer votre environnement Snowflake

Présentation des données

Limiter et ordonner les données renvoyées

Types de données de colonne

Transformation des types de données

Requêtes d'objets

object_with_object_properties

Exemple 1

Exemple 2

objects

Exemple 1

object_properties

Exemple 1

Exemple 2

object_properties_history

Exemple 1

Exemple 2

Requêtes d'associations

association_definitions

Exemple 1

Exemple 2

associations

Exemple 1

Exemple 2

Exemple 3

Requêtes du propriétaire

owners

Exemple 1

Exemple 2

Exemple 3

Questions de l'équipe

Équipes

Exemple 1

owner_team

Exemple 1

Requêtes sur les pipelines

pipelines

Exemple 1

Exemple 2

pipeline_stages

Exemple 1

Exemple 2

Demandes de renseignements sur la propriété

property_definitions

Exemple 1

Requêtes d'événement

Exemple 1

Exemple 2

Requêtes de type objet et événement

object_and_event_type_definitions

Exemple 1

Requêtes de segments

Segments

Exemple 1

Exemple 2

segment_membership

Exemple 1

Exemple 2

FAQ

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

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

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

Articles similaires