Doorgaan naar artikel
Let op: De Nederlandse vertaling van dit artikel is alleen bedoeld voor het gemak. De vertaling wordt automatisch gemaakt via een vertaalsoftware en is mogelijk niet proefgelezen. Daarom moet de Engelse versie van dit artikel worden beschouwd als de meest recente versie met de meest recente informatie. U kunt het hier raadplegen.

HubSpot-gegevens opvragen in Snowflake

Laatst bijgewerkt: 3 september 2025

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

Nadat je Snowflake hebt gekoppeld met je HubSpot-account, kun je Snowflake's Data Share gebruiken om HubSpot-gegevens te bevragen vanuit je Snowflake-account.

Gegevensachterstand en uw Snowflake-accountregio

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

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

Stel uw Snowflake-omgeving in

Om je HubSpot-gegevens in Snowflake te bevragen, moet je het magazijn, de database en het schema selecteren van waaruit je een query wilt uitvoeren. Je kunt ze op werkbladniveau instellen om ze automatisch op te nemen in je query's, of je kunt ze handmatig toevoegen.

Uw magazijn, database en schema selecteren op werkbladniveau:

  • Klik in de bovenste rij van het werkblad op de werkbladactiebalk.

    snowflake-worksheet-settings0
  • In het pop-upvenster:
    • Klik op het vervolgkeuzemenu Warehouse en selecteer vervolgens je warehouse.
    • Klik op het vervolgkeuzemenu Database en selecteer je HubSpot-database.
    • Klik op het vervolgkeuzemenu Schema en selecteer het schema dat je wilt gebruiken:
        • V2_DAILY: het dagelijkse schema om gegevens op te vragen op basis van tabellen. Gegevens in dit schema worden eenmaal per dag bijgewerkt. Het gebruik van dit schema resulteert in snellere query's en wordt aanbevolen voor query's direct in Snowflake.
        • V2_LIVE: het live schema gebaseerd op Secure Views van HubSpot gegevens. Gegevens in dit schema worden tot elke 15 minuten bijgewerkt. Als je query's uitvoert op een grote set gegevens, kunnen query's traag zijn. In dat geval is het aan te raden om de gegevens eerst met een ETL-proces naar je eigen tabel te kopiëren en dan query's in die tabel uit te voeren.


      snowflake-worksheet-settings-window0

Als je omgeving is geconfigureerd, kun je query's maken naar je HubSpot-gegevens zonder dat je handmatig je database- of schema-type aan query's hoeft toe te voegen.

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


SELECT objectTypeId, property_createddate
FROM hubspot_share_name.V2_LIVE.objects_deals

LIMIT 1

Gegevensoverzicht

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

  • Objecten: standaard en aangepaste objecten, zoals contactpersonen, bedrijven, producten.
  • Records: individuele records, zoals een individueel contact of bedrijf.
  • Associaties: alle beschikbare associatietypen en huidig geassocieerde records.
  • 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 ze zijn ingesteld als eigenaar.
  • Pipelines: deal en ticket pipelines, inclusief pipeline stadia.
  • Eigenschappen: eigenschappen en hun waarden op CRM records, inclusief de geschiedenis van eigenschappen.

Meer informatie over het CRM-gegevensmodel van HubSpot.

Let op: Naarmate we de gegevensdeling ontwikkelen, zullen we wijzigingen introduceren, waarvan sommige een breuk betekenen. Het wordt ten zeerste aanbevolen om je te abonneren op HubSpot's developer change log. Deze wijzigingen worden altijd voorafgaand aan een update in het change log geplaatst.

Teruggestuurde gegevens beperken en ordenen

Bij het samenstellen van query's kun je bepalen hoeveel gegevens worden geretourneerd en in welke volgorde, door LIMIT en ORDER BY in je query op te nemen. Als u bijvoorbeeld een query wilt maken van alle contactpersonen met hun eigenschappen, maar slechts drie resultaten wilt retourneren en deze wilt ordenen op contact-ID, kunt u uw query als volgt construeren:


SELECT objectTypeId, updatedAt, ingestedAt
FROM objects_deals
ORDER BY objectId
LIMIT 10;

Soorten kolomgegevens

Wanneer u gegevens opvraagt 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 linker zijbalk te selecteren.

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

snowflake-sidebar-view-column-details0


Als u een specifieke kolom wilt retourneren, neemt u die kolom op in het veld SELECT van uw query. De volgende query retourneert bijvoorbeeld alleen de kolommen OBJECTID en UpdatedAt:


SELECT
objectId, updatedAt
FROM objects_contacts

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

  • OBJECTTYPEID: een VARCHAR-waarde die het objecttype weergeeft. Bijvoorbeeld, 0-1 vertegenwoordigt het contactpersonenobject, 0-2 vertegenwoordigt het bedrijvenobject en 2-1232 kan een aangepast object in uw account vertegenwoordigen. In segmenten verwijst dit naar het type segment (bijv. contactpersoon of bedrijf). Je kunt alle object- en gebeurtenis-ID's in je account opvragen met de weergave object_en_gebeurtenis_type_definities.
  • OBJECTID: een BIGINT getal dat staat voor een enkele record van een bepaald type object in je HubSpot account. Om een record te identificeren, moet je zowel de objecttype-ID als de object-ID gebruiken.
  • INGESTEDAT: het tijdstempel van wanneer een rij gegevens is toegevoegd aan Snowflake, weergegeven door een TIMESTAMP_NTZ waarde. Niet gerelateerd aan de logische tijdstempel van een aanmaak- of updatebewerking in HubSpot.
    • Door de interne verwerking van HubSpot kan de ingestion timestamp van een rij worden bijgewerkt, zelfs als er geen andere kolommen in de rij zijn gewijzigd.
    • Bij het bouwen van ETL processen die recent gewijzigde data kopiëren, is het aanbevolen om je queries te baseren op de ingestion timestamp. Als je flow dagelijks gegevens kopieert, is het bovendien aan te raden om gegevens van de vorige twee dagen te kopiëren om rekening te houden met vertragingen.
  • CREATEDAT en UPDATEDAT: de logische tijdstempel van wanneer data is gemaakt of bijgewerkt in HubSpot, weergegeven door een TIMESTAMP_NTZ waarde. Deze tijdstempels komen overeen met tijdstempels in HubSpot. De tijd die in HubSpot wordt weergegeven voor de aanmaakdatum van een record is bijvoorbeeld dezelfde als de tijdstempel in de kolom CREATEDAT in Snowflake. Deze zijn niet direct gerelateerd aan de ingestion timestamp en het wordt niet aanbevolen om ETL-processen op deze eigenschappen te baseren.
  • COMBINEDASSOCIATIONTYPE: een VARCHAR-waarde die een unieke associatiedefinitie identificeert.

Gegevenstypen transformeren

Soms worden gegevens geretourneerd uit een query met VARCHAR-kolommen terwijl het wenselijk zou zijn om ze als een ander type te hebben. In dergelijke gevallen is het aan te raden om het VARCHAR-gegevenstype te converteren naar de gewenste types met behulp van Snowflake-functies. Bijvoorbeeld, eigenschappen van een objectrecord worden in de meeste databaseobjecten opgeslagen als VARCHAR-datatypes, maar bevatten soms getal- en datetime-waarden. Functies zoals:
try_to_number, try_to_timestamp_ntz kunnen worden gebruikt om deze VARCHAR-gegevens te converteren naar respectievelijk hun NUMBER- en DATETIME-types:


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

Leer hieronder hoe je gegevens van specifieke HubSpot objecten en records kunt opvragen, samen met de gegevens die worden geretourneerd.

Objectgegevens van verschillende typen zijn op twee manieren georganiseerd en beschikbaar:

  • Individueel: Elk objecttype wordt opgeslagen in een eigen view en bevat alleen records van hetzelfde objecttype, bijv. objects_contacts bevat alleen contactrecords. Hierdoor is het niet meer nodig om een objecttypeid op te geven tijdens het queryen. Deze views zijn eenvoudiger te bevragen omdat je ObjectTypeIds niet hoeft te kennen. Ze retourneren ook gegevens in een meer bruikbare indeling met elke rij die overeenkomt met een object en de huidige versie van zijn eigenschappen. Zolang je geen trage queries ervaart, is het aan te raden om deze views te gebruiken om objectgegevens op te halen. Zie meer in Objects_X weergaven hieronder.
  • Gecombineerd: Alle records voor alle objecttypen worden gecombineerd in één databaseobject. Dus, wanneer je een query uitvoert, moet je een filter specificeren zoals "WHERE objectTypeId='0-1'. Je kunt bijvoorbeeld de volgende objecttypeids gebruiken bij query's:
Objectnaam ObjectTypeId
Contacten 0-1
Bedrijven 0-2
Artikelen 0-8

Aangepaste objecten krijgen een ID toegewezen op het moment van creatie en worden geïdentificeerd als 2-unique_ID. Bijvoorbeeld 2-12345. Meer informatie over object_en_gebeurtenis_type_definities.

Deze databaseobjecten zijn over het algemeen geschikt als je betere queryprestaties wilt dan wat haalbaar is met objecten_x views. Zie meer details in object_with_object_properties, object_properties, objects en object_properties_history hieronder.

objecten_x weergaven

In dit databaseobject heeft elk beschikbaar objecttype, inclusief aangepaste objecten, zijn eigen specifieke view, waarbij elke view alleen records bevat voor objecten van dat specifieke objecttype. Deze weergaven worden benoemd volgens het formaat OBJECTS_<objecttypenaam> waarbij <objecttypenaam> het meervoudsvormlabel van het objecttype is. (Merk op dat als het objecttype geen meervoudsvorm heeft, <objecttypenaam> gewoon het enkelvoudsvormlabel van de objecttypenaam is, aaneengesloten met "S").

Query's naar deze weergave retourneren een rij voor elke record binnen een object met elke eigenschap van het object beschikbaar als een aparte kolom.

Zie hieronder de uitgebreide lijst van beschikbare HubSpot (dat wil zeggen, niet aangepaste) objecttypen, een korte beschrijving van de gegevens die ze vertegenwoordigen en hun bijbehorende weergaven:

HubSpot Objecttype

ObjectTypeId

Beschrijving

CONTACT

0-1

Informatie over personen die contact hebben met uw bedrijf

BEDRIJF

0-2

Informatie over individuele bedrijven of organisaties

DEAL

0-3

Details over omzetmogelijkheden met een contactpersoon of bedrijf

ENGAGEMENT

0-4

Slaat gegevens op van CRM-acties, zoals notities, taken, e-mails, vergaderingen en gesprekken.

TICKET

0-5

Vertegenwoordigt verzoeken van klanten om hulp of ondersteuning

QUOTE

0-14

Gebruikt om prijsinformatie te delen met potentiële kopers

FORMULIER_INDIENING

0-15

Details voor individuele inzendingen voor een HubSpot formulier

LIJN_ITEM

0-8

Vertegenwoordigen een subset van producten die in een deal worden verkocht. Wanneer een product aan een deal wordt gekoppeld, wordt het een regelitem

CONVERSATIE

0-11

Details van inkomende berichten van meerdere kanalen.

LANDING_PAGE

0-25

Details van je landingspagina's

TASK

0-27

Slaat informatie op over takenlijsten

FORM

0-28

Wordt gebruikt om leadinformatie te verzamelen over uw bezoekers en contactpersonen

MARKETING_EMAIL

0-29

Details over e-mails van marketing hub

AD_ACCOUNT

0-30

Slaat informatie op over je advertentieaccounts op Linkedin, Facebook en Google

AD_CAMPAIGN

0-31

Informatie over je advertentiecampagnes. Een advertentiecampagne kan een of meer advertenties bevatten

AD_GROEP

0-32

Logische groepering van advertenties binnen een advertentiecampagne

AD

0-33

Details over individuele advertenties

CAMPAIGN

0-35

Informatie over gerelateerde marketingactiva en inhoud, zodat u eenvoudig de effectiviteit van uw collectieve marketinginspanningen kunt meten

SITE PAGINA

0-38

Gegevens over afzonderlijke pagina's op uw websites

BLOG_POST

0-39

Gegevens over blogberichten

OBJECT_SEGMENT

0-45

Informatie over groeperingen van objectrecords gebaseerd op hun eigenschappen of activiteiten

OPROEP

0-48

Oproepen gedaan door andere CRM-records, bijv. contactpersonen

INVOICE

0-53

Facturen beheren en synchroniseren met externe boekhoudsystemen

MEDIA_BRIDGE

0-57

Informatie over media activa geïmporteerd in Hubspot

SEQUENCE

0-58

Een sequentie is een reeks gerichte, getimede e-mailsjablonen om contacten in de loop van de tijd te voeden.

TEMPLATE

0-62

Opgeslagen e-mailinhoud die kan worden hergebruikt voor het verzenden van e-mails

DEAL_SPLIT

0-72

Deal-splitsingen worden gebruikt om dealtegoed te verdelen onder meerdere gebruikers

VERKOOPDOCUMENT

0-83

Verkoopdocumenten bouwen een inhoudsbibliotheek voor je hele team om documenten te uploaden en te delen met je contactpersonen

FEEDBACK_INDIENING

0-19

Slaat informatie op die is ingediend bij een feedbackenquête

ABONNEMENT

0-69

Abonnementen bevatten gegevens over terugkerende betalingen

COMMERCE BETALING

0-101

Bevat gegevens over geld dat is geïnd van klanten



Elk databaseobject retourneert de volgende kolommen:

Naam kolom

Type

Beschrijving

OBJECTTYPEID

Varchar

Het ID van het objecttype (contactpersonen is bijvoorbeeld 0-1).

OBJECTID

Aantal

De ID van de record (bijv. een contactrecord met een ID van 123752).

UPDATEDAT

Tijdstempel

De datum en tijd waarop dit object voor het laatst is bijgewerkt in HubSpot.

INGESTEDAT

Tijdstempel

De datum en tijd waarop de gegevens voor het laatst zijn opgenomen door Snowflake.

PROPERTY_*

Varchar

Afzonderlijke kolommen die de laatste versie van de objecteigenschappen bevatten. Voor elke objecteigenschap met een datum- of getaltype (zoals gespecificeerd door property_definitions), zijn er twee kolommen:

  1. Een kolom die de waarde van de eigenschap als string bevat. De kolomnaam is property_unparsed_[naam] . Bijvoorbeeld, DEAL object property, deal_amount zal de kolom property_unparsed_deal_amount hebben .
  2. Een kolom die de waarde bevat die is geconverteerd naar het native type. De kolom heeft de naam property_[naam]. Bijvoorbeeld, DEAL object property, deal_amount heeft de kolom property_deal_amount. Merk op dat deze kolom nul zal bevatten als de conversie naar het native type mislukt door ongeldige gegevens.

Voorbeeld 1


Verkrijg de voornaam, achternaam en levenscyclusfase voor alle contactpersonen.

Vraag:


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

FROM objects_contact

Retourneert:

OBJECTID

EERSTE NAAM

LAATSTE NAAM

LEVENSCYCLUS

54325098

Hobbes

Baron

leiden

96805401

Milo

Goud

lood

6922028

Henry

Riley

lood

Voorbeeld 2

Verkrijg de dealnaam en -fase van maximaal drie deals.

Query:


SELECT objectId, property_dealName, property_dealStage,
property_amount AS dealAmount

FROM objects_deals

LIMIT 3

Geeft:

OBJECTID

PROPERTY_DEALNAME

PROPERTY_DEALSTAGE

PROPERTY_DEALBEDRAG

38960439

Dealnaam 1

geslotenwon

34199

321740651

Test Deal 123

14845019

8383663

98392101

Pop Up luifel

geslotenwon

9309007

Voorbeeld 3

Zoek de dealnaam en fase op van de top drie deals op bedrag.

Query:

Aangezien de gegevens over het bedrag van de deal beschikbaar zijn als een datatype met getallen, kunnen ze worden gebruikt om te ordenen zonder dat conversie of casting nodig is.


SELECT objectId, property_dealName, property_dealStage,
property_amount AS dealAmount

FROM objects_deals
ORDER BY property_amount DESC
LIMIT 3


Retourneert:

OBJECTID

PROPERTY_DEALNAME

EIGENDOM_DEALSTAGE

EIGENDOM_DEALBEDRAG

98392101

Pop-up luifel

geslotenwon

9309007

321740651

Test Deal 123

14845019

8383663

38960439

Deal naam 1

geslotenwon

34199

object_met_object_eigenschappen

Dit databaseobject bevat gegevens van je HubSpot records. Query's naar dit databaseobject retourneren een rij voor elke record binnen een objecttype (bijv. alle contactrecords in het objecttype Contacten). Alle eigenschappen worden opgeslagen in de kolom Eigenschappen, wat een Snowflake Variant / JSON kolom is.

Deze weergave kan de volgende kolommen retourneren:

Kolom naam Type Beschrijving
OBJECTTYPEID Varchar Het ID van het objecttype (contactpersonen is bijvoorbeeld 0-1).
OBJECTID Nummer De ID van de record (bijv. een contactrecord met een ID van 123752).
PROPERTIES Variant De waarden van de eigenschappen van de record.
UPDATEDAT Tijdstempel De datum en tijd waarop het record voor het laatst is bijgewerkt in HubSpot. Meer informatie over kolom gegevenstypen.
INGESTEDAT Tijdstempel De datum en tijd waarop de gegevens voor het laatst zijn opgenomen door Snowflake.

Let op: Op 25 januari 2022 wordt de kolom, timestamp in object_with_object_properties tabel en view, die de datum en tijd weergeeft waarop de objectrecord voor het laatst is bijgewerkt in HubSpot, updatedat. Dit is om aan te sluiten bij de manier waarop datetime data wordt weergegeven in de rest van de data share.

Omdat dit een doorbrekende verandering is, is de nieuwe kolom, updatedat toegevoegd aan de tabel en view. Voor de komende 90 dagen zullen deze twee nieuwe kolommen naast timestamp bestaan, de kolommen die ze willen vervangen. Dit geeft je de gelegenheid om over te schakelen op het gebruik van de nieuwe kolommen.

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

Voorbeeld 1

Alle contactpersonen en hun eigenschappen ophalen.

Vraag:


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


Retourneert:

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

Voorbeeld 2

Haal de dealnaam en faseop van maximaal drie deals.

Vraag:


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;


Geeft als resultaat:

OBJECTID DEALNAME DEALSTAGE DEALAMOUNT
38960439 Deal naam 1 afgesloten 7488939
321740651 Deal naam 1 geslotenwinnaar 9292029
98392101 Deal naam 1 verloren 62626528

objecten

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

Dit databaseobject kan handig zijn als je account een grote hoeveelheid gegevens heeft, waardoor object_with_object_properties en objects_x views traag werken. Het gebruik van dit databaseobject met het object_properties databaseobject maakt het mogelijk om de gegevens in object_with_object_properties te repliceren, terwijl je controle houdt over welke eigenschappen worden geretourneerd.

Dit databaseobject kan de volgende kolommen retourneren:

Naam kolom Type Beschrijving
OBJECTTYPEID Varchar De ID van het objecttype (contactpersonen is bijvoorbeeld 0-1).
OBJECTID Aantal De ID van de record (bijv. een contactrecord met een ID van 123752).
INGESTEDAT Tijdstempel De datum en tijd waarop de gegevens voor het laatst zijn opgenomen door Snowflake. Meer informatie over kolomgegevenstypen.

Voorbeeld 1

Alle contactrecords ophalen.

Vraag:


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


Retourneert:

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

object_eigenschappen

Dit databaseobject is een subset van het object_with_object_properties databaseobject. Elke rij bevat de huidige waarde van de eigenschap die is ingesteld op een gegeven record. Een contactpersoon heeft bijvoorbeeld een rij voor de eigenschap Voornaam en een rij voor de eigenschap Achternaam. Als een record geen waarde heeft voor een eigenschap, zal de rij verschijnen met een lege string of helemaal niet verschijnen.

Dit databaseobject kan de volgende kolommen retourneren:

Naam kolom Type Beschrijving
OBJECTTYPEID Varchar De ID van het objecttype (contactpersonen is bijvoorbeeld 0-1).
OBJECTID Aantal De ID van de record (bijv. een contactrecord met een ID van 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. Meer informatie over kolom gegevenstypen.
INGESTEDAT Tijdstempel De datum en tijd waarop de gegevens voor het laatst zijn opgenomen door Snowflake.

Voorbeeld 1

De eigenschappen Voornaam, Achternaam en Plaats ophalen voor alle contactpersonen.

Vraag:


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

Verkrijg de voornaam, achternaam en levenscyclusfase voor alle contactpersonen en combineer ze in één rij per contactpersoon. Dit voorbeeld gebruikt de syntaxis SQL PIVOT.

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

Retourneert:

OBJECTTYPEID OBJECTID FIRSTNAME LAATSTE NAAM LEVENSCYCLUS
0-1 54325098 Hobbes Baron leiden
0-1 96805401 Milo Goud lood
0-1 6922028 Henry Riley voorsprong
... ... ... ... ...

object_eigenschappen_geschiedenis

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

Dit databaseobject kan de volgende kolommen teruggeven:

Naam kolom Type Beschrijving
OBJECTTYPEID Varchar De ID van het objecttype (contactpersonen is bijvoorbeeld 0-1).
OBJECTID Aantal De ID van de record (bijv. een contactrecord met een ID van 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 zijn opgenomen door Snowflake.

Voorbeeld 1

De geschiedenis van één eigenschap voor één contactpersoon ophalen.

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;


Geeft als resultaat:

OBJECTID NAAM WAARDE UPDATEDAT

136493192

hs_predictivescoringtier

niveau_1

2022-06-22 22:45:05.931

136493192

hs_predictivescoringtier

niveau_2

2021-09-18 08:20:56.622

136493192

hs_predictivescoringtier

niveau_3

2019-11-31 18:20:22.851

...

...

...

...

Voorbeeld 2

Haal de huidige naam op van alle contactpersonen die ooit een levenscyclusfase van 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'
);


Geeft als resultaat:

OBJECTID EERSTE NAAM LAATSTE NAAM
54325098 Hobbes Baron
96805401 Milo Goud
6922028 Henry Riley
... ... ...

Associatiequery's

Net als objectgegevens worden associatiegegevens op twee manieren georganiseerd:

  • Individual: Elk associatietype wordt opgeslagen in zijn eigen weergave en bevat alleen records van dat type. Associaties_contacten_naar_deals bevat bijvoorbeeld alleen records van associaties tussen contact- en transactieobjecten. Dit elimineert de noodzaak om een associatietypeid op te geven tijdens het queryen. Deze views zijn vrij eenvoudig te bevragen omdat er geen kennis van het CRM-gegevensmodel nodig is om ze te gebruiken. Ze retourneren ook een verrijkte beschrijving van de associatierecord tussen twee objecten die gemakkelijk kan worden gebruikt in joins met objects_x views. Zolang je geen last hebt van trage query's, is het aan te raden om deze views te gebruiken om associatiegegevens op te halen. Zie meer in associaties_x_naar_y weergaven hieronder.
  • Gecombineerd: Alle records voor alle associatietypen worden gecombineerd in één databaseobject. Wanneer je dus een query uitvoert, moet je een filter specificeren zoals "WHERE combinedassociationtypeid='0-32'". Zie meer in associaties en associatie_definities hieronder.

associaties_x_naar_y weergaven

Elk associatietype heeft zijn eigen view, gelabeld als associations_<associatietype naam> bijv. associations_contacts_to_deals. Elke weergave is een subset van de gegevens in het associaties databaseobject en bevat alleen records van een specifiek gecombineerd associatietypeid.

Elk databaseobject retourneert de volgende kolommen:

Kolom naam

Type

Beschrijving

COMBINEDASSOCIATIONTYPEID

Varchar

De unieke identifier van de associatiedefinitie.

ASSOCIATIECATEGORIE

Varchar

De bron van het associatietype. Een van: HUBSPOT_GEDEFINIEERD, GEBRUIKER_GEDEFINIEERD, INTEGRATOR_GEDEFINIEERD

ASSOCIATIONTYPEID

Varchar

Een unieke identifier van een associatiedefinitie binnen een specifieke associatiecategorie, d.w.z. geen twee definities in een associatiecategorie zullen dezelfde associationtypeid hebben.

FROMOBJECTTYPEID

Varchar

Het objecttypeid dat de bron is van de associatiedefinitie.

FROMOBJECTTYPE

Varchar

De naam van het objecttype dat de bron is van de associatiedefinitie.

TOOBJECTTYPEID

Varchar

Het objecttypeid dat de bestemming is van de associatiedefinitie.

TOOBJECTTYPEPE

Varchar

De naam van het objecttype dat de bestemming is van de associatiedefinitie.

NAAM

Varchar

De naam van de associatiedefinitie.

LABEL

Varchar

Beschrijving van de associatiedefinitie.

ISMAINASSOCIATIONDEFINITION

Booleaans

Of de associatiedefinitie het hoofdtype is. Als dit waar is, is de definitie degene die HubSpot weergeeft op geassocieerde records.

[VANOBJECTTYPE_OBJECTID] bijv. voor de weergave ASSOCIATIONS_CONTACTS_TO_DEALS is dit CONTACT_OBJECTID

Aantal

Het object-ID van het bronobject.

[TOOBJECTTYPE_OBJECTID] bijv. voor de weergave ASSOCIATIONS_CONTACTS_TO_DEALS is dit DEAL_OBJECTID

Aantal

Het object-ID van het bestemmingsobject.

INGESTEDAT

Tijdstempel

De datum en tijd waarop de gegevens voor het laatst zijn opgenomen door Snowflake.

Voorbeeld 1

Alle deals ophalen die geassocieerd zijn met een specifiek contact.

Vraag:


SELECT
contact_objectId, deal_objectId

FROM associaties_contacten_naar_deals

WAAR contactId = 6626541373

Geeft als resultaat:

CONTACT_OBJECTID

DEAL_OBJECTID

6626541373

233620335

6626541373

90253678

Voorbeeld 2

Alle contactpersonen in de tijdzone Bogota en hun deals ophalen.


SELECT contacten.eigenschap_voornaam contact_voornaam,

contacts.property_lastname contact_lastname,
contacts.property_email contact_email,
deals.property_dealtype deal_type, deals.property_bedrag deal_bedrag
FROM objects_contacts contacts
JOIN associations_contacts_to_deals assoc on
assoc.contact_objectid=contacten.objectid
JOIN objects_deals deals on deals.objectid=assoc.deal_objectid
where contacts.property_hs_timezone='america_slash_bogota'.

CONTACT_VOORNAAM

CONTACT_ACHTERNAAM

CONTACT_EMAIL

TRANSACTIE TYPE

TRANSACTIE BEDRAG

David

Magalhães

dmagalhaes@example.com

newbusiness

74848

Fernanda

Rodrigues

fmoreira@example.com

newbusiness

253530

Voorbeeld 3

Zoek alle contactpersonen op en het totale bedrag van de gesloten deals voor elk contactpersoon.


SELECT SUM(deals.property_hs_closed_amount) AS
total_closed_amount, contacts.property_email contact_email
FROM objects_contacts contacts
JOIN associations_contacts_to_deals assoc on
assoc.contact_objectid=contacten.objectid
JOIN objects_deals deals on deals.objectid=assoc.deal_objectid
GROUP BY contact_email
ORDER BY total_closed_amount DESC

Geeft terug:

TOTAAL_GESLOTEN_BEDRAG

CONTACT_EMAIL

98474793

johndoe@riverview.com

849488

sallymae@longford.com

associatie_definities

Dit databaseobject bevat informatie over alle beschikbare associatietypen tussen HubSpot-objecten, met één rij per associatietype. Je kunt dit databaseobject koppelen aan het associaties databaseobject om record-specifieke associatie-informatie te krijgen.

Er kunnen meerdere typen associaties zijn tussen dezelfde objecten. Het belangrijkste associatietype, wat het type is dat wordt weergegeven in HubSpot wanneer records worden geassocieerd, gebruikt de associatie waarbij ISMAINASSOCIATIONDEFINITION true is.

Dit databaseobject kan de volgende kolommen retourneren:

Naam kolom Type Beschrijving
COMBINEDASSOCIATIONTYPEID Varchar De unieke identifier van de associatiedefinitie.
CATEGORY Varchar De bron van het associatietype. Een van: HUBSPOT_DEFINED, USER_DEFINED, INTEGRATOR_DEFINED
ID Nummer De identifier van de associatiedefinitie binnen zijn categorie.
FROMOBJECTTYPEID Varchar Het 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 Booleaans Of de associatiedefinitie het hoofdtype is. Als dit waar is, is de definitie degene die HubSpot weergeeft op geassocieerde records.
INGESTEDAT Tijdstempel De datum en tijd waarop de gegevens voor het laatst zijn opgenomen door Snowflake. Meer informatie over kolomgegevenstypen.

Voorbeeld 1

Vraag de typen associaties op die beschikbaar zijn in je account.

Vraag:


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


Geeft als resultaat:

GECOMBINEERD ASSOCIATIETYPE FROMOBJECTTYPEID TOOBJECTTYPEID NAAM
0-1 0-1 0-2 CONTACT_NAAR_BEDRIJF
0-2 0-2 0-1 BEDRIJF_NAAR_CONTACT
0-3 0-3 0-1 DEAL_NAAR_CONTACT
0-4 0-1 0-3 CONTACT_NAAR_DEAL
0-5 0-3 0-2 DEAL_NAAR_BEDRIJF
... ... ... ...

Voorbeeld 2

De beschikbare associatietypen tussen deals en bedrijven ophalen.

Vraag:


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

ORDER BY category, id


Geeft als resultaat:

COMBINATIETYPE FROMOBJECTTYPEID TOOBJECTTYPEID NAAM
0-5 0-3 0-2 DEAL_NAAR_BEDRIJF
0-271 0-3 0-2 DEAL_NAAR_PRIMAIR_BEDRIJF
0-341 0-3 0-2 DEAL_NAAR_BEDRIJF_ONGELABELD

associaties

Dit databaseobject bevat informatie over de associaties tussen specifieke records. Elke rij vertegenwoordigt een associatie van een object naar een ander object. Rijen kunnen aanwezig zijn in dit databaseobject ook al zijn de records waarnaar verwezen wordt verwijderd. Je kunt controleren of records bestaan door te linken met de objecten tabel.

Dit databaseobject kan nuttig zijn als je account een grote hoeveelheid gegevens heeft, waardoor weergaven van associaties_x_naar_y traag werken.

Dit databaseobject kan de volgende kolommen retourneren:

Naam kolom Type Beschrijving
COMBINEDASSOCIATIONTYPEID Varchar De unieke identificatiecode van de associatiedefinitie.
FROMOBJECTID Aantal De ID van het bronobject.
TOOBJECTID Aantal De ID van het bestemmingsobject.
INGESTEDAT Tijdstempel De datum en tijd waarop de gegevens voor het laatst zijn opgenomen door Snowflake. Meer informatie over kolomgegevenstypen.

Voorbeeld 1

Alle geassocieerde deals en contactpersonen ophalen.

Query:


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


Retourneert:

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

Voorbeeld 2

Alle tickets ophalen die aan een specifiek contact zijn gekoppeld (contact-ID: 3005).

Query:


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


Geeft als resultaat:

GECOMBINEERD ASSOCIATIETYPE VANOBJECTID TOOBJECTID
0-5 6626541373 233620335

Voorbeeld 3

Alle deals ophalen die gekoppeld zijn aan een specifiek contact (contact-ID: 4464). In plaats van de gecombineerdeAssociationTypeId hard te coderen, koppelt dit voorbeeld met association_definitions.

Vraag:


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;


Retourneert:

COMBINEDASSOCIATIONTYPEID VANOBJECTID TOTBJECTID
0-5 6626541373 233620335

Eigenaar query's

eigenaars

Dit databaseobject bevat informatie over de gebruikers in je HubSpot account. Gebruikers kunnen worden ingesteld als eigenaar van een record en bevatten zowel een gebruikers-ID als een eigenaar-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 Aantal Eigenaars-ID van de gebruiker.
USERID Nummer De gebruikers-ID van de gebruiker. Gebruikers met 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 Booleaans Of de gebruiker verwijderd is.
CREATEDAT Tijdstempel De datum en tijd waarop de gebruiker is aangemaakt in HubSpot. Zie kolomgegevenstypen voor meer informatie.
UPDATEDAT Tijdstempel De datum en tijd waarop de gebruiker voor het laatst is bijgewerkt in HubSpot. Zie kolom gegevenstypen voor meer informatie.
INGESTEDAT Tijdstempel De datum en tijd waarop de gegevens voor het laatst zijn opgenomen door Snowflake.

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:

EIGENAARID USERID EMAIL EERSTE NAAM LAATSTE NAAM
29584574 4621126 233620335 Hobbes Baron
30532717 4874784 3866015468 Pablo Walters
30580321 925511 7132752747 Milo Goud
... ... ... ... ...

Voorbeeld 2

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

Vraag:


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


Geeft als resultaat:

EWNERID GEBRUIKERID EMAIL EERSTE NAAM LAATSTE NAAM
29584574 4621126 233620335 Hobbes Baron

Voorbeeld 3

Alle contactpersonen en hun eigenaars ophalen. Deze query koppelt records aan eigenaars met object_with_object_properties en de contacteigenschap hubspot_owner_id.


SELECT
contact.objectId contactid,
contact.property_firstname contact_firstname,
contact.property_lastname contact_lastname,
contact.property_hubspot_owner_id contact_hubspot_owner_id,
owner.firstname owner_firstname,
owner.lastname owner_lastname,
owner.email owner_email
FROM objects_contacts contact

JOIN owners owner ON contact.property_hubspot_owner_id = owner.ownerId


Geeft:

CONTACTID CONTACT_VOORNAAM CONTACT_ACHTERNAAM CONTACT_HUBSPOT_EIGENAAR_ID EIGENAAR_VOORNAAM EIGENAARNAAM EIGENAAR_EMAIL
113834202 Richard Greenfield 29584574 Hobbes Baron hobbes.b@business.com
53540801 Ford Karl 30241125 Milo Goud milo.g@business.com
... ... ... ... ... ... ...

Query's voor teams

teams

Met teams in HubSpot kun je je gebruikers indelen in groepen 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:

Naam kolom Type Beschrijving
TEAMID Aantal De ploeg ID.
TEAMNAAM Varchar De teamnaam.
PARENTEAMID Aantal Het team-ID van het ouderteam.
KINDERTEAMIDS Matrix De team-ID's van de kindteams.
PRIMARYOWNERMEMBERS Varchar De eigenaars-ID's van de primaire teamleden.
SECUNDAIRE LEDEN Booleaans De eigenaar ID's van de secundaire teamleden.
INGESTEDAT Tijdstempel De datum en tijd waarop de gegevens voor het laatst zijn opgenomen door Snowflake.

Voorbeeld 1

Alle teams ophalen.

Vraag:

SELECT teamId,teamName, primaryOwnerMembers

van teams

Retourneert:

TEAMID TEAMNAAM PRIMAIRE LEDEN
29584574 Subteam [233620335, 1234553]
30532717 Super Team [3866015468, 126221873]
3058032 Een team [7132752747]

eigenaar_team

Dit databaseobject bevat informatie over welke eigenaren corresponderen met welke teams in je HubSpot-account.

Dit databaseobject kan de volgende kolommen retourneren:

Naam kolom Type Beschrijving
TEAMID Aantal De team-ID.
EIGENAARID Nummer De eigenaars-ID van de gebruiker.
ISTEAMPRIMARY Booleaans Of dit team het primaire team is voor deze eigenaar.
INGESTEDAT Tijdstempel De datum en tijd waarop de gegevens voor het laatst zijn opgenomen door Snowflake.

Voorbeeld 1

Alle eigenaren voor een bepaald team ophalen.

Vraag:

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

Geeft terug.

TEAMID TEAMNAAM ISTEAMPRIMARY
29584574 233620335 WAAR
29584574 1234553 WAAR

Pijplijn query's

Leer hieronder hoe je deals en ticket pijplijngegevenskunt opvragen , zoals de beschikbare pijplijnen in je account en hun stadia.

Je kunt deze gegevens combineren met objectgegevens voor een volledig beeld van je pijplijnen. Je kunt bijvoorbeeld deals en hun pijplijnen opvragen door de objects_deals_view of de object_with_object_properties data te combineren met pijplijn data.

pijplijnen

Dit databaseobject bevat informatie over de deal- en ticketpijplijnen in je account. Elke geretourneerde rij vertegenwoordigt een enkele pijplijn.

Deze tabel kan de volgende kolommen retourneren:

Naam kolom Type Beschrijving
PIPELINEID Varchar ID van de pijplijn.
OBJECTTYPEID Varchar Het ID van het object dat de pijplijn kan bevatten (bijv. deals of tickets).
LABEL Varchar De naam van de pijplijn in HubSpot.
DISPLAYORDER Aantal De volgorde waarin de pijplijn wordt weergegeven in HubSpot.
ARCHIVED Booleaans 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. Meer informatie over kolomgegevenstypen.
INGESTEDAT Tijdstempel De datum en tijd waarop de gegevens voor het laatst zijn opgenomen door Snowflake.

Voorbeeld 1

Alle beschikbare deal pijplijnen ophalen, gerangschikt op volgorde in HubSpot.

Query:


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


Retourneert:

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

Voorbeeld 2

Verkrijg deals binnen een specifieke pijplijn. Voegt object_with_object_properties en pijplijnen samen.

Vraag:


SELECT

deals.objectId deal_id,
deals.property_dealname deal_name,
pipelines.label pipeline_name
FROM objects_deals deals
INNER JOIN pipelines
ON deals.objectTypeId = pipelines.objectTypeId
AND deals.property_pipeline = pipelines.pipelineid
WHERE pipelines.objectTypeId = '0-3';


Geeft:

DEAL_ID DEAL_NAME PIJPLIJNNAAM
605140072 Wereldwijde inschrijving Meowmix Pijplijn
605457408 Friskies Rebrand Verkooppijplijn
604362473 Fresh Step App bouwen Verkooppijplijn

Voorbeeld 3

Hetzelfde als Voorbeeld 2 hierboven, deals ophalen binnen een specifieke pijplijn. Maar, in plaats van objects_deals te gebruiken in joins, gebruik 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';

Geeft:

DEAL_ID

DEAL_NAAM

PIJPLIJNNAAM

605140072

Wereldwijde inschrijving Meowmix

Pijplijn

605457408

Friskies Rebrand

Verkooppijplijn

604362473

Fresh Step App bouwen

Verkooppijplijn

pijplijn_stappen

Deze weergave bevat informatie over individuele fasen binnen een pijplijn. Identificeer stadia door objecttype-ID, pijplijn-ID en stadium-ID te combineren. Gebruik bij het verbinden met pijplijnen de objecttype-ID en pijplijn-ID.

Dit databaseobject kan de volgende kolommen retourneren:

Kolomnaam Type Beschrijving
PIPELINEID Varchar ID van de pijplijn.
STAGEID Varchar De ID van het stadium.
LABEL Varchar De naam van de stap in HubSpot.
DISPLAYORDER Aantal De volgorde waarin de pijplijn wordt weergegeven in HubSpot.
METADATA Variant Een JSON geformatteerde beschrijving van het stadium inclusief of het open of gesloten is.
ARCHIVED Booleaans Of de pijplijnstap is verwijderd.
CREATEDAT Tijdstempel Wanneer de pijplijnstap is aangemaakt.

Voorbeeld 1

Verkrijg pijplijnstappen voor een dealpijplijn met de naam Verkooppijplijn.

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

Alle deals en hun respectievelijke pijplijnfasen ophalen.

Vraag:


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


Geeft:

DEAL_ID DEAL_NAAM PIJPLIJNNAAM PIJPLEIDING_STAGE_NAAM
605140072 Wereldwijde inschrijving Meowmix Pijplijn verkoop Contract verzonden
605457408 Friskies Rebrand Pijplijn verkoop Afspraak gepland
604362473 Fresh Step App bouwen Pijplijn verkoop Contract ondertekend
... ... ... ...

Query's voor eigenschappen

eigenschap_definities

Dit databaseobject bevat informatie over objecteigenschappen en gebeurteniseigenschappen in je HubSpot-account. Gebeurteniseigenschappen omvatten standaardgebeurtenissen, zoals e-mail openen en klikken, en aangepaste gedragseigenschappen voor gebeurtenissen. Deze informatie kan handig zijn bij het definiëren van waarden die je vindt in object_eigenschappen en gebeurtenisgegevens.

Je kunt specifieke eigenschappen identificeren door hun objecttype-ID en naam te combineren. Je kunt soortgelijke informatie ophalen met de eigenschappen-API.

Dit databaseobject kan de volgende kolommen retourneren:

Naam kolom Type Beschrijving
OBJECTYPEID Varchar De 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 eigenschap (bijv. string, getal, datetime).
FIELDTYPE Varchar Het veldtype van de eigenschap. Definieert hoe de eigenschap wordt weergegeven in HubSpot en op formulieren (bijv. selectievakje, selecteren).
DISPLAYORDER Aantal De weergavevolgorde van de eigenschap.
GROUPNAME Varchar De groepsnaam van de eigenschap.
OPTIONS Variant Voor opsommingseigenschappen, een matrix van de opties van de eigenschap, inclusief de attributen van elke optie (bijv. weergavevolgorde, label).
CREATEDUSERID Aantal De ID van de gebruiker die de eigenschap heeft aangemaakt.
REFERENCEDOBJECTTYPE Varchar Het type object waar de eigenschap naar verwijst. Eigenschappen met de waarde Eigenaar leveren de waarde EIGENAAR op.
CALCULATED Booleaans Of de eigenschap een berekende eigenschap is.
EXTERNALOPTIONS Booleaans Of de opties van de eigenschap gedefinieerd zijn in een extern systeem.
HASUNIQUEVALUE Booleaans Of de waarden van de eigenschap uniek zijn. Kan alleen worden ingesteld bij het maken van een eigenschap via de API.
HIDDEN Booleaans Of de eigenschap verborgen is in HubSpot.
SHOWCURRENCYSYMBOL Booleaans Of de waarde van een numerieke eigenschap wordt opgemaakt als valuta.
FORMFIELD Booleaans Of deze eigenschap in formulieren kan worden gebruikt.
READONLYDEFINITION Booleaans Of de eigenschap kan worden bewerkt in HubSpot.
READONLYVALUE Booleaans Of de waarde van de eigenschap bewerkt kan worden in HubSpot.
HUBSPOTDEFINED Booleaans Of de eigenschap is gemaakt door HubSpot, versus gemaakt door een gebruiker.
ARCHIVED Booleaans Of de eigenschap is verwijderd.
CREATEDAT Tijdstempel De datum en tijd waarop de eigenschap is gemaakt in HubSpot.
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 zijn opgenomen door Snowflake.

Voorbeeld 1

Verkrijg de namen en beschrijvingen voor alle contacteigenschappen.

Vraag:


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


Geeft als resultaat:

NAAM LABEL BESCHRIJVING
ingevoerd_sql_stadium Ingevoerd SQL-stadium Begintelling dagen SQL-stadium.
eerste_conversie_gebeurtenis_naam
Eerste conversie Het eerste formulier dat dit contact heeft ingediend.
adres Straatadres Het adres van de contactpersoon.

Gebeurtenis query's

Gebeurtenissen omvatten standaard HubSpot-gebeurtenissen en aangepaste gedragsevents. Elk evenement heeft zijn eigen databaseobject, gelabeld als events_eventname.

Naam
GEBEURTENISSEN_AD_INTERACTIE Details van een advertentie en contactpersonen die interactie hebben gehad door op de advertentie te klikken of een formulier in te vullen nadat ze met de advertentie in contact zijn gekomen.
GEBEURTENISSEN_AD_METINGEN_INGEVOERD_V0

Details van een advertentie en de bijbehorende prestatiecijfers.
GEBEURTENISSEN_OPROEP_GENOEMD_SLEUTELWOORD Details van trefwoorden die zijn genoemd door deelnemers aan gesprekken.
GEBEURTENISSEN_GEKLIKTE_LINK_IN_EMAIL_V2

Links waarop contactpersonen in marketinge-mails hebben geklikt.
GEBEURTENISSEN_GEKLIKT_LINK_IN_GESPREKKEN_INBOX_EMAIL_V8 Koppelingen waarop is geklikt in e-mails van de conversatie-inbox door contactpersonen.
GEBEURTENISSEN_COOKIE_BANNER_GEKLIKT Contactpersonen die op cookies hebben geklikt.
GEBEURTENISSEN_COOKIE_BANNER_BEKEKEN Contactpersonen die cookies hebben bekeken.
GEBEURTENISSEN_DOCUMENT_GEDEELD_V2 Verkoopdocumenten gedeeld met contactpersonen via een externe link.
GEBEURTENISSEN_DOCUMENT_BEKEKEN_V2 Verkoopdocumenten en contactpersonen die door hen zijn bekeken door de externe link te openen.
GEBEURTENISSEN_DOCUMENT_BEËINDIGD_V2 Verkoopdocumenten en contactpersonen die deze hebben afgesloten.
GEBEURTENISSEN_HS_GEPLANDE_EMAIL_V2 E-mails die zijn ingediend bij de HubSpot e-mailservers om te worden verzonden.
GEBEURTENISSEN_MTA_AFGELEVERD_EMAIL_V2 E-mails die succesvol zijn afgeleverd bij de ontvangers door de HubSpot e-mail servers.
GEBEURTENISSEN_MTA_AFGEWEZEN_EMAIL_V2 E-mail afleverpogingen die werden afgewezen door de e-mailserver van de ontvanger.
GEBEURTENISSEN_GEOPEND_EMAIL_V2 E-mailopeningen door contactpersonen.
GEBEURTENISSEN_GERAPPORTEERDE_SPAM_EMAIL_V2 E-mails die door ontvangers als spam zijn gemarkeerd.
GEBEURTENISSEN_BIJGEWERKT_EMAIL_ABONNEMENT_STATUS_V2 Wijzigingen in e-mailabonnementen door ontvangers.
GEBEURTENISSEN_GEOPEND_GEVOLGD_INBOX_EMAIL_V8 Inbox e-mails geopend door contactpersonen.
GEBEURTENISSEN_MB_MEDIA_AFGESPEELD Video-afspeelactiviteit door contactpersonen.
EVENTS_V2_CONTACT_BOEKTE_VERGADERING_DOOR_REEKS Contactpersoon heeft een vergadering geboekt via volgorde.
EVENTS_V2_CONTACT_INGESCHREVEN_IN_REEKS Contact heeft zich ingeschreven in de reeks.
GEBEURTENISSEN_V2_CONTACT_AFGEROND_REEKS Sequentie beëindigd.
EVENTS_V2_CONTACT_REPLIED_SEQUENCE_EMAIL Contact heeft gereageerd op e-mail (of inkomende e-mail die sequentie afmeldde) die via sequentie is verzonden.
GEBEURTENISSEN_V2_CONTACT_AFGEMELD_UIT_REEKS Contact uitgeschreven uit reeks.
EVENTS_V2_CONTACT_HANDMATIG_UIT_REEKS AFGEMELD Gebruiker heeft het contact handmatig afgemeld.
EVENTS_V2_CONTACT_UITGESCHREVEN_REEKS_EMAIL Contact uitgeschreven, de sequentie uitgeschreven.
GEBEURTENISSEN_V2_REEKS_EMAIL_AFGESLAGEN E-mail van sequentie afgewezen.
GEBEURTENISSEN_V2_REEKS_ERRORED Fout in sequentie waardoor de sequentie niet is ingeschreven.
EVENTS_V2_SEQUENTIE_STAP_UITGEVOERD Sequence stap uitgevoerd.
EVENTS_BEZOCHTE_PAGINA Website pagina bezocht door contacten.
EVENTS_<INTEGRATION_EVENT_NAME>_<UNIQUE_IDENTIFIER> Integratiegebeurtenissen(Timeline V3 API)

Je kunt gebeurtenissen identificeren door hun gebeurtenistype-ID en ID te combineren. 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 evenementtabellen en weergaven:

  • occurredat
  • occurredatdateint

Deze kolommen vervangen de kolommen occuredat en occuredatdateint op 24 november 2022. Op die datum zijn de oude kolommen niet langer beschikbaar en mislukken pogingen om een databaseobject of weergave met events die deze kolommen gebruiken, te bevragen. Meer informatie over brekende wijzigingen voor Snowflake-gegevensshares.



Naam kolom Type Beschrijving
EVENTTYPEID Varchar De ID van het gebeurtenistype, vergelijkbaar met OBJECTTYPEID.
Je kunt alle gebeurtenistype-ID's in je account opvragen met de weergave object_en_event_type_definitions.
ID Varchar Dit is uniek per gebeurtenistype. Geen twee records hebben dezelfde ID binnen een bepaald gebeurtenistype.
OBJECTTYPEID Varchar Het type object dat de gebeurtenis heeft voltooid. Bijvoorbeeld, een klik op een e-maillink zou 0-1 in deze kolom weergeven, wat het contactobject vertegenwoordigt.
OBJECTID Aantal De ID van de record die de gebeurtenis heeft voltooid.
OCCURREDAT Tijdstempel Wanneer de gebeurtenis plaatsvond.

OCCURREDATDATEINT

Aantal Een getal dat aangeeft wanneer de gebeurtenis plaatsvond. Bevat dezelfde gegevens als de kolom OCCURREDAT, maar opgemaakt als een getal en gebruikt als onderdeel van de clustersleutel van de tabel. In de meeste gevallen kun je de OCCURREDAT tijdstempel gebruiken in plaats van dit getal.

OCCUREDATDATEINT

Aantal

Een nummer dat aangeeft wanneer de gebeurtenis plaatsvond. Bevat dezelfde gegevens als de OCCURREDAT kolom, maar opgemaakt als een getal en gebruikt als onderdeel van de clustersleutel van de tabel. In de meeste gevallen kun je de OCCURREDAT tijdstempel gebruiken in plaats van dit getal.

Let op: deze kolom wordt op 24 november 2022 afgeschreven en vervangen door OCCURREDATDATEINT.

OCCUREDAT Tijdstempel

Wanneer de gebeurtenis plaatsvond.

Let op: deze kolom wordt op 24 november 2022 afgeschreven en vervangen door OCCURREDAT.

INGESTEDAT Tijdstempel De datum en tijd waarop de gegevens voor het laatst zijn opgenomen door Snowflake. Meer informatie over kolomgegevenstypen.
PROPERTY_* Varchar Afzonderlijke kolommen die de eigenschappen van de gebeurtenis bevatten.

Voorbeeld 1

De 50 meest recente e-mailklikgebeurtenissen ophalen.

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 occuredAt

LIMIT 50;


Retourneert:

EVENTTYPEID OBJECTTYPEID OBJECTID OCCUREDAT HS_KLIK_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
... ... ... ... ...

Voorbeeld 2

Alle e-mailklikgebeurtenissen ophalen door de contactpersonen die hebben geklikt. Deze query krijgt contactgegevens door samen te voegen met object_met_object_eigenschappen.

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;


Retourneert:

KLIK_TIJDSTEMPEL KLIK_URL CONTACT_VOORNAAM CONTACT_ACHTERNAAM
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 Goud
2018-11-08 09:37:41.426 https://www.website.net/contact?utm_source=hs_automation&utm_medium=email&utm_content=55200164 Harlow Villari
... ... ... ...

Object_en_gebeurtenis_type_query's

object_en_gebeurtenis_type_definities

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

Dit databaseobject kan de volgende kolommen retourneren:

Naam kolom Type Beschrijving
OBJECTTYPEID Varchar Het ID van het object dat de pijplijn kan bevatten (bijv. 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 zijn opgenomen door Snowflake. Meer informatie over kolomgegevenstypen.

Voorbeeld 1

Alle objecten en gebeurtenissen ophalen die beschikbaar zijn in je HubSpot-account.

Query:


SELECT objectTypeId, fullyQualifiedName
FROM object_and_event_type_definitions;


Geeft als resultaat:

OBJECTTYPEID VOLLEDIG GEKWALIFICEERDE NAAM
0-1 CONTACT
0-8 LIJN_ITEM
0-11 CONVERSATIE
... ...

Segmenten query's

Hieronder wordt uitgelegd hoe u uw segmenten kunt opvragen, zoals de beschikbare contact- en bedrijfssegmenten en de records die in deze segmenten zijn opgenomen.

segmenten

Dit databaseobject bevat informatie over HubSpot contact- en bedrijfssegmenten. Retourneert één rij per segment en kolommen bevatten segmentgegevens zoals segmentnaam, grootte en het objecttype van de records die het bevat. Bevat geen informatie over de individuele records binnen elk segment (zie segment_lidmaatschap).

Dit databaseobject kan de volgende kolommen retourneren:

Naam kolom Type Beschrijving
OBJECTTYPEID Varchar Het type records in het segment (bijv. contactpersoon of bedrijf).
SEGMENTID Aantal De ID van het segment. Koppelt aan de kolom SEGMENTID in de tabel segment-leden.
CLASSICSEGMENTID Aantal Een ID die specifiek is voor contactsegmenten en overeenkomt met de ID in de URL van het segment in HubSpot.
NAME Varchar De naam van het segment.
SIZE Aantal Het aantal records in het segment.
CREATEDBYUSERID Aantal De ID van de gebruiker die het segment heeft aangemaakt.
CREATEDAT Tijdstempel Wanneer het segment is gemaakt in HubSpot.
UPDATEDBYUSERID Aantal De ID van de gebruiker die het segment het laatst heeft bijgewerkt.
UPDATEDAT Tijdstempel De datum en tijd waarop de datum voor het laatst is bijgewerkt in HubSpot. Meer informatie over kolom gegevenstypen.
INGESTEDAT Tijdstempel De datum en tijd waarop de gegevens voor het laatst zijn opgenomen door Snowflake.

Voorbeeld 1

Alle contactsegmenten ophalen.

Query:


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


Retourneert:

SEGMENTSID NAAM GROOTTE
118131 Wekelijks bereik 103
66156 Blog abonnees 455
771852 Top abonnees 2021 37
... ... ...

Voorbeeld 2

Een specifiek contactsegment met de naam Top-abonnees 2021 ophalen.

Query:


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


Retourneert:

SEGMENTID NAAM GROOTTE
771852 Top abonnees 2021 37

segment_lidmaatschap

Dit databaseobject bevat informatie over welke records lid zijn van welke segmenten, met een rij per record in het segment. Als je bijvoorbeeld een segment Blog-abonnees hebt met 500 contactpersonen, retourneert het databaseobject 500 rijen.

Bevat alleen segment-ID's en object-ID's. Ga voor meer informatie naar het segmenten databaseobject.

Dit databaseobject kan de volgende kolommen retourneren:

Naam kolom Type Beschrijving
SEGMENTID Varchar De ID van het segment. Koppelt aan de kolom HS_SEGMENT_ID in de segmententabel.
OBJECTID Varchar Het ID van de record in het segment.
UPDATEDAT Tijdstempel De datum en tijd waarop de gegevens voor het laatst zijn bijgewerkt in HubSpot. Meer informatie over kolom datatypes.
INGESTEDAT Tijdstempel De datum en tijd waarop de gegevens voor het laatst zijn opgenomen door Snowflake.

Voorbeeld 1

De ID's van alle contactpersonen in het segment Top-abonnees 2021 ophalen.

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

Zoek de voor- en achternamen van details van contactpersonen in het segment Top-abonnees 2021.

Query:


SELECT

contact.objectId AS objectid,
contact.property_firstname AS firstname,
contact.property_lastname AS lastname
FROM objects_contacts contact
INNER JOIN segment_memberships ON contact.objectId = segment_memberships.objectId
INNER JOIN segments ON segments_memberships.segmentId = segments.segmentId
WHERE segments.objectTypeId = '0-1'
AND segments.name = 'Top Subscribers 2021'


Geeft als resultaat:

OBJECTID

EERSTE NAAM

LAATSTE NAAM

54325098

Hobbes

Baron

96805401

Milo

Goud

6922028

Henry

Riley

...

...

...

FAQs

Ik wil gegevens genereren die vergelijkbaar zijn met een rapport van de Hubspot app, hoe doe ik dat?


Over het algemeen zou je willen kijken naar de kolommen in het rapport waarmee je vergelijkt. Als de rapportvisualisatie niet in tabelvorm is, zal het converteren naar een tabel de kolommen tonen die het rapport bevat. Deze kolommen zijn meestal eigenschappen van een objecttype of een gebeurtenistype. De volgende stap is uitzoeken met welke eigenschap van het objecttype een kolom overeenkomt. Je kunt dit doen door property_definitions te bevragen:


SELECT * FROM property_definitions

WHERE label = [column_name]

Er is misschien niet altijd een exacte overeenkomst omdat sommige namen van eigenschappen meestal worden opgelost naar een meer beschrijvende naam op de app. In zulke gevallen kan een fuzzy search met de LIKE operator op de label (of zelfs de beschrijving) kolom in property_definitions helpen.

Nadat je hebt bepaald bij welk objecttype de kolom hoort, is het triviaal om te bepalen wat je moet opvragen. Je kunt gewoon zoeken naar de object_x view die overeenkomt met het type.

Hoe koppel ik dit gegevenstype aan een ander, bijvoorbeeld hoe kan ik formulieren voor een campagne ophalen?


Als je twee of meer verschillende records aan elkaar moet koppelen, kijk dan eens naar associaties. Associaties vertegenwoordigen de relaties tussen objecten in HubSpot CRM. Alle verschillende associaties die mogelijk zijn tussen twee typen staan vermeld in association_definitions. In het bovenstaande voorbeeld moet je een query uitvoeren op ASSOCIATIONS_CAMPAIGNS_TO_FORMS om te weten aan welke formulieren een campagne is gekoppeld:


SELECT campaigns.property_hs_name campaign_name,
forms.property_hs_form_id form_id
FROM objects_campaigns campaigns
JOIN associations_campaigns_to_forms assoc ON
assoc.campaign_objectid=campaigns.objectid
JOIN objects_forms forms ON forms.objectid=assoc.form_objectid
GROUP BY campaign_name

Hoe weet ik de status van de HubSpot-Snowflake integratie?

Als je realtime statusupdates over uitval en problemen voor de HubSpot-Snowflake integratie wilt ontvangen, query je de data_share_status-weergave:

SELECT * FROM hubspot.public.data_share_status
LIMIT 1

De resultaten worden weergegeven als:

STATUS BERICHT UPDATEDAT
OK MOMENTEEL GEEN INCIDENT BEKEND 2023-04-10 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, kun je de prestaties van de integratie volgen en eventuele downtime of uitval detecteren.

Was dit artikel nuttig?
Dit formulier wordt alleen gebruikt voor feedback op documentatie. Ontdek hoe je hulp krijgt met HubSpot.