HubSpot-gegevens opvragen in Snowflake

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

Datavertraging en de regio van uw Snowflake-account

U krijgt toegang tot het V2_LIVE-schema, dat elke 15 minuten wordt bijgewerkt, en het V2_DAILY-schema, dat elke dag wordt bijgewerkt.

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

Uw Snowflake-omgeving instellen

Om je HubSpot-gegevens in Snowflake op te vragen, moet je het magazijn, de database en het schema selecteren waaruit je gegevens wilt opvragen. Je kunt deze instellen op werkbladsniveau om ze automatisch op te nemen in je query's, of je kunt ze handmatig toevoegen.

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

1. Klik in de bovenste rij van het werkblad op dewerkbladactiebalk.
   
   
   
2. In het pop-upvenster:
   • Klik op het vervolgkeuzemenuMagazijn en selecteer vervolgens uwmagazijn.
   • Klik op het vervolgkeuzemenuDatabase en selecteer vervolgens uw HubSpot-database.
   • Klik op het vervolgkeuzemenuSchema en selecteer vervolgens het schema dat u wilt gebruiken:
     • V2_DAILY: het dagelijkse schema om gegevens op basis van tabellen op te vragen. De gegevens in dit schema worden één keer per dag bijgewerkt. Het gebruik van dit schema resulteert in snellere zoekopdrachten en wordt aanbevolen voor het rechtstreeks opvragen van gegevens in Snowflake.
     • V2_LIVE: het live schema op basis van Secure Views van HubSpot-gegevens. De gegevens in dit schema worden maximaal elke 15 minuten bijgewerkt. Als u een grote hoeveelheid gegevens opvraagt, kunnen de query's traag zijn. In dat geval wordt aanbevolen om de gegevens eerst met een ETL-proces naar uw eigen tabel te kopiëren en vervolgens die tabel te doorzoeken.
     
     
     
     

Als uw omgeving is geconfigureerd, kunt u query's uitvoeren op uw HubSpot-gegevens zonder dat u uw database of schematype handmatig aan query's hoeft toe te voegen.

Om uw database en schematype handmatig toe te voegen aan query's, voegt u de databasenaam gevolgd door het schema toe aan het begin van het FROM-veld. Bijvoorbeeld:

Gegevensoverzicht

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

• Objecten: standaard- en aangepaste objecten, zoals contactpersonen, bedrijven, producten. 
• Records: individuele records, zoals een individuele contactpersoon of bedrijf. 
• Associaties: alle beschikbare associatietypen en momenteel geassocieerde records.
• Gebeurtenissen: gebeurtenisgegevens voor zowel standaard HubSpot-gebeurtenissen, zoals het openen van e-mails, als aangepaste gedragsgebeurtenissen.
• Segmenten: HubSpot-contact- en bedrijfssegmenten.
• Eigenaren: 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, inclusief eigenschappenhistorie.

Meer informatie over het CRM-gegevensmodel van HubSpot. 

Let op: Naarmate we het delen van gegevens verder ontwikkelen, zullen we wijzigingen doorvoeren, waarvan sommige ingrijpend zijn. We raden u ten zeerste aan om u te abonneren op het wijzigingslogboek voor ontwikkelaars van HubSpot. Deze wijzigingen worden altijd voorafgaand aan een update in het wijzigingslogboek geplaatst.

Beperken en ordenen van geretourneerde gegevens

Bij het opstellen van query's kunt u bepalen hoeveel gegevens worden geretourneerd en in welke volgorde, doorLIMIT en ORDER BY in uw query op te nemen. Als u bijvoorbeeld alle contactpersonen met hun eigenschappen wilt opvragen, maar slechts drie resultaten wilt retourneren en deze op contact-ID wilt sorteren, kunt u uw query als volgt opstellen:

Kolomgegevenstypen

Bij het opvragen van gegevens 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 linkerzijbalk te selecteren.

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

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


SELECTobjectId, updatedAt
FROM objects_contacts



Hieronder vindt u algemene definities voor kolommen die een query kan retourneren. Voor andere definities die hieronder niet zijn opgenomen, raadpleegt u de afzonderlijke weergavedefinities in het bovenstaande artikel.

• OBJECTTYPEID: een VARCHAR-waarde die het type van een object vertegenwoordigt. 0-1 staat bijvoorbeeld voor het object 'contacten', 0-2 staat voor het object 'bedrijven' en 2-1232 kan staan voor een aangepast object in uw account. In segmenten verwijst dit naar het type segment (bijvoorbeeld contactpersoon of bedrijf). U kunt alle object- en gebeurtenis-ID's in uw account opvragen met behulp van de weergave object_and_event_type_definitions.
• OBJECTID: een BIGINT-getal dat een enkel record van een bepaald type object in je HubSpot-account vertegenwoordigt. Om een record te identificeren, moet je zowel de objecttype-ID als de object-ID gebruiken.
• INGESTEDAT: de tijdstempel van het moment waarop een rij gegevens aan Snowflake is toegevoegd, weergegeven door een TIMESTAMP_NTZ-waarde. Dit staat los van de logische tijdstempel van een aanmaak- of updatebewerking in HubSpot.
  • Vanwege de interne verwerking van HubSpot kan de tijdstempel van de opname van een rij worden bijgewerkt, zelfs als er geen andere kolommen in de rij zijn gewijzigd.
  • Bij het bouwen van ETL-processen die recent gewijzigde gegevens kopiëren, wordt aanbevolen om uw query's te baseren op de tijdstempel van de opname. Als uw flow dagelijks gegevens kopieert, wordt bovendien aanbevolen om gegevens van de afgelopen 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 tijdstempels komen overeen met de tijdstempels in HubSpot. De tijd die in HubSpot wordt weergegeven voor de aanmaakdatum van een record is bijvoorbeeld dezelfde als de tijdstempel in de kolom CREATEDAT in Snowflake. Deze staan niet rechtstreeks in verband met de tijdstempel van de invoer en het wordt afgeraden om ETL-processen op deze eigenschappen te baseren.
• COMBINEDASSOCIATIONTYPE: een VARCHAR-waarde die een associatiedefinitie op unieke wijze identificeert.

Gegevenstypen transformeren

Soms worden gegevens geretourneerd vanuit een query met VARCHAR-kolommen, terwijl het wenselijk zou zijn om ze als een ander type te hebben. In dergelijke gevallen wordt aanbevolen om het VARCHAR-gegevenstype om te zetten naar de gewenste typen met behulp van Snowflake-functies. De eigenschappen van een objectrecord worden bijvoorbeeld in de meeste databaseobjecten opgeslagen als VARCHAR-gegevenstypen, maar bevatten soms getallen en datum-/tijdwaarden. Functies zoals:
try_to_number, try_to_timestamp_ntz kunnen worden gebruikt om deze VARCHAR-gegevens respectievelijk om te zetten naar hun NUMBER- en DATETIME-typen:


SELECT objectid, value AS amount_str, try_to_number(value) AS amount
FROM object_properties
WHERE objecttypeid='0-3' AND name='amount'
LIMIT 1



Objectquery's

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

Objectgegevens van verschillende typen worden op twee manieren georganiseerd en beschikbaar gesteld: 

• Individueel:Elk objecttype wordt opgeslagen in een eigen weergave en bevat alleen records van hetzelfde objecttype, bijvoorbeeld objects_contacts bevat alleen contactrecords. Hierdoor hoeft u bij het uitvoeren van een query geen objecttype-id op te geven. Deze weergaven zijn gemakkelijker te doorzoeken omdat u geen ObjectTypeIds hoeft te kennen. Ze geven ook gegevens weer in een bruikbaarder formaat, waarbij elke rij overeenkomt met een object en de huidige versie van de eigenschappen ervan. Zolang u geen trage query's ervaart, is het raadzaam om deze weergaven te gebruiken om objectgegevens op te halen. Zie meer in Objects_X-weergaven hieronder. 
• Gecombineerd: Alle records voor alle objecttypen worden gecombineerd in één databaseobject. Bij het uitvoeren van een query moet u dus een filter specificeren, zoals "WHERE objectTypeId='0-1'. U kunt bijvoorbeeld de volgende objecttypeids gebruiken bij het uitvoeren van een query:

Aangepaste objecten krijgen bij het aanmaken een ID toegewezen en worden geïdentificeerd als2-unique_ID. Bijvoorbeeld2-12345. Meer informatie over object_and_event_type_definitions.

Deze databaseobjecten zijn over het algemeen geschikt als u betere queryprestaties wilt dan wat haalbaar is met object_x-weergaven. Zie voor meer informatie object_with_object_properties, object_properties, objects en object_properties_history hieronder.

objects_x-weergaven

In dit databaseobject heeft elk beschikbaar objecttype, inclusief aangepaste objecten, zijn eigen specifieke weergave, waarbij elke weergave alleen records bevat voor objecten van dat specifieke objecttype. Deze weergaven zijn genoemd volgens het formaat OBJECTS_<objecttype naam>, waarbij <objecttype naam> de meervoudsvorm van het objecttype is. (Let op: als het objecttype geen meervoudsvorm heeft, is <objecttype naam> gewoon de enkelvoudsvorm van de objecttype naam, gevolgd door een "S").

Queries naar deze weergave retourneren één rij voor elk record binnen een object, waarbij elke eigenschap van het object als een afzonderlijke kolom beschikbaar is.

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

Elk databaseobject retourneert de volgende kolommen:

Voorbeeld 1

Haal de voornaam, achternaam en levenscyclusfase op voor alle contacten.

Query:


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



Resultaten:

Voorbeeld 2

Haal de naam en fase van maximaal drie deals op.

Query:


SELECT objectId, property_dealName, property_dealStage,
property_amount AS dealAmount

FROM objects_deals

LIMIT 3

Retourneert:

Voorbeeld 3

Haal de naam en fase van de drie belangrijkste deals op basis van bedrag op.

Query:

Aangezien de gegevens over het transactiebedrag beschikbaar zijn als een getaltype, kunnen ze worden gebruikt voor het sorteren zonder dat er conversie of casting nodig is.


SELECT objectId, property_dealName, property_dealStage,
property_amount AS dealAmount

FROM objects_deals
ORDER BY property_amount DESC
LIMIT 3




Retourneert:

object_met_object_eigenschappen

Dit databaseobject bevat gegevens uit uw HubSpot-records. Query's naar dit databaseobject retourneren één rij voor elk record binnen een objecttype (bijvoorbeeld alle contactrecords in het objecttype 'contacten'). Alle eigenschappen worden opgeslagen in de kolom 'Eigenschappen', een Snowflake Variant/JSON-kolom. 

Deze weergave kan de volgende kolommen retourneren:

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

Aangezien dit een ingrijpende wijziging is, is de nieuwe kolom updatedat toegevoegd aan de tabel en weergave. Gedurende de komende 90 dagen zullen deze twee nieuwe kolommen naast timestamp bestaan, de kolommen die ze willen vervangen. Dit geeft u de gelegenheid om over te stappen op het gebruik van de nieuwe kolommen.

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

Voorbeeld 1

Haal alle contacten en hun eigenschappen op.

Query:

Resultaten:

Voorbeeld 2

Haal de naam en fase van maximaal drie dealsop.

Query:

Resultaten:

objecten

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

Dit databaseobject kan handig zijn als uw account een grote hoeveelheid gegevens bevat, waardoor de weergaven object_with_object_properties en objects_x traag werken. Door dit databaseobject te gebruiken in combinatie met het databaseobject object_properties, kunt u de gegevens in object_with_object_properties repliceren en tegelijkertijd controle houden over welke eigenschappen worden geretourneerd.

Dit databaseobject kan de volgende kolommen retourneren:

Voorbeeld 1

Haal alle contactrecords op.

Query:

Retourneert:

object_properties

Dit databaseobject is een subset van het databaseobject object_with_object_properties. Elke rij bevat de huidige eigenschapswaarde die voor een bepaald record is ingesteld. Een contactpersoon heeft bijvoorbeeld één rij voor de eigenschap Voornaam en één rij voor de eigenschapAchternaam. Als een record geen waarde voor een eigenschap heeft, wordt de rij weergegeven met een lege tekenreeks of wordt deze helemaal niet weergegeven.

Dit databaseobject kan de volgende kolommen retourneren:

Voorbeeld 1

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

Query:

Retourneert:

Voorbeeld 2

Haal de voornaam, achternaam en levenscyclusfase voor alle contactpersonen op en combineer deze tot één rij per contactpersoon. In dit voorbeeld wordt de SQL PIVOT-syntaxis gebruikt.

Query:

Resultaten:

object_properties_history

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

Dit databaseobject kan de volgende kolommen retourneren:

Voorbeeld 1

Haal de geschiedenis van een enkele eigenschap voor een enkele contactpersoon op.

Query:

 
Retourneert:

Voorbeeld 2

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

Query:

Resultaten:

Associatiequery's

Net als objectgegevens worden associatiegegevens op twee manieren georganiseerd:

• Individueel: elk associatietype wordt opgeslagen in een eigen weergave en bevat alleen records van dat type. Associations_contacts_to_deals bevat bijvoorbeeld alleen associatierecords tussen contact- en dealobjecten. Hierdoor hoeft u bij het uitvoeren van query's geen associationtypeid op te geven. Deze weergaven zijn vrij eenvoudig te doorzoeken, omdat u geen kennis van het CRM-gegevensmodel nodig hebt om ze te gebruiken. Ze geven ook een uitgebreide beschrijving van het associatierecord tussen twee objecten, die gemakkelijk kan worden gebruikt in joins met object_x-weergaven. Zolang u geen trage query's ervaart, is het raadzaam om deze weergaven te gebruiken om associatiegegevens op te halen. Zie meer in associations_x_to_y-weergaven hieronder. 
• Gecombineerd: alle records voor alle associatietypen worden gecombineerd in één databaseobject. Bij het uitvoeren van een query moet u dus een filter specificeren zoals "WHERE combinedassociationtypeid='0-32' ". Zie voor meer informatie associations en association_definitions hieronder.

associaties_x_naar_y-weergaven

Elk associatietype heeft zijn eigen weergave, aangeduid als associations_<naam associatietype>, bijvoorbeeld associations_contacts_to_deals. Elke weergave is een subset van de gegevens in het associatiedatabaseobject en bevat alleen records van een specifieke combinedassociationtypeid.

Elk databaseobject retourneert de volgende kolommen:

Voorbeeld 1

Haal alle deals op die aan een specifiek contact zijn gekoppeld.

Query:

Resultaten:

Voorbeeld 2

Haal alle contacten op die zich in de tijdzone van Bogota bevinden, samen met hun deals.

Voorbeeld 3

Haal alle contacten op en het totale bedrag van de gesloten deals voor elk contact.

Retourneert:

association_definitions

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

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

Dit databaseobject kan de volgende kolommen retourneren:

Voorbeeld 1 

Haal de associatietypen op die beschikbaar zijn in uw account.

Query:

 
Retourneert:

Voorbeeld 2

Haal de beschikbare associatietypes tussen deals en bedrijven op.

Query:

Resultaten:

associaties

Dit databaseobject bevat informatie over de associaties tussen specifieke records. Elke rij vertegenwoordigt een associatie van het ene object naar het andere object. Rijen kunnen in dit databaseobject aanwezig zijn, ook al zijn de records waarnaar wordt verwezen verwijderd. U kunt controleren of records bestaan door ze te koppelen aan de objectentabel.

Dit databaseobject kan handig zijn als uw account een grote hoeveelheid gegevens bevat, waardoor associations_x_to_y-weergaven traag werken.

Dit databaseobject kan de volgende kolommen retourneren:

Voorbeeld 1

Haal alle gekoppelde deals en contacten op.

Query:

 
Retourneert: 

Voorbeeld 2 

Haal alle tickets op die zijn gekoppeld aan een specifieke contactpersoon (contact-ID: 3005).

Query:

Resultaten:

Voorbeeld 3 

Haal alle deals op die gekoppeld zijn aan een specifieke contactpersoon (contact-ID: 4464). In plaats van combinedAssociationTypeId hard te coderen, wordt in dit voorbeeld een koppeling gemaakt met association_definitions.

Query:

Resultaten:

Eigenaar query's

eigenaren

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

Dit databaseobject kan de volgende kolommen retourneren:

Voorbeeld 1 

Haal alle gebruikers op. Het filter WHERE archived = false verwijdert verwijderde gebruikers uit de geretourneerde gegevens.

Query:

 
Retourneert: 

Voorbeeld 2

Haal een specifieke eigenaar op aan de hand van zijn eigenaar-ID.

Query:

Resultaten: 

Voorbeeld 3

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

Retourneert: 

Teamquery's

teams

Met teams in HubSpot kunt u uw gebruikers in groepen indelen voor organisatorische en rapportagedoeleinden. U kunt een hoofdteam en extra teams hebben.

Dit databaseobject bevat informatie over de teams in uw HubSpot-account. 

Dit databaseobject kan de volgende kolommen retourneren:

Voorbeeld 1

Haal alle teams op.

Query:

Retourneert:

owner_team

Dit databaseobject bevat informatie over welke eigenaren bij welke teams in uw HubSpot-account horen. 

Dit databaseobject kan de volgende kolommen retourneren:

Voorbeeld 1

Haal alle eigenaren voor een bepaald team op.

Query:

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

Retourneert

Pijplijnquery's

Hieronder leert u hoe u pijplijngegevens voor deals en tickets, zoals de beschikbare pijplijnen in uw account en hun fasen.

U kunt deze gegevens koppelen aan objectgegevens voor een volledig overzicht van uw pijplijnen. U kunt bijvoorbeeld deals en hun pijplijnen opvragen door de gegevens van objects_deals_view of object_with_object_properties te koppelen aan pijplijngegevens.

pijplijnen

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

Deze tabel kan de volgende kolommen retourneren:

Voorbeeld 1

Haal alle beschikbare dealpijplijnen op, gesorteerd op hun volgorde in HubSpot.

Query:

 
Resultaten: 

Voorbeeld 2

Haal deals binnen een specifieke pijplijn op. Voegt object_with_object_properties en pijplijnen samen.

Query:

Retourneert: 

Voorbeeld 3

Hetzelfde als voorbeeld 2 hierboven, haal deals binnen een specifieke pijplijn op. Maar in plaats van objects_deals in joins te gebruiken, gebruik je object_with_object_properties.

Resultaten: 

pipeline_stages

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

Dit databaseobject kan de volgende kolommen retourneren:

Voorbeeld 1 

Haal pijplijnfasen op voor een dealpijplijn met de naamVerkooppijplijn.

Query:

 
Retourneert: 

Voorbeeld 2

Haal alle deals en hun respectievelijke pijplijnfasen op.

Query:

Resultaten: 

Vastgoedquery's

property_definitions

Dit databaseobject bevat informatie over objecteigenschappen en gebeurteniseigenschappen in uw HubSpot-account. Gebeurteniseigenschappen omvatten standaardgebeurtenissen, zoals het openen en klikken van e-mails, en aangepaste gedragseigenschappen van gebeurtenissen. Deze informatie kan nuttig zijn voor het definiëren van waarden die worden gevonden in object_properties en gebeurtenisgegevens.

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

Dit databaseobject kan de volgende kolommen retourneren:

Voorbeeld 1

Haal de namen en beschrijvingen op voor alle contacteigenschappen.

Query:

 
Retourneert:

Gebeurtenisquery's

Gebeurtenissen omvatten standaard HubSpot-gebeurtenissen en aangepaste gedragsgebeurtenissen. Elke gebeurtenis heeft zijn eigen databaseobject, aangeduid als events_eventname.

U kunt gebeurtenissen identificeren door hun gebeurtenistype-ID en ID te combineren. De kolommen die worden geretourneerd, zijn afhankelijk van de gebeurtenis, met één kolom voor elke gebeurteniseigenschap. Alle gebeurtenissen retourneren de volgende kolommen:

Voorbeeld 1

Haal de 50 meest recente e-mailklikgebeurtenissen op.

Query:

Resultaten: 

Voorbeeld 2

Haal alle e-mailklikgebeurtenissen op van de contactpersonen die hebben geklikt. Deze query haalt contactgegevens op door te koppelen met object_with_object_properties.

Query:

Resultaten: 

Object_and_event_type_queries

object_and_event_type_definitions

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

Dit databaseobject kan de volgende kolommen retourneren:

Voorbeeld 1

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

Query:

 
Retourneert: 

Segmentquery's

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

segmenten

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

Dit databaseobject kan de volgende kolommen retourneren:

Voorbeeld 1

Haal alle contactsegmenten op.

Query:

 
Retourneert: 

Voorbeeld 2

Haal een specifiek contactsegment op met de naam Topabonnees 2021. 

Query:

Resultaten: 

segment_membership

Dit databaseobject bevat informatie over welke records lid zijn van welke segmenten, met één rij per record in het segment. Als u bijvoorbeeld een segment Blogabonnees hebt met 500 contacten, retourneert het databaseobject 500 rijen. 

Bevat alleen segment-ID's en object-ID's. Voor meer informatie kunt u een koppeling maken met het databaseobject 'segmenten '.

Dit databaseobject kan de volgende kolommen retourneren:

Voorbeeld 1

Haal de ID's op van alle contacten in het segmentTopabonnees 2021.

Query:

 
Retourneert: 

Voorbeeld 2

Haal de voor- en achternamen op van de contactpersonen in het segment Topabonnees 2021.

Query:

Resultaten: 

Veelgestelde vragen

Ik wil gegevens genereren die vergelijkbaar zijn met een rapport uit de Hubspot-app. Hoe doe ik dat?

Over het algemeen kijk je naar de kolommen in het rapport waarmee je vergelijkt. Als de rapportvisualisatie niet tabelvormig is, kun je deze omzetten naar een tabel om de kolommen in het rapport weer te geven. Deze kolommen zijn meestal eigenschappen van een objecttype of een gebeurtenistype. De volgende stap is om uit te zoeken aan welke objecttype-eigenschap een kolom overeenkomt. Dit kun je doen door property_definitions op te vragen:

Er is mogelijk niet altijd een exacte overeenkomst, omdat sommige eigenschapsnamen in de app meestal worden omgezet in een meer beschrijvende naam. In dergelijke gevallen kan het helpen om een fuzzy zoekopdracht uit te voeren met de LIKE-operator op de kolom label (of zelfs de kolom description) in property_definitions.

Nadat u hebt bepaald tot welk objecttype de kolom behoort, is het eenvoudig om te bepalen wat u moet opvragen. U kunt gewoon zoeken naar de object_x-weergave die overeenkomt met het type.

Hoe koppel ik dit gegevenstype aan een ander, bijvoorbeeld hoe haal ik formulieren voor een campagne op?

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

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

Om realtime statusupdates te ontvangen over storingen en problemen met de HubSpot-Snowflake-integratie, voert u de query data_share_status uit:

SELECT * FROM hubspot.public.data_share_status
LIMIT 1

De resultaten worden weergegeven als:

Deze weergave biedt updates over de integratiestatus in omgekeerde chronologische volgorde. Door de resultaten van deze query in een dashboard te integreren, kunt u de prestaties van de integratie volgen en eventuele downtime of storingen detecteren.