- Kunskapsbas
- Rapportering och data
- Rapporter
- Fråga efter HubSpot-data i Snowflake
Fråga efter HubSpot-data i Snowflake
Senast uppdaterad: 31 december 2025
Tillgänglig med något av följande abonnemang, om inte annat anges:
-
Data Hub Enterprise
När du har anslutit Snowflake till ditt HubSpot-konto kan du använda Snowflakes Data Share för att söka efter HubSpot-data från ditt Snowflake-konto.
Datalagring och din Snowflake-kontoregion
Du får tillgång till schemat V2_LIVE, som uppdateras var 15:e minut, och schemat V2_DAILY, som uppdateras varje dag.
Observera: följande vyer i V2_LIVE-schemat uppdateras endast dagligen: association_definitions, owners, pipelines och pipeline_stages.
Konfigurera din Snowflake-miljö
För att söka efter dina HubSpot-data i Snowflake måste du välja det lager, den databas och det schema som du vill söka från. Du kan antingen ställa in dem på kalkylbladsnivå så att de automatiskt inkluderas i dina sökningar, eller så kan du lägga till dem manuellt.
Så här väljer du lager, databas och schema på kalkylbladsnivå:
- Klicka på verktygsfältetför arbetsbladet i den översta raden i arbetsbladet.
- I popup-fönstret:
- Klicka på rullgardinsmenynLager och välj sedan dittlager.
- Klicka på rullgardinsmenynDatabase och välj din HubSpot-databas.
- Klicka på rullgardinsmenynSchema och välj sedan det schema du vill använda:
- V2_DAILY: det dagliga schemat för att söka data baserat på tabeller. Data i detta schema uppdateras en gång per dag. Att använda detta schema resulterar i snabbare sökningar och rekommenderas för sökningar direkt i Snowflake.
- V2_LIVE: det live-schema som baseras på Secure Views av HubSpot-data. Data i detta schema uppdateras upp till var 15:e minut. Om du söker i en stor datamängd kan sökningarna bli långsamma. I detta fall rekommenderas det att först kopiera data till din egen tabell med en ETL-process och sedan söka i den tabellen.
När din miljö är konfigurerad kan du göra frågor till dina HubSpot-data utan att behöva lägga till din databas eller schematyp manuellt i frågorna.
För att manuellt lägga till din databas och schematyp i frågorna lägger du till databasnamnet följt av schemat i början av fältet FROM. Till exempel:
SELECT objectTypeId, property_createddateFROM hubspot_share_name.V2_LIVE.objects_deals
LIMIT 1
Dataöversikt
Frågor konstrueras med hjälp av SQL och kan användas för att hämta HubSpot-data såsom:
- Objekt: standardobjekt och anpassade objekt, såsom kontakter, företag, produkter.
- Poster: enskilda poster, såsom en enskild kontakt eller ett enskilt företag.
- Associationer: alla tillgängliga associationstyper och för närvarande associerade poster.
- Händelser: händelsedata för både standardhändelser i HubSpot, såsom öppnade e-postmeddelanden, och anpassade beteendehändelser.
- Segment: HubSpot-kontakt- och företagssegment.
- Ägare: användare i ditt HubSpot-konto, i relation till de poster som de är angivna som ägare till.
- Pipelines: affärs-och ärendepipelines, inklusive pipeline-stadier.
- Egenskaper: egenskaper och deras värden i CRM-poster, inklusive egenskapshistorik.
Läs mer om HubSpots CRM-datamodell.
Observera I takt med att vi utvecklar datadelningen kommer vi att införa förändringar, varav vissa är genomgripande. Vi rekommenderar starkt att du prenumererar på HubSpots förändringslogg för utvecklare. Dessa förändringar kommer alltid att publiceras i förändringsloggen före varje uppdatering.
Begränsa och sortera returnerade data
När du skapar frågor kan du styra hur mycket data som returneras, samt i vilken ordning den returneras, genom att inkluderaLIMIT och ORDER BY i din fråga. Om du till exempel vill söka efter alla kontakter med deras egenskaper, men bara returnera tre resultat och ordna dem efter kontakt-ID, kan du skapa din fråga på följande sätt:
SELECT objectTypeId, updatedAt, ingestedAtFROM objects_dealsORDER BY objectIdLIMIT 10;
Datatyper för kolumner
När du frågar data i Snowflake beror de kolumner som returneras på den data du frågar om. Du kan visa de tillgängliga kolumnerna för en viss tabell eller vy i Snowflake genom att välja vyn i vänster sidofält.
Observera:I resten av detta dokument använder vi termen databasobjekt när sammanhanget gäller både tabeller och vyer.
För att returnera en specifik kolumn, inkludera den kolumnen i SELECT-fältet i din fråga. Till exempel kommer följande fråga endast att returnera kolumnerna OBJECTID och UpdatedAt:
SELECTobjectId, updatedAtFROM objects_contacts
Nedan följer allmänna definitioner för kolumner som en fråga kan returnera. För andra definitioner som inte ingår nedan, se de enskilda visningsdefinitionerna i artikeln ovan.
- OBJECTTYPEID: ett VARCHAR-värde som representerar ett objekts typ. Till exempel representerar 0-1 kontaktobjektet, 0-2 företagsobjektet och 2-1232 kan representera ett anpassat objekt i ditt konto. I segment avser detta segmenttypen (t.ex. kontakt eller företag). Du kan söka efter alla objekt- och händelse-ID:n i ditt konto med hjälp av vyn object_and_event_type_definitions.
- OBJECTID: ett BIGINT-nummer som representerar en enskild post av en viss objekttyp i ditt HubSpot-konto. För att identifiera en post måste du använda både objekttyps-ID och objekt-ID.
- INGESTEDAT: tidsstämpeln för när en datarad lades till i Snowflake, representerad av ett TIMESTAMP_NTZ-värde. Har inget samband med den logiska tidsstämpeln för en skapande- eller uppdateringsåtgärd i HubSpot.
- På grund av HubSpots interna bearbetning kan en rads ingestions tidsstämpel uppdateras även om inga andra kolumner i raden har ändrats.
- När du skapar ETL-processer som kopierar nyligen ändrade data rekommenderas det att basera dina frågor på tidstämpeln för inmatningen. Om ditt flöde kopierar data dagligen rekommenderas det dessutom att kopiera data från de två föregående dagarna för att ta hänsyn till fördröjningar.
- CREATEDAT och UPDATEDAT: den logiska tidsstämpeln för när data skapades eller uppdaterades i HubSpot, representerad av ett TIMESTAMP_NTZ-värde . Dessa tidsstämplar kommer att matcha tidsstämplarna i HubSpot. Till exempel kommer den tid som visas i HubSpot för en postens skapandedatum att vara densamma som tidsstämpeln i kolumnen CREATEDAT i Snowflake. Dessa är inte direkt relaterade till tidsstämpeln för inläsningen, och det rekommenderas inte att basera ETL-processer på dessa egenskaper.
- COMBINEDASSOCIATIONTYPE: ett VARCHAR-värde som unikt identifierar en associationsdefinition.
Omvandla datatyper
Ibland returneras data från en fråga med VARCHAR-kolumner när det skulle vara önskvärt att ha dem som en annan typ. I sådana fall rekommenderas det att konvertera datatypen VARCHAR till önskade typer med hjälp av Snowflake-funktioner. Till exempel lagras egenskaper för en objektrekord som VARCHAR-datatyper i de flesta databasobjekt, men ibland innehåller de tal- och datum-/tidsvärden. Funktioner som:
try_to_number, try_to_timestamp_ntz kan användas för att konvertera dessa VARCHAR-data till deras NUMBER- respektive DATETIME -typer:
SELECT objectid, value AS amount_str, try_to_number(value) AS amountFROM object_properties
WHERE objecttypeid='0-3' AND name='amount'
LIMIT 1
Objektfrågor
Nedan kan du lära dig hur du frågar data från specifika HubSpot-objekt och -poster, tillsammans med den data som returneras.
Objektdata av olika typer organiseras och finns tillgängliga på två sätt:
- Individuell:Varje objekttyp lagras i sin egen vy och innehåller endast poster av samma objekttyp, t.ex. objects_contacts innehåller endast kontaktposter. Detta eliminerar behovet av att ange en objecttypeid vid sökning. Dessa vyer är enklare att söka i eftersom du inte behöver känna till ObjectTypeIds. De returnerar också data i ett mer användbart format där varje rad motsvarar ett objekt och den aktuella versionen av dess egenskaper. Så länge du inte upplever långsamma sökningar är det lämpligt att använda dessa vyer för att hämta objektdata. Se mer i Objects_X-vyer nedan.
- Kombinerade: Alla poster för alla objekttyper kombineras till ett databasobjekt. När du gör en sökning måste du därför ange ett filter som ”WHERE objectTypeId=’0-1’”. Du kan till exempel använda följande objecttypeids när du gör en sökning:
| Objektnamn | Objekttyp-ID |
| Kontakter | 0-1 |
| Företag | 0-2 |
| Rader | 0-8 |
Anpassade objekt tilldelas ett ID när de skapas och identifieras som2-unique_ID. Till exempel2-12345. Läs mer om object_and_event_type_definitions.
Dessa databasobjekt är i allmänhet lämpliga om du vill ha bättre sökprestanda än vad som är möjligt med objects_x-vyer. Se mer information i object_with_object_properties, object_properties, objects och object_properties_history nedan.
objects_x-vyer
I detta databasobjekt har varje tillgänglig objekttyp, inklusive anpassade objekt, sin egen specifika vy, där varje vy endast innehåller poster för objekt av den specifika objekttypen. Dessa vyer namnges enligt formatet OBJECTS_<objekttypsnamn> där <objekttypsnamn> är pluralformen av objekttypen. (Observera att om objekttypen inte har någon pluralform, kommer <objekttypsnamn> helt enkelt att vara singularformen av objekttypsnamnet sammanfogat med ”S”).
Sökningar i denna vy returnerar en rad för varje post i ett objekt, där varje egenskap i objektet visas som en separat kolumn.
Nedan finns en omfattande lista över tillgängliga HubSpot-objekttyper (dvs. icke-anpassade), en kort beskrivning av de data de representerar och motsvarande vyer:
| HubSpot Objekttyp |
ObjectTypeId |
Beskrivning |
| 0-1 |
Information om personer som interagerar med ditt företag. |
|
| 0 |
Information om enskilda företag eller organisationer |
|
| 0 |
Detaljer om intäktsmöjligheter med en kontaktperson eller ett företag |
|
| 0-4 |
Lagrar data från CRM-åtgärder, inklusive anteckningar, uppgifter, e-postmeddelanden, möten och samtal. |
|
| 0-5 |
Representerar kundernas förfrågningar om hjälp eller support |
|
| 0-14 |
Används för att dela prisinformation med potentiella köpare |
|
| 0-15 |
Detaljer för enskilda inlämningar för ett HubSpot-formulär |
|
| 0-8 |
Representerar en delmängd av produkter som säljs i en affär. När en produkt kopplas till en affär blir den en radpost. |
|
| 0-11 |
Detaljer om inkommande meddelanden från flera kanaler. |
|
| 0-25 |
Detaljer om dina landningssidor |
|
| 0 |
Lagrar information om att göra-listor |
|
| 0-28 |
Används för att samla in leadinformation om dina besökare och kontakter |
|
| 0-29 |
Detaljer om e-postmeddelanden från marknadsföringshubben |
|
| AD_ACCOUNT |
0 |
Lagrar information om dina annonskonton på Linkedin, Facebook och Google |
| 0-31 |
Detaljer om dina annonskampanjer. En annonskampanj kan innehålla en eller flera annonser. |
|
| AD_GROUP |
0-32 |
Logisk gruppering av annonser inom en annonskampanj |
| AD |
0-33 |
Detaljer om enskilda annonser |
| 0-35 |
Information om relaterade marknadsföringsresurser och innehåll, så att du enkelt kan mäta effektiviteten av dina samlade marknadsföringsinsatser. |
|
| SITE_PAGE |
0-38 |
Data om enskilda sidor på dina webbplatser |
| 0-39 |
Data om blogginlägg |
|
| 0-45 |
Information om grupperingar av objektposter baserat på deras egenskaper eller aktiviteter |
|
| 0 |
Samtal som gjorts av andra CRM-poster, t.ex. kontakter |
|
| INVOICE |
0 |
Hantera och synkronisera fakturor med externa redovisningssystem |
| 0 |
Information om medietillgångar som importerats till Hubspot |
|
| 0-58 |
En sekvens är en serie riktade, tidsinställda e-postmallar för att vårda kontakter över tid. |
|
| 0-62 |
Sparat e-postinnehåll som kan återanvändas för att skicka e-postmeddelanden. |
|
| 0-72 |
Affärsuppdelningar används för att dela affärskrediter mellan flera användare |
|
| 0-83 |
Försäljningsdokument skapar ett bibliotek med innehåll som hela teamet kan ladda upp och dela med sina kontakter. |
|
| 0-19 |
Lagrar information som skickats in till en feedbackenkät. |
|
| 0 |
Prenumerationer innehåller information om återkommande betalningar. |
|
| 0 |
Innehåller data om medel som samlats in från kunder |
Varje databasobjekt returnerar följande kolumner:
| Kolumnnamn |
Typ |
Beskriv |
| OBJECTTYPEID |
Varchar |
ID för objekttypen (t.ex. kontakter är 0-1). |
| OBJECTID |
Nummer |
ID för posten (t.ex. en kontaktpost med ID 123752). |
| UPDATEDAT |
Tidsstämpel |
Datum och tidpunkt då detta objekt senast uppdaterades i HubSpot. |
| INGESTEDAT |
Tidsstämpel |
Datum och tid då data senast importerades av Snowflake. |
| PROPERTY_* |
Varchar |
Enskilda kolumner som innehåller den senaste versionen av objektets egenskaper. För varje objektegenskap som har en datum- eller taltyp (enligt specifikationen i property_definitions) finns det två kolumner:
|
Exempel 1
Hämta förnamn, efternamn och livscykelstadium för alla kontakter.
Sökning:
SELECT objectId, property_firstname AS firstname, property_lastname AS lastname,property_lifecyclestage AS lifecyclestageFROM objects_contact
Returnerar:
| OBJECTID |
FIRSTNAME |
LASTNAME |
LIFECYCLESTAGE |
| 54325098 |
Hobbes |
Baron |
led |
| 96805401 |
Milo |
Guld |
bly |
| 6922028 |
Henry |
Riley |
bly |
Exempel 2
Hämta namnet och stadiet för upp till tre affärer.
Fråga:
SELECT objectId, property_dealName, property_dealStage,
property_amount AS dealAmountFROM objects_deals
LIMIT 3
Returnerar:
| OBJECTID |
PROPERTY_DEALNAME |
FASTIGHETSTRANSAKTIONSFAS |
FASTIGHETSTRANSAKTIONSBELOPP |
| 38960439 |
Affärens namn 1 |
closedwon |
34199 |
| 321740651 |
Testaffär 123 |
14845019 |
8383663 |
| 98392101 |
Pop-up-tält |
closedwon |
9309007 |
Exempel 3
Hämta namnet och stadiet för de tre största affärerna efter belopp.
Fråga:
Eftersom affärsvärdet finns tillgängligt som ett numeriskt datatyp kan det användas för sortering utan att behöva konverteras eller omvandlas.
SELECT objectId, property_dealName, property_dealStage,
property_amount AS dealAmountFROM objects_deals
ORDER BY property_amount DESC
LIMIT 3
Returnerar:
| OBJECTID |
PROPERTY_DEALNAME |
FASTIGHETSTRANSAKTIONSFAS |
FASTIGHETSTRANSAKTIONSBELOPP |
| 98392101 |
Pop-up-tält |
closedwon |
9309007 |
| 321740651 |
Test Deal 123 |
14845019 |
8383663 |
| 38960439 |
Affärens namn 1 |
closedwon |
34199 |
objekt_med_objektegenskaper
Detta databasobjekt innehåller data från dina HubSpot-poster. Frågor till detta databasobjekt returnerar en rad för varje post inom en objekttyp (t.ex. alla kontaktposter i objekttypen kontakter). Alla egenskaper lagras i kolumnen Egenskaper, som är en Snowflake Variant/JSON-kolumn.
Denna vy kan returnera följande kolumner:
| Kolumnnamn | Typ | Beskrivning |
OBJECTTYPEID |
Varchar | ID för objekttypen (t.ex. kontakter är 0-1). |
OBJECTID |
Nummer | ID för posten (t.ex. en kontaktpost med ID 123752). |
EGENSKAPER |
Variant | Posteringens egenskapsvärden. |
UPDATEDAT |
Tidsstämpel | Datum och tidpunkt då posten senast uppdaterades i HubSpot. Läs mer om kolumnens datatyper. |
INGESTEDAT |
Tidsstämpel | Datum och tidpunkt då data senast importerades av Snowflake. |
Observera Den 25 januari 2022 kommer kolumnen timestamp i tabellen och vyn object_with_object_properties, som representerar datum och tid då objektposten senast uppdaterades i HubSpot, att uppdateras. Detta för att anpassa sig till hur datetime-data representeras i resten av datadelningen.
Eftersom detta är en genomgripande förändring har den nya kolumnen updatedat lagts till i tabellen och vyn. Under de kommande 90 dagarna kommer dessa två nya kolumner att existera parallellt med timestamp, de kolumner som de ska ersätta. Detta ger dig möjlighet att byta till att använda de nya kolumnerna.
Efter 90 dagar, den 25 januari 2022, kommer kolumnen timestamp att tas bort från tabellen och vyn. Efter detta datum kommer alla försök att söka i tabellen eller vyn object_with_object_properties med hjälp av timestamp-kolumner att misslyckas.
Exempel 1
Hämta alla kontakter och deras egenskaper.
Fråga:
SELECT objectTypeId, objectId, propertiesFROM object_with_object_propertiesWHERE objectTypeId = '0-1'
Returnerar:
| OBJECTTYPEID | OBJECTID | EGENSKAPER |
| 0 | 38960439 | {"createdate": "1504656970152"...} |
| 0-1 | 321740651 | { "createdate": "1590183081949"...} |
| 0-1 | 98392101 | { "createdate": "1533566477279"...} |
| ... | ... | ... |
Exempel 2
Hämta namnet och stadiet för upp till tre affärer.
Fråga:
SELECTobjectId,egenskaper:affärsnamn::sträng SOM affärsnamn,egenskaper:affärsstadium::sträng SOM affärsstadium, egenskaper:belopp::tal SOM affärsbeloppFROM objekt_med_objektegenskaperDÄR objectTypeId = '0-3'LIMIT 3;
Returnerar:
| OBJECTID | DEALNAME | DEALSTAGE | DEALAMOUNT |
| 38960439 | Affärens namn 1 | avslutadförlorad | 7488939 |
| 321740651 | Affärens namn 1 | avslutadvunnen | 9292029 |
| 98392101 | Affärens namn 1 | avslutadförlorad | 62626528 |
objekt
Detta databasobjekt är en delmängd av data i databasobjektet object_with_object_properties. Varje returnerad rad returnerar objekt-ID för varje post. Detta databasobjekt returnerar endast befintliga poster. När en post raderas i HubSpot tas den bort från detta databasobjekt. Detta databasobjekt är en delmängd av data i tabellen object_with_object_properties. Varje returnerad rad returnerar objekt-ID för varje post. Denna vy returnerar endast befintliga poster. När en post raderas i HubSpot tas den bort från denna vy.
Detta databasobjekt kan vara användbart om ditt konto har en stor mängd data, vilket leder till att vyerna object_with_object_properties och objects_x fungerar långsamt. Genom att använda detta databasobjekt tillsammans med databasobjektet object_properties är det möjligt att replikera data i object_with_object_properties, samtidigt som du behåller kontrollen över vilka egenskaper som returneras.
Detta databasobjekt kan returnera följande kolumner:
| Kolumnnamn | Typ | Beskrivning |
OBJECTTYPEID |
Varchar | ID för objekttypen (t.ex. kontakter är 0-1). |
OBJECTID |
Nummer | ID för posten (t.ex. en kontaktpost med ID 123752). |
INGESTEDAT |
Tidsstämpel | Datum och tidpunkt då data senast importerades av Snowflake. Läs mer om kolumndatatyper. |
Exempel 1
Hämta alla kontaktposter.
Fråga:
VÄLJ objectTypeId, objectIdFRÅN objektDÄR objectTypeId = '0-1'
Returnerar:
| OBJECTTYPEID | OBJECTID |
| 0 | 36721864 |
| 0 | 103580363 |
| 0-1 | 56047670 |
| ... | ... |
object_properties
Detta databasobjekt är en delmängd av databasobjektet object_with_object_properties. Varje rad innehåller det aktuella egenskapsvärdet som är inställt för en given post. En kontakt har till exempel en rad för egenskapen Förnamn och en rad för egenskapenEfternamn. Om en post inte har något värde för en egenskap visas raden antingen med en tom sträng eller visas inte alls.
Detta databasobjekt kan returnera följande kolumner:
| Kolumnnamn | Typ | Beskrivning |
OBJECTTYPEID |
Varchar | ID för objekttypen (t.ex. kontakter är 0-1). |
OBJECTID |
Nummer | ID för posten (t.ex. en kontaktpost med ID 123752). |
NAME |
Varchar | Namnet på egenskapen. |
VALUE |
Tidsstämpel | Värdet på egenskapen. |
UPDATEDAT |
Tidsstämpel | Datum och tidpunkt då posten senast uppdaterades i HubSpot. Läs mer om kolumnens datatyper. |
INGESTEDAT |
Tidsstämpel | Datum och tidpunkt då data senast importerades av Snowflake. |
Exempel 1
Hämta egenskaperna för förnamn, efternamn och ort för alla kontakter.
Fråga:
VÄLJ objectTypeId, objectId, namn, värdeFRÅN object_propertiesDÄR objectTypeId = '0-1'OCH namn I ('förnamn', 'efternamn', 'stad')ORDER BY objectId;
Returnerar:
| OBJECTTYPEID | OBJECTID | NAME | VÄRDE |
| 0 | 10401 | förnamn | Brian |
| 0-1 | 10401 | stad | Dublin |
| 0-1 | 10401 | efternamn | Gallagher |
| 0-1 | 23451 | förnamn | Fernando |
| 0-1 | 23451 | efternamn | Fierro |
| 0-1 | 25751 | förnamn | Charles |
| ... | ... | ... | ... |
Exempel 2
Hämta förnamn, efternamn och livscykelstadium för alla kontakter och kombinera dem till en rad per kontakt. I det här exemplet används SQL PIVOT-syntax.
Fråga:
VÄLJ objectId, förnamn, efternamn, livscykelstadium FROM(VÄLJ objectId, namn, värdeFROM objekt_egenskaperDÄR objectTypeId = '0-1'OCH namn I ('förnamn', 'efternamn', 'livscykelstadium'))PIVOT(MAX(värde) FÖR namn I ('förnamn', 'efternamn', 'livscykelstadium')) SOM p(objektId, förnamn, efternamn, livscykelstadium);
Returnerar:
| OBJECTTYPEID | OBJEKTID | FÖRNAMN | EFTERNAMN | LIVSCYKELSTADIUM |
| 0-1 | 54325098 | Hobbes | Baron | bly |
| 0-1 | 96805401 | Milo | Guld | ledning |
| 0-1 | 6922028 | Henry | Riley | ledning |
| ... | ... | ... | ... | ... |
object_properties_history
Detta databasobjekt innehåller historiska egenskapsvärden. För kontakter innehåller det de 45 senaste värdena. För alla andra objekt innehåller det de 20 senaste värdena. Visar en rad för varje historiskt egenskapsvärde. Det aktuella värdet för en egenskap bestäms av den senaste UPDATEDAT-tidsstämpelni egenskapens historik.
Detta databasobjekt kan returnera följande kolumner:
| Kolumnnamn | Typ | Beskrivning |
OBJECTTYPEID |
Varchar | ID för objekttypen (t.ex. kontakter är 0-1). |
OBJECTID |
Nummer | ID för posten (t.ex. en kontaktpost med ID 123752). |
NAME |
Varchar | Namnet på egenskapen. |
VALUE |
Tidsstämpel | Värdet på egenskapen. |
UPPDATERAD |
Tidsstämpel | Datum och tidpunkt då data senast uppdaterades i HubSpot. Läs mer om kolumnens datatyper. |
INGESTEDAT |
Tidsstämpel | Datum och tidpunkt då data senast importerades av Snowflake. |
Exempel 1
Hämta historiken för en enskild egenskap för en enskild kontakt.
Fråga:
VÄLJ objectId, namn, värde, uppdaterad vidFROM objekt_egenskaper_historikDÄR objectTypeId = '0-1'OCH objectId = 136493192OCH namn = 'hs_predictivescoringtier'ORDER BY UPDATEDAT DESC;
Returnerar:
| OBJECTID | NAME | VALUE | UPPDATERAD |
| 136493192 |
hs_predictivescoringtier |
tier_1 |
2022-06-22 22:45:05.931 |
| 136493192 |
hs_predictivescoringtier |
tier_2 |
2021-09-18 08:20:56.622 |
| 136493192 |
hs_predictivescoringtier |
tier_3 |
2019-11-31 18:20:22.851 |
| ... |
... |
... |
... |
Exempel 2
Hämta det aktuella namnet på alla kontakter som någonsin har haft livscykelstadiet Prenumerant.
Fråga:
VÄLJobjectId,egenskaper:förnamn::sträng SOM förnamn,egenskaper:efternamn::sträng SOM efternamnFROM objekt_med_objektegenskaperDÄR objekt_med_objektegenskaper.objekttypId = '0-1'OCH objectId I (VÄLJ objectIdFRÅN objekt_egenskaper_historikDÄRobjekt_egenskaper_historik.objekttypId = '0-1'OCH object_properties_history.name = 'livscykelstadium'OCH object_properties_history.värde = 'abonnent');
Returnerar:
| OBJECTID | FÖRNAMN | EFTERNAMN |
| 54325098 | Hobbes | Baron |
| 96805401 | Milo | Gold |
| 6922028 | Henry | Riley |
| ... | ... | ... |
Associeringsfrågor
Precis som objektdata organiseras associationsdata på två sätt:
- Individuell: Varje associationstyp lagras i sin egen vy och innehåller endast poster av den typen. Till exempel innehåller associations_contacts_to_deals endast associationsposter mellan kontakt- och affärsobjekt. Detta eliminerar behovet av att ange en associationtypeid vid sökning. Dessa vyer är ganska lätta att söka i eftersom de inte kräver någon kunskap om CRM-datamodellen för att kunna användas. De returnerar också en utökad beskrivning av associationsposten mellan två objekt som enkelt kan användas i sammanfogningar med objects_x-vyer. Så länge du inte upplever långsamma sökningar är det lämpligt att använda dessa vyer för att hämta associationsdata. Se mer i associations_x_to_y-vyer nedan.
- Kombinerade: Alla poster för alla associationstyper kombineras till ett databasobjekt. När du gör en sökning måste du därför ange ett filter som ”WHERE combinedassociationtypeid=’0-32’ ”. Se mer i associations och association_definitions nedan.
associations_x_to_y-vyer
Varje associationstyp har sin egen vy, märkt som associations_<associationstypens namn>, t.ex. associations_contacts_to_deals. Varje vy är en delmängd av data i associationsdatabasobjektet och innehåller endast poster med en specifik combinedassociationtypeid.
Varje databasobjekt returnerar följande kolumner:
| Kolumnnamn |
Typ |
Beskrivning |
| COMBINEDASSOCIATIONTYPEID |
Varchar |
Den unika identifieraren för associationsdefinitionen. |
| ASSOCIATIONCATEGORY |
Varchar |
Källan till associationstypen. En av följande: HUBSPOT_DEFINED, USER_DEFINED, INTEGRATOR_DEFINED |
| ASSOCIATIONTYPEID |
Varchar |
En unik identifierare för en associeringsdefinition inom en specifik associeringskategori, dvs. inga två definitioner i en associeringskategori kan ha samma associationtypeid. |
| FROMOBJECTTYPEID |
Varchar |
Den objecttypeid som är källan till associationsdefinitionen. |
| FROMOBJECTTYPE |
Varchar |
Namnet på den objekttyp som är källan till associationsdefinitionen. |
| TOOBJECTTYPEID |
Varchar |
Objekttyp-id som är destinationen för associationsdefinitionen. |
| TOOBJECTTYPE |
Varchar |
Namnet på objektet som är destinationen för associationsdefinitionen. |
| NAME |
Varchar |
Namnet på associationsdefinitionen. |
| LABEL |
Varchar |
Beskrivningen av associationsdefinitionen. |
| ISMAINASSOCIATIONDEFINITION |
Boolesk |
Om associationsdefinitionen är huvudtypen. Om true är definitionen den som HubSpot visar på associerade poster |
| [FROMOBJECTTYPE_OBJECTID] t.ex. för vyn ASSOCIATIONS_CONTACTS_TO_DEALS blir detta CONTACT_OBJECTID |
Number |
Källobjektets objekt-ID. |
| [TOOBJECTTYPE_OBJECTID] t.ex. för vyn ASSOCIATIONS_CONTACTS_TO_DEALS är detta DEAL_OBJECTID. |
Nummer |
Objekt-ID för måletobjektet. |
| INGESTEDAT |
Tidsstämpel |
Datum och tidpunkt då data senast importerades av Snowflake. |
Exempel 1
Hämta alla affärer som är associerade med en specifik kontakt.
Fråga:
SELECT
contact_objectId, deal_objectId
FROM associations_contacts_to_deals
WHERE contactId = 6626541373
Returnerar:
| CONTACT_OBJECTID |
DEAL_OBJECTID |
| 6626541373 |
233620335 |
| 6626541373 |
90253678 |
Exempel 2
Hämta alla kontakter baserade i tidszonen Bogota och deras affärer.
SELECT contacts.property_firstname contact_firstname,
kontakter.fastighets_efternamn kontakt_efternamn,
kontakter.fastighets_e-post kontakt_e-post,
affärer.fastighetsaffärstyp affärstyp, affärer.fastighetsbelopp affärsbelopp
FROM objects_kontakter kontakter
JOIN associations_kontakter_till_affärer assoc på
assoc.kontakt_objektid=kontakter.objektid
JOIN objects_deals deals på deals.objectid=assoc.deal_objectid
där contacts.property_hs_timezone='america_slash_bogota'
| KONTAKT_FÖRNAMN |
KONTAKT_EFTERNAMN |
KONTAKT_EMAIL |
AFFÄRSTYP |
AFFÄRSBELOPP |
| David |
Magalhães |
dmagalhaes@example.com |
nyverksamhet |
74848 |
| Fernanda |
Rodrigues |
fmoreira@example.com |
newbusiness |
253530 |
Exempel 3
Hämta alla kontakter och den totala summan av avslutade affärer för varje kontakt.
VÄLJ SUM(affärer.fastighets_hs_stängningsbelopp) SOM
total_closed_amount, contacts.property_email contact_email
FROM objects_contacts kontakter
JOIN associations_contacts_to_deals assoc på
assoc.contact_objectid=kontakter.objectid
JOIN objects_deals deals på deals.objectid=assoc.deal_objectid
GROUP BY kontakt_e-post
ORDER BY total_closed_amount DESC
Returnerar:
| TOTAL_CLOSED_AMOUNT |
CONTACT_EMAIL |
| 98474793 |
johndoe@riverview.com |
| 849488 |
sallymae@longford.com |
association_definitions
Detta databasobjekt innehåller information om alla tillgängliga associationstyper mellan HubSpot-objekt, med en rad per associationstyp. Du kan koppla detta databasobjekt till associationsdatabasobjektet för att få registerspecifik associationsinformation.
Det kan finnas flera typer av associationer mellan samma objekt. Den huvudsakliga associationstypen, som är den typ som visas i HubSpot när poster är associerade, använder associationen där ISMAINASSOCIATIONDEFINITION är sant.
Detta databasobjekt kan returnera följande kolumner:
| Kolumnnamn | Typ | Beskrivning |
COMBINEDASSOCIATIONTYPEID |
Varchar | Den unika identifieraren för associationsdefinitionen. |
KATEGORI |
Varchar | Källan till associeringstypen. En av följande: HUBSPOT_DEFINED, USER_DEFINED, INTEGRATOR_DEFINED |
ID |
Nummer | Identifieraren för associationsdefinitionen inom sin kategori. |
FROMOBJECTTYPEID |
Varchar | ID för objektet som är källan till associationsdefinitionen. |
TOOBJECTTYPEID |
Varchar | ID för objektet som är destinationen för associationsdefinitionen. |
NAME |
Varchar | Namnet på associationsdefinitionen. |
LABEL |
Varchar | Associationsdefinitionens etikett. |
ISMAINASSOCIATIONDEFINITION |
Boolesk | Om associationsdefinitionen är huvudtypen. Om true är definitionen den som HubSpot visar på associerade poster. |
INGESTEDAT |
Tidsstämpel | Datum och tidpunkt då data senast importerades av Snowflake. Läs mer om kolumndatatyper. |
Exempel 1
Hämta de typer av associationer som är tillgängliga i ditt konto.
Fråga:
VÄLJ combinedAssociationTypeId, fromObjectTypeId, toObjectTypeId, namnFROM associationsdefinitionerORDER BY kategori, id
Returnerar:
| COMBINEDASSOCIATIONTYPE | FROMOBJECTTYPEID | TOOBJECTTYPEID | NAME |
| 0 | 0 | 0-2 | KONTAKT_TILL_FÖRETAG |
| 0-2 | 0-2 | 0-1 | FÖRETAG_ATT_KONTAKTA |
| 0-3 | 0-3 | 0-1 | AFFÄR_ATT_KONTAKTA |
| 0-4 | 0-1 | 0-3 | KONTAKT_TILL_AFFÄR |
| 0-5 | 0-3 | 0-2 | AFFÄR_TILL_FÖRETAG |
| ... | ... | ... | ... |
Exempel 2
Hämta tillgängliga associationstyper mellan affärer och företag.
Fråga:
VÄLJkombineradAssociationTypeId, frånObjectTypeId, tillObjectTypeId, namnFRÅN association_definitionsDÄR fromObjectTypeId = '0-3' OCH toObjectTypeId = '0-2'
OCH isMainAssociationDefinition = trueORDER BY kategori, id
Returnerar:
| KOMBINERAD ASSOCIERINGSTYP | FRÅNOBJEKTTYPID | TILLOBJEKTTYPID | NAMN |
| 0-5 | 0 | 0-2 | DEAL_TO_COMPANY |
| 0-271 | 0-3 | 0-2 | DEAL_TO_PRIMARY_COMPANY |
| 0-341 | 0-3 | 0-2 | DEAL_TO_COMAPNY_UNLABELED |
associationer
Detta databasobjekt innehåller information om associationerna mellan specifika poster. Varje rad representerar en association från ett objekt till ett annat objekt. Rader kan finnas i detta databasobjekt även om de refererade posterna har raderats. Du kan kontrollera om poster finns genom att koppla ihop med objekttabellen.
Detta databasobjekt kan vara användbart om ditt konto har en stor mängd data, vilket leder till att associations_x_to_y-vyerna fungerar långsamt.
Detta databasobjekt kan returnera följande kolumner:
| Kolumnnamn | Typ | Beskrivning |
COMBINEDASSOCIATIONTYPEID |
Varchar | Den unika identifieraren för associationsdefinitionen. |
FROMOBJECTID |
ID för källobjektet. | |
TOOBJECTID |
Nummer | ID för målet. |
INGESTEDAT |
Tidsstämpel | Datum och tidpunkt då data senast importerades av Snowflake. Läs mer om kolumnens datatyper. |
Exempel 1
Hämta alla associerade affärer och kontakter.
Fråga:
VÄLJ combinedAssociationTypeId, fromObjectId, toObjectIdFRÅN associationsDÄR combinedAssociationTypeId = '0-5'
Returnerar:
| COMBINEDASSOCIATIONTYPEID | FROMOBJECTID | TOOBJECTID |
| 0 | 6626541373 | 233620335 |
| 0 | 6616436082 | 3866015468 |
| 0 | 6690805943 | 7132752747 |
| ... | ... | ... |
Exempel 2
Hämta alla ärenden som är kopplade till en specifik kontakt (kontakt-ID: 3005).
Fråga:
VÄLJ combinedAssociationTypeId, fromObjectId, toObjectIdFRÅN associationsDÄR associationCategory = 'HUBSPOT_DEFINED'OCH combinedAssociationTypeId = '0-15'OCH fromObjectId = 3005;
Returnerar:
| KOMBINERAD ASSOCIATIONSTYP | FRÅNOBJEKTID | TILLOBJEKTID |
| 0-5 | 6626541373 | 233620335 |
Exempel 3
Hämta alla affärer som är kopplade till en specifik kontakt (kontakt-ID: 4464). I stället för att hårdkoda combinedAssociationTypeId, sammanfogar detta exempel med association_definitions.
Fråga:
VÄLJ combinedAssociationTypeId, fromObjectId toObjectId,FRÅN associationerDÄRkombineradAssociationTypeId = (SELECT combinedAssociationTypeId FRÅN association_definitions DÄR fromObjectTypeId = '0-1' OCH toObjectTypeId = '0-3' OCH isMainAssociationDefinition)OCH fromObjectId = 4464;
Returnerar:
| KOMBINERAD ASSOCIERINGSTYPID | FROMOBJECTID | TILLOBJEKTID |
| 0-5 | 6626541373 | 233620335 |
Ägarfrågor
ägare
Detta databasobjekt innehåller information om användarna i ditt HubSpot-konto. Användare kan anges som registerägare och kommer att innehålla både ett användar-ID och ett ägar-ID, beroende på sammanhanget. Båda ID:n kan användas för att identifiera samma användare.
Detta databasobjekt kan returnera följande kolumner:
| Kolumnnamn | Typ | Beskrivning |
ÄGAR-ID |
Nummer | Användarens ägar-ID. |
USERID |
Nummer | Användarens användar-ID. Användare med NULL i denna kolumn har raderats. |
EMAIL |
Varchar | Användarens e-postadress. |
FÖRNAMN |
Varchar | Användarens förnamn. |
LASTNAME |
Varchar | Användarens efternamn. |
ARCHIVED |
Boolean | Om användaren har raderats. |
CREATEDAT |
Tidsstämpel | Datum och tid då användaren skapades i HubSpot. Se kolumnens datatyper för mer information. |
UPDATEDAT |
Tidsstämpel | Datum och tid då användaren senast uppdaterades i HubSpot. Se kolumnens datatyper för mer information. |
INGESTEDAT |
Tidsstämpel | Datum och tidpunkt då data senast importerades av Snowflake. |
Exempel 1
Hämta alla användare. Filtret WHERE archived = false tar bort raderade användare från de returnerade uppgifterna.
Sökning:
VÄLJ ägar-ID, användar-ID, e-postadress, förnamn, efternamn
FRÅN ägare
DÄR arkiverad = falsk
Returnerar:
| OWNERID | USERID | FÖRNAMN | EFTERNAMN | |
| 29584574 | 4621126 | 233620335 | Hobbes | Baron |
| 30532717 | 4874784 | 3866015468 | Pablo | Walters |
| 30580321 | 925511 | 7132752747 | Milo | Guld |
| ... | ... | ... | ... | ... |
Exempel 2
Hämta en specifik ägare utifrån deras ägar-ID.
Fråga:
VÄLJ ägar-ID, användar-ID, e-postadress, förnamn, efternamnFRÅN ägareDÄR ägar-ID = 29584574;
Returnerar:
| ÄGAR-ID | ANVÄNDAR-ID | FÖRNAMN | EFTERNAMN | |
| 29584574 | 4621126 | 233620335 | Hobbes | Baron |
Exempel 3
Hämta alla kontakter och deras ägare. Denna fråga sammanfogar poster till ägare med object_with_object_properties och kontaktattributet hubspot_owner_id.
SELECT
kontakt.objektId kontaktid,
kontakt.egendom_förnamn kontakt_förnamn,
kontakt.egenskap_efternamn kontakt_efternamn,
kontakt.egendom_hubspot_ägare_id kontakt_hubspot_ägare_id,
ägare.förnamn ägarens_förnamn,
ägare.efternamn ägarens efternamn,
ägare.e-post ägare_e-post
FROM objects_contacts kontakt
JOIN ägare ägare PÅ kontakt.property_hubspot_owner_id = ägare.ägareId
Returnerar:
| CONTACTID | KONTAKTNAMN | KONTAKTNAMN | KONTAKT_HUBSPOT_ÄGAR_ID | ÄGARENS FORNAMN | ÄGARENS EFTERNAMN | ÄGARENS_E-POSTADRESS |
| 113834202 | Richard | Greenfield | 29584574 | Hobbes | Baron | hobbes.b@business.com |
| 53540801 | Ford | Karl | 30241125 | Milo | Guld | milo.g@business.com |
| ... | ... | ... | ... | ... | ... | ... |
Teamfrågor
team
Med team i HubSpot kan du organisera dina användare i grupper för organisatoriska och rapporteringsändamål. Du kan ha ett huvudteam och extra team.
Detta databasobjekt innehåller information om teamen i ditt HubSpot-konto.
Detta databasobjekt kan returnera följande kolumner:
| Kolumnnamn | Typ | Beskrivning |
| TEAMID | Nummer | Teamets ID. |
| TEAMNAME | Varchar | Lagets namn. |
| PARENTTEAMID | Nummer | Team-ID för det överordnade teamet. |
| CHILDTEAMIDS | Array | Team-ID för underordnade team. |
| PRIMARYOWNERMEMBERS | Varchar | Ägar-ID för teamets primära medlemmar. |
| SECONDARYOWNERMEMBERS | Boolean | Ägar-ID för teamets sekundära medlemmar. |
| INGESTEDAT | Tidsstämpel | Datum och tidpunkt då data senast importerades av Snowflake. |
Exempel 1
Hämta alla team.
Fråga:
VÄLJ teamId,teamName, primaryOwnerMembers
FRÅN team
Returnerar:
| TEAMID | TEAMNAME | PRIMÄRA ÄGARE |
| 29584574 | Underteam | [233620335, 1234553] |
| 30532717 | Superteam | [3866015468, 126221873] |
| 3058032 | A-laget | [7132752747] |
owner_team
Detta databasobjekt innehåller information om vilka ägare som motsvarar vilka team i ditt HubSpot-konto.
Detta databasobjekt kan returnera följande kolumner:
| Kolumnnamn | Typ | Beskrivning |
| TEAMID | Nummer | Teamets ID. |
| ÄGAR-ID | Nummer | Användarens ägar-ID. |
| ISTEAMPRIMARY | Boolesk | Om detta team är det primära teamet för denna ägare. |
| INGESTEDAT | Tidsstämpel | Datum och tidpunkt då data senast importerades av Snowflake. |
Exempel 1
Hämta alla ägare för ett visst team.
Fråga:
SELECT teamId, ownerId, isTeamPrimaryFROM teamsWHERE teamId = 29584574
Returnerar
| TEAMID | TEAMNAME | ISTEAMPRIMARY |
| 29584574 | 233620335 | SANT |
| 29584574 | 1234553 | SANT |
Pipeline-frågor
Nedan kan du lära dig hur du gör förfrågningar om affärs- och ärendepipeline-data, till exempel tillgängliga pipelines i ditt konto och deras stadier.
Du kan koppla samman dessa data med objektdata för att få en fullständig bild av dina pipelines. Du kan till exempel söka efter affärer och deras pipelines genom att koppla samman data från objects_deals_view eller object_with_object_properties med pipeline-data.
pipelines
Detta databasobjekt innehåller information om affärs- och ärendepipelines i ditt konto. Varje rad som returneras representerar en enskild pipeline.
Denna tabell kan returnera följande kolumner:
| Kolumnnamn | Typ | Beskrivning |
PIPELINEID |
Varchar | Pipeline-ID. |
OBJECTTYPEID |
Varchar | ID för det objekt som pipelinen kan innehålla (t.ex. affärer eller biljetter). |
LABEL |
Varchar | Pipeline-namnet i HubSpot. |
DISPLAYORDER |
Nummer | Den ordning i vilken pipelinen visas i HubSpot. |
ARCHIVED |
Boolesk | Om pipelinen har raderats. |
SKAPAD |
Tidsstämpel | När pipelinen skapades. |
UPDATEDAT |
Tidsstämpel | Datum och tidpunkt då data senast uppdaterades i HubSpot. Läs mer om kolumnens datatyper. |
INGESTEDAT |
Tidsstämpel | Datum och tidpunkt då data senast importerades av Snowflake. |
Exempel 1
Hämta alla tillgängliga affärspipelines, sorterade efter deras ordning i HubSpot.
Fråga:
VÄLJ objectTypeId, pipelineId, labelFRÅN pipelinesDÄR objectTypeId = '0-3' OCH inte arkiveradORDER BY displayorder;
Returnerar:
| OBJECTTYPEID | PIPELINEID | LABEL |
| 0-3 | 1bed503c-37f7-4f51-9d40-7598902673f4 | Försäljningspipeline |
| 0 | 12659678 | Licenspipeline |
| 0-3 | 75e28846-ad0d-4be2-a027-5e1da6590b98 | Ny verksamhet |
| ... | ... | ... |
Exempel 2
Hämta affärer inom en specifik pipeline. Sammanfogar object_with_object_properties och pipelines.
Fråga:
VÄLJ
affärer.objektId affär_id,
affärer.fastighetsaffärsnamn affärsnamn,
pipelines.label pipeline_name
FROM objects_deals deals
INNER JOIN pipelines
ON deals.objectTypeId = pipelines.objectTypeId
OCH deals.property_pipeline = pipelines.pipelineid
DÄR pipelines.objekttypId = '0-3';
Returnerar:
| DEAL_ID | DEAL_NAME | PIPELINE_NAME |
| 605140072 | Meowmix Global Registrering | Försäljningspipeline |
| 605457408 | Friskies omprofilering | Försäljningspipeline |
| 604362473 | Fresh Step App Build | Försäljningspipeline |
Exempel 3
Samma som exempel 2 ovan, hämta affärer inom en specifik pipeline. Men istället för att använda objects_deals i sammanfogningar, använd object_with_object_properties.
SELECT
affärer.objektId affär_id,
affärer.egenskaper:affärsnamn::varchar affärsnamn,
pipelines.label pipeline_name
FROM objekt_med_objektegenskaper affärer
INNER JOIN pipelines
ON deals.objectTypeId = pipelines.objectTypeId
AND deals.properties:pipeline::string = pipelines.pipelineid
DÄR deals.objecttypeId = '0-3'
OCH pipelines.objekttypId = '0-3';
Returnerar:
| DEAL_ID |
DEAL_NAME |
PIPELINE_NAME |
| 605140072 |
Meowmix Global Registrering |
Försäljningspipeline |
| 605457408 |
Friskies omprofilering |
Försäljningspipeline |
| 604362473 |
Fresh Step App Build |
Försäljningspipeline |
pipeline_stages
Denna vy innehåller information om enskilda steg inom en pipeline. Identifiera steg genom att kombinera objekttyp-ID, pipeline-ID och steg-ID. När du sammanfogar med pipelines använder du objekttyp-ID och pipeline-ID.
Detta databasobjekt kan returnera följande kolumner:
| Kolumnnamn | Typ | Beskrivning |
PIPELINEID |
Varchar | Pipeline-ID. |
STAGEID |
Varchar | Stadiets ID. |
LABEL |
Varchar | Stegets namn i HubSpot. |
DISPLAYORDER |
Nummer | Den ordning i vilken pipelinen visas i HubSpot. |
METADATA |
Variant | En beskrivning i JSON-format av steget, inklusive om det är öppet eller stängt. |
ARKIVERAD |
Boolesk | Om pipeline-steget har raderats. |
CREATEDAT |
Tidsstämpel | När pipeline-steget skapades. |
Exempel 1
Hämta pipeline-steg för en affärspipeline med namnetFörsäljningspipeline.
Fråga:
VÄLJ pipelineid, stageId, labelFROM pipeline_stagesDÄR inte arkiveratOCH pipelineid = (VÄLJ pipelineid FROM pipelines DÄR objectTypeId = '0-3' OCH inte arkiverad OCH etikett = 'Försäljningspipeline' BEGRÄNSNING 1)ORDER BY displayorder;
Returnerar:
| PIPELINEID | STAGEID | LABEL |
| 941650 | 941651 | Kontakt |
| 941650 | 941652 | Möte inbokat |
| 941650 | 941653 | Faktura skickad |
| ... | ... | ... |
Exempel 2
Hämta alla affärer och deras respektive pipeline-stadier.
Fråga:
VÄLJaffärer.objektId affär_id,affärer.egenskaper:affärsnamn::varchar affärsnamn,pipelines.label pipeline_name,pipeline_stages.label pipeline_stage_nameFROM objekt_med_objektegenskaper affärerINNER JOIN pipelinesON deals.objectTypeId = pipelines.objectTypeIdAND deals.egenskaper:pipeline::sträng = pipelines.pipelineidINNER JOIN pipeline_stagesON deals.objectTypeId = pipeline_stages.pipelineidOCH deals.properties:pipeline::string = pipeline_stages.pipelineidOCH deals.properties:dealstage::string = pipeline_stages.stageIdDÄR deals.objecttypeId = '0-3';
Returnerar:
| DEAL_ID | DEAL_NAME | PIPELINE_NAME | PIPELINE_STAGE_NAME |
| 605140072 | Meowmix Global Registrering | Försäljningspipeline | Kontrakt skickat |
| 605457408 | Friskies omprofilering | Försäljningspipeline | Möte inbokat |
| 604362473 | Fresh Step App-utveckling | Försäljningspipeline | Kontrakt undertecknat |
| ... | ... | ... | ... |
Fastighetsfrågor
property_definitions
Detta databasobjekt innehåller information om objektegenskaper och händelseegenskaper i ditt HubSpot-konto. Händelseegenskaper inkluderar standardhändelser, såsom öppnade e-postmeddelanden och klick, samt anpassade beteendehändelseegenskaper. Denna information kan vara användbar för att definiera värden som finns i object_properties och händelsedata.
Du kan identifiera specifika egenskaper genom att kombinera deras objekttyp-ID och namn. Du kan hämta liknande information med hjälp av egenskaps-API:et.
Detta databasobjekt kan returnera följande kolumner:
| Kolumnnamn | Typ | Beskrivning |
OBJECTYPEID |
Varchar | ID för det objekt som händelsen avser. |
NAME |
Varchar | Egenskapens interna namn. |
LABEL |
Varchar | Egenskapens etikett. |
BESKRIVNING |
Varchar | Egenskapsbeskrivningen. |
TYP |
Varchar | Egenskapens typ (t.ex. sträng, tal, datum och tid). |
FIELDTYPE |
Varchar | Egenskapens fälttyp. Definierar hur egenskapen visas i HubSpot och i formulär (t.ex. kryssruta, rullgardinsmeny). |
DISPLAYORDER |
Number | Egenskapens visningsordning. |
GROUPNAME |
Varchar | Fastighetens gruppnamn. |
OPTIONS |
Variant | För uppräkningsegenskaper, en matris med egenskapens alternativ, inklusive varje alternativs attribut (t.ex. visningsordning, etikett). |
CREATEDUSERID |
ID för den användare som skapade egenskapen. | |
REFERENCEDOBJECTTYPE |
Varchar | Den typ av objekt som egenskapen refererar till. Ägaregenskaper returnerar värdet OWNER. |
CALCULATED |
Boolean | Om egenskapen är en beräknad egenskap. |
EXTERNALOPTIONS |
Boolesk | Om egenskapens alternativ definieras i ett externt system. |
HASUNIQUEVALUE |
Boolesk | Om egenskapens värden är unika. Kan endast ställas in när en egenskap skapas via API. |
HIDDEN |
Boolesk | Om egenskapen är dold i HubSpot. |
SHOWCURRENCYSYMBOL |
Boolesk | Om ett numeriskt egenskapsvärde är formaterat som valuta. |
FORMFIELD |
Boolesk | Om denna egenskap kan användas i formulär. |
READONLYDEFINITION |
Boolesk | Om egenskapen kan redigeras i HubSpot. |
READONLYVALUE |
Boolesk | Om egenskapens värde kan redigeras i HubSpot. |
HUBSPOTDEFINED |
Boolesk | Om egenskapen skapades av HubSpot eller av en användare. |
ARKIVERAD |
Boolesk | Om egenskapen har raderats. |
CREATEDAT |
Tidsstämpel | Datum och tid då egenskapen skapades i HubSpot. |
UPDATEDAT |
Tidsstämpel | Datum och tid då data senast uppdaterades i HubSpot. Läs mer om kolumnens datatyper. |
INGESTEDAT |
Tidsstämpel | Datum och tidpunkt då data senast importerades av Snowflake. |
Exempel 1
Hämta namn och beskrivningar för alla kontaktegenskaper.
Fråga:
VÄLJ namn, etikett, beskrivningFROM fastighetsdefinitionerDÄR objectTypeId = '0-1'
Returnerar:
| NAME | LABEL | BESKRIVNING |
| entered_sql_stage | Inmatad SQL-fas | Starta räkningen av SQL-stegdagar. |
|
first_conversion_event_name
|
Första konvertering | Det första formuläret som denna kontakt skickade in. |
| adress | Gatuadress | Kontaktens adress. |
Händelsefrågor
Händelser inkluderar standardhändelser från HubSpot och anpassade beteendehändelser. Varje händelse har sitt eget databasobjekt, märkt som events_eventname.
| Nam | |
| EVENTS_AD_INTERACTION | Detaljer om en annons och kontakter som interagerat med den genom att klicka på annonsen eller skicka in ett formulär efter att ha engagerat sig i den. |
| EVENTS_AD_METRICS_IMPORTED_V0 |
Detaljer om en annons och dess prestationsmått. |
| EVENTS_CALL_MENTIONED_KEYWORD | Detaljer om nyckelord som nämnts av deltagare i samtal. |
| EVENTS_CLICKED_LINK_IN_EMAIL_V2 |
Länkar som klickats på i marknadsföringsmejl av kontakter. |
| EVENTS_CLICKED_LINK_IN_TRACKED_INBOX_EMAIL_V8 | Länkar som klickats på i e-postmeddelanden i konversationsinkorgen av kontakter. |
| EVENTS_COOKIE_BANNER_CLICKED | Kontakter som klickat på cookies. |
| EVENTS_COOKIE_BANNER_VIEWED | Kontakter som har visat cookies. |
| EVENTS_DOCUMENT_SHARED_V2 | Försäljningsdokument som delats med kontakter via en extern länk. |
| EVENTS_DOCUMENT_VIEWED_V2 | Försäljningsdokument och kontakter som har visat dem genom att öppna den externa länken. |
| EVENTS_DOCUMENT_COMPLETED_V2 | Försäljningsdokument och kontakter som har avslutat dem. |
| EVENTS_HS_SCHEDULED_EMAIL_V2 | E-postmeddelanden som skickats till HubSpots e-postservrar för att skickas. |
| EVENTS_MTA_DELIVERED_EMAIL_V2 | E-postmeddelanden som framgångsrikt har levererats till mottagarna av HubSpots e-postservrar. |
| EVENTS_MTA_BOUNCED_EMAIL_V2 | E-postleveransförsök som avvisats av mottagarens e-postserver. |
| EVENTS_OPENED_EMAIL_V2 | E-postmeddelanden som öppnats av kontakter. |
| EVENTS_REPORTED_SPAM_EMAIL_V2 | E-postmeddelanden som markerats som skräppost av mottagarna. |
| EVENTS_UPDATED_EMAIL_SUBSCRIPTION_STATUS_V2 | Ändringar av e-postprenumerationer av mottagare. |
| EVENTS_OPENED_TRACKED_INBOX_EMAIL_V8 | Öppnade e-postmeddelanden i inkorgen för konversationer av kontakter. |
| EVENTS_MB_MEDIA_PLAYED | Videouppspelningsaktivitet av kontakter. |
| EVENTS_V2_CONTACT_BOOKED_MEETING_THROUGH_SEQUENCE | Kontakten bokade ett möte via sekvens. |
| EVENTS_V2_CONTACT_ENROLLED_IN_SEQUENCE | Kontakten har anmält sig från sekvensen. |
| EVENTS_V2_CONTACT_FINISHED_SEQUENCE | Sekvensen avslutad. |
| EVENTS_V2_CONTACT_REPLIED_SEQUENCE_EMAIL | Kontakt svarade på e-post (eller inkommande e-post som avregistrerade sekvensen) som skickades via sekvensen. |
| EVENTS_V2_CONTACT_AVREGISTRERAD_FRÅN_SEKVENS | Kontakten har avregistrerat sig från sekvensen. |
| EVENTS_V2_CONTACT_UNENROLLED_MANUALLY_FROM_SEQUENCE | Användaren har manuellt avregistrerat kontakten. |
| EVENTS_V2_CONTACT_UNSUBSCRIBED_SEQUENCE_EMAIL | Kontakten har avslutat prenumerationen och avregistrerats från sekvensen. |
| EVENTS_V2_SEQUENCE_EMAIL_BOUNCED | Sekvensens e-post har studsat tillbaka. |
| EVENTS_V2_SEQUENCE_ERRORED | Sekvensfel som orsakar avregistrering. |
| EVENTS_V2_SEQUENCE_STEP_EXECUTED | Sekvenssteg utfört. |
| EVENTS_VISITED_PAGE | Besök på webbplatsen av kontakter. |
| EVENTS_<INTEGRATION_EVENT_NAME>_<UNIQUE_IDENTIFIER> | Integrationshändelser (Timeline V3 API) |
Du kan identifiera händelser genom att kombinera deras händelsetyp-ID och ID. De kolumner som returneras beror på händelsen, med en kolumn för varje händelseegenskap. Alla händelser returnerar följande kolumner:
Observera: HubSpot har lagt till två nya kolumner i alla händelsetabeller och vyer:
inträffadeoccurredatdateint
Dessa kolumner kommer att ersätta kolumnerna occuredat och occuredatdateint den 24 november 2022. Från och med det datumet kommer de gamla kolumnerna inte längre att vara tillgängliga, och försök att söka efter ett databasobjekt eller en vy som innehåller händelser med hjälp av dessa kolumner kommer att misslyckas. Läs mer om viktiga ändringar för Snowflake-datadelning.
| Kolumnnamn | Typ | Beskrivning |
EVENTTYPEID |
Varchar | ID för händelsetypen, liknande OBJECTTYPEID Du kan söka efter alla händelsetyps-ID:n i ditt konto med hjälp av vyn object_and_event_type_definitions. |
ID |
Varchar | Detta är unikt för varje händelsetyp. Inga två poster kan ha samma ID inom en given händelsetyp. |
OBJECTTYPEID |
Varchar | Den typ av objekt som slutförde händelsen. Till exempel skulle ett klick på en e-postlänk visa0-1 i denna kolumn, vilket representerar kontaktsobjektet. |
OBJECTID |
Number | ID för den post som slutförde händelsen. |
OCCURREDAT |
Tidsstämpel | När händelsen inträffade. |
|
|
Nummer | Ett nummer som representerar när händelsen inträffade. Innehåller samma data som kolumnen OCCURREDAT, men formaterad som ett nummer och används som en del av tabellens klusternyckel. I de flesta fall kan du använda tidsstämpeln OCCURREDAT istället för detta nummer. |
|
|
Nummer | Ett tal som anger när händelsen inträffade. Innehåller samma data som kolumnen Observera: denna kolumn kommer att fasas ut den 24 november 2022 och ersättas med |
OCCUREDAT |
Tidsstämpel | När händelsen inträffade. Observera: denna kolumn kommer att fasas ut den 24 november 2022 och ersättas med |
INGESTEDAT |
Tidsstämpel | Datum och tidpunkt då data senast importerades av Snowflake. Läs mer om kolumnens datatyper. |
PROPERTY_* |
Varchar | Enskilda kolumner som innehåller händelseegenskaperna. |
Exempel 1
Hämta de 50 senaste e-postklickhändelserna.
Fråga:
SELECT eventTypeId, objectTypeId, objectId, occuredAt, property_hs_click_raw_url AS hs_click_raw_urlFROM events_clicked_link_in_email_V2
ORDER BY occuredAt
LIMIT 50;
Returnerar:
| EVENTTYPEID | OBJECTTYPEID | OBJECTID | OCCUREDAT | HS_CLICK_RAW_URL |
| 4-666288 | 0 | 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 |
| ... | ... | ... | ... | ... |
Exempel 2
Hämta alla e-postklickhändelser från de kontakter som klickat. Denna fråga hämtar kontaktdata genom att koppla ihop med object_with_object_properties.
Sökning:
SELECT
klick.occuredat klick_timestamp,
klick.egenskap_hs_klick_rå_url klick_url,
contact.properties:firstname::varchar contact_firstname,
contact.properties:lastname::varchar contact_lastname
FROM events_clicked_link_in_email_V2 klick
LEFT JOIN objekt_med_objektegenskaper kontakt
ON click.objectTypeId = contact.objectTypeId
AND klick.objektId = kontakt.objektId
LIMIT 3;
Returnerar:
| KLICKTID | KLICK_URL | KONTAKT_FÖRNAMN | KONTAKT_EFTERNAMN |
| 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 | Gold |
| 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_and_event_type_queries
object_and_event_type_definitions
Detta databasobjekt innehåller definitioner för alla objekt och händelser som finns tillgängliga i ditt HubSpot-konto.
Detta databasobjekt kan returnera följande kolumner:
| Kolumnnamn | Typ | Beskrivning |
OBJECTTYPEID |
Varchar | ID för objektet som pipeline kan innehålla (t.ex. affärer eller biljetter). |
FULLYQUALIFIEDNAME |
Varchar | Namnet på objektet eller händelsen. |
INGESTEDAT |
Tidsstämpel | Datum och tidpunkt då data senast importerades av Snowflake. Läs mer om kolumndatatyper. |
Exempel 1
Hämta alla objekt och händelser som finns tillgängliga i ditt HubSpot-konto.
Sökning:
VÄLJ objectTypeId, fullständigtNamnFRÅN objekt-och-händelsetypdefinitioner;
Returnerar:
| OBJECTTYPEID | FULLYQUALIFIEDNAME |
| 0 | CONTACT |
| 0-8 | LINE_ITEM |
| 0-11 | KONVERSATION |
| ... | ... |
Segmentfrågor
Nedan kan du lära dig hur du söker i dina segment, till exempel tillgängliga kontakt- och företagssegment och de poster som ingår i dessa segment.
segment
Detta databasobjekt innehåller information om HubSpot-kontakt- och företagssegment. Returnerar en rad per segment, och kolumnerna innehåller segmentdetaljer såsom segmentnamn, storlek och objekttyp för de poster som ingår. Innehåller inte information om de enskilda posterna inom varje segment (se segment_membership).
Detta databasobjekt kan returnera följande kolumner:
| Kolumnnamn | Typ | Beskrivning |
OBJECTTYPEID |
Varchar | Typ av poster i segmentet (t.ex. kontakt eller företag). |
SEGMENTID |
Nummer | Segmentets ID. Kopplas till kolumnenSEGMENTID i tabellen segment-medlemskap. |
CLASSICSEGMENTID |
Nummer | Ett ID som är specifikt för kontaktsegment och som matchar ID:t i URL:en för segmentet i HubSpot. |
NAME |
Varchar | Segmentets namn. |
STORLEK |
Antal | Antalet poster i segmentet. |
CREATEDBYUSERID |
Antal | ID för den användare som skapade segmentet. |
CREATEDAT |
Tidsstämpel | När segmentet skapades i HubSpot. |
UPPDATERAD AV ANVÄNDAR-ID |
Nummer | ID för den användare som senast uppdaterade segmentet. |
UPPDATERAD |
Tidsstämpel | Datum och tidpunkt då segmentet senast uppdaterades i HubSpot. Läs mer om kolumnens datatyper. |
INGESTEDAT |
Tidsstämpel | Datum och tidpunkt då data senast importerades av Snowflake. |
Exempel 1
Hämta alla kontaktsegment.
Fråga:
VÄLJ segmentId, namn, storlekFRÅN segmentDÄR objectTypeId = '0-1';
Returnerar:
| SEGMENTSID | NAME | SIZE |
| 118131 | Veckans räckvidd | 103 |
| 66156 | Bloggprenumeranter | 455 |
| 771852 | De mest populära prenumeranterna 2021 | 37 |
| ... | ... | ... |
Exempel 2
Hämta ett specifikt kontaktsegment med namnet Top subscribers 2021.
Fråga:
VÄLJ segmentId, namn, storlek FRÅN segmentDÄR objectTypeId = '0-1'
OCHsegmentName = 'Top subscribers 2021';
Returnerar:
| SEGMENTID | NAMN | STORLEK |
| 771852 | De mest populära prenumeranterna 2021 | 37 |
segment_membership
Detta databasobjekt innehåller information om vilka poster som är medlemmar i vilka segment, med en rad per post i segmentet. Om du till exempel har ett segment med bloggprenumeranter med 500 kontakter kommer databasobjektet att returnera 500 rader.
Innehåller endast segment-ID och objekt-ID. För mer information, koppla ihop med databasobjektet för segment.
Detta databasobjekt kan returnera följande kolumner:
| Kolumnnamn | Typ | Beskrivning |
SEGMENTID |
Varchar | Segmentets ID. Kopplas till kolumnen HS_SEGMENT_ID i segment tabellen. |
OBJECTID |
Varchar | ID för posten i segmentet. |
UPDATEDAT |
Tidsstämpel | Datum och tidpunkt då data senast uppdaterades i HubSpot. Läs mer om kolumnens datatyper. |
INGESTEDAT |
Tidsstämpel | Datum och tidpunkt då data senast importerades av Snowflake. |
Exempel 1
Hämta ID:n för alla kontakter i segmentetTop prenumeranter 2021.
Fråga:
VÄLJ objektIdFRÅN segmentmedlemskapINNER JOIN segmentON segment_memberships.segmentId = segments.segmentIdWHERE segments.objectTypeId = '0-1'OCH segments.name = 'Top Subscribers 2021';
Returnerar:
| OBJECTID |
| 54325098 |
| 96805401 |
| 6922028 |
| ... |
Exempel 2
Hämta för- och efternamn för kontakter i segmentet Top subscribers 2021.
Fråga:
VÄLJ
contact.objectId AS objectid,
contact.property_firstname AS firstname,
contact.property_lastname AS lastname
FROM objects_contacts kontakt
INNER JOIN segmentmedlemskap PÅ kontakt.objektId = segmentmedlemskap.objektId
INNER JOIN segment PÅ segment_medlemskap.segmentId = segment.segmentId
DÄR segment.objekttypId = '0-1'
OCH segments.name = 'Top Subscribers 2021'
Returnerar:
| OBJECTID |
FÖRNAMN |
EFTERNAMN |
| 54325098 |
Hobbes |
Baron |
| 96805401 |
Milo |
Gold |
| 6922028 |
Henry |
Riley |
| ... |
... |
... |
Vanliga
Jag vill generera data som liknar en rapport från Hubspot-appen, hur gör jag det?
I allmänhet bör du titta på kolumnerna i den rapport du jämför med. Om rapporten inte är tabellformad kan du konvertera den till en tabell för att visa kolumnerna i rapporten. Dessa kolumner är vanligtvis egenskaper för en objekttyp eller en händelsetyp. Nästa steg är att ta reda på vilken objekttypsegenskap en kolumn motsvarar. Du kan göra detta genom att fråga property_definitions:
VÄLJ * FRÅN egenskapsdefinitioner
DÄR etikett = [kolumnnamn]
Det finns kanske inte alltid en exakt matchning, eftersom vissa egenskapsnamn vanligtvis omvandlas till ett mer beskrivande namn i appen. I sådana fall kan det vara till hjälp att göra en fuzzy-sökning med hjälp av LIKE-operatorn på kolumnen label (eller till och med description) i property_definitions.
När du har fastställt vilken objekttyp kolumnen tillhör är det enkelt att avgöra vad du ska söka efter. Du kan helt enkelt söka efter den object_x-vy som motsvarar typen.
Hur länkar jag denna datatyp till en annan, t.ex. hur hämtar jag formulär för en kampanj?
Om du behöver länka två eller flera olika poster till varandra kan du titta på associationer. Associationer representerar relationerna mellan objekt i HubSpot CRM. Alla olika associationer som är möjliga mellan två typer listas i association_definitions. I exemplet ovan måste du fråga ASSOCIATIONS_CAMPAIGNS_TO_FORMS för att få reda på alla formulär som en kampanj är länkad till:
VÄLJ kampanjer.property_hs_name kampanjnamn,
formulär.fastighets-hs-formulär-id formulär-id
FROM objects_campaigns kampanjer
JOIN associations_campaigns_to_forms assoc ON
assoc.kampanjobjektid=kampanjer.objektid
JOIN objects_forms forms ON forms.objectid=assoc.form_objectid
GROUP BY kampanjnamn
Hur får jag reda på statusen för HubSpot-Snowflake-integrationen?
För att få statusuppdateringar i realtid om avbrott och problem för HubSpot-Snowflake-integrationen, fråga data_share_status-vyn:
SELECT * FROM hubspot.public.data_share_status
LIMIT 1
Resultaten visas som:
| STATUS | MEDDELANDE | UPPDATERAD |
| OK | INGA KÄNDA INCIDENTER FÖR NÄRVARANDE | 2023-04-10 09:21:20.123 |
Denna vy visar uppdateringar om integrationsstatusen i omvänd kronologisk ordning. Genom att integrera resultaten från denna fråga i en instrumentpanel kan du spåra integrationens prestanda och upptäcka eventuella driftstopp eller avbrott.