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: februari 1, 2024

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

Operations Hub Enterprise

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.

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.

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.

    snowflake-worksheet-settings0
  • 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:
        • 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 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.

snowflake-sidebar-view-column-details0


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:


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

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

VOORNAAM

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

VASTGOED_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 -fase 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 op voor alle contactpersonen 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 VOORNAAM 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 VOORNAAM 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 fasen door objecttype-ID, pijplijn-ID en fase-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 occuredAt

LIMIT 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'
AND
listName = '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 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 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 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.