HubSpot-gegevens opvragen in Snowflake

Geschreven door HubSpot Support | Nov 1, 2021 12:54:04 PM

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

Gegevensvertraging 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.

Uw Snowflake-omgeving instellen

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

Om uw magazijn, database en schema op werkbladniveau te selecteren:

Klik in de bovenste rij van het werkblad op de werkbladactiebalk.
In het pop-upvenster:
- Klik op het vervolgkeuzemenu Warehouse en selecteer 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:

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 queries toe te voegen, voeg je de databasenaam gevolgd door het schema toe aan het begin van het FROM veld. Bijvoorbeeld:

SELECT objectTypeId, property_createddate
FROM hubspot_share_name.V2_LIVE.objects_deals

LIMIT 1

Overzicht gegevens

Query's worden opgesteld 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 momenteel geassocieerde records.
Gebeurtenissen: gebeurtenisgegevens voor zowel standaard HubSpot-gebeurtenissen, zoals het openen van e-mails, als aangepaste gedragsgebeurtenissen.
Lijsten: HubSpot contact- en bedrijfslijsten.
Eigenaren: gebruikers in je HubSpot account, in relatie tot de records waarvan ze zijn ingesteld als eigenaar.
Pijplijnen: deal- en ticketpijplijnen, inclusief pijplijnstadia.
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 het delen van gegevens verder ontwikkelen, zullen we wijzigingen introduceren, waarvan sommige een breuk betekenen. Het wordt ten zeerste aanbevolen om je te abonneren op HubSpot's wijzigingenlogboek voor ontwikkelaars. 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 er worden geretourneerd en in welke volgorde, door LIMIT en ORDER BY in je query op te nemen. Als u bijvoorbeeld alle contactpersonen met hun eigenschappen wilt opvragen, 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;

Gegevenstypen kolommen

Wanneer je gegevens opvraagt in Snowflake, zijn de kolommen die worden geretourneerd afhankelijk van de gegevens die je opvraagt. Je kunt de beschikbare kolommen voor een bepaalde tabel of weergave in Snowflake bekijken door de weergave in de linkerzijbalk 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 views.

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

SELECTobjectId, 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 artikel hierboven.

OBJECTTYPEID: een VARCHAR-waarde die het objecttype vertegenwoordigt. Bijvoorbeeld, 0-1 vertegenwoordigt het contactpersonenobject, 0-2 vertegenwoordigt het bedrijvenobject en 2-1232 kan een aangepast object in je account vertegenwoordigen. In lijsten verwijst dit naar het type lijst (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 gegevens zijn 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 wordt aanbevolen om het VARCHAR-datatype 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

Objectvragen

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

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

Individueel: Elk objecttype wordt opgeslagen in zijn 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 objecttypes worden gecombineerd in één databaseobject. Wanneer je dus een query uitvoert, moet je een filter specificeren zoals "WHERE objectTypeId='0-1'. Je kunt bijvoorbeeld de volgende objecttypeids gebruiken bij query's:

Naam object	ObjectTypeId
Contacten	0-1
Bedrijven	0-2
Regelitems	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 aanzicht waarbij elk aanzicht alleen records bevat voor objecten van dat specifieke objecttype. Deze weergaven krijgen de naam 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 met beschikbare HubSpot (dat wil zeggen, niet aangepaste) objecttypen, een korte beschrijving van de gegevens die ze vertegenwoordigen en de 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, inclusief notities, taken, e-mails, vergaderingen en gesprekken.
TICKET	0-5	Vertegenwoordig verzoeken om hulp of ondersteuning van klanten.
QUOTE	0-14	Wordt 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	Gebruikt om leadinformatie te verzamelen over je bezoekers en contactpersonen
MARKETING_EMAIL	0-29	Details over e-mails van marketinghub
AD_ACCOUNT	0-30	Slaat informatie op over je advertentieaccounts op Linkedin, Facebook en Google
AD_CAMPAIGN	0-31	Details 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 afzonderlijke advertenties
CAMPAGNE	0-35	Informatie over gerelateerde marketingmiddelen en content, zodat je eenvoudig de effectiviteit van je gezamenlijke marketinginspanningen kunt meten.
SITE PAGINA	0-38	Gegevens over afzonderlijke pagina's op uw websites
BLOG_POST	0-39	Gegevens over blogberichten
OBJECTLIJST	0-45	Informatie over groepen objectrecords op basis van hun eigenschappen of activiteiten
BEL	0-48	Gesprekken gevoerd door andere CRM-records, zoals contactpersonen
INVOICE	0-53	Facturen beheren en synchroniseren met externe boekhoudsystemen
MEDIA_BRIDGE	0-57	Informatie over in Hubspot geïmporteerde media-assets
SEQUENCE	0-58	Een reeks is een reeks gerichte, getimede e-mailsjablonen om contacten in de loop van de tijd te koesteren.
DEAL_SPLIT	0-72	Dealsplitsingen 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
COMMERCIËLE BETALING	0-101	Bevat gegevens over geld dat is verzameld van klanten

Elk databaseobject retourneert de volgende kolommen:

Kolomnaam	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: Een kolom die de waarde van de eigenschap als tekenreeks bevat. De kolomnaam is property_unparsed_[naam] . Bijvoorbeeld, DEAL object eigenschap, deal_bedrag zal de kolom property_unparsed_deal_bedrag hebben. Een kolom die de waarde bevat die is geconverteerd naar het native type. De kolom krijgt de naam property_[naam]. Bijvoorbeeld, DEAL object property, deal_amount krijgt 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

Haal de voornaam, achternaam en levenscyclusfase op 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	lood
96805401	Milo	Goud	lood
6922028	Henry	Riley	lood

Voorbeeld 2

Haal de dealnaam en het stadium van maximaal drie deals op.

Query:

SELECT objectId, property_dealName, property_dealStage, property_amount AS dealAmount
FROM objects_deals LIMIT 3

Retourneert:

OBJECTID	EIGENDOM_KOOPNAAM	EIGENDOM_DEALSTAGE	EIGENDOM_BEDRAG
38960439	Deal naam 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.

Vraag:

Omdat de gegevens van de dealhoeveelheid 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	EIGENDOM_KOOPNAAM	VASTGOED_DEALSTAGE	EIGENDOM_BEDRAG
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 één rij voor elke record binnen een objecttype (bijvoorbeeld 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 weergeven:

Kolomnaam	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`).
`PROPERTIES`	Variant	De vastgoedwaarden van het 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 Wanneer de gegevens voor het laatst zijn opgenomen door Snowflake.

Let op: op 25 januari 2022 wordt de kolom timestamp in de 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 het stadium van maximaal drie dealsop.

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;

Retourneert:

OBJECTID	DEALNAME	DEALSTAGE	DEALAMOUNT
38960439	Deal naam 1	geslotenlost	7488939
321740651	Deal naam 1	geslotenwon	9292029
98392101	Deal naam 1	geslotenlost	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:

Kolomnaam	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
...	...

objecteigenschappen

Dit databaseobject is een subset van het object_with_object_properties databaseobject. Elke rij bevat de huidige eigenschapwaarde 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:

Kolomnaam	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 het eigendom.
`VALUE`	Tijdstempel	De waarde van het eigendom.
`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 voornaam, achternaam en plaatsnaam 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

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

Vraag:

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	VOORNAAM	LAATSTE NAAM	LEVENSCYCLUS
0-1	54325098	Hobbes	Baron	lood
0-1	96805401	Milo	Goud	lood
0-1	6922028	Henry	Riley	lood
...	...	...	...	...

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 een eigenschap. De huidige waarde van een eigenschap wordt bepaald door de meest recente tijdstempel UPDATEDAT in de geschiedenis van de eigenschap.

Dit databaseobject kan de volgende kolommen retourneren:

Kolomnaam	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 het eigendom.
`VALUE`	Tijdstempel	De waarde van het eigendom.
`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 ophalen van een enkele eigenschap voor een enkele contactpersoon.

Vraag:

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

Vraag:

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

Retourneert:

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

Verenigingsvragen

Net als objectgegevens worden associatiegegevens op twee manieren georganiseerd:

Individueel: Elk associatietype wordt opgeslagen in een eigen view 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 weergave, 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:

Kolomnaam	Type	Beschrijving
GECOMBINEERD VERENIGINGSTYPEID	Varchar	De unieke identifier van de associatiedefinitie.
ASSOCIATIECATEGORIE	Varchar	De bron van het associatietype. Een van: HUBSPOT_GEDEFINIEERD, GEBRUIKER_GEDEFINIEERD, INTEGRATOR_GEDEFINIEERD
VERENIGINGSTYPEID	Varchar	Een unieke identifier van een associatiedefinitie binnen een specifieke associatiecategorie, d.w.z. geen twee definities in een associatiecategorie zullen dezelfde associationtypeid hebben.
VANOBJECTTYPEID	Varchar	Het objecttypeid dat de bron is van de associatiedefinitie.
VANOBJECTTYPE	Varchar	De naam van het objecttype dat de bron is van de associatiedefinitie.
NAAROBJECTTYPEID	Varchar	Het objecttypeid dat de bestemming is van de associatiedefinitie.
TOOBJECTTYPE	Varchar	De naam van het objecttype dat de bestemming is van de associatiedefinitie.
NAAM	Varchar	De naam van de associatiedefinitie.
ETIKET	Varchar	De beschrijving van de associatie.
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 doelobject.
INGESTEDAT	Tijdstempel	De datum en tijd waarop de gegevens voor het laatst zijn opgenomen door Snowflake.

Voorbeeld 1

Alle deals ophalen die gekoppeld zijn aan een specifiek contact.

Vraag:

SELECT
contact_objectId, deal_objectId

FROM associaties_contacten_naar_deals

WHERE contactId = 6626541373

Retourneert:

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	DEAL_TYPE	DEAL_AMOUNT
David	Magalhães	dmagalhaes@example.com	newbusiness	74848
Fernanda	Rodrigues	fmoreira@example.com	newbusiness	253530

Voorbeeld 3

Alle contactpersonen ophalen en de totale som van het gesloten bedrag voor elk contact.

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

Retourneert:

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, het type dat wordt weergegeven in HubSpot wanneer records worden gekoppeld, is de associatie waarbij ISMAINASSOCIATIONDEFINITION true is.

Dit databaseobject kan de volgende kolommen retourneren:

Kolomnaam	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`	Aantal	De identifier van de associatiedefinitie binnen zijn categorie.
`FROMOBJECTTYPEID`	Varchar	Het ID van het object dat de bron is van de associatiedefinitie.
`TOOBJECTTYPEID`	Varchar	Het 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

De types associaties opvragen die beschikbaar zijn in je account.

Vraag:

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

Retourneert:

GECOMBINEERD VERENIGINGSTYPE	VANOBJECTTYPEID	NAAROBJECTTYPEID	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

Retourneert:

GECOMBINEERD VERENIGINGSTYPE	VANOBJECTTYPEID	NAAROBJECTTYPEID	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

verenigingen

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 tabel Objecten.

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:

Kolomnaam	Type	Beschrijving
`COMBINEDASSOCIATIONTYPEID`	Varchar	De unieke identifier van de associatiedefinitie.
`FROMOBJECTID`	Aantal	Het 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 bijbehorende deals en contactpersonen ophalen.

Vraag:

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

Retourneert:

GECOMBINEERD VERENIGINGSTYPEID	VANOBJECTID	TOOBJECTID
0-5	6626541373	233620335
0-5	6616436082	3866015468
0-5	6690805943	7132752747
...	...	...

Voorbeeld 2

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

Vraag:

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

Retourneert:

GECOMBINEERD VERENIGINGSTYPE	VANOBJECTID	TOOBJECTID
0-5	6626541373	233620335

Voorbeeld 3

Alle deals ophalen die zijn gekoppeld aan een specifiek contact (contact-ID: 4464). In plaats van de gecombineerdeAssociationTypeId hard te coderen, voegt dit voorbeeld samen 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:

GECOMBINEERD VERENIGINGSTYPEID	VANOBJECTID	TOOBJECTID
0-5	6626541373	233620335

Vragen van eigenaren

eigenaren

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	De eigenaars-ID van de gebruiker.
`USERID`	Aantal	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 kolom gegevenstypen 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 zijn opgenomen door Snowflake.

Voorbeeld 1

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

Vraag:

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 ophalen aan de hand van zijn eigenaars-ID.

Vraag:

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

Retourneert:

EIGENAARID	USERID	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

Retourneert:

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

Team vragen

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:

Kolomnaam	Type	Beschrijving
TEAMID	Aantal	De team-ID.
TEAMNAAM	Varchar	De teamnaam.
PARENTEAMID	Aantal	Het team-ID van het ouderteam.
CHILDTEAMIDS	Array	De team-ID's van de kindteams.
PRIMAIRE-EIGENDOMSLEDEN	Varchar	De eigenaars-ID's van de primaire teamleden.
SECUNDAIRE LEDEN	Booleaans	De eigenaars-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-EIGENDOMSLEDEN
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:

Kolomnaam	Type	Beschrijving
TEAMID	Aantal	De team-ID.
EIGENAARID	Aantal	De eigenaars-ID van de gebruiker.
ISTEAMPRIMATIE	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 eigenaars voor een bepaald team ophalen.

Vraag:

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

Geeft

TEAMID	TEAMNAAM	ISTEAMPRIMATIE
29584574	233620335	WARE
29584574	1234553	WAR E

Query's voor pijpleidingen

Hieronder lees je hoe je gegevens over deal- en ticketpijplijnen kuntopvragen , zoals de beschikbare pijplijnen in je account en hun stadia.

Je kunt deze gegevens combineren met objectgegevens voor een volledig overzicht 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.

pijpleidingen

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

Kolomnaam	Type	Beschrijving
`PIPELINEID`	Varchar	De ID van de pijpleiding.
`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`	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 pipelines ophalen, gerangschikt op volgorde in HubSpot.

Vraag:

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

Retourneert:

OBJECTTYPEID	PIPELINEID	ETIKET
0-3	1bed503c-37f7-4f51-9d40-7598902673f4	Verkooppijplijn
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';

Retourneert:

DEAL_ID	DEAL_NAME	PIJPELIJNNAAM
605140072	Wereldwijde inschrijving Meowmix	Verkooppijplijn
605457408	Friskies Rebrand	Verkooppijplijn
604362473	Verse stap 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 je 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';

Retourneert:

DEAL_ID	DEAL_NAME	PIJPELIJNNAAM
605140072	Wereldwijde inschrijving Meowmix	Verkooppijplijn
605457408	Friskies Rebrand	Verkooppijplijn
604362473	Verse stap app bouwen	Verkooppijplijn

pijplijn_stappen

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

Dit databaseobject kan de volgende kolommen retourneren:

Kolomnaam	Type	Beschrijving
`PIPELINEID`	Varchar	De ID van de pijpleiding.
`STAGEID`	Varchar	De ID van het podium.
`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 podium, inclusief of het open of gesloten is.
`ARCHIVED`	Booleaans	Of de pijplijnfase is verwijderd.
`CREATEDAT`	Tijdstempel	Wanneer de pijplijnstap is gemaakt.

Voorbeeld 1

Haal pijplijnfasen op voor een dealpijplijn met de naam Verkooppijplijn.

Vraag:

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	ETIKET
941650	941651	Contact opgenomen met
941650	941652	Afspraak gepland
941650	941653	Factuur verzonden
...	...	...

Voorbeeld 2

Alle deals en hun respectievelijke pijplijnstadia 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';

Retourneert:

DEAL_ID	DEAL_NAME	PIJPELIJNNAAM	PIJPLIJN_STAGE_NAAM
605140072	Wereldwijde inschrijving Meowmix	Verkooppijplijn	Contract verzonden
605457408	Friskies Rebrand	Verkooppijplijn	Afspraak gepland
604362473	Verse stap app bouwen	Verkooppijplijn	Contract ondertekend
...	...	...	...

Vragen over eigendom

eigendom_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 voor het definiëren van waarden die je kunt vinden in object_eigenschappen en gebeurtenisgegevens.

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

Dit databaseobject kan de volgende kolommen retourneren:

Kolomnaam	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 het eigendom.
`TYPE`	Varchar	Het type eigenschap (bijv. tekenreeks, 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. Eigenaar-eigenschappen geven de waarde EIGENAAR terug.
`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 getaleigenschap wordt opgemaakt als een valuta.
`FORMFIELD`	Booleaans	Of deze eigenschap kan worden gebruikt in formulieren.
`READONLYDEFINITION`	Booleaans	Of de eigenschap kan worden bewerkt in HubSpot.
`READONLYVALUE`	Booleaans	Of de waarde van de eigenschap kan worden bewerkt in HubSpot.
`HUBSPOTDEFINED`	Booleaans	Of de eigenschap is gemaakt door HubSpot of 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

Haal de namen en beschrijvingen op voor alle contacteigenschappen.

Vraag:

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

Retourneert:

NAAM	ETIKET	BESCHRIJVING
ingevoerd_sql_stadium	SQL-fase binnengegaan	Begin telling SQL stage dagen.
eerste_conversie_gebeurtenis_naam	Eerste conversie	Het eerste formulier dat deze contactpersoon heeft verzonden.
adres	Adres	Het adres van de contactpersoon.

Evenement opvragen

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

Naam
GEBEURTENISSEN_AD_INTERACTIE	Details van een advertentie en contactpersonen die interactie hadden door op de advertentie te klikken of een formulier in te vullen nadat ze met de advertentie in contact waren gekomen.
GEBEURTENISSEN_AD_METRIEK_INGEVOERD_V0	Details van een advertentie en de bijbehorende prestatiecijfers.
GEBEURTENISSEN_OPROEP_GENOEMD_SLEUTELWOORD	Details van trefwoorden die door deelnemers aan gesprekken zijn genoemd.
GEBEURTENISSEN_KLIKTE_LINK_IN_EMAIL_V2	Koppelingen waarop contactpersonen in marketinge-mails hebben geklikt.
GEBEURTENISSEN_KLIKTE_LINK_IN_GESPOORD_INBOX_EMAIL_V8	Geklikte koppelingen in e-mails van de Inbox van Gesprekken door contactpersonen.
GEBEURTENISSEN_COOKIE_BANNER_GEKLIKT	Contactpersonen die op cookies hebben geklikt.
GEBEURTENISSEN_COOKIE_BANNER_BEKEKEN	Contacten die cookies hebben bekeken.
GEBEURTENISSEN_DOCUMENT_GEDEELD_V2	Verkoopdocumenten gedeeld met contactpersonen via een externe link.
GEBEURTENISSEN_DOCUMENT_BEKEKEN_V2	Verkoopdocumenten en contactpersonen die ze hebben bekeken door de externe link te openen.
GEBEURTENISSEN_DOCUMENT_VOLTOOID_V2	Verkoopdocumenten en contactpersonen die deze hebben afgesloten.
GEBEURTENISSEN_HS_GEPLANDE_EMAIL_V2	E-mails die naar de HubSpot e-mailservers worden verzonden.
GEBEURTENISSEN_MTA_BEZORGDE_EMAIL_V2	E-mails succesvol afgeleverd bij de ontvangers door HubSpot e-mail servers.
GEBEURTENISSEN_MTA_AANGEKONDIGDE_EMAIL_V2	E-mail afleverpogingen die werden afgewezen door de e-mailserver van de ontvanger.
GEBEURTENISSEN_GEOPEND_EMAIL_V2	Geopende e-mails door contactpersonen.
GEBEURTENISSEN_GEMELDE_SPAM_EMAIL_V2	E-mails die door ontvangers als spam zijn gemarkeerd.
GEBEURTENISSEN_BIJGEWERKTE_EMAIL_ABONNEMENT_STATUS_V2	Wijzigingen in e-mailabonnementen door ontvangers.
GEBEURTENISSEN_GEOPEND_GETRACEERD_INBOX_EMAIL_V8	Conservations Inbox e-mails geopend door contactpersonen.
GEBEURTENISSEN_MB_MEDIA_AFGESPEELD	Video afspelen per contactpersoon.
GEBEURTENISSEN_V2_CONTACT_GEBOEKTE_BIJEENKOMST_DOOR_REEKS	Contact boekte een vergadering via sequence.
GEBEURTENISSEN_V2_CONTACT_INGESCHREVEN_IN_REEKS	Contact ingeschreven uit reeks.
GEBEURTENISSEN_V2_CONTACT_VOLTOOID_REEKS	Sequentie voltooid.
GEBEURTENISSEN_V2_CONTACT_BEANTWOORD_REEKS_EMAIL	Contact heeft geantwoord op e-mail (of inkomende e-mail die sequentie afmeldde) die via sequentie is verzonden.
GEBEURTENISSEN_V2_CONTACT_NIET_INGESCHREVEN_UIT_REEKS	Contact uit de reeks verwijderd.
GEBEURTENISSEN_V2_CONTACT_NIET_INGESCHREVEN_HANDMATIG_UIT_REEKS	De gebruiker heeft het contact handmatig afgemeld.
GEBEURTENISSEN_V2_CONTACT_NIET-INGESCHREVEN_REEKS_EMAIL	Contact heeft zich afgemeld, waardoor de reeks niet meer wordt ingeschreven.
GEBEURTENISSEN_V2_REEKS_EMAIL_AANGEKONDIGD	Sequence e-mail bounced.
GEBEURTENISSEN_V2_VOLGORDE_ERRORED	Fout in volgorde waardoor inschrijving geweigerd wordt.
GEBEURTENISSEN_V2_OPEENVOLGING_STAP_UITGEVOERD	Sequence stap uitgevoerd.
GEBEURTENISSEN_BEZOCHTE_PAGINA	Bezoeken aan websitepagina's door contactpersonen.
GEBEURTENISSEN_<INTEGRATIE_GEBEURTENIS_NAAM>_<UNIEKE_IDENTIFICATOR>	Integratiegebeurtenissen(Timeline V3 API)

Je kunt gebeurtenissen identificeren door hun gebeurtenistype-ID en ID te combineren. De kolommen die worden geretourneerd hangen af van de gebeurtenis, met een 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 de kolommen occuredat en occuredatdateint op 24 november 2022. Op die datum zullen de oude kolommen niet langer beschikbaar zijn en zullen pogingen om een databaseobject of weergave met gebeurtenissen die deze kolommen gebruiken, te bevragen, mislukken. Meer informatie over brekende wijzigingen voor Snowflake-gegevensshares.

Kolomnaam	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 binnen een bepaald evenementtype zullen dezelfde ID hebben.
`OBJECTTYPEID`	Varchar	Het type object dat de gebeurtenis heeft voltooid. Bijvoorbeeld, een klik op een e-maillink zou `0-1` weergeven in deze kolom, die het contactobject voorstelt.
`OBJECTID`	Aantal	De ID van de record die het voorval voltooide.
`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 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. 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.

Vraag:

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;

Retourneert:

EVENTTYPEID	OBJECTTYPEID	OBJECTID	OP	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 bij de contactpersonen die hebben geklikt. Deze query krijgt contactgegevens door samen te voegen met object_with_object_properties.

Vraag:

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_vragen

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:

Kolomnaam	Type	Beschrijving
`OBJECTTYPEID`	Varchar	De 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.

Vraag:

SELECT objectTypeId, fullyQualifiedName
FROM object_and_event_type_definitions;

Retourneert:

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

Lijsten met zoekopdrachten

Hieronder wordt uitgelegd hoe u uw lijsten kunt doorzoeken, zoals de beschikbare lijsten met contactpersonen en bedrijven en de records in die lijsten.

lijsten

Dit databaseobject bevat informatie over HubSpot contact- en bedrijfslijsten. Retourneert één rij per lijst en kolommen bevatten lijstdetails zoals lijstnaam, grootte en het objecttype van de records die het bevat. Bevat geen informatie over de individuele records binnen elke lijst (zie list_membership).

Dit databaseobject kan de volgende kolommen retourneren:

Kolomnaam	Type	Beschrijving
`OBJECTTYPEID`	Varchar	Het type records in de lijst (bijv. contactpersoon of bedrijf).
`LISTID`	Aantal	Het ID van de lijst. Koppelt aan de kolom LISTID in de tabel met lijstlidmaatschappen.
`CLASSICLISTID`	Aantal	Een ID die specifiek is voor contactlijsten en overeenkomt met de ID in de URL van de lijst in HubSpot.
`NAME`	Varchar	De naam van de lijst.
`SIZE`	Aantal	Het aantal records in de lijst.
`CREATEDBYUSERID`	Aantal	Het ID van de gebruiker die de lijst heeft aangemaakt.
`CREATEDAT`	Tijdstempel	Wanneer de lijst is gemaakt in HubSpot.
`UPDATEDBYUSERID`	Aantal	De ID van de gebruiker die de lijst 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 contactlijsten ophalen.

Vraag:

SELECT listId, name, size
FROM lists
WHERE objectTypeId = '0-1';

Retourneert:

LISTID	NAAM	SIZE
118131	Wekelijks bereik	103
66156	Blog abonnees	455
771852	Top-abonnees 2021	37
...	...	...

Voorbeeld 2

Een specifieke lijst met contactpersonen ophalen met de naam Top-abonnees 2021.

Vraag:

SELECT listId, name, size
FROM lists
WHERE objectTypeId = '0-1' ANDlistName = 'Top subscribers 2021';

Retourneert:

LISTID	NAAM	SIZE
771852	Top-abonnees 2021	37

lijst_lidmaatschap

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

Bevat alleen lijst-ID's en object-ID's. Sluit je aan bij het databaseobject Lijsten voor meer informatie.

Dit databaseobject kan de volgende kolommen retourneren:

Kolomnaam	Type	Beschrijving
`LISTID`	Varchar	Het ID van de lijst. Koppelt aan de kolom HS_LIST_ID in de tabel met lijsten.
`OBJECTID`	Varchar	Het ID van de record in de lijst.
`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 ID's ophalen van alle contactpersonen in de lijst Top-abonnees 2021.

Vraag:

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

Retourneert:

OBJECTID

54325098

96805401

6922028

...

Voorbeeld 2

De voor- en achternaam ophalen van details van contactpersonen in de lijst Top-abonnees 2021.

Vraag:

SELECT

contact.objectId AS objectid, contact.property_firstname AS firstname, contact.property_lastname AS lastname FROM objects_contacts contact INNER JOIN list_memberships ON contact.objectId = list_memberships.objectId INNER JOIN lists ON list_memberships.listId = lists.listId WHERE lists.objectTypeId = '0-1' AND lists.name = 'Top Subscribers 2021'

Retourneert:

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

FAQs

Ik wil gegevens genereren die lijken op een rapport van de Hubspot-app, hoe pak ik dat aan?

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 een query uit te voeren op property_definitions:

SELECT * FROM property_definitions

WHERE label = [column_name]

Er is niet altijd een exacte overeenkomst omdat sommige namen van eigenschappen meestal worden omgezet naar een meer beschrijvende naam in de app. In dit soort 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 haal ik formulieren op voor een campagne?

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?

Om realtime statusupdates over uitval en problemen voor de HubSpot-Snowflake integratie te 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	GEEN INCIDENT BEKEND OP DIT MOMENT	2023-04-10 09:21:20.123

Deze weergave geeft updates over de integratiestatus in omgekeerd chronologische volgorde. Door de resultaten van deze query te integreren in een dashboard kun je de prestaties van de integratie volgen en eventuele downtime of uitval detecteren.

Volledig bericht weergeven