Fråga efter HubSpot-data i Snowflake

När du har anslutit Snowflake till ditt HubSpot-konto kan du använda Snowflakes datadelning för att fråga efter HubSpot-data från ditt Snowflake-konto.

Datafördröjning och din Snowflake-kontoregion

Du får tillgång till V2_LIVE-schemat som uppdateras var 15:e minut och V2_DAILY-schemat som uppdateras varje dag.

Konfigurera din Snowflake-miljö

För att söka efter HubSpot-data i Snowflake måste du välja lager, databas och schema som du vill söka från. Du kan antingen ställa in dem på kalkylbladsnivå för att inkludera dem automatiskt i dina frågor eller så kan du lägga till dem manuellt.

Om du vill välja lager, databas och schema på kalkylbladsnivå:

• Klicka på Åtgärdsfältet för arbetsbladet på den övre raden i arbetsbladet.
  
  
• I popup-fönstret:
  • Klicka på rullgardinsmenyn Lager och välj sedan ditt lager.
  • Klicka på rullgardinsmenyn Databas och välj sedan din HubSpot-databas.
  • Klicka på rullgardinsmenyn Schema 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 det här schemat uppdateras en gång per dag. Om du använder det här schemat får du snabbare sökningar och det rekommenderas för sökningar direkt i Snowflake.
    • V2_LIVE: Live-schemat baserat på säkra vyer av HubSpot-data. Data i detta schema uppdateras upp till var 15:e minut. Om du frågar efter en stor mängd data kan sökningarna bli långsamma. I det här fallet rekommenderas att du först kopierar data till en egen tabell med en ETL-process och sedan frågar i den tabellen.
    
    
    

När din miljö är konfigurerad kan du göra sökningar på dina HubSpot-data utan att behöva lägga till din databas eller schematyp manuellt i sökningarna.

Om du vill lägga till din databas och schematyp manuellt i frågor lägger du till databasnamnet följt av schemat i början av FROM-fältet. Till exempel:

Översikt över uppgifter

Förfrågningar konstrueras med hjälp av SQL och kan användas för att hämta HubSpot-data, t.ex:

• Objekt: standardobjekt och anpassade objekt, t.ex. kontakter, företag och produkter.
• Register: enskilda register, t.ex. en enskild kontaktperson eller ett 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, t.ex. öppning av e-postmeddelanden, och anpassade beteendehändelser.
• Listor: HubSpot kontakt- och företagslistor.
• Ägare: Användare i ditt HubSpot-konto i förhållande till de poster som de är ägare till.
• Pipelines: pipelines för affärer och biljetter, inklusive pipeline-steg.
• Egenskaper: Egenskaper och deras värden i CRM-poster, inklusive egenskapshistorik.

Läs mer om HubSpots CRM-datamodell.

Observera: I takt medatt vi utvecklar datautbytet kommer vi att införa ändringar, varav en del är brytande. Det rekommenderas starkt att du prenumererar på HubSpots ändringslogg för utvecklare. Dessa ändringar kommer alltid att publiceras i ändringsloggen före varje uppdatering.

Begränsning och ordnande av returnerade uppgifter

När du konstruerar frågor kan du kontrollera hur mycket data som returneras och i vilken ordning den returneras genom att inkludera LIMIT och ORDER BY i din fråga. Om du till exempel vill fråga efter alla kontakter med deras egenskaper, men bara returnera tre resultat och ordna dem efter kontakt-ID, kan du konstruera din fråga på följande sätt:

Datatyper för kolumner

När du frågar efter data i Snowflake beror kolumnerna som returneras på vilka data du frågar efter. Du kan visa de tillgängliga kolumnerna för en viss tabell eller vy i Snowflake genom att välja vyn i den vänstra sidofältet.

Observera:I resten av den här dokumentationen använder vi termen databasobjekt när det gäller både tabeller och vyer.

Om du vill returnera en specifik kolumn inkluderar du den kolumnen i SELECT-fältet i din fråga. Följande fråga returnerar till exempel endast kolumnerna OBJECTID och UpdatedAt:


SELECTobjectId, updatedAt
FROM objects_contacts



Nedan finns allmänna definitioner av kolumner som en fråga kan ge tillbaka. För andra definitioner som inte finns med nedan, se de enskilda vydefinitionerna i artikeln ovan.

• OBJECTTYPEID: ett VARCHAR-värde som representerar ett objekts typ. Exempelvis representerar 0-1 kontaktobjektet, 0-2 representerar företagsobjektet och 2-1232 kan representera ett anpassat objekt i ditt konto. I listor hänvisar detta till listtypen (t.ex. kontakt eller företag). Du kan fråga 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 enda post av en viss typ av objekt i ditt HubSpot-konto. För att identifiera en post måste du använda både objekttyp-ID och objekt-ID.
• INGESTEDAT: tidsstämpeln för när en datarad lades till i Snowflake, representerad av ett TIMESTAMP_NTZ-värde. Inte relaterat till den logiska tidsstämpeln för en skapelse- eller uppdateringsoperation i HubSpot.
  • På grund av HubSpots interna behandling kan en rads tidsstämpel för inmatning uppdateras även om inga andra kolumner i raden har ändrats.
  • När du bygger ETL-processer som kopierar nyligen ändrade data rekommenderas att du baserar dina frågor på tidsstämpeln för inmatning. Om ditt flöde kopierar data dagligen rekommenderas dessutom att du kopierar data från de två föregående dagarna för att ta hänsyn till förseningar.
• 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ämplar i HubSpot. Den tid som visas i HubSpot för ett datum för skapande av en post kommer till exempel att vara densamma som tidsstämpeln i kolumnen CREATEDAT i Snowflake. Dessa är inte direkt relaterade till tidsstämpeln för inmatning och det rekommenderas inte att basera ETL-processer på dessa egenskaper.
• COMBINEDASSOCIATIONTYPE: ett VARCHAR-värde som unikt identifierar en associationsdefinition.

Omvandling av datatyper

Ibland returneras data från en fråga med VARCHAR-kolumner när det vore önskvärt att ha dem av en annan typ. I sådana fall rekommenderas att VARCHAR-datatypen konverteras till önskad typ med hjälp av Snowflake-funktioner. Egenskaperna i en objektpost lagras till exempel som VARCHAR-datatyper i de flesta databasobjekt, men ibland innehåller de värden för tal och datum. Funktioner som:
try_to_number, try_to_timestamp_ntz kan användas för att konvertera dessa VARCHAR-data till deras typer NUMBER respektive DATETIME:


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



Förfrågningar om objekt

Nedan får du veta hur du frågar efter data från specifika HubSpot-objekt och -poster och vilka data som returneras.

Objektdata av olika typer är organiserade och tillgängliga på två sätt:

• Individuellt: Varje objekttyp lagras i en egen vy och innehåller endast poster av samma objekttyp, t.ex. objects_contacts innehåller endast kontaktposter. Detta eliminerar behovet av att ange ett objekttypid vid sökning. Dessa vyer är lättare att fråga 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 frågor är det lämpligt att använda dessa vyer för att hämta objektdata. Mer information finns i vyerna Objects_X nedan.
• Kombinerad: Alla poster för alla objekttyper kombineras till ett databasobjekt. När du gör en sökning måste du alltså ange ett filter som "WHERE objectTypeId='0-1'. Du kan t.ex. använda följande objekttypsid vid sökning:

Anpassade objekt kommer att tilldelas ett ID när de skapas och identifieras som 2-unique_ID. Till exempel 2-12345. Läs mer om object_and_event_type_definitions.

De här databasobjekten är i allmänhet lämpliga om du vill ha bättre prestanda än vad som kan uppnås med objects_x-vyer. Mer information finns i object_with_object_properties, object_properties, objects och object_properties_history nedan.

objects_x views

I det här databasobjektet 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_<objekttypnamn> där <objekttypnamn> är objekttypens pluralform(observera att om objekttypen inte har någon pluralform kommer <objekttypnamn> helt enkelt att vara objekttypens singularformsbeteckning med ett "S").

Förfrågningar till den här vyn returnerar en rad för varje post i ett objekt med varje egenskap i objektet 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:

Varje databasobjekt returnerar följande kolumner:

Exempel 1

Hämta förnamn, efternamn och livscykelstadium för alla kontakter.

Förfrågan:


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



Returnerar:

Exempel 2

Hämta namn och stadium för upp till tre affärer.

Query:


SELECT objectId, property_dealName, property_dealStage,
property_amount AS dealAmount

FROM objects_deals

LIMIT 3

Returnerar:

Exempel 3

Hämta namn och stadium för de tre största affärerna efter belopp.

Fråga:

Eftersom uppgifter om deal amount finns tillgängliga som en datatyp för tal kan de användas för beställning utan att behöva konverteras eller gjutas.


SELECT objectId, property_dealName, property_dealStage,
property_amount AS dealAmount

FROM objects_deals
ORDER BY property_amount DESC
LIMIT 3




Returnerar:

object_with_object_properties

Det här databasobjektet innehåller data från dina HubSpot-poster. Förfrågningar till det här databasobjektet returnerar en rad för varje post inom en objekttyp (t.ex. alla kontaktposter i objekttypen contacts). Alla egenskaper lagras i kolumnen Egenskaper, som är en Snowflake Variant/JSON-kolumn.

Denna vy kan visa följande kolumner:

Observera: Den 25 januari 2022 kommer kolumnen timestamp i tabellen object_with_object_properties och vyn, som representerar det datum och den tid då objektet senast uppdaterades i HubSpot, att vara updatedat. Detta för att anpassa sig till hur datumtidsdata representeras i resten av datadelarna.

Eftersom detta är en brytande ändring har den nya kolumnen updatedat lagts till i tabellen och vyn. Under de kommande 90 dagarna kommer dessa två nya kolumner att samexistera med timestamp, de kolumner som de försöker ersätta. Detta ger dig en möjlighet att övergå 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 object_with_object_properties eller vyn med hjälp av kolumner med tidsstämpel att misslyckas.

Exempel 1

Hämta alla kontakter och deras egenskaper.

Fråga:

Returnerar:

Exempel 2

Hämta namn och stadium för upp till tre affärer.

Fråga:

Returnerar:

objekt

Detta databasobjekt är en delmängd av uppgifterna 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 tas bort i HubSpot tas den bort från detta databasobjekt. Det här databasobjektet är en delmängd av uppgifterna i tabellen object_with_object_properties. Varje returnerad rad returnerar objekt-ID för varje post. Den här vyn returnerar endast befintliga poster. När en post tas bort i HubSpot tas den bort från den här vyn.

Det här databasobjektet kan vara användbart om kontot har en stor mängd data, vilket gör att object_with_object_properties och objects_x-vyer fungerar långsamt. Om du använder det här databasobjektet tillsammans med databasobjektet object_properties kan du 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:

Exempel 1

Hämta alla kontaktuppgifter.

Fråga:

Returnerar:

objekt_egenskaper

Detta databasobjekt är en delmängd av databasobjektet object_with_object_properties. Varje rad innehåller det aktuella egenskapsvärdet för en viss post. En kontakt har till exempel en rad för egenskapen Förnamn och en rad för egenskapen Efternamn. Om en post inte har något värde för en egenskap visas raden antingen med en tom sträng eller inte alls.

Detta databasobjekt kan returnera följande kolumner:

Exempel 1

Hämta egenskaperna för förnamn, efternamn och stad för alla kontakter.

Fråga:

Returnerar:

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

Fråga:

Returnerar:

object_properties_history

Detta databasobjekt innehåller historiska fastighetsvärden. För kontakter innehåller det de senaste 45 värdena. För alla andra objekt innehåller det de senaste 20 värdena. Visar en rad för varje historiskt egenskapsvärde. Det aktuella värdet för en egenskap bestäms av den senaste tidsstämpeln UPDATEDAT i egenskapens historik.

Detta databasobjekt kan returnera följande kolumner:

Exempel 1

Hämta historiken för en enskild egenskap för en enskild kontakt.

Fråga:

Returnerar:

Exempel 2

Hämta det aktuella namnet på alla kontakter som någonsin har haft livscykelstadiet Abonnent.

Fråga:

Returnerar:

Förfrågningar om sammanslutningar

Liksom uppgifter om objekt organiseras uppgifter om sammanslutningar på två sätt:

• Enskilda personer: Varje associationstyp lagras i en egen vy och innehåller endast poster av den typen. Till exempel innehåller associations_contacts_to_deals endast associationsposter mellan kontakt- och avtalsobjekt. Detta gör att man inte behöver ange ett associationtypeid vid sökning. De här vyerna är ganska enkla att fråga efter eftersom de inte kräver kännedom om CRM-datamodellen för att kunna användas. De returnerar också en berikad beskrivning av associationsposten mellan två objekt som lätt kan användas i föreningar med objects_x-vyer. Så länge du inte upplever långsamma frågor är det lämpligt att använda dessa vyer för att hämta associationsdata. Mer information finns i vyerna associations_x_to_y nedan.
• Kombinerad: Alla poster för alla associationsformer kombineras i ett databasobjekt. När du gör en sökning måste du ange ett filter som "WHERE combinedassociationtypeid='0-32' ". Se mer om associationer och association_definitioner nedan.

associations_x_to_y views

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 uppgifterna i associationsdatabasobjektet och innehåller endast poster med ett visst kombineratassociationtypeid.

Varje databasobjekt returnerar följande kolumner:

Exempel 1

Hämta alla affärer som är kopplade till en specifik kontakt.

Fråga:

Returnerar:

Exempel 2

Hämta alla kontakter som är baserade i tidszonen Bogota och deras affärer.

Exempel 3

Hämta alla kontakter och den totala summan av det avslutade beloppet för varje kontakt.

Returnerar:

association_definitioner

Det här databasobjektet innehåller information om alla tillgängliga associationstyper mellan HubSpot-objekt, med en rad per associationstyp. Du kan koppla ihop det här databasobjektet med databasobjektet Associations för att få information om specifika associationer.

Det kan finnas flera typer av kopplingar 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 sann.

Detta databasobjekt kan returnera följande kolumner:

Exempel 1

Hämta de typer av föreningar som finns tillgängliga på ditt konto.

Fråga:

Returnerar:

Exempel 2

Hämta de tillgängliga associationstyperna mellan affärer och företag.

Fråga:

Returnerar:

föreningar

Det här databasobjektet innehåller information om sambanden mellan specifika poster. Varje rad representerar ett samband från ett objekt till ett annat objekt. Rader kan finnas i detta databasobjekt även om de refererade posterna har tagits bort. Du kan kontrollera om det finns poster genom att göra en sammanfogning med objekttabellen.

Det här databasobjektet kan vara användbart om kontot 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:

Exempel 1

Hämta alla associerade affärer och kontakter.

Fråga:

Returnerar:

Exempel 2

Hämta alla biljetter som är kopplade till en viss kontakt (kontakt-ID: 3005).

Fråga:

Returnerar:

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 används association_definitions i det här exemplet.

Fråga:

Returnerar:

Förfrågningar från ägaren

ägare

Det här databasobjektet 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:

Exempel 1

Hämta alla användare. Filtret WHERE archived = false tar bort raderade användare från de returnerade uppgifterna.

Fråga:

Returnerar:

Exempel 2

Hämta en specifik ägare med hjälp av dennes ägar-ID.

Fråga:

Returnerar:

Exempel 3

Hämta alla kontakter och deras ägare. Den här frågan kopplar ihop poster till ägare med object_with_object_properties och kontaktens egenskap hubspot_owner_id.

Returnerar:

Förfrågningar om rörledningar

Nedan får du veta hur du söker efter data om affärer och biljettpipelines, till exempel vilka pipelines som finns tillgängliga på ditt konto och deras stadier.

Du kan kombinera dessa data med objektdata för att få en fullständig bild av dina pipelines. Du kan t.ex. fråga efter affärer och deras pipelines genom att koppla samman objects_deals_view eller object_with_object_properties-data med pipelines-data.

rörledningar

Det här databasobjektet innehåller information om affärs- och biljettpipelines i ditt konto. Varje rad som returneras representerar en enskild pipeline.

Tabellen kan visa följande kolumner:

Exempel 1

Hämta alla tillgängliga pipelines för affärer, ordnade efter deras ordning i HubSpot.

Fråga:

Returnerar:

Exempel 2

Hämta affärer inom en specifik pipeline. Sammanfogar object_with_object_properties och pipelines.

Fråga:

Returnerar:

Exempel 3

Samma som exempel 2 ovan, men hämta affärer inom en specifik pipeline. Men i stället för att använda objects_deals i joins använder du object_with_object_properties.

Returnerar:

pipeline_stages

Den här vyn innehåller information om enskilda steg i en pipeline. Identifiera etapper genom att kombinera objekttyp-ID, pipeline-ID och etapp-ID. När du ansluter dig till rörledningar använder du objekttyp-ID och rörlednings-ID.

Detta databasobjekt kan returnera följande kolumner:

Exempel 1

Hämta pipeline-steg för en affärspipeline som heter Sales pipeline.

Fråga:

Returnerar:

Exempel 2

Hämta alla affärer och deras respektive stadier i pipeline.

Fråga:

Returnerar:

Förfrågningar om fastigheter

Egendomsdefinitioner

Det här databasobjektet innehåller information om objekt- och händelseegenskaper i ditt HubSpot-konto. Händelseegenskaperna omfattar standardhändelser, t.ex. öppningar och klick i e-postmeddelanden, och anpassade beteendehändelseegenskaper. Den här informationen kan vara till hjälp 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 API:et för egenskaper.

Detta databasobjekt kan returnera följande kolumner:

Exempel 1

Hämta namn och beskrivningar för alla kontaktegenskaper.

Fråga:

Returnerar:

Förfrågningar om evenemang

Händelser inkluderar standardhändelser från HubSpot och anpassade beteendehändelser. Varje händelse har ett eget databasobjekt som kallas events_eventname.

Du kan identifiera händelser genom att kombinera deras ID för händelsetyp och ID. Kolumnerna som returneras beror på händelsen, med en kolumn för varje händelseegenskap. Alla händelser returnerar följande kolumner:

Exempel 1

Hämta de 50 senaste klickhändelserna i e-postmeddelanden.

Fråga:

Returnerar:

Exempel 2

Hämta alla klickhändelser i e-postmeddelanden efter de kontakter som klickade. Den här frågan hämtar kontaktuppgifter genom att gå samman med object_with_object_properties.

Fråga:

Returnerar:

Object_and_event_type_queries (frågor om objekt- och händelsetyper)

Object_and_event_type_definitions

Det här databasobjektet innehåller definitioner för alla objekt och händelser som är tillgängliga i ditt HubSpot-konto.

Detta databasobjekt kan returnera följande kolumner:

Exempel 1

Hämta alla objekt och händelser som finns tillgängliga i ditt HubSpot-konto.

Fråga:

Returnerar:

Listor förfrågningar

Nedan får du veta hur du söker i dina listor, t.ex. de tillgängliga kontakt- och företagslistorna och de poster som ingår i dessa listor.

förteckningar

Det här databasobjektet innehåller information om HubSpot kontakt- och företagslistor. Det returnerar en rad per lista och kolumnerna innehåller information om listan, t.ex. listnamn, storlek och objekttyp för de poster som ingår. Innehåller inte information om de enskilda posterna i varje lista (se list_membership).

Detta databasobjekt kan returnera följande kolumner:

Exempel 1

Hämta alla kontaktlistor.

Fråga:

Returnerar:

Exempel 2

Hämta en specifik kontaktlista som heter Toppabonnenter 2021.

Fråga:

Returnerar:

list_membership

Det här databasobjektet innehåller information om vilka poster som ingår i vilka listor, med en rad per post i listan. Om du till exempel har en lista över bloggprenumeranter med 500 kontakter kommer databasobjektet att ge 500 rader.

Innehåller endast list-ID och objekt-ID. För mer information, gå samman med databasobjektet lists.

Detta databasobjekt kan returnera följande kolumner:

Exempel 1

Hämta ID:n för alla kontakter i listan Toppabonnenter 2021.

Fråga:

Returnerar:

Exempel 2

Hämta för- och efternamn för uppgifter om kontakter i listan Toppabonnenter 2021.

Fråga:

Returnerar:

Vanliga frågor

Jag vill generera data som liknar en rapport från Hubspot-appen, hur gör jag det?

I allmänhet vill du titta på kolumnerna i den rapport du jämför med. Om rapportens visualisering inte är tabellformad, kan du konvertera den till en tabell för att visa de kolumner som rapporten innehåller. Dessa kolumner är vanligtvis egenskaper för en objekttyp eller en händelsetyp. Nästa steg är att ta reda på vilken objekttypegenskap en kolumn motsvarar. Detta kan du göra genom att fråga efter property_definitions:

Det kanske inte alltid är en exakt matchning eftersom vissa egenskapsnamn brukar lösas upp till ett mer beskrivande namn i appen. I sådana fall kan det hjälpa att göra en oklar sökning med hjälp av LIKE-operatorn på kolumnen label (eller till och med description) i property_definitions.

Efter att ha bestämt vilken objekttyp kolumnen tillhör är det trivialt att bestämma vad som ska efterfrågas. Du kan helt enkelt söka efter den object_x-vy som motsvarar typen.

Hur kopplar jag den här datatypen 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 ta en titt 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 efter ASSOCIATIONS_CAMPAIGNS_TO_FORMS för att få reda på alla formulär som en kampanj är kopplad till: