Observera: Översättningen av denna artikel är endast avsedd att underlätta för dig. Översättningen har skapats automatiskt med hjälp av en översättningsprogramvara och har eventuellt inte korrekturlästs. Den engelska versionen av denna artikel bör därför betraktas som den gällande versionen med den senaste informationen. Du kan komma åt den här.

Fråga efter HubSpot-data i Snowflake

Senast uppdaterad: 3 september 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 fråga HubSpot-data från ditt Snowflake-konto.

Datalagring och din Snowflake-kontoregion

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

Observera att följande vyer i V2_LIVE-schemat endast uppdateras dagligen: association_definitions, owners, pipelines och pipeline_stages.

Konfigurera din Snowflake-miljö

För att kunna söka efter HubSpot-data i Snowflake måste du välja det lager, den databas och det schema som du vill göra sökningar 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.

Så här väljer du lager, databas och schema på kalkylbladsnivå:

I den övre raden i kalkylbladet klickar du på kalkylbladets åtgärdsfält.
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 som du vill använda:

När du har konfigurerat din miljö kan du göra frågor till dina HubSpot-data utan att behöva lägga till din databas eller schematyp i frågorna manuellt.

För att manuellt lägga till din databas och schematyp i frågor lägger du till databasnamnet följt av schemat i början av fältet FROM. Ett exempel:

SELECT objectTypeId, property_createddate
FROM 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 som t.ex:

Objects: standardobjekt och anpassade objekt, t.ex. kontakter, företag, produkter.
Records: enskilda poster, t.ex. en enskild kontakt eller ett enskilt företag.
Associationer: alla tillgängliga associationstyper och för närvarande associerade poster.
Events: händelsedata för både standardhändelser i HubSpot, t.ex. öppnade e-postmeddelanden, och anpassade beteendehändelser.
Segment: HubSpot-kontakt- och företagssegment.
Ägare: användare i ditt HubSpot-konto, i förhållande till de poster som de har angetts som ägare till.
Pipelines: pip elines för affärer och ärenden, inklusive pipeline-steg.
Properties: egenskaper och deras värden i CRM-poster, inklusive egenskapshistorik.

Läs mer om HubSpots CRM-datamodell.

Observera: När vi utvecklar datadelningen kommer vi att införa ändringar, vissa av dem är omvälvande ändringar. Det rekommenderas starkt att du prenumererar på HubSpots ändringslogg för utvecklare. Dessa ändringar kommer alltid att publiceras i förändringsloggen före varje uppdatering.

Begränsa och beställa returnerade data

När du konstruerar frågor kan du styra hur mycket data som returneras, tillsammans med den ordning i vilken de returneras, genom att inkludera LIMIT och ORDER BY i din fråga. Om du t.ex. vill söka 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:

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

Datatyper för kolumner

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

Observera:i resten av detta dokument använder vi termen databasobjekt när sammanhanget gäller både tabeller och vyer.

snowflake-sidebar-view-column-details0

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

SELECTobjectId, updatedAt
FROM objects_contacts

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

OBJECTTYPEID: ett VARCHAR-värde som representerar ett objekts typ. Till exempel representerar 0-1 kontaktobjektet, 0-2 representerar företagsobjektet och 2-1232 kan representera ett anpassat objekt i ditt konto. I segment hänvisar detta till typen av segment (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 objekttypens ID och objektets 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 create- eller update-operation i HubSpot.
- På grund av HubSpots interna bearbetning kan en rads tidsstämpel för inmatning uppdateras även om inga andra kolumner på raden har ändrats.
- När du bygger ETL-processer som kopierar nyligen ändrade data rekommenderas det att du baserar dina frågor på tidsstämpeln för ingestion. 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ö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ämplarna i HubSpot. Till exempel kommer den tid som visas i HubSpot för en posts skapandedatum att vara densamma som tidsstämpeln i kolumnen CREATEDAT i Snowflake. Dessa egenskaper är inte direkt relaterade till tidsstämpeln för ingestion 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 skulle vara önskvärt att ha dem som en annan typ. I sådana fall är det lämpligt att konvertera VARCHAR-datatypen till önskad typ med hjälp av Snowflake-funktioner. Exempelvis lagras egenskaper för en objektpost som VARCHAR-datatyper i de flesta databasobjekt, men ibland innehåller de tal- och datetime-värden. Funktioner som t.ex:
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 amount
FROM object_properties WHERE objecttypeid='0-3' AND name='amount' LIMIT 1

Objektförfrågningar

Nedan kan du läsa om hur du frågar efter data från specifika HubSpot-objekt och poster, samt vilka data som returneras.

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

Individuell: Varje objekttyp lagras i sin egen vy och innehåller endast poster av samma objekttyp, t.ex. innehåller objects_contacts endast kontaktposter. Detta eliminerar behovet av att ange ett objecttypeid när du ställer en fråga. Dessa vyer är enklare 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. Se mer i Objects_X-vyer nedan.
Kombinerad: Alla poster för alla objekttyper kombineras till ett databasobjekt. När du ställer en fråga måste du därför ange ett filter som "WHERE objectTypeId='0-1'. Du kan t.ex. använda följande objekttypid när du ställer frågor:

Objektets namn	ObjektTypId
Kontakter	0-1
Företag	0-2
Linjeposter	0-8

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

Dessa databasobjekt är i allmänhet lämpliga om du vill ha bättre sökprestanda än vad som kan erhållas från objects_x-vyer. Se mer information i object_with_object_properties, object_properties, objects och object_properties_history nedan.

objects_x-vyer

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_<objekttypens namn> där <objekttypens namn> är etiketten i pluralform för objekttypen (observera att om objekttypen inte har någon pluralform kommer <objekttypens namn> helt enkelt att vara etiketten i singularform för objekttypens namn sammanlänkad med "S").

Frågor till denna vy returnerar en rad för varje post inom ett objekt med varje egenskap hos objektet tillgänglig som en separat kolumn.

Nedan finns en omfattande lista över tillgängliga HubSpot-objekttyper (som inte är kundanpassade), en kort beskrivning av de data de representerar och deras motsvarande vyer:

HubSpot Objekttyp	ObjektTypId	Beskrivning av objektet
KONTAKT	0-1	Information om individer som interagerar med ditt företag
FÖRETAG	0-2	Information om enskilda företag eller organisationer
DEAL	0-3	Detaljer om intäktsmöjligheter med en kontakt eller ett företag
ENGAGEMANG	0-4	Lagrar data från CRM-åtgärder, inklusive anteckningar, uppgifter, e-postmeddelanden, möten och samtal
TICKET	0-5	Representerar kundförfrågningar om hjälp eller support
QUOTE	0-14	Används för att dela prisinformation med potentiella köpare
FORM_SUBMISSION	0-15	Detaljer för enskilda inlämningar för ett HubSpot-formulär
LINJE_ITEM	0-8	Representerar en delmängd av de produkter som säljs i ett avtal. När en produkt är kopplad till ett avtal blir den en linjeartikel
KONVERSATION	0-11	Detaljer om inkommande meddelanden från flera kanaler.
LANDNINGSSIDA	0-25	Detaljer om dina målsidor
UPPGIFT	0-27	Lagrar information om att-göra-listor
FORMULÄR	0-28	Används för att samla in lead-information om dina besökare och kontakter
MARKNADSFÖRING_EMAIL	0-29	Detaljer om e-postmeddelanden från marknadsföringshubben
AD_ACCOUNT	0-30	Lagrar information om dina annonskonton på Linkedin, Facebook och Google
AD_CAMPAIGN	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_GROUP	0-33	Detaljer om enskilda annonser
KAMPANJ	0-35	Information om relaterade marknadsföringstillgångar och innehåll, så att du enkelt kan mäta effektiviteten i dina samlade marknadsföringsinsatser
SITE_PAGE	0-38	Data om enskilda sidor på dina webbplatser
BLOGG_POST	0-39	Data om blogginlägg
OBJECT_SEGMENT	0-45	Information om grupperingar av objektposter baserat på deras egenskaper eller aktiviteter
CALL	0-48	Samtal som görs av andra CRM-poster, t.ex. kontakter
FAKTURA	0-53	Hantera och synkronisera fakturor med externa redovisningssystem
MEDIA_BRIDGE	0-57	Information om medietillgångar som importerats till Hubspot
SEQUENS	0-58	En sekvens är en serie riktade, tidsbestämda e-postmallar för att vårda kontakter över tid
MALL	0-62	Sparat e-postinnehåll som kan återanvändas för att skicka e-postmeddelanden
DEAL_SPLIT	0-72	Deal splits används för att dela deal credit mellan flera användare
SALES_DOKUMENT	0-83	Försäljningsdokument skapar ett innehållsbibliotek för hela teamet där man kan ladda upp och dela dokument med sina kontakter
FEEDBACK_SÄNDNING	0-19	Lagrar information som skickats in till en feedbackundersökning
ABONNEMANG	0-69	Prenumerationer innehåller information om återkommande betalningar
HANDELSBETALNING	0-101	Innehåller data om medel som samlats in från kunder

Varje databasobjekt kommer att returnera följande kolumner:

Kolumnens namn	Typ av kolumn	Beskrivning
OBJECTTYPEID	Varchar	ID för objekttypen (t.ex. kontakter är 0-1).
OBJECTID	Nummer	Postens ID (t.ex. en kontaktpost med ett ID på 123752).
UPPDATERADAT	Tidsstämpel	Datum och tid då detta objekt senast uppdaterades i HubSpot.
INGESTEDAT	Tidsstämpel	Datum och tid då data senast togs in av Snowflake.
PROPERTY_*	Varchar	Enskilda kolumner som innehåller den senaste versionen av objektets egenskaper För varje objektsegenskap som har en datum- eller siffertyp (enligt specifikation i property_definitions) kommer det att finnas två kolumner: En kolumn som innehåller egenskapens värde som en sträng. Kolumnnamnet kommer att vara property_unparsed_[name] . Till exempel kommer DEAL-objektets egenskap deal_amount att ha kolumnen property_unparsed_deal_amount En kolumn som innehåller det värde som konverterats till den ursprungliga typen. Kolumnen kommer att ha namnet property_[name] Exempel: DEAL object property, deal_amount kommer att ha kolumnen property_deal_amount. Observera att den här kolumnen innehåller null om konverteringen till ursprunglig typ misslyckas på grund av ogiltiga data.

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:

OBJECTID	FÖRSTANAMN	SISTNAMN	LIVSCYKELÅLDER (LIFECYCLESTAGE)
54325098	Hobbes	Baron	bly
96805401	Milo	Guld	bly
6922028	Henry	Riley	Bly

Exempel 2

Hämta affärsnamn 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:

OBJECTID	EGENDOM_AFFÄRSNAMN	PROPERTY_DEALSTAGE	EGENDOM_DEALBELOPP
38960439	Affärens namn 1	closedwon	34199
321740651	Testavtal 123	14845019	8383663
98392101	Pop-Up skärmtak	closedwon	9309007

Exempel 3

Hämta affärsnamn och steg för de tre bästa affärerna efter belopp.

Frågeställning:

Eftersom data om affärsbelopp finns tillgängliga som en datatyp för tal kan de användas för beställning utan att man behöver göra konvertering eller casting.

SELECT objectId, property_dealName, property_dealStage, property_amount AS dealAmount
FROM objects_deals ORDER BY property_amount DESC LIMIT 3

Returnerar:

OBJECTID	FASTIGHET_AFFÄRSNAMN	PROPERTY_DEALSTAGE	EGENDOM_DEALBELOPP
98392101	Pop-Up skärmtak	closedwon	9309007
321740651	Testavtal 123	14845019	8383663
38960439	Affärens namn 1	closedwon	34199

objekt_med_objekt_egenskaper

Det här databasobjektet innehåller data från dina HubSpot-poster. Frågor 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 Properties, som är en Snowflake Variant / JSON-kolumn.

Den här vyn kan returnera följande kolumner:

Kolumnens namn	Typ av kolumn	Beskrivning
`OBJECTTYPEID`	Varchar	ID för objekttypen (t.ex. kontakter är `0-1`).
`OBJECTID`	Nummer	Postens ID (t.ex. en kontaktpost med ID `123752`).
`PROPERTIES`	Variant	Postens egenskapsvärden.
`UPDATEDAT`	Tidsstämpel	Datum och tid då posten senast uppdaterades i HubSpot. Läs mer om datatyper för kolumner.
`INGESTEDAT`	Tidsstämpel	Datum och tid för när data senast matades in av Snowflake.

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

Eftersom detta är en genomgripande ä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 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 ställa frågor till tabellen eller vyn object_with_object_properties med hjälp av kolumner med tidsstämpel att misslyckas.

Exempel 1

Hämta alla kontakter och deras egenskaper.

Frågar efter:

SELECT objectTypeId, objectId, properties
FROM object_with_object_properties
WHERE objectTypeId = '0-1'

Returnerar:

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

Exempel 2

Hämta affärsnamn och steg för upp till tre affärer.

Frågeställning:

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

Returnerar:

OBJECTID	DEALNAME	DEALSTAGE	DEALAMOUNT
38960439	Namn på affär 1	stängd förlust	7488939
321740651	Dealens namn 1	stängt vunnit	9292029
98392101	Avtalets namn 1	stängdförlorad	62626528

Objekt

Detta databasobjekt är en delmängd av data i databasobjektet object_with_object_properties. Varje rad som returneras innehåller objekt-ID för varje post. Det här databasobjektet returnerar endast befintliga poster. När en post raderas i HubSpot kommer den att tas 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 kommer den att tas bort från denna vy.

Detta databasobjekt kan vara användbart om ditt konto har en stor mängd data, vilket leder till att object_with_object_properties och objects_x-vyerna 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 och samtidigt behålla kontrollen över vilka egenskaper som returneras.

Det här databasobjektet kan returnera följande kolumner:

Kolumnens namn	Typ av kolumn	Beskrivning
`OBJECTTYPEID`	Varchar	ID för objekttypen (t.ex. kontakter är `0-1`).
`OBJECTID`	Nummer	Postens ID (t.ex. en kontaktpost med ID `123752`).
`INGESTEDAT`	Tidsstämpel	Datum och tid då data senast matades in av Snowflake. Läs mer om datatyper för kolumner.

Exempel 1

Hämta alla kontaktposter.

Frågar efter:

SELECT objectTypeId, objectId
FROM objects
WHERE objectTypeId = '0-1'

Returnerar:

OBJECTTYPEID	OBJECTID
0-1	36721864
0-1	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 ställts in för en viss post. En kontakt har t.ex. en rad för egenskapen First name och en rad för egenskapen Last name. Om en post inte har något värde för en egenskap kommer raden antingen att visas med en tom sträng eller inte visas alls.

Detta databasobjekt kan returnera följande kolumner:

Kolumnens namn	Typ av tjänst	Beskrivning
`OBJECTTYPEID`	Varchar	ID för objekttypen (t.ex. kontakter är `0-1`).
`OBJECTID`	Nummer	Postens ID (t.ex. en kontaktpost med ID `123752`).
`NAME`	Varkar	Namnet på egenskapen.
`VALUE`	Tidsstämpel	Egenskapens värde.
`UPDATEDAT`	Tidsstämpel	Datum och tid då posten senast uppdaterades i HubSpot. Läs mer om datatyper för kolumner.
`INGESTEDAT`	Tidsstämpel	Datum och tid då data senast hämtades in av Snowflake.

Exempel 1

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

Frågeställning:

SELECT objectTypeId, objectId, name, value
FROM object_properties
WHERE objectTypeId = '0-1'
AND name IN ('firstname', 'lastname', 'city')
ORDER BY objectId;

Returnerar:

OBJECTTYPEID	OBJECTID	NAMN	VÄRDE
0-1	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-syntaxen.

Frågeställning:

SELECT objectId, firstname, lastname, lifecyclestage
FROM
(
SELECT objectId, name, value
FROM object_properties
WHERE objectTypeId = '0-1'
AND name IN ('firstname', 'lastname', 'lifecyclestage')
)
PIVOT(MAX(value) FOR name IN ('firstname', 'lastname', 'lifecyclestage')) AS p(objectId, firstname, lastname, lifecyclestage);

Returnerar:

OBJECTTYPEID	OBJECTID	FÖRSTANAMN	SISTNAMN	LIVSCYKELSTADIUM
0-1	54325098	Hobbes	Baron	bly
0-1	96805401	Milo	Guld	bly
0-1	6922028	Henry	Riley	bly
...	...	...	...	...

object_properties_history

Det här databasobjektet innehåller historiska egenskapsvä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 UPDATEDAT-tidsstämpeln i egenskapens historik.

Detta databasobjekt kan returnera följande kolumner:

Kolumnens namn	Typ av kolumn	Beskrivning
`OBJECTTYPEID`	Varchar	ID för objekttypen (t.ex. kontakter är `0-1`).
`OBJECTID`	Nummer	Postens ID (t.ex. en kontaktpost med ID `123752`).
`NAME`	Varkar	Namnet på egenskapen.
`VALUE`	Tidsstämpel	Värdet för egenskapen.
`UPDATEDAT`	Tidsstämpel	Det datum och den tid då uppgifterna senast uppdaterades i HubSpot. Läs mer om datatyper för kolumner.
`INGESTEDAT`	Tidsstämpel	Det datum och den tid då data senast togs in av Snowflake.

Exempel 1

Hämta historiken för en enda fastighet för en enda kontakt.

Förfrågan:

SELECT objectId, name, value, updatedAt
FROM object_properties_history
WHERE objectTypeId = '0-1'
AND objectId = 136493192
AND name = 'hs_predictivescoringtier'
ORDER BY UPDATEDAT DESC;

Returnerar:

OBJECTID	NAMN	VÄRDE	UPPDATERAD
136493192	hs_prediktivescoringtier	tier_1	2022-06-22 22:45:05.931
136493192	hs_prediktivescoringtier	nivå_2	2021-09-18 08:20:56.622
136493192	hs_prediktivescoringtier	nivå_3	2019-11-31 18:20:22.851
...	...	...	...

Exempel 2

Hämta det aktuella namnet på alla kontakter som någonsin har haft ett livscykelstadium som Subscriber.

Frågeställning:

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

Returnerar:

OBJECTID	FÖRSTANAMN	SISTNAMN
54325098	Hobbes	Baron
96805401	Milo	Guld
6922028	Henry	Riley
...	...	...

Frågor om associationer

Precis som objektdata är associationsdata organiserade på två sätt:

Individuell: Varje associationstyp lagras i sin egen vy och innehåller endast poster av den typen. Exempelvis innehåller associations_contacts_to_deals endast associationsposter mellan kontakt- och avtalsobjekt. Detta eliminerar behovet av att ange ett associationstypeid när du ställer en fråga. Dessa vyer är ganska enkla att ställa frågor till 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 enkelt kan användas i joins med objects_x-vyer. Så länge du inte upplever långsamma frågor är det tillrådligt att använda dessa vyer för att hämta associationsdata. Se mer i associations_x_to_y-vyerna nedan.
Kombinerad: Alla poster för alla associationstyper kombineras till ett databasobjekt. När du ställer en fråga måste du därför ange ett filter som "WHERE combinedassociationtypeid='0-32' ". Se mer i associations och association_definitions nedan.

associationer_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 associations-databasobjektet och innehåller endast poster med ett specifikt combinedassociationtypeid.

Varje databasobjekt kommer att returnera följande kolumner:

Kolumnens namn	Typ av kolumn	Beskrivning
KOMBINERADASSOCIATIONSTYPID	Varkar	Den unika identifieraren för associationsdefinitionen.
ASSOCIATIONSKATEGORI	Varkar	Källan till associationstypen. En av följande: HUBSPOT_DEFINED, USER_DEFINED, INTEGRATOR_DEFINED
ASSOCIATIONTYPEID	Varkar	En unik identifierare för en associationsdefinition inom en specifik associationskategori, dvs. inga två definitioner i en associationskategori kommer att ha samma associationstypeid.
FRÅNOBJEKTTYPID	Varkar	Det objekttypeid som är källan till associationsdefinitionen.
FROMOBJECTTYPE	Varchar	Namnet på den objekttyp som är källan till associationsdefinitionen.
TOOBJECTTYPEID	Varchar	Det objekttypeid som är destinationen för associationsdefinitionen.
TOOBJECTTYPE	Varchar	Namnet på den objekttyp som är destination för associationsdefinitionen.
NAME	Varkar	Associationsdefinitionens namn.
LABEL	Varkar	Associationsdefinitionens beskrivning.
ISMAINASSOCIATIONDEFINITION	Boolean	Om associationsdefinitionen är huvudtypen. När true är sant är definitionen den som HubSpot visar på associerade poster
[FROMOBJECTTYPE_OBJECTID] t.ex. för vyn ASSOCIATIONS_CONTACTS_TO_DEALS kommer detta att vara CONTACT_OBJECTID	Antal	Objekt-ID för källobjektet.
[TOOBJECTTYPE_OBJECTID] t.ex. för vyn ASSOCIATIONS_CONTACTS_TO_DEALS kommer detta att vara DEAL_OBJECTID	Antal	Objekt-ID för destinationsobjektet.
INGESTEDAT	Tidsstämpel	Datum och tid då uppgifterna senast togs in av Snowflake.

Exempel 1

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

Förfrågan:

SELECT
kontakt_objektId, avtal_objektId

FROM associationer_kontakter_till_affärer

WHERE contactId = 6626541373

Returnerar:

KONTAKT_OBJEKTID	DEAL_OBJECTID
6626541373	233620335
6626541373	90253678

Exempel 2

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

SELECT contacts.property_firstname contact_firstname,

contacts.property_lastname contact_lastname,
contacts.property_email contact_email,
deals.property_dealtype deal_type, deals.property_amount deal_amount
FROM objects_contacts contacts
JOIN associations_contacts_to_deals assoc on
assoc.contact_objectid=contacts.objectid
JOIN objects_deals deals on deals.objectid=assoc.deal_objectid
where contacts.property_hs_timezone='america_slash_bogota'

KONTAKT_FÖRNAMN	KONTAKT_EFTERNAMN	KONTAKT_EMILJÖ	DEAL_TYPE	DEAL_AMOUNT
David	Magalhães	dmagalhaes@example.com	nya affärer	74848
Fernanda	Rodrigues	fmoreira@example.com	nya affärer	253530

Exempel 3

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

SELECT SUM(deals.property_hs_closed_amount) AS
total_closed_amount, contacts.property_email contact_email
FROM objects_contacts contacts
JOIN associations_contacts_to_deals assoc on
assoc.contact_objectid=contacts.objectid
JOIN objects_deals deals on deals.objectid=assoc.deal_objectid
GROUP BY contact_email
ORDER BY total_closed_amount DESC

Returnerar:

TOTALT_AVSLUTAT_BELOPP	KONTAKT_EMILJÖ
98474793	johndoe@riverview.com
849488	sallymae@longford.com

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 detta databasobjekt med associations-databasobjektet för att få postspecifik 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 true.

Detta databasobjekt kan returnera följande kolumner:

Kolumnens namn	Typ av kolumn	Beskrivning
`COMBINEDASSOCIATIONTYPEID`	Varchar	Den unika identifieraren för associationsdefinitionen.
`CATEGORY`	Varchar	Källan till associationstypen. En av: `HUBSPOT_DEFINED`, `USER_DEFINED`, `INTEGRATOR_DEFINED`
`ID`	Nummer	Identifieraren för associationsdefinitionen inom dess kategori.
`FROMOBJECTTYPEID`	Varchar	ID för det objekt som är källan till associationsdefinitionen.
`TOOBJECTTYPEID`	Varchar	ID för det objekt som är destinationsobjekt för associationsdefinitionen.
`NAME`	Varchar	Associationsdefinitionens namn.
`LABEL`	Varchar	Associationsdefinitionens etikett.
`ISMAINASSOCIATIONDEFINITION`	Boolean	Om associationsdefinitionen är huvudtypen. När true är sant är definitionen den som HubSpot visar på associerade poster.
`INGESTEDAT`	Tidsstämpel	Datum och tid då data senast togs in av Snowflake. Läs mer om datatyper för kolumner.

Exempel 1

Hämta de typer av associationer som finns tillgängliga i ditt konto.

Förfrågan:

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

Returnerar:

KOMBINERADASSOCIATIONSTYP	FRÅNOBJEKTTYPID	TILLOBJECTTYPEID	NAMN
0-1	0-1	0-2	KONTAKT_TILL_FÖRETAG
0-2	0-2	0-1	FÖRETAG_TILL_KONTAKT
0-3	0-3	0-1	AVTAL_TILL_KONTAKT
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 de tillgängliga associationstyperna mellan affärer och företag.

Fråga:

SELECTcombinedAssociationTypeId, fromObjectTypeId, toObjectTypeId, name
FROM association_definitions
WHERE fromObjectTypeId = '0-3' AND toObjectTypeId = '0-2' AND isMainAssociationDefinition = true
ORDER BY category, id

Returnerar:

KOMBINERAD ASSOCIERINGSTYP	FRÅNOBJEKTTYPID	TOOBJECTTYPEID	NAMN
0-5	0-3	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

Det här databasobjektet 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 det här databasobjektet även om de refererade posterna har tagits bort. Du kan kontrollera om posterna finns genom att göra en join med tabellen objects.

Det här databasobjektet kan vara användbart om ditt konto har en stor mängd data, vilket leder till att associations_x_to_y-vyer fungerar långsamt.

Det här databasobjektet kan returnera följande kolumner:

Kolumnens namn	Typ av kolumn	Beskrivning
`COMBINEDASSOCIATIONTYPEID`	Varchar	Den unika identifieraren för associationsdefinitionen.
`FROMOBJECTID`	Nummer	ID för källobjektet.
`TOOBJECTID`	Nummer	ID för destinationsobjektet.
`INGESTEDAT`	Tidsstämpel	Datum och tid då data senast togs in av Snowflake. Läs mer om datatyper för kolumner.

Exempel 1

Hämta alla associerade erbjudanden och kontakter.

Frågeställning:

SELECT combinedAssociationTypeId, fromObjectId, toObjectId
FROM associations
WHERE combinedAssociationTypeId = '0-5'

Returnerar:

KOMBINERADASSOCIATIONSTYPID	FRÅNOBJECTID	TILLOBJECTID
0-5	6626541373	233620335
0-5	6616436082	3866015468
0-5	6690805943	7132752747
...	...	...

Exempel 2

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

Frågeställning:

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

Returnerar:

KOMBINERAD ASSOCIATIONSTYP	FRÅNOBJECTID	TILLOBJECTID
0-5	6626541373	233620335

Exempel 3

Hämta alla avtal som är kopplade till en viss kontakt (kontakt-ID: 4464). Istället för hårdkodning av combinedAssociationTypeId, ansluter detta exempel till association_definitions.

Frågeställning:

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

Returnerar:

KOMBINERAD FÖRENINGSTYPID	FROMOBJECTID	TOOBJECTID
0-5	6626541373	233620335

Förfrågningar om ägare

Ägare

Detta databasobjekt innehåller information om användarna i ditt HubSpot-konto. Användare kan anges som ägare till poster 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:

Kolumnens namn	Typ av tjänst	Beskrivning
`OWNERID`	Nummer	Användarens ägar-ID.
`USERID`	Nummer	Användarens användar-ID. Användare med NULL i denna kolumn har tagits bort.
`EMAIL`	Varchar	Användarens e-postadress.
`FIRSTNAME`	Varchar	Användarens förnamn.
`LASTNAME`	Varchar	Användarens efternamn.
`ARCHIVED`	Boolean	Om användaren har tagits bort.
`CREATEDAT`	Tidsstämpel	Datum och tid då användaren skapades i HubSpot. Se kolumndatatyper för mer information.
`UPDATEDAT`	Tidsstämpel	Datum och tid då användaren senast uppdaterades i HubSpot. Se kolumndatatyper för mer information.
`INGESTEDAT`	Tidsstämpel	Det datum och den tid då data senast hämtades av Snowflake.

Exempel 1

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

Förfrågan:

SELECT ownerId, userId, email, firstname, lastname FROM owners WHERE archived = false

Returnerar:

ÄGAREID	ANVÄNDARID	E-POST	FÖRNAMN	SISTNAMN
29584574	4621126	233620335	Hobbes	Baron
30532717	4874784	3866015468	Pablo	Walters
30580321	925511	7132752747	Milo	Guld
...	...	...	...	...

Exempel 2

Hämta en specifik ägare via dennes ägar-ID.

Fråga:

SELECT ownerId, userId, email, firstname, lastname
FROM owners
WHERE ownerId = 29584574;

Returnerar:

ÄGAREID	ANVÄNDARID	EMAIL	FÖRNAMN	SISTNAMN
29584574	4621126	233620335	Hobbes	Baron

Exempel 3

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

SELECT contact.objectId contactid, contact.property_firstname contact_firstname, contact.property_lastname contact_lastname, contact.property_hubspot_owner_id contact_hubspot_owner_id, owner.firstname owner_firstname, owner.lastname owner_lastname, owner.email owner_email FROM objects_contacts contact

JOIN owners owner ON contact.property_hubspot_owner_id = owner.ownerId

Returnerar:

KONTAKTTID	KONTAKT_FÖRNAMN	KONTAKT_EFTERNAMN	KONTAKT_HUBSPOT_ÄGAR_ID	ÄGARE_FÖRNAMN	ÄGARE_SAMNAMN	ÄGARE_EMIL
113834202	Richard	Greenfield	29584574	Hobbes	Baron	hobbes.b@business.com
53540801	Ford	Karl	30241125	Milo	Guld	milo.g@business.com
...	...	...	...	...	...	...

Team-frågor

Team

Med team i HubSpot kan du organisera dina användare i grupper för organisations- och rapporteringsändamål. Du kan ha ett huvudteam och extra team.

Detta databasobjekt innehåller information om de team som finns i ditt HubSpot-konto.

Det här databasobjektet kan returnera följande kolumner:

Kolumnens namn	Typ av kolumn	Beskrivning
TEAMID	Nummer	Lagets ID.
TEAMNAME	Varchar	Teamets namn.
PARENTTEAMID	Nummer	Team-ID för föräldrateamet.
BARNTEAMIDS	Array	Team-ID för de underordnade teamen.
PRIMÄRA ÄGARMEDLEMMAR	Varchar	Ägar-ID för teamets primära medlemmar.
SEKUNDÄRA ÄGARMEDLEMMAR	Boolean	Ägar-ID för teamets sekundära medlemmar.
INGESTEDAT	Tidsstämpel	Datum och tid för när Snowflake senast tog in data.

Exempel 1

Hämta alla team.

Förfrågan:

SELECT teamId,teamName, primaryOwnerMembers

FRÅN team

Returnerar:

TEAMID	TEAMNAMN	PRIMÄRA ÄGARE MEDLEMMAR
29584574	Underteam	[233620335, 1234553]
30532717	Super Team	[3866015468, 126221873]
3058032	A Team	[7132752747]

ägare_team

Detta databasobjekt innehåller information om vilka ägare som motsvarar vilka team i ditt HubSpot-konto.

Det här databasobjektet kan returnera följande kolumner:

Kolumnens namn	Typ av kolumn	Beskrivning
TEAMID	Nummer	Teamets ID.
ÄGAREID	Nummer	Användarens ägar-ID.
ISTEAMPRIMARY	Booleansk	Om det här teamet är det primära teamet för den här ägaren.
INGESTEDAT	Tidsstämpel	Datum och tid för när Snowflake senast tog in data.

Exempel 1

Hämta alla ägare för ett visst team.

Förfrågan:

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

Returnerar

TEAMID	TEAMNAME	ISTEAMPRIMARY
29584574	233620335	SANT
29584574	1234553	SANT

Frågor om pipeline

Nedan beskrivs hur du ställer frågor om pipelinedata för avtal och biljetter, t.ex. tillgängliga pipelines i ditt konto och deras stadier.

Du kan koppla dessa data till objektdata för att få en fullständig vy över dina pipelines. Du kan till exempel ställa frågor om erbjudanden och deras pipelines genom att koppla samman data från objects_deals_view eller object_with_object_properties med pipelinedata.

Pipelines

Det här databasobjektet innehåller information om pipelines för avtal och biljetter i ditt konto. Varje rad som returneras representerar en enskild pipeline.

Den här tabellen kan returnera följande kolumner:

Kolumnens namn	Typ av kolumn	Beskrivning
`PIPELINEID`	Varchar	Rörledningens ID.
`OBJECTTYPEID`	Varkar	ID för det objekt som pipelinen kan innehålla (t.ex. erbjudanden eller biljetter).
`LABEL`	Varkar	Pipelinens namn i HubSpot.
`DISPLAYORDER`	Nummer	Den ordning i vilken pipelinen visas i HubSpot.
`ARCHIVED`	Boolean	Om pipelinen har tagits bort.
`CREATEDAT`	Tidsstämpel	När pipelinen skapades.
`UPDATEDAT`	Tidsstämpel	Det datum och den tid då data senast uppdaterades i HubSpot. Läs mer om datatyper för kolumner.
`INGESTEDAT`	Tidsstämpel	Det datum och den tid då data senast togs in av Snowflake.

Exempel 1

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

Förfrågan:

SELECT objectTypeId, pipelineId, label
FROM pipelines
WHERE objectTypeId = '0-3'AND not archived
ORDER BY displayorder;

Returnerar:

OBJECTTYPEID	PIPELINEID	LABEL
0-3	1bed503c-37f7-4f51-9d40-7598902673f4	Försäljningspipeline
0-3	12659678	Licenser Pipeline
0-3	75e28846-ad0d-4be2-a027-5e1da6590b98	Ny verksamhet
...	...	...

Exempel 2

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

Frågar efter:

SELECT

deals.objectId deal_id, deals.property_dealname deal_name, pipelines.label pipeline_name FROM objects_deals deals INNER JOIN pipelines ON deals.objectTypeId = pipelines.objectTypeId AND deals.property_pipeline = pipelines.pipelineid WHERE pipelines.objectTypeId = '0-3';

Returnerar:

DEAL_ID	DEAL_NAME	PIPELINE_NAME
605140072	Meowmix Global registrering	Försäljningspipeline
605457408	Friskies nytt varumärke	Försäljningspipeline
604362473	Fresh Step App Build	Försäljningspipeline

Exempel 3

Samma sak som i exempel 2 ovan, hämta erbjudanden inom en specifik pipeline. Men istället för att använda objects_deals i joins, använd object_with_object_properties.

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

Returnerar:

DEAL_ID	DEAL_NAME	PIPELINE_NAME
605140072	Meowmix Global registrering	Försäljningspipeline
605457408	Friskies nytt varumärke	Försäljningspipeline
604362473	Fresh Step App Build	Försäljningspipeline

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 sammanfogar med pipelines använder du objekttyp-ID och pipeline-ID.

Detta databasobjekt kan returnera följande kolumner:

Kolumnens namn	Typ av kolumn	Beskrivning
`PIPELINEID`	Varchar	Pipelines ID.
`STAGEID`	Varchar	Etappens ID.
`LABEL`	Varchar	Etappens namn i HubSpot.
`DISPLAYORDER`	Nummer	Den ordning i vilken pipelinen visas i HubSpot.
`METADATA`	Variant	En JSON-formaterad beskrivning av etappen, inklusive om den är öppen eller stängd
`ARCHIVED`	Booleansk	Om pipeline-etappen har tagits bort.
`CREATEDAT`	Tidsstämpel	När rörledningsetappen skapades.

Exempel 1

Hämta pipelinefaser för en affärspipeline med namnet Försäljningspipeline.

Förfrågan:

SELECT pipelineid, stageId, label
FROM pipeline_stages
WHERE not archived
AND pipelineid = (
SELECT pipelineid
FROM pipelines
WHERE objectTypeId = '0-3'
AND not archived
AND label = 'Sales Pipeline' LIMIT 1)
ORDER BY displayorder;

Returnerar:

PIPELINEID	STEGID	ETIKETT
941650	941651	Kontakad
941650	941652	Tidsbestämt möte
941650	941653	Faktura skickad
...	...	...

Exempel 2

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

Fråga:

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

Returnerar:

DEAL_ID	DEAL_NAME	PIPELINE_NAME	PIPELINE_STAGE_NAME
605140072	Meowmix Global registrering	Försäljningspipeline	Kontrakt skickat
605457408	Friskies nytt varumärke	Försäljningspipeline	Möte planerat
604362473	Fresh Step App Build	Försäljningspipeline	Kontrakt undertecknat
...	...	...	...

Frågor om egenskaper

egenskap_definitioner

Detta databasobjekt innehåller information om objekt- och händelseegenskaper i ditt HubSpot-konto. Händelseegenskaper inkluderar standardhändelser, t.ex. öppningar och klick på e-postmeddelanden, och anpassade beteendemässiga händelse egenskaper. 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:

Kolumnens namn	Typ av kolumn	Beskrivning
`OBJECTYPEID`	Varchar	ID för det objekt som händelsen avser.
`NAME`	Varkar	Egenskapens interna namn.
`LABEL`	Varkar	Egenskapens etikett.
`DESCRIPTION`	Varchar	Egenskapens beskrivning.
`TYPE`	Varchar	Egenskapens typ (t.ex. sträng, nummer, datetime).
`FIELDTYPE`	Varchar	Egenskapens fälttyp. Definierar hur egenskapen visas i HubSpot och på formulär (t.ex. kryssruta, välj).
`DISPLAYORDER`	Nummer	Egenskapens visningsordning.
`GROUPNAME`	Varchar	Egenskapens gruppnamn.
`OPTIONS`	Variant	För uppräkningsegenskaper, en array av egenskapens alternativ, inklusive varje alternativs attribut (t.ex. visningsordning, etikett).
`CREATEDUSERID`	Nummer	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`	Booleskt	Om egenskapens alternativ är definierade i ett externt system.
`HASUNIQUEVALUE`	Boolean	Om egenskapens värden är unika. Kan endast anges när en egenskap skapas via API:et.
`HIDDEN`	Boolesk	Om egenskapen är dold i HubSpot.
`SHOWCURRENCYSYMBOL`	Boolean (Boolesk)	Om ett värde för en talegenskap formateras som en valuta.
`FORMFIELD`	Boolesk	Om den här egenskapen 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`	Boolean	Om egenskapen skapades av HubSpot, eller om den skapades av en användare.
`ARCHIVED`	Boolesk	Om egenskapen har tagits bort.
`CREATEDAT`	Tidsstämpel	Datum och tid då objektet skapades i HubSpot.
`UPDATEDAT`	Tidsstämpel	Det datum och den tid då data senast uppdaterades i HubSpot. Läs mer om datatyper för kolumner.
`INGESTEDAT`	Tidsstämpel	Det datum och den tid då data senast togs in av Snowflake.

Exempel 1

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

Förfrågan:

SELECT name, label, description
FROM property_definitions
WHERE objectTypeId = '0-1'

Returnerar:

NAMN	ETIKETT	BESKRIVNING
angiven_sql_stadium	Påbörjat SQL-stadium	Starta räkningen av dagar i SQL-stadiet.
första_konvertering_händelsens_namn	Första omvandlingen	Det första formuläret som den här kontakten skickade in.
adress	Gatuadress	Kontaktens adress.

Händelsefrågor

Händelser inkluderar standard HubSpot-händelser och anpassade beteendehändelser. Varje händelse har sitt eget databasobjekt, märkt som events_eventname.

namn
HÄNDELSER_ANNONS_INTERAKTION	Detaljer om en annons och kontakter som interagerade med den genom att klicka på annonsen eller skicka in ett formulär efter att ha interagerat med den.
EVENTS_AD_METRICS_IMPORTED_V0	Information om en annons och dess prestationsmått.
HÄNDELSER_SAMTAL_OMNÄMNDA_NYCKELORD	Information om nyckelord som nämnts av deltagare i samtal.
EVENTS_CLICKED_LINK_IN_EMAIL_V2	Länkar som kontakter har klickat på i marknadsföringsmeddelanden.
EVENTS_CLICKED_LINK_IN_TRACKED_INBOX_EMAIL_V8	Länkar som kontakter har klickat på i e-postmeddelanden från Conversations Inbox.
HÄNDELSER_COOKIE_BANNER_KLICKADE	Kontakter som klickade på cookies.
HÄNDELSER_COOKIE_BANNER_VISAD	Kontakter som tittade på 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 tittat på 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 levererats till mottagarna av HubSpots e-postservrar.
EVENTS_MTA_BOUNCED_EMAIL_V2	Försök till leverans av e-post som avvisades av mottagarens e-postserver.
EVENTS_OPENED_EMAIL_V2	Öppnade e-postmeddelanden av kontakter.
HÄNDELSER_RAPPORTERAD_SPAM_EMAIL_V2	E-postmeddelanden som markerats som skräppost av mottagare.
HÄNDELSER_UPPDATERAD_EPOST_PRENUMERATION_STATUS_V2	Ändringar av mottagares e-postprenumerationer.
HÄNDELSER_ÖPPNADE_SPÅRADE_INBOX_E-POSTMEDDELANDEN_V8	Öppningar av e-postmeddelanden i Conservations Inbox av kontakter.
EVENTS_MB_MEDIA_PLAYED	Videouppspelningsaktivitet av kontakter.
EVENTS_V2_CONTACT_BOOKED_MEETING_THROUGH_SEQUENCE	Kontakten bokade ett möte genom en sekvens.
EVENTS_V2_CONTACT_ENROLLED_IN_SEQUENCE	Kontakten anmälde sig från sekvensen.
EVENTS_V2_KONTAKT_AVSLUTAD_SEKVENS	Sekvensen är avslutad.
EVENTS_V2_CONTACT_REPLIED_SEQUENCE_EMAIL	Kontakten svarade på e-post (eller inkommande e-post som avregistrerade sekvensen) som skickats via sekvensen.
EVENTS_V2_CONTACT_UNENROLLED_FROM_SEQUENCE	Kontakten avregistrerades från sekvensen.
EVENTS_V2_CONTACT_UNENROLLED_MANUALLY_FROM_SEQUENCE	Användaren avregistrerade kontakten manuellt.
EVENTS_V2_CONTACT_UNSUBSCRIBED_SEQUENCE_EMAIL	Kontakten avanmälde sig, vilket avregistrerade sekvensen.
EVENTS_V2_SEQUENCE_EMAIL_BOUNCED	E-postmeddelandet för sekvensen studsade.
EVENTS_V2_SEQUENCE_ERRORED	Fel i sekvensen som orsakar avregistrering.
EVENTS_V2_SEQUENCE_STEP_EXECUTED	Sekvenssteget har utförts.
HÄNDELSER_BESÖKT_SIDA	Besök på webbplatsens sida av kontakter.
EVENTS_<INTEGRATION_EVENT_NAME>_<UNIQUE_IDENTIFIER>	Integrationshändelser(API för Timeline V3)

Du kan identifiera händelser genom att kombinera deras ID för händelsetyp 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 eventtabeller och vyer:

occurredat
occurredatdateint

Dessa kolumner kommer att ersätta kolumnerna occuredat och occuredatdateint den 24 november 2022. På det datumet kommer de gamla kolumnerna inte längre att vara tillgängliga, och försök att fråga ett databasobjekt eller en vy som innehåller händelser som använder dessa kolumner kommer att misslyckas. Läs mer om ändringar för Snowflake-datadelar.

Namn i kolumn	Typ av kolumn	Beskrivning
`EVENTTYPEID`	Varchar	ID för händelsetypen, liknande OBJECTTYPEID Du kan fråga efter alla ID:n för händelsetyper 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 kommer att ha samma ID inom en viss händelsetyp.
`OBJECTTYPEID`	Varkar	Den typ av objekt som slutförde händelsen. Till exempel skulle ett klick på en e-postlänk visa `0-1` i den här kolumnen, vilket representerar kontaktobjektet.
`OBJECTID`	Nummer	ID för den post som slutförde händelsen.
`OCCURREDAT`	Tidsstämpel	När händelsen inträffade.
`OCCURREDATDATEINT`	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 klusternyckeln i tabellen. I de flesta fall kan du använda tidsstämpeln för `OCCURREDAT` i stället för det här numret.
`OCCUREDATDATEINT`	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 klusternyckeln i tabellen. I de flesta fall kan du använda tidsstämpeln `OCCURREDAT` i stället för det här numret. Observera: den här kolumnen kommer att tas bort den 24 november 2022 och ersättas med `OCCURREDATDATEINT`.
`OCCUREDAT`	Tidsstämpel	När händelsen inträffade. Observera: denna kolumn kommer att tas bort den 24 november 2022 och ersättas med `OCCURREDAT`.
`INGESTEDAT`	Tidsstämpel	Datum och tid då data senast matades in av Snowflake. Läs mer om datatyper för kolumner.
`PROPERTY_*`	Varchar	Enskilda kolumner som innehåller händelseegenskaperna.

Exempel 1

Hämta de 50 senaste klickhändelserna för e-post.

Frågeställning:

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

Returnerar:

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

Exempel 2

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

Frågeställning:

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

Returnerar:

KLICK_TIDSSTÄMPEL	CLICK_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	Guld
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

objekt_och_händelsetyp_definitioner

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

Det här databasobjektet kan returnera följande kolumner:

Kolumnens namn	Typ av kolumn	Beskrivning
`OBJECTTYPEID`	Varchar	ID för det objekt som pipelinen kan innehålla (t.ex. erbjudanden eller biljetter).
`FULLYQUALIFIEDNAME`	Varkar	Namnet på objektet eller händelsen.
`INGESTEDAT`	Tidsstämpel	Datum och tid då data senast togs in av Snowflake. Läs mer om datatyper för kolumner.

Exempel 1

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

Förfrågan:

SELECT objectTypeId, fullyQualifiedName
FROM object_and_event_type_definitions;

Returnerar:

OBJECTTYPEID	FULLSTÄNDIGT KVALIFICERAT NAMN
0-1	KONTAKT
0-8	LINJE_ITEM
0-11	KONVERSATION
...	...

Förfrågningar om segment

Nedan beskrivs hur du söker efter dina segment, t.ex. tillgängliga kontakt- och företagssegment och de poster som ingår i dessa segment.

Segment

Detta databasobjekt innehåller information om HubSpots kontakt- och företagssegment. Returnerar en rad per segment och kolumnerna innehåller segmentdetaljer som segmentnamn, storlek och objekttyp för de poster som det innehåller. Innehåller inte information om de enskilda posterna inom varje segment (se segment_membership).

Detta databasobjekt kan returnera följande kolumner:

Kolumnens namn	Typ av kolumn	Beskrivning
`OBJECTTYPEID`	Varchar	Typ av poster i segmentet (t.ex. kontakt eller företag).
`SEGMENTID`	Nummer	ID för segmentet. Kopplar till kolumnen SEGMENTID i tabellen segment-memberships.
`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	Namnet på segmentet.
`SIZE`	Number (antal)	Antalet poster i segmentet.
`CREATEDBYUSERID`	Nummer	ID för den användare som skapade segmentet.
`CREATEDAT`	Tidsstämpel	När segmentet skapades i HubSpot.
`UPDATEDBYUSERID`	Nummer	ID för den användare som senast uppdaterade segmentet.
`UPDATEDAT`	Tidsstämpel	Datum och tid då datumet senast uppdaterades i HubSpot. Läs mer om datatyper för kolumner.
`INGESTEDAT`	Tidsstämpel	Det datum och den tid då data senast togs in av Snowflake.

Exempel 1

Hämta alla kontaktsegment.

Frågeställning:

SELECT segmentId, name, size
FROM segments
WHERE objectTypeId = '0-1';

Returnerar:

SEGMENTSID	NAMN	STORLEK
118131	Uppsökande verksamhet varje vecka	103
66156	Bloggprenumeranter	455
771852	Bästa prenumeranter 2021	37
...	...	...

Exempel 2

Hämta ett specifikt kontaktsegment med namnet Top subscribers 2021.

Fråga:

SELECT segmentId, name, size
FROM segments
WHERE objectTypeId = '0-1' ANDsegmentName = 'Top subscribers 2021';

Returnerar:

SEGMENTID	NAMN	STORLEK
771852	Bästa abonnenter 2021	37

segment_membership

Det här databasobjektet innehåller information om vilka poster som är medlemmar i vilka segment, med en rad per post i segmentet. Om du t.ex. har ett segment Blog subscribers med 500 kontakter kommer databasobjektet att returnera 500 rader.

Innehåller endast segment-ID:n och objekt-ID:n. Mer information finns i databasobjektet segments.

Det här databasobjektet kan returnera följande kolumner:

Kolumnens namn	Typ av kolumn	Beskrivning
`SEGMENTID`	Varchar	ID för segmentet. Kopplar till kolumnen HS_SEGMENT_ID i tabellen segments.
`OBJECTID`	Varchar	ID för posten i segmentet.
`UPDATEDAT`	Tidsstämpel	Datum och tid då data senast uppdaterades i HubSpot. Läs mer om datatyper för kolumner.
`INGESTEDAT`	Tidsstämpel	Det datum och den tid då data senast togs in av Snowflake.

Exempel 1

Hämta ID:n för alla kontakter i segmentet Top subscribers 2021.

Förfrågan:

SELECT objectId
FROM segment_memberships
INNER JOIN segments
ON segment_memberships.segmentId = segments.segmentId
WHERE segments.objectTypeId = '0-1'
AND segments.name = 'Top Subscribers 2021';

Returnerar:

OBJECTID

54325098

96805401

6922028

...

Exempel 2

Hämta för- och efternamn på detaljer om kontakter i segmentet Toppabonnenter 2021.

Frågeställning:

SELECT

contact.objectId AS objectid, contact.property_firstname AS firstname, contact.property_lastname AS lastname FROM objects_contacts contact INNER JOIN segment_memberships ON contact.objectId = segment_memberships.objectId INNER JOIN segments ON segments_memberships.segmentId = segments.segmentId WHERE segments.objectTypeId = '0-1' AND segments.name = 'Top Subscribers 2021'

Returnerar:

OBJECTID	FÖRNAMN	EFTERNAMN
54325098	Hobbes	Baron
96805401	Milo	Guld
6922028	Henry	Riley
...	...	...

Vanliga frågor

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

Generellt sett bör du titta på kolumnerna i den rapport du jämför med. Om rapportvisualiseringen 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 objekttypsegenskap som en kolumn motsvarar. Det kan du göra genom att fråga property_definitions:

SELECT * FROM property_definitions

WHERE label = [column_name]

Det kanske inte alltid finns 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 fuzzy-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 man ska fråga. Du kan helt enkelt söka efter den object_x-vy som motsvarar typen.

Hur länkar 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 ASSOCIATIONS_CAMPAIGNS_TO_FORMS om du vill veta alla formulär som en kampanj är länkad till:

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

Hur vet jag statusen för integrationen mellan HubSpot och Snowflake?

För att få statusuppdateringar i realtid om avbrott och problem för HubSpot-Snowflake-integrationen, fråga vyn data_share_status:

SELECT * FROM hubspot.public.data_share_status LIMIT 1

Resultaten kommer att visas som:

STATUS	MEDDELANDE	UPPDATERADAT
OK	INGEN KÄND INCIDENT FÖR TILLFÄLLET	2023-04-10 09:21:20.123

Den här vyn ger uppdateringar om integrationsstatusen i omvänd kronologisk ordning. Genom att integrera resultaten av den här frågan i en instrumentpanel kan du följa integrationens prestanda och upptäcka eventuella driftstopp eller avbrott.

Hjälpte artikeln?

Detta formulär används endast för dokumentationsfeedback. Få reda på hur du får hjälp med HubSpot.

Fråga efter HubSpot-data i Snowflake

Tillgänglig med något av följande abonnemang, om inte annat anges:

Datalagring och din Snowflake-kontoregion

Konfigurera din Snowflake-miljö

Dataöversikt

Begränsa och beställa returnerade data

Datatyper för kolumner

Omvandling av datatyper

Objektförfrågningar

objects_x-vyer

Exempel 1

Exempel 2

Exempel 3

objekt_med_objekt_egenskaper

Exempel 1

Exempel 2

Objekt

Exempel 1

object_properties

Exempel 1

Exempel 2

object_properties_history

Exempel 1

Exempel 2

Frågor om associationer

associationer_x_to_y-vyer

Exempel 1

Exempel 2

Exempel 3

association_definitioner

Exempel 1

Exempel 2

Associationer

Exempel 1

Exempel 2

Exempel 3

Förfrågningar om ägare

Ägare

Exempel 1

Exempel 2

Exempel 3

Team-frågor

Team

Exempel 1

ägare_team

Exempel 1

Frågor om pipeline

Pipelines

Exempel 1

Exempel 2

Exempel 3

pipeline_stages

Exempel 1

Exempel 2

Frågor om egenskaper

egenskap_definitioner

Exempel 1

Händelsefrågor

Exempel 1

Exempel 2

Object_and_event_type_queries

objekt_och_händelsetyp_definitioner

Exempel 1

Förfrågningar om segment

Segment

Exempel 1

Exempel 2

segment_membership

Exempel 1

Exempel 2

Vanliga frågor

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

Hur länkar jag den här datatypen till en annan, t.ex. hur hämtar jag formulär för en kampanj?

Hur vet jag statusen för integrationen mellan HubSpot och Snowflake?

Relaterat innehåll