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: november 8, 2021

Geldt voor:

Operations Hub Enterprise

Nadat u Snowflake hebt verbonden met uw HubSpot-account, kunt u Snowflake's Data Share gebruiken om HubSpot-gegevens op te vragen vanuit uw Snowflake-account.

Queries worden gemaakt met SQL, en kunnen gebruikt worden om HubSpot data 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 associatietypen en momenteel geassocieerde records.
  • Eigenaars: gebruikers in uw HubSpot account, in relatie tot de records waarvan zij de eigenaar zijn.
  • Pijplijnen:deal- en ticketpijplijnen, inclusief pijplijnfasen.
  • Eigenschappen: eigenschappen en hun waarden op CRM-records, met inbegrip van de geschiedenis van de eigenschappen.
  • Gebeurtenissen: gebeurtenisgegevens voor zowel standaard HubSpot-gebeurtenissen, zoals geopende e-mails, als aangepaste gedragsevenementen.
  • Lijsten: HubSpot lijsten met contactpersonen en bedrijven (BETA).

Leer meer over HubSpot's CRM-gegevensmodel.

Uw Snowflake omgeving opzetten

Om query's uit te voeren op uw HubSpot-gegevens in Snowflake, moet u het magazijn, de database en het schema selecteren waarvan u query's wilt uitvoeren. U kunt ze 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 dewerkblad-actiebalk.

    snowflake-worksheet-settings0
  • In het pop-up venster:
    • Klik op het vervolgkeuzemenuWarehouse en selecteer uwwarehouse.
    • Klik op het dropdown menuDatabase, selecteer dan uw HubSpot database.
    • Klik op het vervolgkeuzemenuSchema en selecteer vervolgens het schema dat u wilt gebruiken:
      • V2_LIVE: het live schema gebaseerd op Secure Views van HubSpot data. Gegevens in dit schema worden maximaal elke 15 minuten bijgewerkt. Als u een grote set gegevens doorzoekt, kunnen query's traag zijn. In dit geval is het aan te raden om de data eerst in een eigen tabel te kopiëren met een ETL proces, en dan die tabel te queryen.
      • V2_DAILY (BETA): het dagelijkse schema om gegevens te bevragen op basis van tabellen. Gegevens in dit schema worden één keer per dag bijgewerkt. Het gebruik van dit schema zal resulteren in snellere queries, en wordt aanbevolen voor query's direct in Snowflake.

      snowflake-worksheet-settings-window0

Met uw omgeving geconfigureerd, kunt u queries maken naar uw HubSpot data zonder dat u uw database of schema type handmatig aan queries hoeft toe te voegen.

Om handmatig uw database en schema type toe te voegen aan queries, voegt u de database naam gevolgd door het schema toe aan het begin van het FROM veld. Bijvoorbeeld:


SELECT objectTypeId, objectId
FROM hubspot_share_name.V2_LIVE.object_with_object_properties
WAAR objectTypeId = '0-1'

Overzicht gegevens

Queries worden gemaakt met SQL, en kunnen gebruikt worden om HubSpot data 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 associatietypen en momenteel geassocieerde records.
  • Eigenaars: gebruikers in uw HubSpot account, in relatie tot de records waarvan zij de eigenaar zijn.
  • Pijplijnen:deal- en ticketpijplijnen, inclusief pijplijnfasen.
  • Eigenschappen: eigenschappen en hun waarden op CRM-records, met inbegrip van de geschiedenis van de eigenschappen.
  • Gebeurtenissen: gebeurtenisgegevens voor zowel standaard HubSpot-gebeurtenissen, zoals geopende e-mails, als aangepaste gedragsevenementen.
  • Lijsten: HubSpot lijsten met contactpersonen en bedrijven (BETA).

Leer meer over HubSpot's CRM-gegevensmodel.

Beperken en ordenen van geretourneerde gegevens

Wanneer u queries construeert, kunt u bepalen hoeveel gegevens worden teruggegeven, samen met de volgorde waarin ze worden teruggegeven, door LIMIT en ORDER BY in uw query op te nemen. Bijvoorbeeld, om alle contacten met hun eigenschappen te bevragen, maar slechts drie resultaten terug te geven en ze te rangschikken op contact ID, zou u uw query als volgt kunnen construeren:


SELECT objectTypeId, objectId, eigenschappen
FROM object_with_object_properties
WAAR objectTypeId = '0-1'
ORDER BY objectId
LIMIT 10;

Object zoekopdrachten

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

U kunt de volgende object-ID's gebruiken bij het opvragen:

Naam van het object ObjectTypeId
Contacten 0-1
Bedrijven 0-2
Deals 0-3
Verloving 0-4
Tickets 0-5
Posten 0-8

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

object_met_object_eigenschappen

Deze weergave bevat gegevens van uw HubSpot records. Queries naar deze tabel retourneren een rij voor elke record binnen een object (bijv. alle contact records in het contacten object). Alle eigenschappen worden opgeslagen in de kolom Eigenschappen, die een Snowflake Variant / JSON kolom is.

Deze weergave kan de volgende kolommen opleveren:

Kolom naam Type Beschrijving
OBJECTTYPEID Varchar De ID van het objecttype (bijv. contacten is 0-1).
OBJECTID Nummer De ID van de record (bv. een contactrecord met een ID van 123752).
PROPERTIES Variant De waarde van de eigendommen.
UPDATEDAT Tijdstempel De datum en tijd waarop 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
FROM object_with_object_properties
WAAR objectTypeId = '0-1'


Terugkeren:

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

Voorbeeld 2

Zoek de naam en het stadium van de deal van maximaal drie deals.

Query:


SELECT

objectId,
properties:dealname::string AS dealname,
properties:dealstage::string AS dealstage,
properties:amount::number AS dealamount
FROM object_with_object_properties
WAAR objectTypeId = '0-3'
LIMIT 3;


Terugkeren:

OBJECTID DEALNAME DEALSTAGE DEALAMOUNT
38960439 Deal naam 1
2021-10-12 13:49:35.219
2021-10-12 13:49:35.219
321740651 Deal naam 1
2021-10-12 13:49:35.219
2021-10-12 13:49:35.219
98392101 Deal naam 1
2021-10-12 13:49:35.219
2021-10-12 13:49:35.219

objecten

Dit overzicht is een deelverzameling van de gegevens in de object_with_object_properties tabel. Elke teruggegeven rij retourneert de object-ID voor elke record. Deze view retourneert alleen bestaande records. Wanneer een record wordt verwijderd in HubSpot, zal het worden verwijderd uit deze weergave.

Deze weergave kan nuttig zijn als uw account een grote hoeveelheid gegevens heeft, waardoor object_with_object_properties traag presteert. Het gebruik van deze tabel met de object_properties tabel maakt het mogelijk om de gegevens in object_with_object_properties te repliceren, terwijl u controle houdt over welke eigenschappen worden geretourneerd.

Deze weergave kan de volgende kolommen opleveren:

Kolom naam Type Beschrijving
OBJECTTYPEID Varchar De ID van het objecttype (bijv. contacten is 0-1).
OBJECTID Nummer De ID van de record (bv. een contactrecord met een ID van 123752).
INGESTEDAT Tijdstempel De datum en tijd waarop de gegevens voor het laatst door Snowflake zijn opgenomen. Meer informatie over kolomdatatypes.

Voorbeeld 1

Alle contactrecords ophalen.

Query:


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


Terugkeren:

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

object_eigenschappen

Deze tabel is een subset van de object_with_object_properties tabel. Elke rij bevat de huidige ingestelde waarde van de eigenschap op een gegeven record. Bijvoorbeeld, een contact zal één rij hebben voor zijn Voornaam eigenschap en één rij voor zijnAchternaam eigenschap. Als een record geen waarde heeft voor een eigenschap, zal de rij ofwel verschijnen met een lege string of zal helemaal niet verschijnen.

Deze tabel kan nuttig zijn als uw account een grote hoeveelheid gegevens heeft, waardoor object_with_object_properties traag werkt. Het gebruik van deze tabel met de object_properties tabel maakt het mogelijk om de gegevens in object_with_object_properties te repliceren, terwijl je controle hebt over welke eigenschappen geretourneerd worden.

Deze weergave kan de volgende kolommen opleveren:

Kolom naam Type Beschrijving
OBJECTTYPEID Varchar De ID van het objecttype (bijv. contacten is 0-1).
OBJECTID Nummer De ID van de record (bv. een contactrecord met een ID van 123752).
NAAM Varchar De naam van het eigendom.
WAARDE 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 datatypes.
INGESTEDAT Tijdstempel De datum en tijd waarop de gegevens voor het laatst door Snowflake zijn opgenomen.

Voorbeeld 1

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

Query:


SELECT objectTypeId, objectId, naam, waarde
FROM object_properties
WAAR objectTypeId = "0-1
AND name IN ('firstname', 'lastname', 'city')
ORDER BY objectId;


Terugkeren:

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

Query:


SELECT objectId, voornaam, achternaam, levenscyclus
VAN
(
SELECTEER objectId, naam, waarde
FROM object_properties
WAAR objectTypeId = '0-1'
AND name IN ('firstname', 'lastname', 'lifecyclestage')
)
PIVOT(MAX(waarde) FOR name IN ('firstname', 'lastname', 'lifecyclestage')) AS p(objectId, voornaam, achternaam, levenscyclusfase);

Terugkeren:

OBJECTTYPEID OBJECTID FIRSTNAME LASTNAME LEVENSCYCLUSSTADIUM
0-1 54325098 Hobbes Baron lood
0-1 96805401 Milo Goud lood
0-1 6922028 Henry Riley lood
... ... ... ... ...

object_eigenschappen_geschiedenis

Deze weergave bevat historische waarden van eigendommen. Voor contacten 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 eigenschapwaarde. De huidige waarde van een eigenschap wordt bepaald door de meest recente UPDATEDAT tijdstempel in de geschiedenis van de eigenschap.

Deze weergave kan de volgende kolommen opleveren:

Kolom naam Type Beschrijving
OBJECTTYPEID Varchar De ID van het objecttype (bijv. contacten is 0-1).
OBJECTID Nummer De ID van de record (bv. een contactrecord met een ID van 123752).
NAAM Varchar De naam van het eigendom.
WAARDE 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 kolomdatatypes.
INGESTEDAT Tijdstempel De datum en tijd waarop de gegevens voor het laatst door Snowflake zijn opgenomen.

Voorbeeld 1

De geschiedenis van een enkele eigenschap voor een enkele contactpersoon opvragen.

Query:


SELECT objectId, naam, waarde, tijdstempel
FROM object_properties_history
WAAR objectTypeId = '0-1'
AND objectId = 585
AND name = "hs_predictivescoringtier
ORDER BY timestamp DESC;


Returns:

OBJECTTYPEID OBJECTID FIRSTNAME LASTNAME LEVENSCYCLUSSTADIUM
0-1 54325098 Hobbes Baron lood
0-1 96805401 Milo Goud lood
0-1 6922028 Henry Riley lood
... ... ... ... ...

Voorbeeld 2

Haalt de huidige naam op van alle contactpersonen die ooit een levenscyclusfase van Abonnee hebben gehad.

Query:


SELECT
objectId,
properties:firstname::string AS firstname,
properties:lastname::string AS lastname
FROM object_with_object_properties
WHERE object_with_object_properties.objectTypeId = '0-1'
AND objectId IN (
SELECTEER objectId
FROM object_properties_history
WAARobject_properties_history.objectTypeId = '0-1'
AND object_properties_history.name = 'lifecyclestage'
AND object_properties_history.value = "abonnee
);


Terugkeren:

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

Associatie vragen

Leer hieronder hoe u associaties kunt opvragen, zoals de beschikbare types van associaties tussen objecten en de records die momenteel geassocieerd zijn.

associatie_definities

Deze weergave bevat informatie over alle beschikbare associatietypen tussen HubSpot-objecten, met één rij per associatietype. U kunt deze tabel samenvoegen met de tabel Associaties om record-specifieke associatie-informatie te verkrijgen.

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

Deze weergave kan de volgende kolommen opleveren:

Kolom naam Type Beschrijving
GECOMBINEERD VERENIGINGSTYPEID Varchar De unieke identifier van de associatiedefinitie.
CATEGORIE Varchar De bron van het verenigingstype. Een van: HUBSPOT_DEFINED, USER_DEFINED, INTEGRATOR_DEFINED
ID Nummer De identifier van de associatiedefinitie binnen haar categorie.
VANOBJECTTYPEID Varchar De ID van het object dat de bron is van de associatiedefinitie.
TOOBJECTTYPEID Varchar De ID van het object dat de bestemming is van de associatiedefinitie.
NAAM Varchar De naam van de associatiedefinitie.
LABEL Varchar Het label van de associatiedefinitie.
ISMAINASSOCIATIONDEFINITION Booleaans Of de associatiedefinitie het hoofdtype is. Indien true, is de definitie de definitie die HubSpot weergeeft op geassocieerde records.
INGESTEDAT Tijdstempel De datum en tijd waarop de gegevens voor het laatst door Snowflake zijn opgenomen. Meer informatie over kolomdatatypes.

Voorbeeld 1

Zoek de soorten associaties op die in uw account beschikbaar zijn.

Query:


SELECT combinedAssociationTypeId, fromObjectTypeId, toObjectTypeId, naam
FROM association_definitions
ORDER BY categorie, id


Returns:

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

Zoek de beschikbare associatietypen op tussen deals en bedrijven.

Query:


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

ORDER BY categorie, id


Terugkeren:

GECOMBINEERD VERENIGINGSTYPE VANOBJECTTYPEID TOOBJECTTYPEID NAAM
0-5 0-3 0-2 DEAL_NAAR_BEDRIJF
0-271 0-3 0-2 DEAL_TO_PRIMARY_COMPANY
0-341 0-3 0-2 DEAL_TO_COMAPNY_UNLABELED

verenigingen

Dit overzicht bevat informatie over de associaties tussen specifieke records. Elke rij vertegenwoordigt een associatie van een object met een ander object. Rijen kunnen in deze tabel aanwezig zijn ook al zijn de records waarnaar verwezen wordt, verwijderd. U kunt controleren of records bestaan door te verbinden met de objectentabel.

Deze weergave kan de volgende kolommen opleveren:

Kolom naam Type Beschrijving
GECOMBINEERD VERENIGINGSTYPEID Varchar De unieke identifier van de associatiedefinitie.
FROMOBJECTID Nummer De ID van het bronobject.
TOOBJECTID Nummer De ID van het doelobject.
INGESTEDAT Tijdstempel De datum en tijd waarop de gegevens voor het laatst door Snowflake zijn opgenomen. Meer informatie over kolomdatatypes.

Voorbeeld 1

Alle bijbehorende deals en contacten ophalen.

Query:


SELECT combinedAssociationTypeId, fromObjectId, toObjectId
VAN verenigingen
WHERE combinedAssociationTypeId = '0-5'


Returns:

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

Voorbeeld 2

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

Query:


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


Terugkeren:

GECOMBINEERD VERENIGINGSTYPE FROMOBJECTID TOOBJECTID
0-5 6626541373 233620335

Voorbeeld 3

Alle deals ophalen die geassocieerd zijn met een specifieke contactpersoon (contact ID: 4464). In plaats van hard-coding combinedAssociationTypeId, sluit dit voorbeeld aan met association_definitions.

Query:


SELECT combinedAssociationType, fromObjectId, toObjectId,
VAN verenigingen
OVERWEGENDE
combinedAssociationTypeId = (
SELECT combinedAssociationTypeId
FROM association_definitions
WHERE fromObjectTypeId = '0-1'
AND toObjectTypeId = '0-3'
AND isMainAssociationDefinition)
AND fromObjectId = 4464;


Terugkeren:

GECOMBINEERD VERENIGINGSTYPE FROMOBJECTID TOOBJECTID
0-5 6626541373 233620335

eigenaars

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

Deze weergave kan de volgende kolommen opleveren:

Kolom naam Type Beschrijving
EWNERID Nummer De eigenaars-ID van de gebruiker.
USERID Nummer De gebruikers-ID van de gebruiker. Gebruikers met NULL in deze kolom zijn verwijderd.
EMAIL Varchar Het e-mailadres van de gebruiker.
FIRSTNAME Varchar De voornaam van de gebruiker.
LASTNAME Varchar De achternaam van de gebruiker.
ISACTIVE Booleaans Of de gebruiker verwijderd is.
CREATEDAT Tijdstempel De datum en tijd waarop de gebruiker is aangemaakt in HubSpot. Zie kolom datatypes voor meer informatie.
UPDATEDAT Tijdstempel De datum en tijd waarop de gebruiker voor het laatst is bijgewerkt in HubSpot. Zie kolom datatypes voor meer informatie.

Voorbeeld 1

Alle gebruikers ophalen. Het filter WHERE isActive = true verwijdert verwijderde gebruikers uit de geretourneerde gegevens.

Query:


SELECT ownerId, userId, email, firstname, lastname
FROM owners
WHERE isActive = true


Returns:

EWNERID ACTIVEUSERID EMAIL FIRSTNAME LASTNAME
29584574 4621126 233620335 Hobbes Baron
30532717 4874784 3866015468 Pablo Walters
30580321 925511 7132752747 Milo Goud
... ... ... ... ...

Voorbeeld 2

Zoek een specifieke eigenaar op hun eigenaar ID.

Query:


SELECT ownerId, userId, email, firstname, lastname
VAN eigenaars
WAAR eigenaarId = 29584574;


Returns:

EWNERID ACTIVEUSERID EMAIL FIRSTNAME LASTNAME
29584574 4621126 233620335 Hobbes Baron

Voorbeeld 3

Alle contacten en hun eigenaars ophalen. Deze query koppelt records aan eigenaars met object_with_object_properties en de contact eigenschap hubspot_owner_id.


SELECT
contact.objectId contact_id,
contact.properties:firstname::string contact_firstname,
contact.properties:lastname::string contact_lastname,
contact.properties:hubspot_owner_id::getal contact_hubspot_owner_id,
owner.firstname owner_firstname,
owner.lastname owner_lastname,
owner.email owner_email
FROM object_with_object_properties contact
inner join owners owner on contact.properties:hubspot_owner_id::number = owner.ownerId
where objectTypeId = '0-1';


Returns:

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

Pijplijn zoekopdrachten

Leer hieronder hoe u deal en ticket pijplijn gegevens kunt opvragen, zoals de beschikbare pijplijnen in uw account en hun stadia.

U kunt deze gegevens samenvoegen met object gegevens voor een volledig overzicht van uw pijplijnen. U kunt bijvoorbeeld deals en hun pijplijnen opvragen door de object_with_object_properties gegevens te combineren met de pijplijn gegevens.

pijpleidingen

Deze weergave bevat informatie over de deal en ticket pijplijnen in uw account. Elke teruggestuurde rij vertegenwoordigt een enkele pijplijn.

Deze tabel kan de volgende kolommen opleveren:

Kolom naam 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 Nummer De volgorde waarin de pijplijn wordt weergegeven in HubSpot.
GEARCHIVEERD Booleaans Of de pijplijn is verwijderd.
CREATEDAT Tijdstempel Wanneer de pijplijn werd gecreëerd.
UPDATEDAT Tijdstempel De datum en tijd waarop de gegevens voor het laatst zijn bijgewerkt in HubSpot. Meer informatie over kolomdatatypes.
INGESTEDAT Tijdstempel De datum en tijd waarop de gegevens voor het laatst door Snowflake zijn opgenomen.

Voorbeeld 1

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

Query:


SELECT objectTypeId, pipelineId, label
VAN pijpleidingen
WAAR objectTypeId = '0-3'
EN niet gearchiveerd
ORDER BY weergavevolgorde;


Returns:

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

Voorbeeld 2

Zoek overeenkomsten binnen een specifieke pijplijn. Voegt object_with_object_properties en pijplijnen samen.

Query:


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


Returns:

DEAL_ID DEAL_NAME PIJPELIJNNAAM
605140072 Meowmix Wereldwijde Aanmelding Verkoop pijplijn
605457408 Friskies Rebrand Verkoop pijplijn
604362473 Fresh Step App Build Verkoop pijplijn

pijplijn_stadia

Deze weergave bevat informatie over individuele fasen binnen een pijplijn. Identificeer stadia door object type ID, pijplijn ID en stadium ID te combineren. Bij het verbinden met pijplijnen, gebruik de object type ID en pijplijn ID.

Deze tabel kan de volgende kolommen opleveren:

Kolom naam 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 Nummer De volgorde waarin de pijplijn wordt weergegeven in HubSpot.
GEARCHIVEERD Booleaans Of de pijplijn is verwijderd.
UPDATEDAT Tijdstempel De datum en tijd waarop de gegevens voor het laatst zijn bijgewerkt in HubSpot. Meer informatie over kolomdatatypes.
INGESTEDAT Tijdstempel De datum en tijd waarop de gegevens voor het laatst door Snowflake zijn opgenomen.

Voorbeeld 1

Pijplijnstadia ophalen voor een deal pijplijn met de naamVerkoop pijplijn.

Query:


SELECT pipelineid, stageId, label
FROM pipeline_stages
WAAR niet gearchiveerd
EN pipelineid = (
SELECTEER pijplijnid
VAN pijplijnen
WAAR objectTypeId = '0-3'
EN niet gearchiveerd
AND label = "Verkooppijplijn" LIMIT 1)
ORDER BY displayorder;


Returns:

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

Voorbeeld 2

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


Returns:

DEAL_ID DEAL_NAME PIJPELIJNNAAM PIJPLEIDING_STAGE_NAAM
605140072 Meowmix Wereldwijde Aanmelding Verkoop pijplijn Contract verzonden
605457408 Friskies Rebrand Verkoop pijplijn Afspraak gepland
604362473 Fresh Step App Build Verkoop pijplijn Contract ondertekend
... ... ... ...

property_definitions

Deze weergave bevat informatie over object eigenschappen en event eigenschappen in uw HubSpot account. Gebeurteniseigenschappen omvatten standaardgebeurtenissen, zoals e-mails openen en klikken, en aangepaste gedragseigenschappen voor gebeurtenissen. Deze informatie kan nuttig zijn voor het definiëren van waarden in object_properties en gebeurtenissengegevens.

Je kan specifieke eigenschappen identificeren door hun object type ID en naam te combineren. Je kan gelijkaardige informatie opvragen via de properties API.

Deze weergave kan de volgende kolommen opleveren:

Kolom naam 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 eigendom.
BESCHRIJVING Varchar De beschrijving van het eigendom.
TYPE Varchar Het type van de eigenschap (b.v. string, nummer, datetime).
FIELDTYPE Varchar Het veldtype van de eigenschap. Bepaalt hoe de eigenschap wordt weergegeven in HubSpot en op formulieren (bijv. selectievakje, selectie).
DISPLAYORDER Nummer De weergavevolgorde van het eigendom.
GROEPNAAM Varchar De groepsnaam van de eigenschap.
OPTIES Variant Voor opsommingseigenschappen, een array van de opties van de eigenschap, met inbegrip van de attributen van elke optie (b.v. weergavevolgorde, label).
CREATEDUSERID Nummer De ID van de gebruiker die de eigenschap heeft aangemaakt.
VERWEZENOBJECTTYPE Varchar Het type object waarnaar de eigenschap verwijst. Eigenaar-eigenschappen zullen een waarde van EIGENAAR teruggeven.
GECALCULEERD Booleaans Of de eigenschap een berekende eigenschap is.
EXTERNE OPTIES 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 aanmaken van een eigenschap via de API.
HIDDEN Booleaans Of de eigenschap verborgen is in HubSpot.
SHOWCURRENCYSYMBOOL Booleaans Of de waarde van een getal eigenschap wordt geformatteerd als een valuta.
FORMFIELD Booleaans Of deze eigenschap in formulieren kan worden gebruikt.
READONLYDEFINITION Booleaans Of de eigenschap kan worden bewerkt in HubSpot.
READONLYVALUE Booleaans Of de waarde van de eigenschap kan worden bewerkt in HubSpot.
HUBSPOTGEDEFINIEERD Booleaans Of de eigenschap is aangemaakt door HubSpot, of door een gebruiker.
GEARCHIVEERD Booleaans Of de eigenschap verwijderd is.
CREATEDAT Tijdstempel De datum en tijd waarop de eigenschap werd aangemaakt in HubSpot.
UPDATEDAT Tijdstempel De datum en tijd waarop de gegevens voor het laatst zijn bijgewerkt in HubSpot. Meer informatie over kolomdatatypes.
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 eigenschappen van contactpersonen.

Query:


SELECT naam, label, beschrijving
FROM property_definitions
WAAR objectTypeId = "0-1


Returns:

NAAM LABEL BESCHRIJVING
entered_sql_stage SQL stadium binnengegaan Start telling SQL etappe dagen.
eerste_conversie_gebeurtenis_naam
Eerste bekering Het eerste formulier dat dit contact heeft ingediend.
adres Adres Het adres van de contactpersoon.

Event zoekopdrachten

Gebeurtenissen omvatten standaard HubSpot gebeurtenissen en aangepaste gedragsgebeurtenissen. Elke gebeurtenis heeft zijn eigen weergave, gelabeld alsEvents_eventname.

Beschikbare evenementen zijn onder andere:

  • Gebeurtenissen voor het klikken op een advertentie(events_ad_clicked)
  • Geopende en geklikte e-mailberichten(events_opened_email_V2,events_clicked_link_in_email_v2, enz.)
  • Web analytics(events_visited_page)

U kunt gebeurtenissen identificeren door hun gebeurtenistype-ID en ID te combineren. De kolommen die geretourneerd worden hangen af van de gebeurtenis, met een kolom voor elke eigenschap van de gebeurtenis. Alle gebeurtenissen zullen de volgende kolommen teruggeven:

Kolom naam Type Beschrijving
EVENTTYPEID Varchar De ID van de pijpleiding.
ID Varchar De ID van het object dat de pijplijn kan bevatten (bijv. deals of tickets).
OBJECTTYPEID Varchar Het type object dat de gebeurtenis voltooide. Bijvoorbeeld, een klik op een e-mail link zou0-1 in deze kolom weergeven, wat het contacten object voorstelt.
OBJECTID Nummer De ID van de record die de gebeurtenis heeft voltooid.
VOORGEVALLEN OP DE DATUM VAN Nummer Een getal dat weergeeft wanneer de gebeurtenis zich heeft voorgedaan. Bevat dezelfde gegevens als de kolom OCCUREDAT, maar geformatteerd als een getal en gebruikt als een deel van de clustersleutel van de tabel. In de meeste gevallen kunt u de OCCUREDAT timestamp gebruiken in plaats van dit getal.
OCCUREDAT Tijdstempel Wanneer de gebeurtenis plaatsvond.
INGESTEDAT Tijdstempel De datum en tijd waarop de gegevens voor het laatst door Snowflake zijn opgenomen. Meer informatie over kolomdatatypes.
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, hs_click_raw_url
FROM events_clicked_link_in_email_V2
ORDER BY occuredAt

LIMIT 50;


Returns:

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

Haal alle email klikgebeurtenissen op bij de contactpersonen die geklikt hebben. Deze query krijgt contact gegevens door te verbinden met object_with_object_properties.

Query:


SELECT
click.timestamp 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;


Returns:

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_definities

Deze weergave bevat definities voor alle objecten en gebeurtenissen die beschikbaar zijn in uw HubSpot account.

Deze weergave kan de volgende kolommen opleveren:

Kolom naam Type Beschrijving
OBJECTTYPEID Varchar De ID van het object dat de pijplijn kan bevatten (bijv. deals of tickets).
VOLLEDIG GEKWALIFICEERDE NAAM Varchar De naam van het object of de gebeurtenis.
INGESTEDAT Tijdstempel De datum en tijd waarop de gegevens voor het laatst door Snowflake zijn opgenomen. Meer informatie over kolomdatatypes.

Voorbeeld 1

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

Query:


SELECT objectTypeId, fullyQualifiedName
FROM object_and_event_type_definitions;


Returns:

OBJECTTYPEID VOLLEDIG GEKWALIFICEERDE NAAM
0-1 CONTACT
0-2 BEDRIJF
0-3 DEAL
0-4 ENGAGEMENT
0-5 TICKET
0-8 LIJN_ITEM
0-11 CONVERSATIE
... ...

Lijsten zoekopdrachten (BETA)

Hieronder leest u hoe u uw lijsten kunt doorzoeken, zoals de beschikbare lijsten met contactpersonen en bedrijven en de records die in die lijsten zijn opgenomen.

lijsten

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

Deze weergave kan de volgende kolommen opleveren:

Kolom naam Type Beschrijving
OBJECTTYPEID Varchar Het type records in de lijst (bv. contactpersoon of bedrijf).
LISTID Nummer De ID van de lijst. Maakt een koppeling met de kolom LISTID in de tabel Lijst-Lidmaatschap.
CLASSICLISTID Nummer Een ID specifiek voor contactlijsten die overeenkomt met de ID in de URL van de lijst in HubSpot.
LISTNAME Varchar De naam van de lijst.
LISTSIZE Nummer Het aantal records in de lijst.
AANGEMAAKT DOOR GEBRUIKERSNAAM Nummer De ID van de gebruiker die de lijst heeft aangemaakt.
CREATEDAT Tijdstempel Wanneer de lijst is aangemaakt in HubSpot.
UPDATED BYUSERID Nummer 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 datatypes.
INGESTEDAT Tijdstempel De datum en tijd waarop de gegevens voor het laatst door Snowflake zijn opgenomen.

Voorbeeld 1

Alle contactlijsten ophalen.

Query:


SELECT listId, listName, listSize
VAN lijsten
WAAR objectTypeId = '0-1';


Returns:

LISTID LISTNAME LISTSIZE
118131 Wekelijkse outreach 103
66156 Blog abonnees 455
771852 Top abonnees 2021 37
... ... ...

Voorbeeld 2

Een specifieke contactlijst ophalen met de naam Top abonnees 2021.

Query:


SELECT listId, listName, listSize
VAN lijsten
WHERE objectTypeId = '0-1'
AND
listName = 'Top abonnees 2021';


Returns:

LISTID LISTNAME LISTSIZE
771852 Top abonnees 2021 37

lijst_leden

Deze weergave bevat informatie over welke records lid zijn van welke lijsten, met één rij per record in de lijst. Als u bijvoorbeeld een Blog-abonneeslijst hebt met 500 contactpersonen, zal de tabel 500 rijen opleveren.

Bevat alleen lijst ID's en object ID's. Voor meer informatie, voeg je bij de lijsten tabel.

Deze weergave kan de volgende kolommen opleveren:

Kolom naam Type Beschrijving
LISTID Varchar De ID van de lijst. Verbindt met de HS_LIST_ID kolom in de lijsten tabel.
OBJECTID Varchar De 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 kolomdatatypes.
INGESTEDAT Tijdstempel De datum en tijd waarop de gegevens voor het laatst door Snowflake zijn opgenomen.

Voorbeeld 1

De ID's ophalen van alle contactpersonen in de lijstTop abonnees 2021.

Query:


SELECTEER objectId
FROM list_memberships
INNER JOIN lijsten
OP list_memberships.listId = lists.listId
WHERE lists.objectTypeId = '0-1'
AND lists.name = 'Top Abonnees 2021';


Returns:

OBJECTID
54325098
96805401
6922028
...

Voorbeeld 2

Verkrijg de voor- en achternaam van details van contactpersonen in de Top abonnees 2021

Query:


SELECT
contact.objectId AS objectid,
contact.properties:firstname::string AS firstname,
contact.properties:lastname::string AS lastname
FROM object_with_object_properties contact
INNER JOIN list_memberships ON contact.objectId = list_memberships.objectId
INNER JOIN lijsten ON list_memberships.listId = lists.listId
WAAR
contact.objectTypeId = '0-1'
EN lijsten.objectTypeId = '0-1'
AND lists.listName = 'Top Abonnees 2021'


Returns:

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

Kolomgegevenstypen

Wanneer u gegevens opvraagt in Snowflake, zijn de kolommen die worden geretourneerd afhankelijk van de gegevens die u opvraagt. U kunt de beschikbare kolommen voor een bepaalde tabel of weergave in Snowflake bekijken door de weergave in de linkerzijbalkte selecteren.

snowflake-sidebar-view-column-details0


Om een specifieke kolom te retourneren, neemt u die kolom op in het SELECT-veld van uw query. De volgende query geeft bijvoorbeeld alleen de kolommen FROMOBJECTID en TOOBJECTID weer:


SELECT
fromObjectTypeId, toObjectTypeId
FROM association_definitions

Hieronder staan algemene definities voor kolommen die een query zou kunnen retourneren. Voor andere definities die hieronder niet zijn opgenomen, zie de individuele view definities in het artikel hierboven.

  • OBJECTTYPEID: een VARCHAR-waarde die het type van een object vertegenwoordigt. Bijvoorbeeld, 0-1 vertegenwoordigt het contactpersonen-object, 0-2 vertegenwoordigt het bedrijven-object, 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 object_en_gebeurtenistype_definities-weergave.
  • OBJECTID: een BIGINT nummer dat een enkel record van een bepaald type object in uw HubSpot account vertegenwoordigt. Om een record te identificeren, moet u zowel de object type ID als de object ID gebruiken.
  • INGESTEDAT: de tijdstempel van wanneer een rij gegevens werd toegevoegd aan Snowflake, weergegeven door een TIMESTAMP_NTZ waarde. Niet gerelateerd aan de logische tijdstempel van een creatie of update operatie in HubSpot.
    • Als gevolg van HubSpot's interne verwerking kan de ingestion timestamp van een rij worden bijgewerkt, zelfs als geen andere kolommen op de rij zijn gewijzigd.
    • Bij het bouwen van ETL processen die recent gewijzigde data kopiëren, is het aanbevolen om uw queries te baseren op de ingestion timestamp. Bovendien, als uw stroom dagelijks gegevens kopieert, is het aanbevolen 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 werden gecreëerd of bijgewerkt in HubSpot, weergegeven door een TIMESTAMP_NTZ waarde. Deze tijdstempels zullen overeenkomen met tijdstempels in HubSpot. Bijvoorbeeld, de tijd die wordt weergegeven in HubSpot voor de aanmaakdatum van een record zal dezelfde zijn als de tijdstempel in de kolom CREATEDAT in Snowflake. Deze zijn niet direct gerelateerd aan de ingestion timestamp, en het is niet aan te raden ETL processen te baseren op deze eigenschap.
  • COMBINEDASSOCIATIONTYPE: een VARCHAR-waarde die een associatiedefinitie op een unieke wijze identificeert.