Let op: De Nederlandse vertaling van dit artikel is alleen bedoeld voor het gemak.

HubSpot-gegevens opvragen in Snowflake

Laatst bijgewerkt: 24 september 2026

Beschikbaar met elk van de volgende abonnementen, behalve waar vermeld:

Data Hub Enterprise

Nadat je Snowflake aan je HubSpot-account hebt gekoppeld, kun je met Data Share van Snowflake HubSpot-gegevens opvragen vanuit je Snowflake-account.

Gegevensvertraging en de regio van uw Snowflake-account

Je hebt toegang tot het V2_LIVE-schema, dat elke 15 minuten wordt bijgewerkt, en het V2_DAILY-schema, dat dagelijks wordt bijgewerkt.

Let op: de volgende views in het V2_LIVE-schema worden slechts dagelijks bijgewerkt: association_definitions, owners, pipelines en pipeline_stages.

Je Snowflake-omgeving instellen

Om je HubSpot-gegevens in Snowflake op te vragen, moet je het warehouse, de database en het schema selecteren waaruit je gegevens wilt opvragen. Je kunt deze instellingen op werkbladniveau configureren, zodat ze automatisch in je query's worden opgenomen, of je kunt ze handmatig toevoegen.

Je warehouse, database en schema op werkbladniveau selecteren:

Klik in de bovenste rij van het werkblad op dewerkbladactiebalk.
In het pop-upvenster:
- Klik op het vervolgkeuzemenu'Warehouse' en selecteer vervolgens uwwarehouse.
- Klik op het vervolgkeuzemenu'Database' en selecteer vervolgens uw HubSpot-database.
- Klik op het vervolgkeuzemenu'Schema ' en selecteer vervolgens het schema dat u wilt gebruiken:

Zodra je omgeving is geconfigureerd, kun je query's uitvoeren op je HubSpot-gegevens zonder dat je je database of schemetype handmatig aan query's hoeft toe te voegen.

Om je database en schematype handmatig aan query's toe te voegen, voeg je de databasenaam gevolgd door het schema toe aan het begin van het FROM. Bijvoorbeeld:

SELECT objectTypeId, objectId, updatedAt

FROM hubspot_share_name.V2_LIVE.objects

WAAR objectTypeId = '0-3'

BEPERK 1;

Gegevensoverzicht

Query's worden opgesteld met behulp van SQL en kunnen worden gebruikt om HubSpot-gegevens op te halen, zoals:

Objecten: standaard- en aangepaste objecten, zoals contactpersonen, bedrijven en producten.
Records: afzonderlijke records, zoals een individueel contact of een bedrijf.
Koppelingen: alle beschikbare koppelingstypen en records waaraan momenteel een koppeling is gemaakt.
Gebeurtenissen: gebeurtenisgegevens voor zowel standaard HubSpot-gebeurtenissen, zoals het openen van e-mails, als aangepaste gedragsgebeurtenissen.
Segmenten: HubSpot-contact- en bedrijfssegmenten.
Eigenaren: gebruikers in je HubSpot-account, in relatie tot de records waarvan zij als eigenaar zijn aangewezen.
Pijplijnen: deal-en ticketpijplijnen, inclusief pijplijnfasen.
Eigenschappen: eigenschappen en hun waarden in CRM-records, inclusief de eigenschapsgeschiedenis.

Meer informatie over het CRM-gegevensmodel van HubSpot.

Let op: Naarmate we de gegevensuitwisseling verder ontwikkelen, zullen we wijzigingen doorvoeren, waarvan sommige ingrijpende wijzigingen zijn. Het wordt ten zeerste aanbevolen om je te abonneren op het wijzigingslogboek voor ontwikkelaars van HubSpot. Deze wijzigingen worden altijd voorafgaand aan een update in het wijzigingslogboek geplaatst.

Het beperken en sorteren van geretourneerde gegevens

Bij het opstellen van query’s kunt u bepalen hoeveel gegevens worden geretourneerd en in welke volgorde, doorLIMIT en ORDER BY in uw query op te nemen. Als u bijvoorbeeld alle contacten met hun eigenschappen wilt opvragen, maar slechts drie resultaten wilt retourneren en deze op contact-ID wilt sorteren, kunt u uw query als volgt opstellen:

SELECT objectTypeId, updatedAt, ingestedAt

FROM objects

WAAR objectTypeId = '0-1'

SORTEREN OP objectId

LIMIT 10;

Gegevenstypen van kolommen

Bij het opvragen van gegevens in Snowflake zijn de kolommen die worden geretourneerd afhankelijk van de gegevens die u opvraagt. U kunt de beschikbare kolommen voor een bepaalde tabel of weergave in Snowflake bekijken door de weergave in de linkerzijbalk te selecteren.

Let op:in de rest van dit document gebruiken we de term ‘databaseobject’ wanneer de context zowel op tabellen als op weergaven van toepassing is.

snowflake-sidebar-view-column-details0

Om een specifieke kolom terug te geven, neemt u die kolom op in het SELECT van uw query. De volgende query geeft bijvoorbeeld alleen de kolommen OBJECTID en UpdatedAt terug

SELECT objectTypeId, updatedAt, ingestedAt

FROM objects

WAAR objectTypeId = '0-1'

SORTEREN OP objectId

LIMIT 10;

Hieronder staan algemene definities voor kolommen die een query kan retourneren. Voor andere definities die hieronder niet zijn opgenomen, raadpleeg je de afzonderlijke weergavedefinities in het bovenstaande artikel.

OBJECTTYPEID: een VARCHAR-waarde die het type van een object aangeeft. Zo staat 0-1 bijvoorbeeld voor het object 'contacten', 0-2 voor het object 'bedrijven' en 2-1232 mogelijk voor een aangepast object in uw account. In segmenten verwijst dit naar het type segment (bijv. contact of bedrijf). U kunt alle object- en gebeurtenis-ID's in uw account opvragen met behulp van de weergave 'object_and_event_type_definitions '.
OBJECTID: een BIGINT-getal dat staat voor één record van een bepaald objecttype in je HubSpot-account. Om een record te identificeren, moet je zowel de objecttype-ID als de object-ID gebruiken.
INGESTEDAT: de tijdstempel van het moment waarop een rij gegevens aan Snowflake is toegevoegd, weergegeven als een TIMESTAMP_NTZ-waarde. Dit staat los van de logische tijdstempel van een aanmaak- of bijwerkingsbewerking in HubSpot.
- Als gevolg van de interne verwerking door HubSpot kan de tijdstempel van de opname van een rij worden bijgewerkt, zelfs als er geen andere kolommen in de rij zijn gewijzigd.
- Bij het opzetten van ETL-processen die recent gewijzigde gegevens kopiëren, wordt aanbevolen om je query's te baseren op de tijdstempel van de opname. Als je flow dagelijks gegevens kopieert, wordt bovendien aanbevolen om gegevens van de afgelopen twee dagen te kopiëren om rekening te houden met vertragingen.
CREATEDAT en UPDATEDAT: de logische tijdstempel van het moment waarop gegevens in HubSpot zijn aangemaakt of bijgewerkt, weergegeven als een TIMESTAMP_NTZ-waarde . Deze tijdstempels komen overeen met de tijdstempels in HubSpot. De tijd die bijvoorbeeld in HubSpot wordt weergegeven voor de aanmaakdatum van een record, is dezelfde als de tijdstempel in de kolom CREATEDAT in Snowflake. Deze hebben geen direct verband met de tijdstempel van de gegevensinvoer, en het wordt afgeraden om ETL-processen op deze eigenschappen te baseren.
COMBINEDASSOCIATIONTYPE: een VARCHAR-waarde die een associatiedefinitie op unieke wijze identificeert.

Gegevenstypen omzetten

Soms worden gegevens uit een query geretourneerd met VARCHAR-kolommen, terwijl het wenselijk zou zijn om ze in een ander type te hebben. In dergelijke gevallen wordt aanbevolen om het VARCHAR-gegevenstype met behulp van Snowflake-functies om te zetten naar de gewenste typen. Zo worden eigenschappen van een objectrecord in de meeste databaseobjecten opgeslagen als VARCHAR-gegevenstypen, maar bevatten ze soms getal- en datum/tijdwaarden. Functies zoals:
try_to_number, try_to_timestamp_ntz kunnen worden gebruikt om deze VARCHAR-gegevens respectievelijk om te zetten naar de typen NUMBER en DATETIME:

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

Objectquery's

Hieronder lees je hoe je gegevens uit specifieke HubSpot-objecten en -records kunt opvragen, en welke gegevens worden geretourneerd.

Objectgegevens zijn beschikbaar in gedeelde databaseobjecten. Filter op objectTypeId om een specifiek objecttype op te halen. Gebruik OBJECT_WITH_OBJECT_PROPERTIES als je de huidige eigenschappen voor elk record nodig hebt. Eigenschapswaarden worden opgeslagen in de properties JSON-kolom. Gebruik OBJECTS voor kernattributen van records en OBJECT_PROPERTIES of OBJECT_PROPERTIES_HISTORY voor gegevens per eigenschap.

Objectnaam	ObjectTypeId
Contacten	0-1
Bedrijven	0-2
Regelitems	0-8

Aangepaste objecten krijgen bij het aanmaken een ID toegewezen en worden aangeduid als2-unique_ID. Bijvoorbeeld:2-12345. Lees meer over object_and_event_type_definitions.

Zie hieronder voor meer details bij object_with_object_properties, object_properties, objects en object_properties_history.

object_with_object_properties

Dit databaseobject bevat gegevens uit uw HubSpot-records. Query's op dit databaseobject leveren één rij op voor elk record binnen een objecttype (bijvoorbeeld alle contactrecords in het objecttype ‘contacten’). Alle eigenschappen worden opgeslagen in de kolom ‘Properties’, een Snowflake Variant / JSON-kolom.

Deze weergave kan de volgende kolommen retourneren:

Kolomnaam	Type	Beschrijving
`OBJECTTYPEID`	Varchar	Het ID van het objecttype (bijv. 'contacts' is `0-1`).
`OBJECTID`	Getal	Het ID van het record (bijv. een contactrecord met ID `123752`).
`PROPERTIES`	Variant	De eigenschapswaarden van het record.
`UPDATEDAT`	Tijdstempel	De datum en tijd waarop het record voor het laatst is bijgewerkt in HubSpot. Meer informatie over kolomgegevenstypen.
`INGESTEDAT`	Tijdstempel	De datum en tijd waarop de gegevens voor het laatst door Snowflake zijn geïmporteerd.

Let op: Op 25 januari 2022 wordt de kolom ‘timestamp ’ in de tabel en weergave ‘object_with_object_properties’, die de datum en tijd aangeeft waarop het objectrecord voor het laatst in HubSpot is bijgewerkt, gewijzigd in ‘updatedat’. Dit is om de weergave van datum- en tijdgegevens in overeenstemming te brengen met de rest van de gegevensuitwisseling.

Aangezien dit een ingrijpende wijziging is, is de nieuwe kolom ` updatedat ` toegevoegd aan de tabel en de weergave. Gedurende de komende 90 dagen zullen deze twee nieuwe kolommen naast `timestamp` bestaan, de kolommen die ze moeten vervangen. Dit geeft u de gelegenheid om over te stappen op het gebruik van de nieuwe kolommen.

Na 90 dagen, op 25 januari 2022, wordt de kolom ‘timestamp’ uit de tabel en de weergave verwijderd. Na deze datum zal elke poging om de tabel ‘object_with_object_properties’ of de weergave te doorzoeken met behulp van ‘timestamp’-kolommen mislukken.

Voorbeeld 1

Haal alle contacten en hun eigenschappen op.

Query:

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

Resultaat:

OBJECTTYPEID	OBJECTID	PROPERTIES
0-1	38960439	{"createdate": "1504656970152"...}
0-1	321740651	{ "createdate": "1590183081949"...}
0-1	98392101	{ "createdate": "1533566477279"...}
...	...	...

Voorbeeld 2

Haal de naam en de fase van maximaal drie dealsop.

Query:

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;

Retourneert:

OBJECTID	DEALNAME	DEALSTADIUM	DEALAMOUNT
38960439	Dealnaam 1	afgesloten-verloren	7488939
321740651	Naam van de deal 1	gesloten gewonnen	9292029
98392101	Transactienaam 1	afgesloten, verloren	62626528

objecten

Dit databaseobject is een subset van de gegevens in het databaseobject object_with_object_properties. Elke geretourneerde rij bevat de object-ID voor elk record. Dit databaseobject retourneert alleen bestaande records. Wanneer een record in HubSpot wordt verwijderd, wordt het uit dit databaseobject verwijderd. Dit databaseobject is een subset van de gegevens in de tabel object_with_object_properties. Elke geretourneerde rij bevat de object-ID voor elk record. Deze weergave geeft alleen bestaande records weer. Wanneer een record in HubSpot wordt verwijderd, wordt het uit deze weergave verwijderd.

Dit databaseobject bevat actuele objectgegevens zonder eigenschapswaarden. Gebruik het wanneer u alleen de kernattributen van records nodig hebt, of koppel het aan OBJECT_PROPERTIES wanneer u geselecteerde eigenschappen nodig hebt. Door dit databaseobject te gebruiken in combinatie met het databaseobject object_properties is het mogelijk om de gegevens in object_with_object_properties te repliceren, terwijl u de controle behoudt over welke eigenschappen worden geretourneerd.

Dit databaseobject kan de volgende kolommen retourneren:

Kolomnaam	Type	Beschrijving
`OBJECTTYPEID`	Varchar	Het ID van het objecttype (bijv. 'contacts' is `0-1`).
`OBJECTID`	Getal	Het ID van het record (bijv. een contactrecord met ID `123752`).
`INGESTEDAT`	Tijdstempel	De datum en tijd waarop de gegevens voor het laatst door Snowflake zijn ingelezen. Lees meer over kolomgegevenstypen.

Voorbeeld 1

Haal alle contactrecords op.

Query:

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

Retourneert:

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

object_properties

Dit databaseobject is een subset van het databaseobject `object_with_object_properties`. Elke rij bevat de huidige waarde van een eigenschap die voor een bepaald record is ingesteld. Een contactpersoon heeft bijvoorbeeld één rij voor de eigenschap ‘Voornaam ’ en één rij voor de eigenschap‘Achternaam ’. Als een record geen waarde voor een eigenschap heeft, wordt de rij weergegeven met een lege tekenreeks of verschijnt deze helemaal niet.

Dit databaseobject kan de volgende kolommen retourneren:

Kolomnaam	Type	Beschrijving
`OBJECTTYPEID`	Varchar	Het ID van het objecttype (bijv. 'contacts' is `0-1`).
`OBJECTID`	Getal	Het ID van het record (bijv. een contactrecord met ID `123752`).
`NAME`	Varchar	De naam van de eigenschap.
`VALUE`	Tijdstempel	De waarde van de eigenschap.
`UPDATEDAT`	Tijdstempel	De datum en tijd waarop het record voor het laatst is bijgewerkt in HubSpot. Lees meer over kolomgegevenstypen.
`INGESTEDAT`	Tijdstempel	De datum en tijd waarop de gegevens voor het laatst door Snowflake zijn geïmporteerd.

Voorbeeld 1

Haal de eigenschappen ‘Voornaam’, ‘Achternaam’ en ‘Woonplaats’ op voor alle contactpersonen.

Query:

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

Retourneert:

OBJECTTYPEID	OBJECTID	NAAM	WAARDE
0-1	10401	voornaam	Brian
0-1	10401	stad	Dublin
0-1	10401	achternaam	Gallagher
0-1	23451	voornaam	Fernando
0-1	23451	achternaam	Fierro
0-1	25751	voornaam	Charles
...	...	...	...

Voorbeeld 2

Haal de voornaam, achternaam en levenscyclusfase op voor alle contacten en combineer deze tot één rij per contact. In dit voorbeeld wordt de SQL PIVOT-syntaxis gebruikt.

Query:

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);

Resultaten:

OBJECTTYPEID	OBJECTID	VOORNAAM	ACHTERNAAM	LEVENSCYCLUSFASE
0-1	54325098	Hobbes	Baron	lead
0-1	96805401	Milo	Goud	voorsprong
0-1	6922028	Henry	Riley	voorsprong
...	...	...	...	...

object_properties_history

Dit databaseobject bevat historische eigenschapswaarden. Voor contactpersonen bevat het de 45 meest recente waarden. Voor alle andere objecten bevat het de 20 meest recente waarden. Geeft een rij weer voor elke historische eigenschapswaarde. De huidige waarde van een eigenschap wordt bepaald door de meest recente UPDATEDAT-tijdstempelin de geschiedenis van de eigenschap.

Dit databaseobject kan de volgende kolommen retourneren:

Kolomnaam	Type	Beschrijving
`OBJECTTYPEID`	Varchar	De ID van het objecttype (bijvoorbeeld: ‘contacten’ is `0-1`).
`OBJECTID`	Getal	De ID van het record (bijvoorbeeld een contactrecord met ID `123752`).
`NAME`	Varchar	De naam van de eigenschap.
`VALUE`	Tijdstempel	De waarde van de eigenschap.
`UPDATEDAT`	Tijdstempel	De datum en tijd waarop de gegevens voor het laatst zijn bijgewerkt in HubSpot. Meer informatie over kolomgegevenstypen.
`INGESTEDAT`	Tijdstempel	De datum en tijd waarop de gegevens voor het laatst door Snowflake zijn geïmporteerd.

Voorbeeld 1

Haal de geschiedenis van één eigenschap voor één contactpersoon op.

Query:

SELECT objectId, name, value, updatedAt
FROM object_properties_history
WHERE objectTypeId = '0-1'
AND objectId = 136493192
AND name = 'hs_predictivescoringtier'
ORDER BY UPDATEDAT DESC;

Retourneert:

OBJECTID	NAAM	WAARDE	UPDATEDAT
136493192	hs_predictivescoringtier	tier_1	22-06-2022 22:45:05.931
136493192	hs_voorspellingsscoreklasse	tier_2	18-09-2021 08:20:56.622
136493192	hs_voorspellingsscoringsniveau	tier_3	31-11-2019 18:20:22.851
...	...	...	...

Voorbeeld 2

Haal de huidige naam op van alle contactpersonen die ooit de levenscyclusfase 'Abonnee' hebben gehad.

Query:

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'
);

Resultaten:

OBJECTID	VOORNAAM	ACHTERNAAM
54325098	Hobbes	Baron
96805401	Milo	Gold
6922028	Henry	Riley
...	...	...

Associatiequery's

Associatiegegevens zijn beschikbaar in ASSOCIATIONS. Filter op combinedAssociationTypeId om een specifiek associatietype op te halen. Voeg ASSOCIATIONS samen met ASSOCIATION_DEFINITIONS om de gerelateerde objecttypen en associatiedefinitie te identificeren.

association_definitions

Dit databaseobject bevat informatie over alle beschikbare associatietypen tussen HubSpot-objecten, met één rij per associatietype. U kunt dit databaseobject koppelen aan het databaseobject associations om recordspecifieke associatie-informatie op te halen.

Er kunnen meerdere associatietypen bestaan tussen dezelfde objecten. Het hoofdassociatietype, dat wordt weergegeven in HubSpot wanneer records aan elkaar zijn gekoppeld, is de associatie waarbij ISMAINASSOCIATIONDEFINITION true is.

Dit databaseobject kan de volgende kolommen retourneren:

Kolomnaam	Type	Beschrijving
`COMBINEDASSOCIATIONTYPEID`	Varchar	De unieke identificatiecode van de associatiedefinitie.
`CATEGORY`	Varchar	De bron van het associatietype. Een van de volgende: `HUBSPOT_DEFINED`, `USER_DEFINED`, `INTEGRATOR_DEFINED`
`ID`	Getal	De identificatiecode van de associatiedefinitie binnen de betreffende categorie.
`FROMOBJECTTYPEID`	Varchar	De ID van het object dat de bron is van de associatiedefinitie.
`TOOBJECTTYPEID`	Varchar	De ID van het object dat de bestemming is van de associatiedefinitie.
`NAME`	Varchar	De naam van de associatiedefinitie.
`LABEL`	Varchar	Het label van de associatiedefinitie.
`ISMAINASSOCIATIONDEFINITION`	Booleaanse waarde	Geeft aan of de associatiedefinitie het hoofdtype is. Indien true, is dit de definitie die HubSpot weergeeft bij gekoppelde records.
`INGESTEDAT`	Tijdstempel	De datum en tijd waarop de gegevens voor het laatst door Snowflake zijn ingelezen. Lees meer over kolomgegevenstypen.

Voorbeeld 1

Haal de koppelingstypen op die beschikbaar zijn in je account.

Query:

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

Retourneert:

COMBINEDASSOCIATIONTYPE	FROMOBJECTTYPEID	TOOBJECTTYPEID	NAAM
0-1	0-1	0-2	CONTACT_TO_COMPANY
0-2	0-2	0-1	BEDRIJF_OM_CONTACT_OP_TE_NEMEN
0-3	0-3	0-1	DEAL_TO_CONTACT
0-4	0-1	0-3	CONTACT_NAAR_DEAL
0-5	0-3	0-2	DEAL_TO_BEDRIJF
...	...	...	...

Voorbeeld 2

Haal de beschikbare associatietypen tussen deals en bedrijven op.

Query:

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

Geeft het volgende weer:

GECOMBINEERD VERENIGINGSTYPE	VAN OBJECTTYPE-ID	NAAR OBJECTTYPE-ID	NAAM
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

associaties

Dit databaseobject bevat informatie over de koppelingen tussen specifieke records. Elke rij vertegenwoordigt een koppeling van het ene object naar het andere object. Er kunnen rijen in dit databaseobject aanwezig zijn, ook al zijn de records waarnaar wordt verwezen verwijderd. U kunt controleren of records bestaan door een join uit te voeren met de objectentabel.

Dit databaseobject bevat koppelingsrecords voor alle koppelingstypen. Filter op ` combinedAssociationTypeId ` en voer een join uit met ` ASSOCIATION_DEFINITIONS ` wanneer u metadata over koppelingen nodig hebt.

Dit databaseobject kan de volgende kolommen retourneren:

Kolomnaam	Type	Beschrijving
`COMBINEDASSOCIATIONTYPEID`	Varchar	De unieke identificatiecode van de associatiedefinitie.
`FROMOBJECTID`	Getal	De ID van het bronobject.
`TOOBJECTID`	Getal	De ID van het doelobject.
`INGESTEDAT`	Tijdstempel	De datum en tijd waarop de gegevens voor het laatst door Snowflake zijn ingelezen. Meer informatie over kolomgegevenstypen.

Voorbeeld 1

Haal alle gekoppelde deals en contactpersonen op.

Query:

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

Retourneert:

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

Voorbeeld 2

Haal alle tickets op die gekoppeld zijn aan een specifiek contact (contact-ID: 3005).

Query:

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

Resultaat:

GECOMBINEERD VERBINDINGSTYPE	VAN OBJECT-ID	TOT OBJECT-ID
0-5	6626541373	233620335

Voorbeeld 3

Haal alle deals op die gekoppeld zijn aan een specifiek contact (contact-ID: 4464). In plaats van combinedAssociationTypeId hard te coderen, maakt dit voorbeeld gebruik van een join met association_definitions.

Query:

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;

Resultaten:

GECOMBINEERD ASSOCIATIETYPE-ID	VANOBJECTID	TOT OBJECT-ID
0-5	6626541373	233620335

Eigenaarsquery's

eigenaren

Dit databaseobject bevat informatie over de gebruikers in je HubSpot-account. Gebruikers kunnen worden ingesteld als recordeigenaren en bevatten zowel een gebruikers-ID als een eigenaars-ID, afhankelijk van hun context. Beide ID's kunnen worden gebruikt om dezelfde gebruiker te identificeren.

Dit databaseobject kan de volgende kolommen retourneren:

Kolomnaam	Type	Beschrijving
`OWNERID`	Getal	De eigenaars-ID van de gebruiker.
`USERID`	Getal	De gebruikers-ID van de gebruiker. Gebruikers met de waarde NULL in deze kolom zijn verwijderd.
`EMAIL`	Varchar	Het e-mailadres van de gebruiker.
`FIRSTNAME`	Varchar	De voornaam van de gebruiker.
`LASTNAME`	Varchar	De achternaam van de gebruiker.
`ARCHIVED`	Boolean	Of de gebruiker is verwijderd.
`CREATEDAT`	Tijdstempel	De datum en tijd waarop de gebruiker in HubSpot is aangemaakt. Zie kolomdatatypen voor meer informatie.
`UPDATEDAT`	Tijdstempel	De datum en tijd waarop de gebruiker voor het laatst is bijgewerkt in HubSpot. Zie kolomgegevenstypen voor meer informatie.
`INGESTEDAT`	Tijdstempel	De datum en tijd waarop de gegevens voor het laatst door Snowflake zijn geïmporteerd.

Voorbeeld 1

Alle gebruikers ophalen. Het filter WHERE archived = false verwijdert verwijderde gebruikers uit de geretourneerde gegevens.

Query:

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

Retourneert:

OWNERID	USERID	EMAIL	VOORNAAM	ACHTERNAAM
29584574	4621126	233620335	Hobbes	Baron
30532717	4874784	3866015468	Pablo	Walters
30580321	925511	7132752747	Milo	Goud
...	...	...	...	...

Voorbeeld 2

Een specifieke eigenaar ophalen op basis van zijn eigenaar-ID.

Query:

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

Resultaat:

EIGENAARID	GEBRUIKERS-ID	E-MAIL	VOORNAAM	ACHTERNAAM
29584574	4621126	233620335	Hobbes	Baron

Voorbeeld 3

Alle contacten en hun eigenaren ophalen. Deze query koppelt records aan eigenaren met behulp van ` object_with_object_properties ` en de contact-eigenschap ` hubspot_owner_id`.

SELECT

contact.objectId ALS contact_id,

contact.properties:firstname::string AS contact_voornaam,

contact.properties:lastname::string AS contact_achternaam,

contact.properties:hubspot_owner_id::getal AS contact_hubspot_owner_id,

owner.firstname AS owner_voornaam,

owner.lastname AS eigenaar_achternaam,

e-mail van eigenaar AS e-mail_eigenaar

VAN object_met_object_eigenschappen AS contact

JOIN eigenaren AS eigenaar

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

WAAR contact.objectTypeId = '0-1';

Resultaten:

CONTACTID	CONTACT_VOORNAAM	CONTACT_ACHTERNAAM	CONTACT_HUBSPOT_EIGENAAR_ID	EIGENAAR_VOORNAAM	EIGENAAR_ACHTERNAAM	E-MAIL_EIGENAAR
113834202	Richard	Greenfield	29584574	Hobbes	Baron	hobbes.b@business.com
53540801	Ford	Karl	30241125	Milo	Gold	milo.g@business.com
...	...	...	...	...	...	...

Teamquery's

teams

Met teams in HubSpot kun je je gebruikers in groepen indelen voor organisatorische en rapportagedoeleinden. Je kunt een hoofdteam en extra teams hebben.

Dit databaseobject bevat informatie over de teams in je HubSpot-account.

Dit databaseobject kan de volgende kolommen retourneren:

Kolomnaam	Type	Beschrijving
TEAMID	Getal	De team-ID.
TEAMNAME	Varchar	De teamnaam.
PARENTTEAMID	Getal	Het team-ID van het bovenliggende team.
CHILDTEAMIDS	Array	De team-ID's van de onderliggende teams.
PRIMARYOWNERMEMBERS	Varchar	De eigenaars-ID's van de primaire teamleden.
SECONDARYOWNERMEMBERS	Boolean	De eigenaar-ID's van de secundaire leden van het team.
INGESTEDAT	Tijdstempel	De datum en tijd waarop de gegevens voor het laatst door Snowflake zijn ingelezen.

Voorbeeld 1

Alle teams ophalen.

Query:

SELECT teamId,teamName, primaryOwnerMembers

FROM teams

Geeft het volgende weer:

TEAMID	TEAMNAAM	PRIMAIRE EIGENAAR LEDEN
29584574	Subteam	[233620335, 1234553]
30532717	Superteam	[3866015468, 126221873]
3058032	A-team	[7132752747]

owner_team

Dit databaseobject bevat informatie over welke eigenaren bij welke teams in je HubSpot-account horen.

Dit databaseobject kan de volgende kolommen retourneren:

Kolomnaam	Type	Beschrijving
TEAMID	Getal	De team-ID.
OWNERID	Nummer	De eigenaar-ID van de gebruiker.
ISTEAMPRIMARY	Booleaanse waarde	Geeft aan of dit het primaire team is voor deze eigenaar.
INGESTEDAT	Tijdstempel	De datum en tijd waarop de gegevens voor het laatst door Snowflake zijn ingelezen.

Voorbeeld 1

Haal alle eigenaren voor een bepaald team op.

Query:

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

Geeft het volgende terug

TEAMID	TEAMNAME	ISTEAMPRIMARY
29584574	233620335	TRUE
29584574	1234553	WAAR

Pijplijnquery's

Hieronder leert u hoe u deal- en ticketpijplijngegevens, zoals de beschikbare pijplijnen in uw account en de fasen daarvan.

Je kunt deze gegevens koppelen aan objectgegevens om een volledig overzicht van je pijplijnen te krijgen. Je kunt bijvoorbeeld deals en hun pijplijnen opvragen door ` object_with_object_properties ` te koppelen aan pipelines`.

pipelines

Dit databaseobject bevat informatie over de deal- en ticketpijplijnen in uw account. Elke geretourneerde rij vertegenwoordigt één pijplijn.

Deze tabel kan de volgende kolommen retourneren:

Kolomnaam	Type	Beschrijving
`PIPELINEID`	Varchar	Het ID van de pijplijn.
`OBJECTTYPEID`	Varchar	De ID van het object dat de pijplijn kan bevatten (bijv. deals of tickets).
`LABEL`	Varchar	De naam van de pijplijn in HubSpot.
`DISPLAYORDER`	Getal	De volgorde waarin de pijplijn in HubSpot wordt weergegeven.
`ARCHIVED`	Booleaanse waarde	Of de pijplijn is verwijderd.
`CREATEDAT`	Tijdstempel	Wanneer de pijplijn is aangemaakt.
`UPDATEDAT`	Tijdstempel	De datum en tijd waarop de gegevens voor het laatst zijn bijgewerkt in HubSpot. Lees meer over kolomgegevenstypen.
`INGESTEDAT`	Tijdstempel	De datum en tijd waarop de gegevens voor het laatst door Snowflake zijn geïmporteerd.

Voorbeeld 1

Haal alle beschikbare deal-pijplijnen op, gesorteerd op hun volgorde in HubSpot.

Query:

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

Geeft het volgende weer:

OBJECTTYPEID	PIPELINEID	LABEL
0-3	1bed503c-37f7-4f51-9d40-7598902673f4	Verkoop-pijplijn
0-3	12659678	Licentiespijplijn
0-3	75e28846-ad0d-4be2-a027-5e1da6590b98	Nieuwe zaken
...	...	...

Voorbeeld 2

Haal deals binnen een specifieke pijplijn op met behulp vanobject_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';

Retourneert:

DEAL_ID	DEAL_NAME	PIPELINE_NAME
605140072	Meowmix Global Aanmelding	Verkoop-pijplijn
605457408	Friskies-rebranding	Verkooppijplijn
604362473	Ontwikkeling van de Fresh Step-app	Verkoop-pijplijn

pipeline_stages

Deze weergave bevat informatie over afzonderlijke fasen binnen een pijplijn. Identificeer fasen door de objecttype-ID, pijplijn-ID en fase-ID te combineren. Gebruik bij het koppelen met pijplijnen de objecttype-ID en pijplijn-ID.

Dit databaseobject kan de volgende kolommen retourneren:

Kolomnaam	Type	Beschrijving
`PIPELINEID`	Varchar	Het ID van de pijplijn.
`STAGEID`	Varchar	De ID van de fase.
`LABEL`	Varchar	De naam van het podium in HubSpot.
`DISPLAYORDER`	Nummer	De volgorde waarin de pijplijn in HubSpot wordt weergegeven.
`METADATA`	Variant	Een beschrijving van de fase in JSON-formaat, inclusief of deze open of gesloten is
`ARCHIVED`	Booleaanse waarde	Geeft aan of de pijplijnfase is verwijderd.
`CREATEDAT`	Tijdstempel	Wanneer de pijplijnfase is aangemaakt.

Voorbeeld 1

Haal de pijplijnfasen op voor een dealpijplijn met de naam'Sales pipeline'.

Query:

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;

Retourneert:

PIPELINEID	STAGEID	LABEL
941650	941651	Gecontacteerd
941650	941652	Afspraak gepland
941650	941653	Factuur verzonden
...	...	...

Voorbeeld 2

Haal alle deals en hun respectievelijke pijplijnfasen op.

Query:

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';

Resultaten:

DEAL_ID	DEAL_NAME	PIPELINE_NAME	PIPELINE_FASE_NAAM
605140072	Meowmix Wereldwijde aanmelding	Verkoop-pijplijn	Contract verzonden
605457408	Friskies-rebranding	Verkooppijplijn	Afspraak gepland
604362473	Fresh Step-app ontwikkelen	Verkooppijplijn	Contract ondertekend
...	...	...	...

Vastgoedquery's

property_definitions

Dit databaseobject bevat informatie over objecteigenschappen en gebeurteniseigenschappen in uw HubSpot-account. Gebeurteniseigenschappen omvatten standaardgebeurtenissen, zoals het openen van e-mails en klikken, en aangepaste gedragseigenschappen van gebeurtenissen. Deze informatie kan nuttig zijn voor het definiëren van waarden die te vinden zijn in object_properties- en events-gegevens.

U kunt specifieke eigenschappen identificeren door de ID en naam van het objecttype te combineren. U kunt soortgelijke informatie ophalen met behulp van de properties-API.

Dit databaseobject kan de volgende kolommen retourneren:

Kolomnaam	Type	Beschrijving
`OBJECTYPEID`	Varchar	Het ID van het object waarop de gebeurtenis betrekking heeft.
`NAME`	Varchar	De interne naam van de eigenschap.
`LABEL`	Varchar	Het label van de eigenschap.
`DESCRIPTION`	Varchar	De beschrijving van de eigenschap.
`TYPE`	Varchar	Het type van de eigenschap (bijv. tekenreeks, getal, datum/tijd).
`FIELDTYPE`	Varchar	Het veldtype van de eigenschap. Bepaalt hoe de eigenschap wordt weergegeven in HubSpot en op formulieren (bijv. selectievakje, keuzelijst).
`DISPLAYORDER`	Getal	De weergavevolgorde van de eigenschap.
`GROUPNAME`	Varchar	De groepsnaam van de eigenschap.
`OPTIONS`	Variant	Voor opsommingskenmerken: een array met de opties van het kenmerk, inclusief de attributen van elke optie (bijv. weergavevolgorde, label).
`CREATEDUSERID`	Getal	Het ID van de gebruiker die de eigenschap heeft aangemaakt.
`REFERENCEDOBJECTTYPE`	Varchar	Het type object waarnaar de eigenschap verwijst. Bij eigenschappen van de eigenaar wordt de waarde OWNER geretourneerd.
`CALCULATED`	Boolean	Geeft aan of de eigenschap een berekende eigenschap is.
`EXTERNALOPTIONS`	Booleaanse waarde	Geeft aan of de opties van de eigenschap in een extern systeem zijn gedefinieerd.
`HASUNIQUEVALUE`	Booleaanse waarde	Geeft aan of de waarden van de eigenschap uniek zijn. Kan alleen worden ingesteld bij het aanmaken van een eigenschap via de API.
`HIDDEN`	Booleaanse waarde	Geeft aan of de eigenschap verborgen is in HubSpot.
`SHOWCURRENCYSYMBOL`	Booleaanse waarde	Of de waarde van een getal-eigenschap wordt weergegeven als valuta.
`FORMFIELD`	Booleaanse waarde	Of deze eigenschap in formulieren kan worden gebruikt.
`READONLYDEFINITION`	Booleaanse waarde	Of de eigenschap kan worden bewerkt in HubSpot.
`READONLYVALUE`	Booleaanse waarde	Of de waarde van de eigenschap kan worden bewerkt in HubSpot.
`HUBSPOTDEFINED`	Booleaanse waarde	Geeft aan of de eigenschap door HubSpot is aangemaakt, in plaats van door een gebruiker.
`ARCHIVED`	Booleaanse waarde	Geeft aan of de eigenschap is verwijderd.
`CREATEDAT`	Tijdstempel	De datum en tijd waarop de eigenschap in HubSpot is aangemaakt.
`UPDATEDAT`	Tijdstempel	De datum en tijd waarop de gegevens voor het laatst zijn bijgewerkt in HubSpot. Lees meer over kolomgegevenstypen.
`INGESTEDAT`	Tijdstempel	De datum en tijd waarop de gegevens voor het laatst door Snowflake zijn geïmporteerd.

Voorbeeld 1

Haal de namen en beschrijvingen op voor alle contact-eigenschappen.

Query:

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

Retourneert:

NAME	LABEL	BESCHRIJVING
entered_sql_stage	SQL-fase ingevoerd	Start het tellen van de dagen in de SQL-fase.
first_conversion_event_name	Eerste conversie	Het eerste formulier dat deze contactpersoon heeft ingediend.
adres	Straatadres	Het adres van de contactpersoon.

Gebeurtenisquery's

Gebeurtenissen omvatten standaard HubSpot-gebeurtenissen en aangepaste gedragsgebeurtenissen. Elke gebeurtenis heeft een eigen databaseobject, met de naam events_eventname.

Naam
EVENTS_AD_INTERACTION	Details van een advertentie en contacten die ermee hebben geïnterageerd door op de advertentie te klikken of een formulier in te vullen na interactie met de advertentie.
EVENTS_AD_METRICS_IMPORTED_V0	Gegevens over een advertentie en de prestatiestatistieken ervan.
EVENTS_CALL_MENTIONED_KEYWORD	Details van zoekwoorden die door deelnemers aan gesprekken zijn genoemd.
EVENTS_CLICKED_LINK_IN_EMAIL_V2	Links waarop contactpersonen in marketing-e-mails hebben geklikt.
EVENTS_CLICKED_LINK_IN_TRACKED_INBOX_EMAIL_V8	Links waarop contactpersonen hebben geklikt in e-mails in de Conversations-inbox.
EVENTS_COOKIE_BANNER_CLICKED	Contactpersonen die op cookies hebben geklikt.
EVENTS_COOKIE_BANNER_VIEWED	Contactpersonen die de cookie-informatie hebben bekeken.
EVENTS_DOCUMENT_SHARED_V2	Verkoopdocumenten die via een externe link met contactpersonen zijn gedeeld.
EVENTS_DOCUMENT_VIEWED_V2	Verkoopdocumenten en contactpersonen die deze hebben bekeken door de externe link te openen.
EVENTS_DOCUMENT_COMPLETED_V2	Verkoopdocumenten en contactpersonen die deze hebben afgesloten.
EVENTS_HS_SCHEDULED_EMAIL_V2	E-mails die zijn verzonden naar de e-mailservers van HubSpot om te worden verstuurd.
EVENTS_MTA_DELIVERED_EMAIL_V2	E-mails die met succes door de e-mailservers van HubSpot bij de ontvangers zijn afgeleverd.
EVENTS_MTA_BOUNCED_EMAIL_V2	Pogingen tot aflevering van e-mails die door de e-mailserver van de ontvanger zijn geweigerd.
EVENTS_OPENED_EMAIL_V2	E-mails die door contactpersonen zijn geopend.
EVENTS_REPORTED_SPAM_EMAIL_V2	E-mails die door ontvangers als spam zijn gemarkeerd.
EVENTS_UPDATED_EMAIL_SUBSCRIPTION_STATUS_V2	Wijzigingen in e-mailabonnementen door ontvangers.
EVENTS_OPENED_TRACKED_INBOX_EMAIL_V8	Geregistreerde e-mails in de Inbox die door contactpersonen zijn geopend.
EVENTS_MB_MEDIA_PLAYED	Activiteit met betrekking tot het afspelen van video's door contactpersonen.
EVENTS_V2_CONTACT_BOOKED_MEETING_THROUGH_SEQUENCE	Contactpersoon heeft een afspraak geboekt via een reeks.
EVENTS_V2_CONTACT_ENROLLED_IN_SEQUENCE	Contact heeft zich via een reeks aangemeld.
EVENTS_V2_CONTACT_HEEFT_SEQUENTIE_VOLTOOID	De reeks is voltooid.
EVENTS_V2_CONTACT_REPLIED_SEQUENCE_EMAIL	Contactpersoon heeft gereageerd op de e-mail (of inkomende e-mail waarmee de inschrijving voor de reeks is geannuleerd) die via de reeks is verzonden.
EVENTS_V2_CONTACT_AFGEMELD_VAN_SEQUENTIE	Contactpersoon heeft zich afgemeld voor de reeks.
EVENTS_V2_CONTACT_HANDMATIG_UIT_SEQUENTIE_AFGEMELD	De gebruiker heeft de contactpersoon handmatig uitgeschreven.
EVENTS_V2_CONTACT_AFGEMELD_SEQUENTIE_E-MAIL	Contact heeft zich afgemeld, waardoor de reeks is beëindigd.
EVENTS_V2_SEQUENCE_EMAIL_BOUNCED	De e-mail van de reeks is teruggestuurd.
EVENTS_V2_SEQUENCE_ERRORED	Er is een fout opgetreden in de reeks, waardoor de afmelding is geactiveerd.
EVENTS_V2_SEQUENCE_STEP_EXECUTED	Stap in de reeks uitgevoerd.
EVENTS_VISITED_PAGE	Bezoeken aan webpagina's door contactpersonen.
EVENTS_<INTEGRATION_EVENT_NAME>_<UNIQUE_IDENTIFIER>	Integratiegebeurtenissen (Timeline V3 API)

U kunt gebeurtenissen identificeren door de ID van het gebeurtenistype te combineren met de ID van de gebeurtenis. De kolommen die worden geretourneerd, zijn afhankelijk van de gebeurtenis, met één kolom voor elke eigenschap van de gebeurtenis. Alle gebeurtenissen retourneren de volgende kolommen:

Let op: HubSpot heeft twee nieuwe kolommen toegevoegd aan alle gebeurtenistabellen en weergaven:

occurredat
occurredatdateint

Deze kolommen vervangen op 24 november 2022 de kolommen occuredat ` en occuredatdateint. Vanaf die datum zijn de oude kolommen niet meer beschikbaar en zullen pogingen om een databaseobject of weergave met gebeurtenissen op te vragen met behulp van die kolommen mislukken. Lees meer over ingrijpende wijzigingen voor Snowflake-gegevensdelingen.

Kolomnaam	Type	Beschrijving
`EVENTTYPEID`	Varchar	De ID van het gebeurtenistype, vergelijkbaar met OBJECTTYPEID U kunt alle gebeurtenistype-ID's in uw account opvragen via de weergave object_and_event_type_definitions.
`ID`	Varchar	Deze is uniek per gebeurtenistype. Binnen een bepaald gebeurtenistype zullen geen twee records dezelfde ID hebben.
`OBJECTTYPEID`	Varchar	Het type object dat de gebeurtenis heeft voltooid. Bijvoorbeeld: bij een klik op een e-maillink wordt in deze kolom`0-1` weergegeven, wat staat voor het contactenobject.
`OBJECTID`	Getal	Het ID van het record dat de gebeurtenis heeft voltooid.
`OCCURREDAT`	Tijdstempel	Wanneer de gebeurtenis plaatsvond.
`OCCURREDATDATEINT`	Getal	Een getal dat aangeeft wanneer de gebeurtenis plaatsvond. Bevat dezelfde gegevens als de kolom `OCCURREDAT`, maar is opgemaakt als een getal en wordt gebruikt als onderdeel van de clustersleutel van de tabel. In de meeste gevallen kunt u de tijdstempel `OCCURREDAT` gebruiken in plaats van dit getal.
`OCCUREDATDATEINT`	Getal	Een getal dat aangeeft wanneer de gebeurtenis plaatsvond. Bevat dezelfde gegevens als de kolom `OCCURREDAT`, maar is opgemaakt als een getal en wordt gebruikt als onderdeel van de clustersleutel van de tabel. In de meeste gevallen kunt u de tijdstempel `OCCURREDAT` gebruiken in plaats van dit getal. Let op: deze kolom wordt op 24 november 2022 afgeschaft en vervangen door `OCCURREDATDATEINT`.
`OCCUREDAT`	Tijdstempel	Wanneer de gebeurtenis plaatsvond. Let op: deze kolom wordt op 24 november 2022 afgeschaft en vervangen door `OCCURREDAT`.
`INGESTEDAT`	Tijdstempel	De datum en tijd waarop de gegevens voor het laatst door Snowflake zijn ingelezen. Meer informatie over kolomgegevenstypen.
`PROPERTY_*`	Varchar	Afzonderlijke kolommen met de gebeurteniseigenschappen.

Voorbeeld 1

Haal de 50 meest recente e-mailklikgebeurtenissen op.

Query:

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;

Geeft het volgende weer:

EVENTTYPEID	OBJECTTYPEID	OBJECTID	OCCUREDAT	HS_CLICK_RAW_URL
4-666288	0-1	45318579	04-08-2016 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	29-08-2016 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	30-11-2017 14:27:11.528	https://hubs.ly/H097a37a?utm_source=hs_email&utm_medium=email&utm_content=58251290
...	...	...	...	...

Voorbeeld 2

Haal alle e-mailklikgebeurtenissen op van de contactpersonen die hebben geklikt. Deze query haalt contactgegevens op door middel van een join met object_with_object_properties.

Query:

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;

Resultaten:

KLIK_TIJDSTIP	KLIK_URL	CONTACT_VOORNAAM	CONTACT_ACHTERNAAM
4 januari 2019 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
8 november 2018 09:37:41.400	https://www.website.net/webinar-case-study?utm_source=hs_automation&utm_medium=email&utm_content=55200164	Milo	Goud
8 november 2018 09:37:41.426	https://www.website.net/contact?utm_source=hs_automation&utm_medium=email&utm_content=55200164	Harlow	Villari
...	...	...	...

Object-en-gebeurtenistype-query's

object_and_event_type_definitions

Dit databaseobject bevat definities voor alle objecten en gebeurtenissen die beschikbaar zijn in je HubSpot-account.

Dit databaseobject kan de volgende kolommen retourneren:

Kolomnaam	Type	Beschrijving
`OBJECTTYPEID`	Varchar	Het ID van het object dat de pijplijn kan bevatten (bijvoorbeeld deals of tickets).
`FULLYQUALIFIEDNAME`	Varchar	De naam van het object of de gebeurtenis.
`INGESTEDAT`	Tijdstempel	De datum en tijd waarop de gegevens voor het laatst door Snowflake zijn ingelezen. Meer informatie over kolomgegevenstypen.

Voorbeeld 1

Haal alle objecten en gebeurtenissen op die beschikbaar zijn in uw HubSpot-account.

Query:

SELECT objectTypeId, fullyQualifiedName
FROM object_and_event_type_definitions;

Retourneert:

OBJECTTYPEID	FULLYQUALIFIEDNAME
0-1	CONTACT
0-8	REGEL_ITEM
0-11	GESPREK
...	...

Segmentquery's

Hieronder leert u hoe u query's kunt uitvoeren op uw segmenten, zoals de beschikbare contact- en bedrijfssegmenten en de records die in die segmenten zijn opgenomen.

segmenten

Dit databaseobject bevat informatie over HubSpot-contact- en bedrijfssegmenten. Het retourneert één rij per segment, en de kolommen bevatten segmentdetails zoals de segmentnaam, de omvang en het objecttype van de records die het bevat. Het bevat geen informatie over de afzonderlijke records binnen elk segment (zie segment_membership).

Dit databaseobject kan de volgende kolommen retourneren:

Kolomnaam	Type	Beschrijving
`OBJECTTYPEID`	Varchar	Het type records in het segment (bijv. contactpersoon of bedrijf).
`SEGMENTID`	Getal	Het ID van het segment. Wordt gekoppeld aan de kolomSEGMENTID in de tabel met segmentlidmaatschappen.
`CLASSICSEGMENTID`	Getal	Een ID dat specifiek is voor contactsegmenten en dat overeenkomt met het ID in de URL van het segment in HubSpot.
`NAME`	Varchar	De naam van het segment.
`SIZE`	Getal	Het aantal records in het segment.
`CREATEDBYUSERID`	Getal	De ID van de gebruiker die het segment heeft aangemaakt.
`CREATEDAT`	Tijdstempel	Wanneer het segment in HubSpot is aangemaakt.
`UPDATEDBYUSERID`	Getal	De ID van de gebruiker die het segment het laatst heeft bijgewerkt.
`UPDATEDAT`	Tijdstempel	De datum en tijd waarop het segment voor het laatst is bijgewerkt in HubSpot. Lees meer over kolomgegevenstypen.
`INGESTEDAT`	Tijdstempel	De datum en tijd waarop de gegevens voor het laatst door Snowflake zijn geïmporteerd.

Voorbeeld 1

Haal alle contactsegmenten op.

Query:

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

Retourneert:

SEGMENTSID	NAAM	SIZE
118131	Wekelijkse outreach	103
66156	Blogabonnees	455
771.852	Topabonnees 2021	37
...	...	...

Voorbeeld 2

Haal een specifiek contactsegment met de naam 'Topabonnees 2021' op.

Zoekopdracht:

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

Resultaat:

SEGMENTID	NAAM	GROOTTE
771.852	Topabonnees 2021	37

segment_membership

Dit databaseobject bevat informatie over welke records lid zijn van welke segmenten, met één rij per record in het segment. Als u bijvoorbeeld een segment 'Blogabonnees' hebt met 500 contacten, retourneert het databaseobject 500 rijen.

Bevat alleen segment-ID's en object-ID's. Voor meer informatie kunt u een koppeling maken met het databaseobject 'segments '.

Dit databaseobject kan de volgende kolommen retourneren:

Kolomnaam	Type	Beschrijving
`SEGMENTID`	Varchar	Het ID van het segment. Koppelt aan de kolom HS_SEGMENT_ID in de tabel segments.
`OBJECTID`	Varchar	Het ID van het record in het segment.
`UPDATEDAT`	Tijdstempel	De datum en tijd waarop de gegevens voor het laatst zijn bijgewerkt in HubSpot. Lees meer over kolomgegevenstypen.
`INGESTEDAT`	Tijdstempel	De datum en tijd waarop de gegevens voor het laatst door Snowflake zijn geïmporteerd.

Voorbeeld 1

Haal de ID's op van alle contacten in het segment'Topabonnees 2021 '.

Query:

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';

Retourneert:

OBJECTID

54325098

96805401

6922028

...

Voorbeeld 2

Haal de voor- en achternamen op van de contactpersonen in het segment 'Topabonnees 2021 '.

Query:

SELECT

contact.objectId ALS object_id,

contact.properties:firstname::string AS voornaam,

contact.properties:lastname::string AS lastname

VAN object_met_object_eigenschappen AS contact

INNER JOIN segment_lidmaatschappen AS lidmaatschap

ON contact.objectId = lidmaatschap.objectId

INNER JOIN segmenten

WAAR lidmaatschap.segmentId = segmenten.segmentId

WAAR contact.objectTypeId = '0-1'

EN segments.objectTypeId = '0-1'

EN segments.name = 'Topabonnees 2021';

Resultaat:

OBJECTID	VOORNAAM	ACHTERNAAM
54325098	Hobbes	Baron
96805401	Milo	Gold
6922028	Henry	Riley
...	...	...

Veelgestelde vragen

Ik wil gegevens genereren die vergelijkbaar zijn met een rapport uit de HubSpot-app. Hoe pak ik dat aan?

Over het algemeen moet u kijken naar de kolommen in het rapport waarmee u vergelijkt. Als de rapportvisualisatie niet in tabelvorm is, kunt u deze omzetten in een tabel om te zien welke kolommen het rapport bevat. Deze kolommen zijn meestal eigenschappen van een objecttype of een gebeurtenistype. De volgende stap is om uit te zoeken aan welke eigenschap van het objecttype een kolom overeenkomt. U kunt dit doen door een query uit te voeren op property_definitions:

SELECT * FROM property_definitions

WHERE label = [column_name]

Er is misschien niet altijd een exacte overeenkomst, omdat sommige eigenschapsnamen in de app meestal worden omgezet naar een meer beschrijvende naam. In dergelijke gevallen kan het helpen om een fuzzy-zoekopdracht uit te voeren met de LIKE-operator op de kolom ‘label’ (of zelfs ‘description’) in property_definitions.

Nadat je hebt vastgesteld bij welk objecttype de kolom hoort, is het eenvoudig om te bepalen wat je moet opvragen. Voer een query uit op object_with_object_properties ` en filter op de ` objectTypeId ` voor dat type. Lees de benodigde eigenschapswaarden uit de JSON-kolom `properties`.

Hoe koppel ik dit gegevenstype aan een ander, bijvoorbeeld om formulieren voor een campagne op te halen?

Om de formulieren op te halen die aan elke campagne zijn gekoppeld, voeg je OBJECT_WITH_OBJECT_PROPERTIES, ASSOCIATIONS en ASSOCIATION_DEFINITIONS samen.

SELECT DISTINCT

campaigns.properties:hs_name::string AS campaign_name,

formulieren.eigenschappen:hs_formulier_id::string AS form_id

VAN object_met_object_eigenschappen AS campagnes

JOIN associaties AS vereniging

OP vereniging.vanObjectId = campagnes.objectId

JOIN associatiedefinities AS definition

ON definitie.combinedAssociationTypeId =

associatie.combinedAssociationTypeId

JOIN object_met_object_eigenschappen AS formulieren

ON forms.objectId = association.toObjectId

WAAR campaigns.objectTypeId = '0-35'

EN forms.objectTypeId = '0-28'

EN definition.fromObjectTypeId = '0-35'

EN definition.toObjectTypeId = '0-28';

Hoe kom ik te weten wat de status is van de HubSpot-Snowflake-integratie?

Om realtime statusupdates te ontvangen over storingen en problemen met de HubSpot-Snowflake-integratie, voer je een query uit op de weergave data_share_status:

SELECT * FROM hubspot.public.data_share_status LIMIT 1

De resultaten worden als volgt weergegeven:

STATUS	BERICHT	BIJGEWERKT OP
OK	OP DIT MOMENT ZIJN ER GEEN INCIDENTEN BEKEND	10-04-2023 09:21:20.123

Deze weergave biedt updates over de integratiestatus in omgekeerde chronologische volgorde. Door de resultaten van deze query in een dashboard te integreren, kunt u de prestaties van de integratie volgen en eventuele downtime of storingen detecteren.

Was dit artikel nuttig?

Dit formulier wordt alleen gebruikt voor feedback op documentatie. Ontdek hoe je hulp krijgt met HubSpot.

HubSpot-gegevens opvragen in Snowflake

Beschikbaar met elk van de volgende abonnementen, behalve waar vermeld:

Gegevensvertraging en de regio van uw Snowflake-account

Je Snowflake-omgeving instellen

Gegevensoverzicht

Het beperken en sorteren van geretourneerde gegevens

Gegevenstypen van kolommen

Gegevenstypen omzetten

Objectquery's

object_with_object_properties

Voorbeeld 1

Voorbeeld 2

objecten

Voorbeeld 1

object_properties

Voorbeeld 1

Voorbeeld 2

object_properties_history

Voorbeeld 1

Voorbeeld 2

Associatiequery's

association_definitions

Voorbeeld 1

Voorbeeld 2

associaties

Voorbeeld 1

Voorbeeld 2

Voorbeeld 3

Eigenaarsquery's

eigenaren

Voorbeeld 1

Voorbeeld 2

Voorbeeld 3

Teamquery's

teams

Voorbeeld 1

owner_team

Voorbeeld 1

Pijplijnquery's

pipelines

Voorbeeld 1

Voorbeeld 2

pipeline_stages

Voorbeeld 1

Voorbeeld 2

Vastgoedquery's

property_definitions

Voorbeeld 1

Gebeurtenisquery's

Voorbeeld 1

Voorbeeld 2

Object-en-gebeurtenistype-query's

object_and_event_type_definitions

Voorbeeld 1

Segmentquery's

segmenten

Voorbeeld 1

Voorbeeld 2

segment_membership

Voorbeeld 1

Voorbeeld 2

Veelgestelde vragen

Ik wil gegevens genereren die vergelijkbaar zijn met een rapport uit de HubSpot-app. Hoe pak ik dat aan?

Hoe koppel ik dit gegevenstype aan een ander, bijvoorbeeld om formulieren voor een campagne op te halen?

Hoe kom ik te weten wat de status is van de HubSpot-Snowflake-integratie?

Gerelateerde documentatie