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

HubSpot-gegevens opvragen in Snowflake

Laatst bijgewerkt: oktober 5, 2022

Geldt voor:

Operations Hub Enterprise

Nadat u Snowflake aan uw HubSpot-account hebt gekoppeld, kunt u Snowflake's Data Share gebruiken om HubSpot-gegevens te bevragen vanuit uw Snowflake-account.

Gegevensvertraging en uw Snowflake-accountregio

De Snowflake-regio van uw account bepaalt hoe vaak uw HubSpot-gegevens worden bijgewerkt. Als de regio van uw Snowflake-account overeenkomt met de regio van HubSpot's Snowflake-account (voor HubSpot-accounts in het EU-datacenter betekent dit EU_CENTRAL_1_AWS, voor alle andere HubSpot-accounts betekent dit US_EAST_1_AWS), dan worden uw gegevens maximaal elke 15 minuten bijgewerkt.

U krijgt toegang tot het V2_LIVE schema dat elke 15 minuten wordt bijgewerkt, en het V2_DAILY schema dat elke dag wordt bijgewerkt. Als uw HubSpot-accountregio en Snowflake-regio niet overeenkomen, hebt u alleen toegang tot het V2_DAILY-schema dat elke dag wordt bijgewerkt.

Uw Snowflake-omgeving opzetten

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

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

  • Klik in de bovenste rij van het werkblad op de werkblad-actiebalk.

    snowflake-worksheet-settings0
  • In het pop-up venster:
    • Klik op het dropdown-menu Warehouse en selecteer je magazijn.
    • Klik op het keuzemenu Database en selecteer vervolgens je HubSpot-database.
    • Klik op het dropdown menu Schema en selecteer het schema dat je wilt gebruiken:
        • V2_DAILY (BETA): het dagelijkse schema om gegevens te bevragen 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 u een grote set gegevens opvraagt, kunnen query's traag zijn. In dat geval is het raadzaam om de gegevens eerst met een ETL-proces naar je eigen tabel te kopiëren en vervolgens die tabel te bevragen. Dit schema is momenteel alleen beschikbaar als uw Snowflake-accountregio overeenkomt met de regio van het Snowflake-account van HubSpot.


      snowflake-worksheet-settings-window0

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

Om handmatig uw database en schema type aan queries toe te voegen, voegt u 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

LIMIET 1

Overzicht gegevens

Queries worden opgebouwd met behulp van SQL, en kunnen worden gebruikt om HubSpot-gegevens op te halen zoals:

  • Objecten: standaard en aangepaste objecten, zoals contacten, bedrijven, producten.
  • Records: individuele records, zoals een individueel contact of bedrijf.
  • Verenigingen: alle beschikbare types associaties en momenteel geassocieerde records.
  • Gebeurtenissen: gebeurtenisgegevens voor zowel standaard HubSpot gebeurtenissen, zoals e-mailopeningen, als aangepaste gedragsgebeurtenissen.
  • Lijsten: HubSpot contact- en bedrijfslijsten.
  • Eigenaren: gebruikers in uw HubSpot-account, in relatie tot de records waarvan zij als eigenaar zijn ingesteld.
  • Pipelines: deal en ticket pipelines, inclusief pijplijnstadia.
  • Eigenschappen: eigenschappen en hun waarden op CRM-records, inclusief de geschiedenis van de eigenschappen.

Meer informatie over HubSpot's CRM datamodel.

Let op: Terwijl we de gegevensdeling ontwikkelen, zullen we wijzigingen introduceren, waarvan sommige brekende wijzigingen. Het is sterk aanbevolen om je te abonneren op HubSpot's developer change log. Deze wijzigingen worden altijd voorafgaand aan een update in het change log geplaatst.

Beperken en ordenen van geretourneerde gegevens

Bij het opstellen van query's kunt u bepalen hoeveel gegevens worden geretourneerd en in welke volgorde, door LIMIT en ORDER BY in uw query op te nemen. Om bijvoorbeeld alle contactpersonen met hun eigenschappen op te vragen, maar slechts drie resultaten te retourneren en ze te ordenen op contact-ID, zou u uw query als volgt kunnen construeren:


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

Soorten kolomgegevens

Bij het bevragen van gegevens in Snowflake zijn de kolommen die worden geretourneerd afhankelijk van de gegevens die u bevraagt. U 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 deze doc gebruiken we de term databaseobject wanneer de context van toepassing is op zowel tabellen als views.

snowflake-sidebar-view-column-details0


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


SELECT
objectId, updatedAt
van objecten_contacten

Hieronder staan algemene definities voor kolommen die een query kan opleveren. 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 staat voor het contactpersonenobject, 0-2 voor het bedrijvenobject, en 2-1232 kan een aangepast object in uw account vertegenwoordigen. In lijsten verwijst dit naar het type lijst (bijv. contactpersoon of bedrijf). U kunt alle object- en gebeurtenis-ID's in uw account opvragen met de weergave object_en_gebeurtenis_type_definities.
  • OBJECTID: een BIGINT nummer dat staat voor een enkele record van een bepaald type object in je HubSpot account. Om een record te identificeren, moet je zowel het objecttype ID als het 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 creatie- of updatebewerking in HubSpot.
    • Als gevolg van HubSpot's interne verwerking, kan de ingestion timestamp van een rij worden bijgewerkt, zelfs als er geen andere kolommen op de rij zijn veranderd.
    • 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 uw stroom dagelijks gegevens kopieert, is het bovendien raadzaam 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 aangemaakt of bijgewerkt in HubSpot, weergegeven door een TIMESTAMP_NTZ waarde. Deze timestamps zullen overeenkomen met timestamps in HubSpot. De tijd die in HubSpot wordt weergegeven voor de aanmaakdatum van een record zal bijvoorbeeld hetzelfde zijn 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 associatiedefinitie uniek identificeert.

Gegevenstypes transformeren

Soms worden gegevens teruggestuurd uit een query met VARCHAR-kolommen, terwijl het wenselijk is dat ze van een ander type zijn. In dergelijke gevallen wordt aanbevolen 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-datatype, maar bevatten soms getallen en datetime-waarden. Functies zoals:
try_to_number, try_to_timestamp_ntz kunnen worden gebruikt om deze VARCHAR-gegevens om te zetten in respectievelijk hun typen NUMBER en DATETIME:


SELECT objectid, value AS amount_str, try_to_number(value) AS amount

VAN object_eigenschappen
WHERE objecttypeid='0-3' AND name='amount'
LIMIT 1

Objectvragen

Hieronder leest u hoe u gegevens van specifieke HubSpot-objecten en -records kunt opvragen, samen met de gegevens die worden geretourneerd.

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

  • Individueel: Elk objecttype wordt opgeslagen in zijn eigen view en bevat alleen records van hetzelfde objecttype, bv. objecten_contacten bevat alleen contactrecords. Dit elimineert de noodzaak om een objecttypeid te specificeren tijdens het queryen. Deze views zijn gemakkelijker te bevragen omdat je geen ObjectTypeIds hoeft te kennen. Ze geven ook gegevens terug in een bruikbaarder formaat, waarbij elke rij overeenkomt met een object en de huidige versie van zijn eigenschappen. Zolang u geen trage queries ervaart, is het raadzaam deze views te gebruiken om objectgegevens op te halen. Zie meer in Objects_X views hieronder.
  • Gecombineerd: Alle records voor alle objecttypen worden gecombineerd in één databaseobject. Daarom moet u bij een query een filter opgeven zoals "WHERE objectTypeId='0-1'. U kunt bijvoorbeeld de volgende objecttypeids gebruiken bij een query:
Naam van het object ObjectTypeId
Contacten 0-1
Bedrijven 0-2
Artikelen 0-8

Aangepaste objecten krijgen een ID toegewezen bij het aanmaken, en worden geïdentificeerd als 2-unique_ID. Bijvoorbeeld 2-12345. Meer informatie over object_en_event_type_definities.

Deze databaseobjecten zijn over het algemeen geschikt als u betere queryprestaties wenst dan wat haalbaar is met objects_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, met inbegrip van aangepaste objecten, zijn eigen specifieke weergave, waarbij elke weergave alleen records bevat voor objecten van dat specifieke objecttype. Deze weergaven worden benoemd volgens het formaat OBJECTS_<objecttypenaam> waarbij <objecttypenaam> de meervoudsvorm label van het objecttype(Merk op dat indien het objecttype geen meervoudsvorm heeft, <objecttypenaam> gewoon het label in enkelvoud van de objecttypenaam is, aaneengesloten met "S").

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

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

HubSpot Objecttype

ObjectTypeId

Beschrijving

CONTACT

0-1

Informatie over personen die met uw bedrijf omgaan

BEDRIJF

0-2

Informatie over individuele bedrijven of organisaties

DEAL

0-3

Details over omzetmogelijkheden bij een contactpersoon of bedrijf.

TICKET

0-5

Vertegenwoordigt verzoeken van klanten om hulp of ondersteuning.

QUOTE

0-14

Gebruikt om prijsinformatie te delen met potentiële kopers.

FORMULIER_INDIENING

0-15

Details voor individuele inzendingen voor een HubSpot-formulier.

LIJN_ITEM

0-8

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

CONVERSATIE

0-11

Details van inkomende berichten van meerdere kanalen.

LANDING_PAGE

0-25

Details van uw landingspagina's

TASK

0-27

Slaat informatie op over to-do lijsten

FORM

0-28

Gebruikt om leadinformatie te verzamelen over uw bezoekers en contacten

MARKETING_EMAIL

0-29

Details over e-mails van marketing hub

AD_ACCOUNT

0-30

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

AD_CAMPAIGN

0-31

Details over uw advertentiecampagnes. Een advertentiecampagne kan één of meer advertenties bevatten

AD_GROEP

0-32

Logische groepering van advertenties binnen een advertentiecampagne

AD

0-33

Details over individuele advertenties

CAMPAGNE

0-35

Informatie over gerelateerde marketingmiddelen en content, zodat u eenvoudig de effectiviteit van uw gezamenlijke marketinginspanningen kunt meten.

SITE_PAGE

0-38

Gegevens over afzonderlijke pagina's op uw websites

BLOG_POST

0-39

Gegevens over blogberichten

OBJECT LIJST

0-45

Informatie over groeperingen van objectrecords op basis van hun eigenschappen of activiteiten

BEL

0-48

Oproepen door andere CRM-records, bijv. contacten

INVOICE

0-53

Facturen beheren en synchroniseren met externe boekhoudsystemen

MEDIA_BRIDGE

0-57

Informatie over media activa geïmporteerd in Hubspot

SEQUENCE

0-58

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

DEAL_SPLIT

0-72

Deal splits worden gebruikt om deal krediet te delen tussen meerdere gebruikers

VERKOOPDOCUMENT

0-83

Verkoopdocumenten bouwen een bibliotheek met inhoud voor uw hele team om documenten te uploaden en te delen met uw contacten.

FEEDBACK_INDIENING

0-19

Slaat informatie op die is ingediend bij een feedbackonderzoek.

INSCHRIJVING

0-69

Abonnementen bevatten details van terugkerende betalingen

COMMERCIËLE BETALING

0-101

Bevat gegevens over bij klanten geïnde gelden



Elk databankobject levert de volgende kolommen op:

Naam van de kolom

Type

Beschrijving

OBJECTTYPEID

Varchar

Het ID van het objecttype (bijv. contacten is 0-1).

OBJECTID

Nummer

Het ID van de record (bv. een contactrecord met een ID van 123752).

UPDATEDAT

Tijdstempel

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

INGESTEDAT

Tijdstempel

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

PROPERTY_*

Varchar

Afzonderlijke kolommen met de laatste versie van de eigenschappen van het object.Voor elke objecteigenschap die een datum- of getaltype heeft (zoals gespecificeerd door eigenschap_definities) zijn er twee kolommen:

  1. Een kolom die de waarde van de eigenschap als string bevat. De kolomnaam is property_unparsed_[name] . Bijvoorbeeld, DEAL object property, deal_amount zal de kolom property_unparsed_deal_amount hebben.
  2. Een kolom die de naar het native type geconverteerde waarde bevat. 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 bevat indien de conversie naar het native type mislukt wegens ongeldige gegevens.

Voorbeeld 1


Haal de voornaam, achternaam en levensfase op voor alle contactpersonen.

Vraag:


SELECT objectId, property_firstname AS voornaam, property_lastname AS achternaam, property_lifecyclestage AS lifecyclestage

VAN objecten_contact

Terug:

OBJECTID

EERSTE NAAM

LASTNAME

LEVENSCYCLUSFASE

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.

Vraag:


SELECT objectId, property_dealName, property_dealStage,
object_bedrag AS dealAmount

FROM objecten_deals

LIMIT 3

Terug:

OBJECTID

PROPERTY_DEALNAME

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 naam en het stadium van de top drie transacties op basis van het bedrag.

Query:

Aangezien de gegevens over het transactiebedrag beschikbaar zijn als een getalstype, kunnen ze worden gebruikt om te ordenen zonder dat conversie of casting nodig is.


SELECT objectId, property_dealName, property_dealStage,
object_bedrag AS dealAmount

VAN objects_deals
ORDER BY property_amount DESC
LIMIT 3


Terug:

OBJECTID

PROPERTY_DEALNAME

EIGENDOM_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 database object bevat gegevens van uw HubSpot records. Queries naar dit database object retourneren een rij voor elke record binnen een objecttype (bijv. alle contact records in het contacts objecttype). Alle eigenschappen worden opgeslagen in de kolom Eigenschappen, die een Snowflake Variant / JSON kolom is.

Deze weergave kan de volgende kolommen opleveren:

Naam van de kolom Type Beschrijving
OBJECTTYPEID Varchar Het ID van het objecttype (bijv. contacten is 0-1).
OBJECTID Nummer Het ID van de record (bv. een contactrecord met een ID van 123752).
EIGENSCHAPPEN Variant De vastgoedwaarden van het record.
UPDATEDAT Tijdstempel De datum en tijd dat het record voor het laatst is bijgewerkt in HubSpot. Meer informatie over kolom datatypes.
INGESTEDAT Tijdstempel De datum en tijd waarop de gegevens voor het laatst door Snowflake zijn opgenomen.

Voorbeeld 1

Alle contacten en hun eigenschappen ophalen.

Query:


SELECT objectTypeId, objectId, eigenschappen
VAN object_met_object_eigenschappen
WAAR objectTypeId = '0-1'


Terug:

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.

Query:


SELECT

objectId,
properties:dealname::string AS dealname,
properties:dealstage::string AS dealstage,
properties:bedrag::getal als dealbedrag
FROM object_with_object_properties
WHERE objectTypeId = '0-3'
LIMIT 3;


Terug:

OBJECTID DEALNAME DEALSTAGE DEALAMOUNT
38960439 Deal naam 1
closedlost
7488939
321740651 Deal naam 1
geslotenwon
9292029
98392101 Deal naam 1
closedlost
62626528

objecten

Dit databaseobject is een subset van de gegevens in het databaseobject object_with_object_properties. Elke geretourneerde rij retourneert het object-ID voor elke record. Dit database object 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, zal het worden verwijderd uit deze weergave.

Dit databaseobject kan nuttig zijn als uw 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, met behoud van controle over welke eigenschappen worden geretourneerd.

Dit databaseobject kan de volgende kolommen teruggeven:

Naam van de kolom Type Beschrijving
OBJECTTYPEID Varchar Het ID van het objecttype (bijv. contacten is 0-1).
OBJECTID Nummer Het ID van de record (bv. 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 contactpersonen ophalen.

Query:


SELECT objectTypeId, objectId
VAN objecten
WAAR objectTypeId = '0-1'


Terug:

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

object_eigenschappen

Dit databaseobject is een deelverzameling van het databaseobject object_with_object_properties. Elke rij bevat de huidige waarde van de eigenschap van een gegeven record. Bijvoorbeeld, een contactpersoon heeft één rij voor de eigenschap Voornaam en één rij voor de eigenschap Achternaam. Als een record geen waarde heeft voor een eigenschap, verschijnt de rij met een lege string of helemaal niet.

Dit databaseobject kan de volgende kolommen teruggeven:

Naam van de kolom Type Beschrijving
OBJECTTYPEID Varchar Het ID van het objecttype (bijv. contacten is 0-1).
OBJECTID Nummer Het ID van de record (bv. een contactrecord met een ID van 123752).
NAAM Varchar De naam van het pand.
WAARDE Tijdstempel De waarde van het eigendom.
UPDATEDAT Tijdstempel De datum en tijd dat het record voor het laatst is bijgewerkt in HubSpot. Meer informatie over kolom datatypes.
INGESTEDAT Tijdstempel De datum en tijd waarop de gegevens voor het laatst door Snowflake zijn opgenomen.

Voorbeeld 1

Ophalen van de voornaam, achternaam en woonplaats voor alle contactpersonen.

Query:


SELECT objectTypeId, objectId, naam, waarde
VAN object_eigenschappen
WHERE objectTypeId = '0-1'
EN naam IN ('voornaam', 'achternaam', 'stad')
ORDER BY objectId;


Terug:

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 levensfase voor alle contactpersonen op en combineer ze in één rij per contactpersoon. Dit voorbeeld gebruikt de SQL PIVOT syntaxis.

Query:


SELECT objectId, voornaam, achternaam, levenscyclusfase
VAN
(
SELECT objectId, naam, waarde
VAN object_eigenschappen
WHERE objectTypeId = '0-1'
EN naam IN ('voornaam', 'achternaam', 'lifecyclestage')
)
PIVOT(MAX(value) FOR name IN ('firstname', 'lastname', 'lifecyclestage')) AS p(objectId, voornaam, achternaam, levenscyclusfase);

Terug:

OBJECTTYPEID OBJECTID EERSTE NAAM LASTNAME LEVENSCYCLUSFASE
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. Toont een rij voor elke historische waarde van een eigenschap. De huidige waarde van een eigenschap wordt bepaald door het meest recente UPDATEDAT-tijdstempel in de geschiedenis van de eigenschap.

Dit databaseobject kan de volgende kolommen teruggeven:

Naam van de kolom Type Beschrijving
OBJECTTYPEID Varchar Het ID van het objecttype (bijv. contacten is 0-1).
OBJECTID Nummer Het ID van de record (bv. een contactrecord met een ID van 123752).
NAAM Varchar De naam van het pand.
WAARDE Tijdstempel De waarde van het eigendom.
UPDATEDAT Tijdstempel De datum en tijd dat de gegevens voor het laatst zijn bijgewerkt in HubSpot. Meer informatie over kolom datatypes.
INGESTEDAT Tijdstempel De datum en tijd waarop de gegevens voor het laatst door Snowflake zijn opgenomen.

Voorbeeld 1

Ophalen van de geschiedenis van één eigenschap voor één contactpersoon.

Query:


SELECT objectId, naam, waarde, updatedAt
FROM object_properties_history
WHERE objectTypeId = '0-1'
EN objectId = 136493192
EN naam = 'hs_predictivescoringtier'.
ORDER BY UPDATEDAT DESC;


Terug:

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 levensfase van Abonnee hebben gehad.

Query:


SELECT
objectId,
eigenschappen:voornaam::string als voornaam,
eigenschappen:achternaam::string als achternaam
VAN object_met_object_eigenschappen
WHERE object_with_object_properties.objectTypeId = '0-1'
EN 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".
);


Terug:

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

Verenigingsvragen

Net als gegevens over objecten worden gegevens over verenigingen op twee manieren georganiseerd:

  • Individueel: Elk associatietype wordt opgeslagen in zijn eigen weergave en bevat alleen records van dat type. Bijvoorbeeld, associations_contacts_to_deals bevat alleen associatie records tussen contact en deal objecten. Dit elimineert de noodzaak om een associatietypeid te specificeren tijdens de query. Deze views zijn vrij eenvoudig te bevragen, omdat er geen kennis van het CRM-gegevensmodel nodig is om ze te gebruiken. Ze geven ook een verrijkte beschrijving van de associatierecord tussen twee objecten, die gemakkelijk kan worden gebruikt in joins met objects_x views. Zolang u geen trage query's ervaart, is het raadzaam deze views te gebruiken om associatiegegevens op te halen. Zie meer in associations_x_to_y views hieronder.
  • Gecombineerd: Alle records voor alle associatietypen worden gecombineerd in één databaseobject. U moet dus bij een query een filter opgeven zoals "WHERE combinedassociationtypeid='0-32'". Zie meer in associaties en associatie_definities hieronder.

associaties_x_naar_y weergaven(BETA)

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

Elk databaseobject geeft de volgende kolommen terug:

Naam van de kolom

Type

Beschrijving

COMBINEDASSOCIATIONTYPEID

Varchar

De unieke identificatiecode van de associatiedefinitie.

ASSOCIATIECATEGORIE

Varchar

De bron van het type associatie. Een van: HUBSPOT_DEFINED, USER_DEFINED, INTEGRATOR_DEFINED

ASSOCIATIONTYPEID

Varchar

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

FROMOBJECTTYPEID

Varchar

Het objecttypeid dat de bron is van de associatiedefinitie.

VANOBJECTTYPE

Varchar

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

TOOBJECTTYPEID

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.

LABEL

Varchar

De beschrijving van de vereniging.

ISMAINASSOCIATIONDEFINITION

Booleaanse

Of de associatiedefinitie het hoofdtype is. Indien waar, is de definitie degene die HubSpot toont op geassocieerde records.

[VANOBJECTTYPE_OBJECTID] bijv. voor de weergave ASSOCIATIONS_CONTACTS_TO_DEALS zal dit CONTACT_OBJECTID zijn.

Nummer

Het object-ID van het bronobject.

[TOOBJECTTYPE_OBJECTID] bijv. voor de weergave ASSOCIATIONS_CONTACTS_TO_DEALS zal dit DEAL_OBJECTID zijn.

Nummer

Het object-ID van het bestemmingsobject.

INGESTEDAT

Tijdstempel

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

Voorbeeld 1

Alle deals ophalen die met een specifiek contact te maken hebben.

Query:


SELECT
contact_objectId, deal_objectId

VAN associaties_contacten_naar_deals

WHERE contactId = 6626541373

Terug:

CONTACT_OBJECTID

DEAL_OBJECTID

6626541373

233620335

6626541373

90253678

Voorbeeld 2

Alle contacten in de tijdzone Bogota en hun deals ophalen.


SELECT contacts.property_firstname contact_firstname,

contacts.property_lastname contact_lastname,
contacts.property_email contact_email,
deals.property_dealtype deal_type, deals.property_bedrag deal_bedrag
VAN objecten_contacten contacten
JOIN associaties_contacten_naar_deals assoc op
assoc.contact_objectid=contacten.objectid
JOIN objects_deals deals on deals.objectid=assoc.deal_objectid
waar 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

Zoek alle contacten en de totale som van de gesloten deals voor elk contact.


SELECT SUM(deals.property_hs_closed_amount) AS
totaal_gesloten_bedrag, contacts.property_email contact_email
VAN objecten_contacten contacten
JOIN associaties_contacten_naar_deals assoc op
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

Terug:

TOTAAL_GESLOTEN_BEDRAG

CONTACT_EMAIL

98474793

johndoe@riverview.com

849488

sallymae@longford.com

associatie_definities

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

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

Dit databaseobject kan de volgende kolommen teruggeven:

Naam van de kolom Type Beschrijving
COMBINEDASSOCIATIONTYPEID Varchar De unieke identificatiecode van de associatiedefinitie.
CATEGORIE Varchar De bron van het type associatie. Een van: HUBSPOT_DEFINED, USER_DEFINED, INTEGRATOR_DEFINED
ID Nummer De identificatiecode 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.
NAAM Varchar De naam van de associatiedefinitie.
LABEL Varchar Het label van de associatiedefinitie.
ISMAINASSOCIATIONDEFINITION Booleaanse Of de associatiedefinitie het hoofdtype is. Indien waar, 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

Zoek de soorten verenigingen die beschikbaar zijn in uw account.

Query:


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


Terug:

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

Voorbeeld 2

Ophalen van de beschikbare associatietypen tussen deals en bedrijven.

Query:


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

ORDER BY category, id


Terug:

GECOMBINEERD VERENIGINGSTYPE FROMOBJECTTYPEID TOOBJECTTYPEID NAAM
0-5 0-3 0-2 DEAL_NAAR_BEDRIJF
0-271 0-3 0-2 DEAL_NAAR_PRIMAIR_BEDRIJF
0-341 0-3 0-2 DEAL_TO_COMAPNY_UNLABELED

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 in dit databaseobject aanwezig zijn, ook al zijn de records waarnaar verwezen wordt, verwijderd. U kunt controleren of er records bestaan door zich te verbinden met de tabel Objecten.

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

Dit databaseobject kan de volgende kolommen teruggeven:

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

Voorbeeld 1

Alle geassocieerde deals en contacten ophalen.

Query:


SELECT gecombineerdAssociatieTypeId, fromObjectId, toObjectId
VAN associaties
WHERE combinedAssociationTypeId = '0-5'.


Terug:

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

Voorbeeld 2

Ophalen van alle tickets gekoppeld aan een specifiek contact (contact ID: 3005).

Query:


SELECT gecombineerdAssociatieTypeId, fromObjectId, toObjectId
VAN associaties
WHERE associationCategory = 'HUBSPOT_DEFINED'.
EN combinedAssociationTypeId = '0-15'
EN fromObjectId = 3005;


Terug:

GECOMBINEERD VERENIGINGSTYPE VANOBJECTID TOOBJECTID
0-5 6626541373 233620335

Voorbeeld 3

Ophalen van alle deals die gekoppeld zijn aan een specifiek contact (contact ID: 4464). In plaats van hard-coding combinedAssociationTypeId, voegt dit voorbeeld samen met association_definitions.

Query:


SELECT combinedAssociationTypeId, fromObjectId toObjectId,
VAN associaties
WAAR
combinedAssociationTypeId = (
SELECT gecombineerdAssociatieTypeId
FROM association_definitions
WHERE fromObjectTypeId = '0-1'
EN toObjectTypeId = '0-3'
AND isMainAssociationDefinition)
EN fromObjectId = 4464;


Terug:

COMBINEDASSOCIATIONTYPEID VANOBJECTID TOOBJECTID
0-5 6626541373 233620335

Vragen van de eigenaar

eigenaren

Dit database object bevat informatie over de gebruikers in je HubSpot account. Gebruikers kunnen worden ingesteld als record eigenaar, en zullen zowel een gebruiker ID als een eigenaar ID bevatten, afhankelijk van hun context. Beide ID's kunnen worden gebruikt om dezelfde gebruiker te identificeren.

Dit databaseobject kan de volgende kolommen teruggeven:

Naam van de kolom Type Beschrijving
EIGENAARID Nummer De eigenaars-ID van de gebruiker.
USERID Nummer Het gebruikers-ID van de gebruiker. Gebruikers met NULL in deze kolom zijn verwijderd.
EMAIL Varchar Het e-mailadres van de gebruiker.
EERSTE NAAM Varchar De voornaam van de gebruiker.
LASTNAME Varchar De achternaam van de gebruiker.
ARCHIEF Booleaanse Of de gebruiker is verwijderd.
CREATEDAT Tijdstempel De datum en tijd dat de gebruiker is aangemaakt in HubSpot. Zie kolom datatypes voor meer informatie.
UPDATEDAT Tijdstempel De datum en tijd dat de gebruiker voor het laatst is bijgewerkt in HubSpot. Zie kolom gegevenstypen voor meer informatie.
INGESTEDAT Tijdstempel De datum en tijd waarop de gegevens voor het laatst door Snowflake zijn opgenomen.

Voorbeeld 1

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

Query:


SELECT ownerId, userId, email, voornaam, achternaam
VAN EIGENAARS
WAAR gearchiveerd = false


Terug:

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

Voorbeeld 2

Ophalen van een specifieke eigenaar aan de hand van zijn eigenaars-ID.

Query:


SELECT ownerId, userId, email, voornaam, achternaam
VAN EIGENAARS
WHERE ownerId = 29584574;


Terug:

EIGENAARID USERID EMAIL EERSTE NAAM LASTNAME
29584574 4621126 233620335 Hobbes Baron

Voorbeeld 3

Ophalen van alle contacten en hun eigenaren. Deze query koppelt records aan eigenaren met object_with_object_properties en de contacteigenschap hubspot_owner_id.


SELECT
contact.objectId contactid,
contact.property_voornaam contact_voornaam,
contact.property_lastname contact_lastname,
contact.property_hubspot_owner_id contact_hubspot_owner_id,
owner.firstname owner_firstname,
owner.lastname owner_lastname,
eigenaar.email eigenaar_email
FROM objecten_contacten contact

JOIN owners owner ON contact.property_hubspot_owner_id = owner.ownerId


Terug:

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

Pijplijn vragen

Hieronder leest u hoe u deal- en ticketpijplijngegevens kunt opvragen, zoals de beschikbare pijplijnen in uw account en hun stadia.

U kunt deze gegevens combineren met objectgegevens voor een volledig overzicht van uw pijplijnen. U kunt bijvoorbeeld deals en hun pijplijnen bevragen door de objects_deals_view of de object_with_object_properties data te verbinden met pijplijn data.

pijpleidingen

Dit database object bevat informatie over de deal en ticket pijplijnen in uw account. Elke geretourneerde rij vertegenwoordigt een enkele pijplijn.

Deze tabel kan de volgende kolommen opleveren:

Naam van de kolom Type Beschrijving
PIPELINEID Varchar De ID van de pijpleiding.
OBJECTTYPEID Varchar De ID van het object dat de pijplijn kan bevatten (bv. deals of tickets).
LABEL Varchar De naam van de pijplijn in HubSpot.
DISPLAYORDER Nummer De volgorde waarin de pijplijn wordt weergegeven in HubSpot.
ARCHIEF Booleaanse Of de pijplijn is verwijderd.
CREATEDAT Tijdstempel Toen de pijplijn werd gecreëerd.
UPDATEDAT Tijdstempel De datum en tijd dat de gegevens voor het laatst zijn bijgewerkt in HubSpot. Meer informatie over kolom datatypes.
INGESTEDAT Tijdstempel De datum en tijd waarop de gegevens voor het laatst door Snowflake zijn opgenomen.

Voorbeeld 1

Haal alle beschikbare deal pipelines op, gerangschikt op hun volgorde in HubSpot.

Query:


SELECT objectTypeId, pipelineId, label
VAN pijplijnen
WHERE objectTypeId = '0-3'
EN niet gearchiveerd
ORDER BY displayorder;


Terug:

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

Voorbeeld 2

Ophalen van deals binnen een specifieke pijplijn. Verbindt object_met_object_eigenschappen en pijplijnen.

Query:


SELECT

deals.objectId deal_id,
deals.object_dealnaam deal_naam,
pipelines.label pipeline_name
VAN objects_deals deals
INNER JOIN pijplijnen
ON deals.objectTypeId = pipelines.objectTypeId
EN deals.object_pipeline = pipelines.pipelineid
WHERE pipelines.objectTypeId = '0-3';


Terug:

DEAL_ID DEAL_NAME PIPELINE_NAME
605140072 Meowmix wereldwijde inschrijving Verkooppijplijn
605457408 Friskies Rebrand Verkooppijplijn
604362473 Fresh Step App Build Verkooppijplijn

Voorbeeld 3

Hetzelfde als voorbeeld 2 hierboven, deals ophalen binnen een specifieke pijplijn. Maar, in plaats van objects_deals te gebruiken in joins, gebruikt u object_met_object_eigenschappen.


SELECT
deals.objectId deal_id,
deals.properties:dealname::varchar deal_name,
pipelines.label pipeline_name
VAN object_met_object_eigenschappen deals
INNER JOIN pijplijnen
ON deals.objectTypeId = pipelines.objectTypeId
EN deals.properties:pipeline::string = pipelines.pipelineid
WHERE deals.objecttypeId = '0-3'
AND pipelines.objectTypeId = '0-3';

Terug:

DEAL_ID

DEAL_NAME

PIPELINE_NAME

605140072

Meowmix wereldwijde inschrijving

Verkooppijplijn

605457408

Friskies Rebrand

Verkooppijplijn

604362473

Fresh Step App Build

Verkooppijplijn

pijplijn_stadia

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

Dit databaseobject kan de volgende kolommen teruggeven:

Naam van de kolom Type Beschrijving
PIPELINEID Varchar De ID van de pijpleiding.
STAGEID Varchar De ID van het podium.
LABEL Varchar De naam van het podium in HubSpot.
DISPLAYORDER Nummer De volgorde waarin de pijplijn wordt weergegeven in HubSpot.
METADATA Variant Een JSON-geformatteerde beschrijving van de etappe, inclusief of deze open of gesloten is.
ARCHIEF Booleaanse Of de pijplijnfase is verwijderd.
CREATEDAT Tijdstempel Wanneer de pijplijnfase werd gecreëerd.

Voorbeeld 1

Haal pijplijnstadia op voor een dealpijplijn met de naam Verkooppijplijn.

Query:


SELECT pipelineid, stageId, label
VAN pijplijn_stadia
WHERE niet gearchiveerd
EN pipelineid = (
SELECT pipelineid
VAN pijplijnen
WHERE objectTypeId = '0-3'
EN niet gearchiveerd
AND label = 'Sales Pipeline' LIMIT 1)
ORDER BY displayorder;


Terug:

PIPELINEID STAGEID LABEL
941650 941651 Contact opgenomen met
941650 941652 Afspraak gepland
941650 941653 Factuur verzonden
... ... ...

Voorbeeld 2

Alle transacties en hun respectieve pijplijnstadia ophalen.

Query:


SELECT

deals.objectId deal_id,
deals.properties:dealname::varchar deal_name,
pipelines.label pipeline_name,
pipeline_stages.label pipeline_stage_name
VAN object_met_object_eigenschappen deals
INNER JOIN pijplijnen
ON deals.objectTypeId = pipelines.objectTypeId
EN deals.properties:pipeline::string = pipelines.pipelineid
INNER JOIN pipeline_stages
ON deals.objectTypeId = pipeline_stages.pipelineid
EN deals.properties:pipeline::string = pipeline_stages.pipelineid
AND deals.properties:dealstage::string = pipeline_stages.stageId
WHERE deals.objecttypeId = '0-3';


Terug:

DEAL_ID DEAL_NAME PIPELINE_NAME PIPELINE_STAGE_NAME
605140072 Meowmix wereldwijde inschrijving Verkooppijplijn Verzonden contract
605457408 Friskies Rebrand Verkooppijplijn Afspraak gepland
604362473 Fresh Step App Build Verkooppijplijn Contract ondertekend
... ... ... ...

Vragen over onroerend goed

eigendom_definities

Dit database object bevat informatie over object eigenschappen en gebeurtenis eigenschappen in je HubSpot account. Gebeurtenis eigenschappen omvatten standaard gebeurtenissen, zoals e-mail opens en klikken, en aangepaste gedragsgebeurtenis eigenschappen. Deze informatie kan nuttig zijn voor het definiëren van waarden 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 teruggeven:

Naam van de kolom Type Beschrijving
OBJECTYPEID Varchar De ID van het object waarop de gebeurtenis betrekking heeft.
NAAM Varchar De interne naam van de eigenschap.
LABEL Varchar Het label van het pand.
BESCHRIJVING Varchar De eigendomsbeschrijving.
TYPE Varchar Het type eigenschap (bijv. string, getal, datetime).
VELDTYPE Varchar Het veldtype van de eigenschap. Definieert hoe de eigenschap wordt weergegeven in HubSpot en op formulieren (bijv. checkbox, select).
DISPLAYORDER Nummer De weergavevolgorde van het pand.
GROEPSNAAM Varchar De groepsnaam van de eigenschap.
OPTIES Variant Voor opsommingseigenschappen, een array van de opties van de eigenschap, inclusief de attributen van elke optie (bv. weergavevolgorde, label).
CREATEDUSERID Nummer De ID van de gebruiker die de eigenschap heeft aangemaakt.
REFERENCEDOBJECTTYPE Varchar Het type object waarnaar de eigenschap verwijst. Eigenaar-eigenschappen geven de waarde EIGENAAR terug.
GECALCULEERD Booleaanse Of de eigenschap een berekende eigenschap is.
EXTERNE OPTIES Booleaanse Of de opties van de eigenschap zijn gedefinieerd in een extern systeem.
HEEFTUNIEKEWAARDE Booleaanse Of de waarden van de eigenschap uniek zijn. Kan alleen worden ingesteld bij het aanmaken van een eigenschap via de API.
VERBORGEN Booleaanse Of de eigenschap verborgen is in HubSpot.
SHOWCURRENCYSYMBOOL Booleaanse Of de waarde van een getaleigenschap wordt opgemaakt als valuta.
FORMFIELD Booleaanse Of deze eigenschap kan worden gebruikt in formulieren.
READONLYDEFINITION Booleaanse Of de eigenschap kan worden bewerkt in HubSpot.
LEES VERDER Booleaanse Of de waarde van de eigenschap kan worden bewerkt in HubSpot.
HUBSPOTDEFINED Booleaanse Of de eigenschap is aangemaakt door HubSpot, versus aangemaakt door een gebruiker.
ARCHIEF Booleaanse Of de eigenschap is verwijderd.
CREATEDAT Tijdstempel De datum en tijd dat de eigenschap is aangemaakt in HubSpot.
UPDATEDAT Tijdstempel De datum en tijd dat de gegevens voor het laatst zijn bijgewerkt in HubSpot. Meer informatie over kolom datatypes.
INGESTEDAT Tijdstempel De datum en tijd waarop de gegevens voor het laatst door Snowflake zijn opgenomen.

Voorbeeld 1

Haal de namen en beschrijvingen op voor alle contacteigenschappen.

Query:


SELECT naam, label, beschrijving
VAN EIGENSCHAPPEN
WAAR objectTypeId = '0-1'


Terug:

NAAM LABEL BESCHRIJVING
entered_sql_stage Het SQL stadium ingegaan Begin telling SQL stage dagen.
eerste_conversie_gebeurtenis_naam
Eerste conversie Het eerste formulier dat dit contact heeft ingediend.
adres Adres Het adres van de contactpersoon.

Evenement vragen

Evenementen omvatten standaard HubSpot gebeurtenissen en aangepaste gedragsevenementen. Elk evenement heeft zijn eigen database object, gelabeld als events_eventname.

Naam
GEBEURTENISSEN_AD_INTERACTIE Details van een advertentie en contacten die er interactie mee hebben gehad door op de advertentie te klikken of een formulier in te dienen nadat ze met de advertentie in contact zijn gekomen.
EVENTS_AD_METRICS_IMPORTED_V0

Details van een advertentie en zijn prestatiecijfers.
EVENTS_CALL_MENTIONED_KEYWORD Details van trefwoorden die door deelnemers aan gesprekken zijn genoemd.
GEBEURTENISSEN_GEKLIKT_LINK_IN_EMAIL_V2

Links die in marketing e-mails door contacten zijn aangeklikt.
EVENTS_KLIK_LINK_IN_TRACKED_INBOX_EMAIL_V8 Geklikte links in Conversaties Inbox e-mails door contacten.
EVENTS_COOKIE_BANNER_GEKLIKT Contacten die op cookies hebben geklikt.
EVENEMENTEN_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 zij hebben bekeken door de externe link te openen.
GEBEURTENISSEN_DOCUMENT_VOLTOOID_V2 Verkoopdocumenten en contacten die ze hebben afgesloten.
EVENTS_HS_SCHEDULED_EMAIL_V2 E-mails die naar de HubSpot e-mailservers worden verzonden.
GEBEURTENISSEN_MTA_AFGELEVERD_EMAIL_V2 E-mails succesvol afgeleverd bij de ontvangers door HubSpot e-mail servers.
GEBEURTENISSEN_MTA_AANGEKONDIGDE_EMAIL_V2 Pogingen tot bezorging van e-mail die door de e-mailserver van de ontvanger zijn afgewezen.
GEBEURTENISSEN_GEOPEND_EMAIL_V2 E-mails geopend door contacten.
GEBEURTENISSEN_GEMELDE_SPAM_EMAIL_V2 E-mails gemarkeerd als spam door ontvangers.
EVENTS_UPDATED_EMAIL_SUBSCRIPTION_STATUS_V2 Wijzigingen van e-mail abonnementen door ontvangers.
EVENTS_OPENED_TRACKED_INBOX_EMAIL_V8 Conservations Inbox e-mail geopend door contacten.
GEBEURTENISSEN_MB_MEDIA_AFGESPEELD Video weergave activiteit door contacten.
EVENEMENTEN_V2_CONTACT_GEBOEKT_BIJEENKOMST_DOOR_REEKS Contact boekte een vergadering via sequentie.
GEBEURTENISSEN_V2_CONTACT_INGESCHREVEN_IN_REEKS Contact ingeschreven van volgorde.
EVENTS_V2_CONTACT_FINISHED_SEQUENCE Sequence finished.
EVENTS_V2_CONTACT_REPLIED_SEQUENCE_EMAIL Contact heeft geantwoord op e-mail (of inkomende e-mail die sequentie uitschrijven) die via sequentie is verzonden.
GEBEURTENISSEN_V2_CONTACT_NIET_INGESCHREVEN_UIT_REEKS Contact uit de reeks.
GEBEURTENISSEN_V2_CONTACT_NIET_INGESCHREVEN_MANUEEL_UIT_REEKS De gebruiker heeft het contact handmatig uitgeschreven.
GEBEURTENISSEN_V2_CONTACT_NIET-INGESCHREVEN_REEKS_EMAIL Het contact heeft zich uitgeschreven, waardoor de reeks niet meer bestaat.
EVENTS_V2_SEQUENCE_EMAIL_BOUNCED Sequence email bounced.
EVENTS_V2_SEQUENCE_ERRORED Sequence errored causing unenrollment.
EVENTS_V2_SEQUENCE_STEP_EXECUTED Volgorde stap uitgevoerd.
GEBEURTENISSEN_BEZOCHTE_PAGINA Bezoeken aan de website door contactpersonen.

U kunt gebeurtenissen identificeren door hun gebeurtenistype-ID en ID te combineren. De kolommen die worden teruggegeven hangen af van de gebeurtenis, met één kolom voor elke eigenschap van de gebeurtenis. Alle gebeurtenissen geven de volgende kolommen terug:

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

  • gebeurde op
  • gebeurde op datum

Deze kolommen zullen de kolommen occuredat en occuredatdateint vervangen 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 breukwijzigingen voor Snowflake-gegevensdeling.



Naam van de kolom Type Beschrijving
EVENTTYPEID Varchar De ID van het gebeurtenistype, vergelijkbaar met OBJECTTYPEID.
U kunt alle gebeurtenistype-ID's in uw account opvragen met de weergave object_en_event_type_definities.
ID Varchar Dit is uniek per gebeurtenistype. Geen twee records zullen hetzelfde ID hebben binnen een bepaald evenementtype.
OBJECTTYPEID Varchar Het type object dat de gebeurtenis voltooide. Bijvoorbeeld, een klik op een e-mail link zou 0-1 weergeven in deze kolom, die het contactobject voorstelt.
OBJECTID Nummer De ID van de record die de gebeurtenis heeft voltooid.
OCCURREDAT Tijdstempel Wanneer de gebeurtenis plaatsvond.

GEBEURDE OP DATUM

Nummer Een getal dat aangeeft wanneer de gebeurtenis heeft plaatsgevonden. 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 kunt u de OCCURREDAT tijdstempel gebruiken in plaats van dit getal.

OCCURETDATUMINT

Nummer

Een getal dat aangeeft wanneer de gebeurtenis heeft plaatsgevonden. 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 kunt u de OCCURREDAT tijdstempel gebruiken in plaats van dit getal.

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

OCCUREDAT Tijdstempel

Wanneer de gebeurtenis plaatsvond.

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

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

Voorbeeld 1

Haal de 50 meest recente e-mail klikgebeurtenissen op.

Query:


SELECT eventTypeId, objectTypeId, objectId, occuredAt, property_hs_click_raw_url AS hs_click_raw_url
FROM events_clicked_link_in_email_V2
ORDER BY occuredAt

LIMIT 50;


Terug:

EVENTTYPEID OBJECTTYPEID OBJECTID OCCUREDAT HS_KLIK_RAW_URL
4-666288 0-1 45318579 2016-08-04 21:06:43.245 http://website.com?utm_campaign=Launch&utm_source=hs_email&utm_medium=email&utm_content=32520579
4-666288 0-1 80701 2016-08-29 13:31:28.622 https://cta-image-cms2.hubspot.com/ctas/v2/public/cs/ci/?pg=f0f6585a-08fc-4273-8422-49cfaddcf8d8&pid=1976760&ecid=ACsprvtkRbakerw4BiWlaDL7xFAqau1aW9m1_PAqSfQiWarY69X7Ds42zHGYTCfhHJLrXUP86Nxu
4-666288 0-1 26146013 2017-11-30 14:27:11.528 https://hubs.ly/H097a37a?utm_source=hs_email&utm_medium=email&utm_content=58251290
... ... ... ... ...

Voorbeeld 2

Alle e-mail klikgebeurtenissen ophalen bij de contacten die geklikt hebben. Deze query krijgt contactgegevens door samen te voegen met object_met_object_eigenschappen.

Query:


SELECT
click.occuredat click_timestamp,
click.property_hs_click_raw_url click_url,
contact.properties:voornaam::varchar contact_voornaam,
contact.properties:lastname::varchar contact_lastname
FROM events_clicked_link_in_email_V2 click
LEFT JOIN object_met_object_eigenschappen contact
ON click.objectTypeId = contact.objectTypeId
AND click.objectId = contact.objectId
LIMIT 3;


Terug:

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 uw HubSpot-account.

Dit databaseobject kan de volgende kolommen teruggeven:

Naam van de kolom Type Beschrijving
OBJECTTYPEID Varchar De ID van het object dat de pijplijn kan bevatten (bv. 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

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

Query:


SELECT objectTypeId, fullyQualifiedName
VAN object_en_event_type_definities;


Terug:

OBJECTTYPEID FULLYQUALIFIEDNAME
0-1 CONTACT
0-8 LIJN_ITEM
0-11 CONVERSATIE
... ...

Lijsten met vragen

Hieronder leest u hoe u uw lijsten kunt bevragen, zoals de beschikbare contact- en bedrijfslijsten en de records in die lijsten.

lijsten

Dit databaseobject bevat informatie over HubSpot contact- en bedrijfslijsten. Geeft éé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 teruggeven:

Naam van de kolom Type Beschrijving
OBJECTTYPEID Varchar Het type records in de lijst (bijv. contactpersoon of bedrijf).
LISTID Nummer Het ID van de lijst. Verbindt zich met de kolom LISTID in de tabel lijst-leden.
CLASSICLISTID Nummer Een ID specifiek voor contactlijsten die overeenkomt met de ID in de URL van de lijst in HubSpot.
NAAM Varchar De naam van de lijst.
SIZE Nummer Het aantal records in de lijst.
CREATEDBYUSERID Nummer Het ID van de gebruiker die de lijst heeft aangemaakt.
CREATEDAT Tijdstempel Wanneer de lijst is aangemaakt in HubSpot.
UPDATEDBYUSERID Nummer Het 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 datatypes.
INGESTEDAT Tijdstempel De datum en tijd waarop de gegevens voor het laatst door Snowflake zijn opgenomen.

Voorbeeld 1

Alle contactlijsten ophalen.

Query:


SELECT lijstId, naam, grootte
VAN lijsten
WHERE objectTypeId = '0-1';


Terug:

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

Voorbeeld 2

Haal een specifieke contactlijst op met de naam Top abonnees 2021.

Query:


SELECT lijstId, naam, grootte
VAN lijsten
WHERE objectTypeId = '0-1'
EN
listName = 'Top abonnees 2021';


Terug:

LISTID NAAM SIZE
771852 Topabonnees 2021 37

lijst_lidmaatschap

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

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

Dit databaseobject kan de volgende kolommen teruggeven:

Naam van de kolom 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 het record in de lijst.
UPDATEDAT Tijdstempel De datum en tijd dat de gegevens voor het laatst zijn bijgewerkt in HubSpot. Meer informatie over kolom datatypes.
INGESTEDAT Tijdstempel De datum en tijd waarop de gegevens voor het laatst door Snowflake zijn opgenomen.

Voorbeeld 1

De ID's ophalen van alle contacten in de lijst Top-abonnees 2021.

Query:


SELECT objectId
VAN lijst_lidmaatschappen
INNER JOIN lijsten
OP lijst_leden.lijstId = lijsten.lijstId
WHERE lists.objectTypeId = '0-1'
AND lists.name = 'Top Abonnees 2021';


Terug:

OBJECTID
54325098
96805401
6922028
...

Voorbeeld 2

Haal de voor- en achternamen op van details van contactpersonen in de lijst Top-abonnees 2021.

Query:


SELECT

contact.objectId AS objectid,
contact.property_firstname AS voornaam,
contact.property_lastname als achternaam
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 Abonnees 2021'.


Terug:

OBJECTID

EERSTE NAAM

NAAM

54325098

Hobbes

Baron

96805401

Milo

Goud

6922028

Henry

Riley

...

...

...

FAQ's

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


In het algemeen wilt u kijken naar de kolommen in het rapport waarmee u 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 objecttype-eigenschap een kolom overeenkomt. U kunt dit doen door property_definitions te bevragen:


SELECT * FROM property_definitions

WHERE label = [kolom_naam]

Er is niet altijd een exacte overeenkomst omdat sommige namen van eigenschappen gewoonlijk worden omgezet in 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 is vastgesteld bij welk objecttype de kolom hoort, is het triviaal om te bepalen waarnaar moet worden gezocht. U 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 voor een campagne op?


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


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

Was this article helpful?
This form is used for documentation feedback only. Learn how to get help with HubSpot.