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: oktober 5, 2022

Gäller för:

Operations Hub Enterprise

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

Snowflake-regionen för ditt konto bestämmer hur ofta dina HubSpot-data uppdateras. Om din Snowflake-kontoregion matchar regionen för HubSpot Snowflake-kontot (för HubSpot-konton i datacentret i EU betyder det EU_CENTRAL_1_AWS, för alla andra HubSpot-konton betyder det US_EAST_1_AWS) uppdateras dina data upp till var 15:e minut.

Du får tillgång till V2_LIVE-schemat som uppdateras var 15:e minut och V2_DAILY-schemat som uppdateras varje dag. Om din HubSpot-kontoregion och Snowflake-region inte stämmer överens har du annars bara tillgång till 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.

Välj 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:

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:

SELECT objectTypeId, property_createddate
FROM hubspot_share_name.V2_LIVE.objects_deals

LIMIT 1

Ö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.
Föreningar: alla tillgängliga associationstyper och för närvarande associerade poster.
Evenemang: Händelsedata för både standardhändelser i HubSpot, t.ex. öppning av e-postmeddelanden, och anpassade beteendehändelser.
Listor: HubSpot-listor över kontakter och företag.
Ä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 med att 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:

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

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.

snowflake-sidebar-view-column-details0

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. Till exempel lagras egenskaper för en objektregistrering som VARCHAR-datatyper i de flesta databasobjekt, men ibland innehåller de värden för antal och datumtid. 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 efter 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 objektsdata. 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:

Objektnamn	ObjectTypeId
Kontakter	0-1
Företag	0-2
Poster	0-8

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 den plural formbeteckning för objekttypen.(Observera att om objekttypen inte har någon pluralform kommer <objekttypnamn> helt enkelt att vara den singulära formen av objekttypens namn, sammanfogad med "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:

HubSpot Objekttyp	ObjectTypeId	Beskrivning
KONTAKT	0-1	Information om personer som interagerar med ditt företag
FÖRETAG	0-2	Information om enskilda företag eller organisationer
DEAL	0-3	Information om intäktsmöjligheter med en kontakt eller ett företag.
BILJETT	0-5	Svara för kundernas förfrågningar om hjälp eller stöd.
QUOTE	0-14	Används för att dela prisinformation med potentiella köpare.
FORM_SUBMISSION	0-15	Information om enskilda inlämningar för ett HubSpot-formulär.
LINE_ITEM	0-8	Representera en delmängd av de produkter som säljs i en affär. När en produkt kopplas till en affär blir den en post.
KONVERSATION	0-11	Detaljer om inkommande meddelanden från flera kanaler.
LANDING_PAGE	0-25	Uppgifter om dina landningssidor
UPPGIFT	0-27	Lagrar information om att göra-listor
FORM	0-28	Används för att samla in information om dina besökare och kontakter.
MARKETING_EMAIL	0-29	Uppgifter om e-postmeddelanden från marknadsföringscentralen
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	0-33	Information om enskilda annonser
KAMPANJ	0-35	Information om relaterade marknadsföringstillgångar och innehåll, så att du enkelt kan mäta hur effektiva dina gemensamma marknadsföringsinsatser är.
SITE_PAGE	0-38	Uppgifter om enskilda sidor på dina webbplatser
BLOG_POST	0-39	Uppgifter om blogginlägg
OBJECT LISTA	0-45	Information om grupperingar av objektposter baserat på deras egenskaper eller aktiviteter.
CALL	0-48	Samtal från 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 importeras till Hubspot
SEQUENCE	0-58	En sekvens är en serie målinriktade, tidsbestämda e-postmallar för att vårda kontakter över tid.
DEAL_SPLIT	0-72	Affärsuppdelningar används för att dela upp affärskredit mellan flera användare.
SALES_DOCUMENT	0-83	Försäljningsdokument bygger upp ett innehållsbibliotek där hela teamet kan ladda upp och dela dokument med dina kontakter.
FEEDBACK_SUBMISSION	0-19	Lagrar information som lämnats i en feedbackundersökning.
ABONNEMANG	0-69	Prenumerationer innehåller uppgifter om återkommande betalningar.
BETALNING FÖR HANDEL	0-101	Innehåller uppgifter om medel som samlats in från kunder.

Varje databasobjekt returnerar följande kolumner:

Namn på kolumnen	Typ	Beskrivning
OBJECTTYPEID	Varchar	ID för objekttypen (t.ex. kontakter är 0-1).
OBJECTID	Antal	Postens ID (t.ex. en kontaktpost med ID 123752).
UPDATEDAT	Tidsstämpel	Datum och tid då det här objektet senast uppdaterades i HubSpot.
INGESTEDAT	Tidsstämpel	Datum och tid då uppgifterna senast togs in av Snowflake.
PROPERTY_*	Varchar	Enskilda kolumner som innehåller den senaste versionen av objektets egenskaper.För varje objektegenskap som har datum- eller taltyp (enligt specifikation i Egendomsdefinitioner), kommer det att finnas två kolumner: En kolumn som innehåller egenskapsvärdet i form av en sträng. Kolumnnamnet blir property_unparsed_[name] . Exempelvis kommer egenskapen DEAL object property, deal_amount att ha kolumnen property_unparsed_deal_amount. En kolumn som innehåller värdet som konverterats till den ursprungliga typen. Kolumnen kommer att ha namnet property_[name].Exempelvis kommer DEAL object property, deal_amount att ha kolumnen property_deal_amount. Observera att den här kolumnen kommer att innehålla noll om konverteringen till den ursprungliga typen 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ÖRNAMN	LASTNAME	LIVSCYKELSTADIUM
54325098	Hobbes	Baron	bly
96805401	Milo	Guld	bly
6922028	Henry	Riley	bly

Exempel 2

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

Förfrågan:

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

Returnerar:

OBJECTID	PROPERTY_DEALNAME	EGENDOM_DEALSTAGE	PROPERTY_DEALAMOUNT
38960439	Namn på affären 1	stängdvunnit	34199
321740651	Test Deal 123	14845019	8383663
98392101	Pop-Up skärmtak	stängdvunnit	9309007

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:

OBJECTID	PROPERTY_DEALNAME	EGENDOM_DEALSTAGE	PROPERTY_DEALAMOUNT
98392101	Pop-Up skärmtak	stängdvunnit	9309007
321740651	Test Deal 123	14845019	8383663
38960439	Namn på affären 1	stängdvunnit	34199

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:

Namn på kolumnen	Typ	Beskrivning
`OBJECTTYPEID`	Varchar	ID för objekttypen (t.ex. kontakter är `0-1`).
`OBJECTID`	Antal	Postens ID ( t.ex. en kontaktpost med ID `123752`).
`EGENSKAPER`	Variant	Registrets fastighetsvärden.
`UPDATEDAT`	Tidsstämpel	Datum och tid då posten senast uppdaterades i HubSpot. Läs mer om kolumndatatyper.
`INGESTEDAT`	Tidsstämpel	Datum och tid då uppgifterna senast När uppgifterna senast togs in av Snowflake.

Exempel 1

Hämta alla kontakter och deras egenskaper.

Fråga:

SELECT objectTypeId, objectId, egenskaper
FROM object_with_object_properties
WHERE objectTypeId = "0-1

Returnerar:

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

Exempel 2

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

Fråga:

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ären 1	closedlost	7488939
321740651	Namn på affären 1	stängdvunnit	9292029
98392101	Namn på affären 1	closedlost	62626528

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

Namn på kolumnen	Typ	Beskrivning
`OBJECTTYPEID`	Varchar	ID för objekttypen (t.ex. kontakter är `0-1`).
`OBJECTID`	Antal	Postens ID ( t.ex. en kontaktpost med ID `123752`).
`INGESTEDAT`	Tidsstämpel	Datum och tid då uppgifterna senast togs in av Snowflake. Läs mer om kolumndatatyper.

Exempel 1

Hämta alla kontaktuppgifter.

Fråga:

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

Returnerar:

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

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:

Namn på kolumnen	Typ	Beskrivning
`OBJECTTYPEID`	Varchar	ID för objekttypen (t.ex. kontakter är `0-1`).
`OBJECTID`	Antal	Postens ID ( t.ex. en kontaktpost med ID `123752`).
`NAMN`	Varchar	Egendomens namn.
`VÄRDE`	Tidsstämpel	Fastighetens värde.
`UPDATEDAT`	Tidsstämpel	Datum och tid då posten senast uppdaterades i HubSpot. Läs mer om kolumndatatyper.
`INGESTEDAT`	Tidsstämpel	Datum och tid då uppgifterna senast När uppgifterna senast togs in av Snowflake.

Exempel 1

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

Fråga:

SELECT objectTypeId, objectId, namn, värde
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	staden	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åga:

SELECT objectId, förnamn, efternamn, livscykelstadium
FROM
(
SELECT objectId, namn, värde
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, förnamn, efternamn, livscykel);

Returnerar:

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

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:

Namn på kolumnen	Typ	Beskrivning
`OBJECTTYPEID`	Varchar	ID för objekttypen (t.ex. kontakter är `0-1`).
`OBJECTID`	Antal	Postens ID ( t.ex. en kontaktpost med ID `123752`).
`NAMN`	Varchar	Egendomens namn.
`VÄRDE`	Tidsstämpel	Fastighetens värde.
`UPDATEDAT`	Tidsstämpel	Datum och tid då uppgifterna senast uppdaterades i HubSpot. Läs mer om kolumndatatyper.
`INGESTEDAT`	Tidsstämpel	Datum och tid då uppgifterna senast togs in av Snowflake.

Exempel 1

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

Fråga:

SELECT objectId, namn, värde, 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	UPDATEDAT
136493192	hs_predictivescoringtier	nivå_1	2022-06-22 22:45:05.931
136493192	hs_predictivescoringtier	nivå_2	2021-09-18 08:20:56.622
136493192	hs_predictivescoringtier	nivå_3	2019-11-31 18:20:22.851
...	...	...	...

Exempel 2

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

Fråga:

VÄLJ
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ÖRNAMN	LASTNAME
54325098	Hobbes	Baron
96805401	Milo	Guld
6922028	Henry	Riley
...	...	...

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. På så sätt behöver man inte 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. Se mer 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(BETA)

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:

Namn på kolumnen	Typ	Beskrivning
COMBINEDASSOCIATIONTYPEID	Varchar	Den unika identiteten för definitionen av en sammanslutning.
FÖRENINGSKATEGORI	Varchar	Källan till föreningstypen. En av följande: HUBSPOT_DEFINED, USER_DEFINED, INTEGRATOR_DEFINED
ASSOCIATIONTYPEID	Varchar	En unik identifierare av en associationsdefinition inom en specifik associationskategori, dvs. två definitioner inom en associationskategori kan inte ha samma associationtypeid.
FROMOBJECTTYPEID	Varchar	Den objekttyp som är källan till definitionen av föreningen.
FRÅNOBJEKTTYP	Varchar	Namnet på den objekttyp som är källan till associationsdefinitionen.
TOOBJECTTYPEID	Varchar	Den objekttyp som är destinationen för associationsdefinitionen.
TOOBJECTTYPE	Varchar	Namnet på den objekttyp som är destinationen för associationsdefinitionen.
NAMN	Varchar	Föreningsdefinitionens namn.
ETIKETT	Varchar	Beskrivningen av definitionen av föreningen.
ISMAINASSOCIATIONDEFINITION	Boolean	Om definitionen av föreningen är huvudtypen. När det är sant är det definitionen som HubSpot visar på associerade poster.
[FROMOBJECTTYPE_OBJECTID] t.ex. för vyn ASSOCIATIONS_CONTACTS_TO_DEALS blir detta CONTACT_OBJECTID.	Antal	Objekt-ID för källobjektet.
[TOOBJECTTYPE_OBJECTID] t.ex. för vyn ASSOCIATIONS_CONTACTS_TO_DEALS blir detta 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 affärer som är kopplade till en specifik kontakt.

Fråga:

VÄLJ
contact_objectId, deal_objectId

FROM associations_contacts_to_deals

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 affärer.

SELECT contacts.property_förnamn contact_förnamn,

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_EMAIL	DEAL_TYPE	DEAL_AMOUNT
David	Magalhães	dmagalhaes@example.com	nyföretagande	74848
Fernanda	Rodrigues	fmoreira@example.com	nyföretagande	253530

Exempel 3

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

SELECT SUM(deals.property_hs_closed_amount) AS
total_closed_amount, contacts.property_email contact_email contact_email
FROM objects_contacts kontakter
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:

TOTAL_CLOSED_AMOUNT	KONTAKT_EMAIL
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 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:

Namn på kolumnen	Typ	Beskrivning
`COMBINEDASSOCIATIONTYPEID`	Varchar	Den unika identiteten för definitionen av en sammanslutning.
`KATEGORI`	Varchar	Källan till föreningstypen. En av följande: `HUBSPOT_DEFINED`, `USER_DEFINED`, `INTEGRATOR_DEFINED`
`ID`	Antal	Identifiering av definitionen av en sammanslutning 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 målet för associationsdefinitionen.
`NAMN`	Varchar	Föreningsdefinitionens namn.
`ETIKETT`	Varchar	Etikett för definitionen av föreningen.
`ISMAINASSOCIATIONDEFINITION`	Boolean	Om definitionen av föreningen är huvudtypen. När det är sant är det definitionen som HubSpot visar på associerade poster.
`INGESTEDAT`	Tidsstämpel	Datum och tid då uppgifterna senast togs in av Snowflake. Läs mer om kolumndatatyper.

Exempel 1

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

Fråga:

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

Returnerar:

KOMBINERAD FÖRENINGSTYP	FROMOBJECTTYPEID	TOOBJECTTYPEID	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	DEAL_TO_CONTACT
0-4	0-1	0-3	KONTAKT_TILL_DEAL
0-5	0-3	0-2	DEAL_TO_COMPANY
...	...	...	...

Exempel 2

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

Fråga:

VÄLJcombinedAssociationTypeId, fromObjectTypeId, toObjectTypeId, name
FROM association_definitions
WHERE fromObjectTypeId = "0-3" AND toObjectTypeId = "0-2 AND isMainAssociationDefinition = true
ORDER BY category, id

Returnerar:

KOMBINERAD FÖRENINGSTYP	FROMOBJECTTYPEID	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

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:

Namn på kolumnen	Typ	Beskrivning
`COMBINEDASSOCIATIONTYPEID`	Varchar	Den unika identiteten för definitionen av en sammanslutning.
`FROMOBJECTID`	Antal	ID för källobjektet.
`TOOBJECTID`	Antal	ID för destinationsobjektet.
`INGESTEDAT`	Tidsstämpel	Datum och tid då uppgifterna senast togs in av Snowflake. Läs mer om kolumndatatyper.

Exempel 1

Hämta alla associerade affärer och kontakter.

Fråga:

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

Returnerar:

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

Exempel 2

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

Fråga:

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

Returnerar:

KOMBINERAD FÖRENINGSTYP	FROMOBJECTID	TOOBJECTID
0-5	6626541373	233620335

Exempel 3

Hämta alla affärer som är kopplade till en specifik kontakt (kontakt-ID: 4464). Istället för att hårdkoda combinedAssociationTypeId, kopplas det här exemplet till association_definitions.

Fråga:

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:

COMBINEDASSOCIATIONTYPEID	FROMOBJECTID	TOOBJECTID
0-5	6626541373	233620335

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:

Namn på kolumnen	Typ	Beskrivning
`OWNERID`	Antal	Användarens ägar-ID.
`USERID`	Antal	Användarens användar-ID. Användare med NULL i den här kolumnen har raderats.
`EMAIL`	Varchar	Användarens e-postadress.
`FÖRNAMN`	Varchar	Användarens förnamn.
`LASTNAME`	Varchar	Användarens efternamn.
`ARKIVERAD`	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	Datum och tid då uppgifterna senast togs in av Snowflake.

Exempel 1

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

Fråga:

SELECT ownerId, userId, email, förnamn, efternamn FROM owners WHERE archived = false

Returnerar:

OWNERID	USERID	EMAIL	FÖRNAMN	LASTNAME
29584574	4621126	233620335	Hobbes	Baron
30532717	4874784	3866015468	Pablo	Walters
30580321	925511	7132752747	Milo	Guld
...	...	...	...	...

Exempel 2

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

Fråga:

SELECT ownerId, userId, email, förnamn, efternamn
FROM owners
WHERE ownerId = 29584574;

Returnerar:

OWNERID	USERID	EMAIL	FÖRNAMN	LASTNAME
29584574	4621126	233620335	Hobbes	Baron

Exempel 3

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

VÄLJ 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:

CONTACTID	KONTAKT_FÖRNAMN	KONTAKT_EFTERNAMN	CONTACT_HUBSPOT_OWNER_ID	ÄGARE_FÖRNAMN	ÄGAREN_NÄMNESNAMN	ÄGAREN_EMAIL
113834202	Richard	Greenfield	29584574	Hobbes	Baron	hobbes.b@business.com
53540801	Ford	Karl	30241125	Milo	Guld	milo.g@business.com
...	...	...	...	...	...	...

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:

Namn på kolumnen	Typ	Beskrivning
`PIPELINEID`	Varchar	Rörledningens ID.
`OBJECTTYPEID`	Varchar	ID för det objekt som rörledningen kan innehålla (t.ex. erbjudanden eller biljetter).
`ETIKETT`	Varchar	Namnet på pipelinen i HubSpot.
`DISPLAYORDER`	Antal	Ordningen i vilken pipeline visas i HubSpot.
`ARKIVERAD`	Boolean	Om rörledningen har tagits bort.
`CREATEDAT`	Tidsstämpel	När rörledningen skapades.
`UPDATEDAT`	Tidsstämpel	Datum och tid då uppgifterna senast uppdaterades i HubSpot. Läs mer om kolumndatatyper.
`INGESTEDAT`	Tidsstämpel	Datum och tid då uppgifterna senast togs in av Snowflake.

Exempel 1

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

Fråga:

SELECT objectTypeId, pipelineId, label
FROM pipelines
WHERE objectTypeId = "0-3OCH inte arkiverad
ORDER BY displayorder;

Returnerar:

OBJECTTYPEID	PIPELINEID	ETIKETT
0-3	1bed503c-37f7-4f51-9d40-7598902673f4	Försäljningspipeline
0-3	12659678	Licenser Pipeline
0-3	75e28846-ad0d-4be2-a027-5e1da6590b98	Nya frågor
...	...	...

Exempel 2

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

Fråga:

VÄLJ

deals.objectId deal_id, deals.property_dealname deal_name, pipelines.label pipeline_name FROM objects_deals 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 byter varumärke	Försäljningspipeline
604362473	Nya steg för att bygga en app	Försäljningspipeline

Exempel 3

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

VÄLJ 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 byter varumärke	Försäljningspipeline
604362473	Nya steg för att bygga en app	Försäljningspipeline

pipeline_stages

Den här vyn innehåller information om enskilda steg i en pipeline. Identifiera steg genom att kombinera objekttyp-ID, pipeline-ID och steg-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:

Namn på kolumnen	Typ	Beskrivning
`PIPELINEID`	Varchar	Rörledningens ID.
`STAGEID`	Varchar	Scenens ID.
`ETIKETT`	Varchar	Etappens namn i HubSpot.
`DISPLAYORDER`	Antal	Ordningen i vilken pipeline visas i HubSpot.
`METADATA`	Variant	En JSON-formaterad beskrivning av scenen, inklusive om den är öppen eller stängd.
`ARKIVERAD`	Boolean	Om pipeline-steget har tagits bort.
`CREATEDAT`	Tidsstämpel	När pipeline-steget skapades.

Exempel 1

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

Fråga:

SELECT pipelineid, stageId, etikett
FROM pipeline_stages
WHERE inte arkiverad
AND pipelineid = (
SELECT pipelineid
FROM pipelines
WHERE objectTypeId = "0-3
OCH inte arkiverad
AND label = "Sales Pipeline" LIMIT 1)
ORDER BY displayorder;

Returnerar:

PIPELINEID	STAGEID	ETIKETT
941650	941651	Kontaktad
941650	941652	Tidsplanerad tid
941650	941653	Faktura skickad
...	...	...

Exempel 2

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

Fråga:

VÄLJ
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	Avtal skickat
605457408	Friskies byter varumärke	Försäljningspipeline	Tidsplanerad tid
604362473	Nya steg för att bygga en app	Försäljningspipeline	Kontrakt undertecknat
...	...	...	...

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:

Namn på kolumnen	Typ	Beskrivning
`OBJECTYPEID`	Varchar	ID för det objekt som händelsen avser.
`NAMN`	Varchar	Egendomens interna namn.
`ETIKETT`	Varchar	Fastighetens etikett.
`BESKRIVNING`	Varchar	Boendets beskrivning.
`TYP`	Varchar	Egendomens typ (t.ex. sträng, nummer, datum).
`FIELDTYPE`	Varchar	Egendomens fälttyp. Definierar hur egenskapen visas i HubSpot och på formulär (t.ex. kryssruta, välj).
`DISPLAYORDER`	Antal	Fastighetens visningsordning.
`GROUPNAME`	Varchar	Fastighetens gruppnamn.
`OPTIONER`	Variant	För uppräkningsegenskaper, en matris med egenskapens alternativ, inklusive varje alternativs attribut (t.ex. visningsordning, etikett).
`CREATEDUSERID`	Antal	ID för den användare som skapade egenskapen.
`REFERENCEDOBJECTTYPE`	Varchar	Den typ av objekt som egenskapen refererar till. Egenskaper för ägare returnerar värdet OWNER.
`KALKULERAD`	Boolean	Om egenskapen är en beräknad egenskap.
`EXTERNA ALTERNATIV`	Boolean	Om fastighetens alternativ är definierade i ett externt system.
`HAR ETT UNIKT VÄRDE`	Boolean	Om fastighetens värden är unika. Kan endast anges när du skapar en egenskap via API.
`HIDDEN`	Boolean	Om egenskapen är dold i HubSpot.
`SHOWCURRENCYSYMBOL`	Boolean	Om ett värde för en talegenskap ska formateras som en valuta.
`FORMFIELD`	Boolean	Om den här egenskapen kan användas i formulär.
`DEFINITION SOM ENDAST ÄR TILLGÄNGLIG FÖR LÄSARE`	Boolean	Om egenskapen kan redigeras i HubSpot.
`READONLYVALUE`	Boolean	Om egenskapens värde kan redigeras i HubSpot.
`HUBSPOTDEFINIERAD`	Boolean	Om egenskapen skapades av HubSpot eller av en användare.
`ARKIVERAD`	Boolean	Om egenskapen har tagits bort.
`CREATEDAT`	Tidsstämpel	Datum och tid då egenskapen skapades i HubSpot.
`UPDATEDAT`	Tidsstämpel	Datum och tid då uppgifterna senast uppdaterades i HubSpot. Läs mer om kolumndatatyper.
`INGESTEDAT`	Tidsstämpel	Datum och tid då uppgifterna senast togs in av Snowflake.

Exempel 1

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

Fråga:

Välj namn, etikett, beskrivning
FROM property_definitions
WHERE objectTypeId = "0-1

Returnerar:

NAMN	ETIKETT	BESKRIVNING
entered_sql_stage	Har gått in i SQL-stadiet	Starträkning SQL stage dagar.
first_conversion_event_name	Första konverteringen	Det första formuläret som denna kontakt skickade in.
adress	Adress	Kontaktpersonens adress.

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.

Namn
EVENTS_AD_INTERACTION	Uppgifter om en annons och kontakter som interagerade med annonsen genom att klicka på annonsen eller skicka in ett formulär efter att ha interagerat med annonsen.
EVENTS_AD_METRICS_IMPORTED_V0	Information om en annons och dess prestanda.
EVENTS_CALL_MENTIONED_KEYWORD (NYCKELORD)	Uppgifter om nyckelord som nämns av deltagare i samtalen.
EVENTS_CLICKED_LINK_IN_EMAIL_V2	Länkar som kontakterna klickat på i marknadsföringsmeddelanden.
EVENTS_CLICKED_LINK_IN_TRACKED_INBOX_EMAIL_V8	Länkar som klickats av kontakter i e-postmeddelanden från Conversations Inbox.
EVENTS_COOKIE_BANNER_CLICKED	Kontakter som klickat på cookies.
EVENTS_COOKIE_BANNER_VIEWED	Kontakter som har tittat på cookies.
EVENTS_DOCUMENT_SHARED_V2	Försäljningsdokument som delas med kontakter via en extern länk.
EVENTS_DOCUMENT_VIEWED_V2	Försäljningsdokument och kontakter som de har tittat på 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 skickas till HubSpot e-postservrar för att skickas.
EVENTS_MTA_DELIVERED_EMAIL_V2	E-postmeddelanden som HubSpot e-postservrar lyckats leverera till mottagarna.
EVENTS_MTA_BOUNCED_EMAIL_V2	Försök att leverera e-post som avvisades av mottagarens e-postserver.
EVENTS_OPENED_EMAIL_V2	E-post öppnas av kontakter.
EVENTS_REPORTED_SPAM_EMAIL_V2	E-postmeddelanden som markerats som skräppost av mottagarna.
EVENTS_UPDATED_EMAIL_SUBSCRIPTION_STATUS_V2	Ändringar av mottagarnas e-postabonnemang.
EVENTS_OPENED_TRACKED_INBOX_EMAIL_V8	E-postmeddelanden från Conservations Inbox öppnas av kontakter.
EVENTS_MB_MEDIA_PLAYED (HÄNDELSER_MB_MEDIA_SPELADE)	Aktivitet för videouppspelning av kontakter.
EVENTS_V2_CONTACT_BOOKED_MEETING_THROUGH_SEQUENCE	Kontakt bokade ett möte genom sekvens.
EVENTS_V2_CONTACT_ENROLLED_IN_SEQUENCE	Kontakt registrerad från sekvensen.
EVENTS_V2_CONTACT_FINISHED_SEQUENCE (HÄNDELSER_V2_KONTAKT_AVSLUTAD_FÖLJD)	Sekvensen är avslutad.
EVENTS_V2_CONTACT_REPLIED_SEQUENCE_EMAIL	Kontakten svarade på e-post (eller inkommande e-post som avregistrerade sekvensen) som skickades genom sekvensen.
EVENTS_V2_CONTACT_UNENROLLED_FROM_SEQUENCE	Kontakt som avregistrerats från sekvensen.
EVENTS_V2_CONTACT_UNENROLLED_MANUALLY_FROM_SEQUENCE	Användaren avregistrerade kontakten manuellt.
EVENTS_V2_CONTACT_UNSUBSCRIBED_SEQUENCE_EMAIL	Kontakten har avregistrerat sig, vilket innebär att sekvensen inte längre är registrerad.
EVENTS_V2_SEQUENCE_EMAIL_BOUNCED	E-postmeddelandet om sekvenser har avvisats.
EVENTS_V2_SEQUENCE_ERRORED	Fel i sekvensen som orsakade avregistrering.
EVENTS_V2_SEQUENCE_STEP_EXECUTED	Sekvenssteget har utförts.
EVENTS_VISITED_PAGE	Sidbesök på webbplatsen av kontakter.

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:

Observera: HubSpot har lagt till två nya kolumner i alla evenemangstabeller och vyer:

inträffade på
inträffade vid en tidpunkt i

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 fråga efter ett databasobjekt eller en vy som innehåller händelser som använder dessa kolumner kommer att misslyckas. Läs mer om brytande ändringar för Snowflake-datadelar.

Namn på kolumnen	Typ	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 evenemangstyp. Det finns inte två poster med samma ID inom en viss händelsetyp.
`OBJECTTYPEID`	Varchar	Den typ av objekt som avslutade händelsen. Om du till exempel klickar på en e-postlänk visas `0-1` i den här kolumnen, vilket representerar kontaktobjektet.
`OBJECTID`	Antal	ID för den post som avslutade händelsen.
`OCCURREDAT`	Tidsstämpel	När händelsen inträffade.
`INTRÄFFADE VID EN TIDPUNKT I`	Antal	Ett nummer som anger 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 `OCCURREDAT-tidsstämpeln` i stället för det här numret.
`INTRÄFFADE PÅ`	Antal	Ett nummer som anger 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 `OCCURREDAT-tidsstämpeln` i stället för det här numret. Observera att den här kolumnen kommer att upphöra att användas den 24 november 2022 och ersättas med `OCCURREDATDATEINT`.
`OCCUREDAT`	Tidsstämpel	När händelsen inträffade. Observera att denna kolumn kommer att upphöra den 24 november 2022 och ersättas med `OCCURREDAT`.
`INGESTEDAT`	Tidsstämpel	Datum och tid då uppgifterna senast togs in av Snowflake. Läs mer om kolumndatatyper.
`PROPERTY_*`	Varchar	Enskilda kolumner som innehåller händelsens egenskaper.

Exempel 1

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

Fråga:

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 kontaktuppgifter genom att gå samman med object_with_object_properties.

Fråga:

VÄLJ 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:

CLICK_TIMESTAMP	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 (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:

Namn på kolumnen	Typ	Beskrivning
`OBJECTTYPEID`	Varchar	ID för det objekt som rörledningen kan innehålla (t.ex. erbjudanden eller biljetter).
`FULLSTÄNDIGT NAMN`	Varchar	Namnet på objektet eller händelsen.
`INGESTEDAT`	Tidsstämpel	Datum och tid då uppgifterna senast togs in av Snowflake. Läs mer om kolumndatatyper.

Exempel 1

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

Fråga:

SELECT objectTypeId, fullyQualifiedName
FROM object_and_event_type_definitions;

Returnerar:

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

Förteckningar frågor

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:

Namn på kolumnen	Typ	Beskrivning
`OBJECTTYPEID`	Varchar	Typ av poster i listan (t.ex. kontakt eller företag).
`LISTID`	Antal	Listans ID. Kopplar till kolumnen LISTID i tabellen list-memberships.
`CLASSICLISTID`	Antal	Ett ID som är specifikt för kontaktlistor och som matchar ID:et i listans URL i HubSpot.
`NAMN`	Varchar	Namnet på listan.
`STORLEK`	Antal	Antalet poster i listan.
`CREATEDBYUSERID`	Antal	ID för den användare som skapade listan.
`CREATEDAT`	Tidsstämpel	När listan skapades i HubSpot.
`UPPDATERAD MED ANVÄNDARNAMN`	Antal	ID för den användare som senast uppdaterade listan.
`UPDATEDAT`	Tidsstämpel	Datum och tid då datumet senast uppdaterades i HubSpot. Läs mer om kolumndatatyper.
`INGESTEDAT`	Tidsstämpel	Datum och tid då uppgifterna senast togs in av Snowflake.

Exempel 1

Hämta alla kontaktlistor.

Fråga:

SELECT listId, namn, storlek
FROM listor
WHERE objectTypeId = "0-1";

Returnerar:

LISTID	NAMN	STORLEK
118131	Veckovis utåtriktad verksamhet	103
66156	Bloggprenumeranter	455
771852	Bästa prenumeranter 2021	37
...	...	...

Exempel 2

Hämta en specifik kontaktlista som heter Toppabonnenter 2021.

Fråga:

SELECT listId, namn, storlek
FROM listor
WHERE objectTypeId = "0-1 ANDlistName = "De främsta abonnenterna 2021";

Returnerar:

LISTID	NAMN	STORLEK
771852	Bästa prenumeranter 2021	37

list_membership

Det här databasobjektet innehåller information om vilka poster som är medlemmar 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:

Namn på kolumnen	Typ	Beskrivning
`LISTID`	Varchar	Listans ID. Kopplar till kolumnen HS_LIST_ID i tabellen lists.
`OBJECTID`	Varchar	ID för posten i listan.
`UPDATEDAT`	Tidsstämpel	Datum och tid då uppgifterna senast uppdaterades i HubSpot. Läs mer om kolumndatatyper.
`INGESTEDAT`	Tidsstämpel	Datum och tid då uppgifterna senast togs in av Snowflake.

Exempel 1

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

Fråga:

Välj objectId
FROM list_memberships
INNER JOIN listor
ON list_memberships.listId = lists.listId
WHERE lists.objectTypeId = "0-1
AND lists.name = "Top Subscribers 2021";

Returnerar:

OBJECTID

54325098

96805401

6922028

...

Exempel 2

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

Fråga:

VÄLJ

contact.objectId AS objectid, contact.property_firstname AS firstname, contact.property_lastname AS lastname FROM objects_contacts contact INNER JOIN list_memberships ON contact.objectId = list_memberships.objectId INNER JOIN lists ON list_memberships.listId = lists.listId WHERE lists.objectTypeId = "0-1". AND lists.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?

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. Det kan du göra genom att fråga efter property_definitions:

SELECT * FROM property_definitions

WHERE label = [column_name]

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:

SELECT campaigns.property_hs_name campaign_name, forms.property_hs_form_id form_id FROM objects_campaigns kampanjer kampanjer 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

Was this article helpful? Yes No

This form is used for documentation feedback only. Learn how to get help with HubSpot.

Fråga efter HubSpot-data i Snowflake

Gäller för:

Datafördröjning och din Snowflake-kontoregion

Konfigurera din Snowflake-miljö

Översikt över uppgifter

Begränsning och ordnande av returnerade uppgifter

Datatyper för kolumner

Omvandling av datatyper

Förfrågningar om objekt

objects_x views

Exempel 1

Exempel 2

Exempel 3

object_with_object_properties

Exempel 1

Exempel 2

objekt

Exempel 1

objekt_egenskaper

Exempel 1

Exempel 2

object_properties_history

Exempel 1

Exempel 2

Förfrågningar om sammanslutningar

associations_x_to_y views(BETA)

Exempel 1

Exempel 2

Exempel 3

association_definitioner

Exempel 1

Exempel 2

föreningar

Exempel 1

Exempel 2

Exempel 3

Förfrågningar från ägaren

ägare

Exempel 1

Exempel 2

Exempel 3

Förfrågningar om rörledningar

rörledningar

Exempel 1

Exempel 2

Exempel 3

pipeline_stages

Exempel 1

Exempel 2

Förfrågningar om fastigheter

Egendomsdefinitioner

Exempel 1

Förfrågningar om evenemang

Exempel 1

Exempel 2

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

Object_and_event_type_definitions

Exempel 1

Förteckningar frågor

förteckningar

Exempel 1

Exempel 2

list_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 kopplar jag den här datatypen till en annan, t.ex. hur hämtar jag formulär för en kampanj?

Relaterat innehåll

Skapa anpassade rapporter för enskilda objekt

Förstå attributionsrapportering

Rapportera om spårade termer i utskrifter