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.

Sök i HubSpot-data i Snowflake

Senast uppdaterad: 24 september 2026

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

Data Hub Enterprise

När du har kopplat Snowflake till ditt HubSpot-konto kan du använda Snowflakes Data Share för att hämta HubSpot-data från ditt Snowflake-konto.

Datafördröjning och regionen för ditt Snowflake-konto

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

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

Konfigurera din Snowflake-miljö

För att kunna göra sökningar i dina HubSpot-data i Snowflake måste du välja det datalager, den databas och det schema som du vill söka i. Du kan antingen ställa in dem på arbetsbladsnivå så att de automatiskt inkluderas i dina sökningar, eller så kan du lägga till dem manuellt.

Så här väljer du ditt datalager, din databas och ditt schema på kalkylbladsnivå:

Klicka på verktygsfältetför arbetsblad i den översta raden på arbetsbladet.
I popup-fönstret:
- Klicka på rullgardinsmenynLager och välj sedan dittlager.
- Klicka på rullgardinsmenyn”Databas” och välj sedan din HubSpot-databas.
- Klicka på rullgardinsmenynSchema och välj sedan det schema du vill använda:

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

Så här lägger du manuellt till databas- och schemotypen i frågorna: Lägg till databasnamnet följt av schemat i början av FROM. Till exempel:

SELECT objectTypeId, objectId, updatedAt

FROM hubspot_share_name.V2_LIVE.objects

WHERE objectTypeId = '0-3'

BEGRÄNS 1;

Dataöversikt

Frågor konstrueras med hjälp av SQL och kan användas för att hämta HubSpot-data såsom:

Objekt: standardobjekt och anpassade objekt, till exempel kontakter, företag och produkter.
Poster: enskilda poster, till exempel en enskild kontakt eller ett företag.
Kopplingar: alla tillgängliga kopplingstyper och poster som för närvarande är kopplade.
Händelser: händelsedata för både standardhändelser i HubSpot, till exempel öppnade e-postmeddelanden, och anpassade beteendehändelser.
Segment: HubSpot-kontakt- och företagssegment.
Ägare: användare i ditt HubSpot-konto, i relation till de poster som de är angivna som ägare till.
Pipelines: affärs-och ärendepipelines, inklusive pipeline-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 vidareutvecklar datadelningen kommer vi att införa ändringar, varav vissa kan medföra kompatibilitetsproblem. Vi rekommenderar starkt att du prenumererar på HubSpots ändringslogg för utvecklare. Dessa ändringar kommer alltid att publiceras i ändringsloggen innan någon uppdatering genomförs.

Begränsa och sortera returnerade data

När du skapar frågor kan du styra hur mycket data som returneras, samt i vilken ordning den returneras, genom att inkluderaLIMIT och ORDER BY i din fråga. Om du till exempel vill söka efter alla kontakter med deras egenskaper, men endast returnera tre resultat och sortera dem efter kontakt-ID, kan du formulera din fråga enligt följande:

SELECT objectTypeId, updatedAt, ingestedAt

FROM objekt

DÄR objectTypeId = '0-1'

SORTERA EFTER objekt-ID

BEGRÄNSA 10;

Datatyper för kolumner

När du söker efter data i Snowflake beror de kolumner som returneras på vilken data du söker efter. Du kan se de tillgängliga kolumnerna för en viss tabell eller vy i Snowflake genom att välja vyn i vänster sidofält.

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

snowflake-sidebar-view-column-details0

För att returnera en specifik kolumn inkluderar du den kolumnen i SELECT i din fråga. Till exempel kommer följande fråga endast att returnera kolumnerna OBJECTID och UpdatedAt

SELECT objectTypeId, updatedAt, ingestedAt

FROM objekt

DÄR objectTypeId = '0-1'

SORTERA EFTER objekt-ID

BEGRÄNSA 10;

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

OBJECTTYPEID: ett VARCHAR-värde som representerar ett objekts typ. Till exempel representerar 0-1 objektet kontakter, 0-2 representerar objektet företag och 2-1232 kan representera ett anpassat objekt i ditt konto. I segment avser detta segmenttypen (t.ex. kontakt eller företag). Du kan söka efter alla objekt- och händelse-ID:n i ditt konto med hjälp av vyn object_and_event_type_definitions.
OBJECTID: ett BIGINT-tal som representerar en enskild post av en viss objekttyp i ditt HubSpot-konto. För att identifiera en post måste du använda både objekttyp-ID:t och objekt-ID:t.
INGESTEDAT: tidsstämpeln för när en datarad lades till i Snowflake, representerad av ett TIMESTAMP_NTZ-värde. Har inget samband med den logiska tidsstämpeln för en skapande- eller uppdateringsåtgärd i HubSpot.
- På grund av HubSpots interna bearbetning kan en rads importtidsstämpel uppdateras även om inga andra kolumner i raden har ändrats.
- När du bygger ETL-processer som kopierar nyligen ändrade data rekommenderas det att basera dina sökningar på tidsstämpeln för inläsningen. Om ditt flöde kopierar data dagligen rekommenderas det dessutom att kopiera data från de två föregående dagarna för att ta hänsyn till fördröjningar.
CREATEDAT och UPDATEDAT: den logiska tidsstämpeln för när data skapades eller uppdaterades i HubSpot, representerad av ett TIMESTAMP_NTZ-värde . Dessa tidsstämplar kommer att stämma överens med tidsstämplarna i HubSpot. Till exempel kommer den tid som visas i HubSpot för en postens skapandedatum att vara densamma som tidsstämpeln i kolumnen CREATEDAT i Snowflake. Dessa är inte direkt relaterade till tidsstämpeln för inläsningen, och det rekommenderas inte att basera ETL-processer på dessa egenskaper.
COMBINEDASSOCIATIONTYPE: ett VARCHAR-värde som unikt identifierar en associationsdefinition.

Omvandling av datatyper

Ibland returneras data från en fråga med VARCHAR-kolumner när det vore önskvärt att ha dem i en annan typ. I sådana fall rekommenderas det att konvertera datatypen VARCHAR till önskade typer med hjälp av Snowflake-funktioner. Till exempel lagras egenskaper för en objektrekord som VARCHAR-datatyper i de flesta databasobjekt, men innehåller ibland tal- och datumtidsvärden. Funktioner som:
try_to_number, try_to_timestamp_ntz kan användas för att konvertera dessa VARCHAR-data till respektive NUMBER- och 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

Objektfrågor

Nedan kan du lära dig hur du hämtar data från specifika HubSpot-objekt och -poster, samt vilka data som returneras.

Objektdata finns tillgängliga i delade databasobjekt. Filtrera efter objectTypeId för att hämta en specifik objekttyp. Använd OBJECT_WITH_OBJECT_PROPERTIES när du behöver de aktuella egenskaperna för varje post. Egenskapsvärden lagras i properties . Använd OBJECTS för centrala postattribut och OBJECT_PROPERTIES eller OBJECT_PROPERTIES_HISTORY för data per egenskap.

Objektnamn	Objekttyp-ID
Kontakter	0–1
Företag	0–2
Radposter	0–8

Anpassade objekt tilldelas ett ID vid skapandet och identifieras som2-unikt_ID. Till exempel2-12345. Läs mer om object_and_event_type_definitions.

Se mer information i avsnitten om objekt_med_objekt_egenskaper, objekt_egenskaper, objekt och objekt_egenskaper_historik nedan.

object_with_object_properties

Detta databasobjekt innehåller data från dina HubSpot-poster. Sökningar mot detta databasobjekt returnerar en rad för varje post inom en objekttyp (t.ex. alla kontaktposter i objekttypen kontakter). Alla egenskaper lagras i kolumnen Properties, som är en Snowflake Variant-/JSON-kolumn.

Denna vy kan returnera följande kolumner:

Kolumnnamn	Typ	Beskrivning
`OBJECTTYPEID`	Varchar	Objekttypens ID (t.ex. är kontakter `0-1`).
`OBJECTID`	Number	ID för posten (t.ex. en kontaktpost med ID `123752`).
`PROPERTIES`	Variant	Postens egenskapsvärden.
`UPDATEDAT`	Tidsstämpel	Datum och tidpunkt då posten senast uppdaterades i HubSpot. Läs mer om datatyper för kolumner.
`INGESTEDAT`	Tidsstämpel	Datum och tidpunkt då data senast importerades av Snowflake.

Observera: Den 25 januari 2022 kommer kolumnen timestamp i tabellen och vyn object_with_object_properties, som representerar datum och tidpunkt då objektregistret senast uppdaterades i HubSpot, att byta namn till updatedat. Detta görs för att anpassa det till hur datetime-data representeras i resten av datadelningen.

Eftersom detta är en kompatibilitetsbrytande ä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 är avsedda att ersätta. Detta ger dig möjlighet att byta till att använda de nya kolumnerna.

Efter 90 dagar, den 25 januari 2022, kommer kolumnen timestamp att tas bort från tabellen och vyn. Efter detta datum kommer alla försök att göra en sökning i tabellen eller vyn object_with_object_properties med hjälp av timestamp-kolumnerna att misslyckas.

Exempel 1

Hämta alla kontakter och deras egenskaper.

Fråga:

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

Resultat:

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 affärsstadium 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	AFFÄRSNAMN	AFFÄRSSTADIUM	AFFÄRSBELOPP
38960439	Affärsnamn 1	avslutad förlorad	7488939
321740651	Affärsnamn 1	avslutad vunnen	9292029
98392101	Affärsnamn 1	avslutad förlorad	62626528

objekt

Detta databasobjekt är en delmängd av data i databasobjektet object_with_object_properties. Varje returnerad rad returnerar objekt-ID för varje post. Detta databasobjekt returnerar endast befintliga poster. När en post raderas i HubSpot tas den bort från detta databasobjekt. Detta databasobjekt är en delmängd av data i tabellen object_with_object_properties. Varje returnerad rad innehåller objekt-ID för varje post. Denna vy returnerar endast befintliga poster. När en post raderas i HubSpot tas den bort från denna vy.

Detta databasobjekt innehåller aktuella objektdata utan egenskapsvärden. Använd det när du endast behöver grundläggande postattribut, eller koppla ihop det med OBJECT_PROPERTIES när du behöver utvalda egenskaper. Genom att använda detta databasobjekt tillsammans med databasobjektet object_properties går det att replikera data i object_with_object_properties, samtidigt som du behåller kontrollen över vilka egenskaper som returneras.

Detta databasobjekt kan returnera följande kolumner:

Kolumnnamn	Typ	Beskrivning
`OBJECTTYPEID`	Varchar	Objekttypens ID (t.ex. är kontakter `0-1`).
`OBJECTID`	Number	ID för posten (t.ex. en kontaktpost med ID `123752`).
`INGESTEDAT`	Tidsstämpel	Datum och tidpunkt då data senast importerades av Snowflake. Läs mer om kolumndatatyper.

Exempel 1

Hämta alla kontaktposter.

Fråga:

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

Returnerar:

OBJECTTYPEID	OBJEKTID
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 är angivet 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 saknar 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:

Kolumnnamn	Typ	Beskrivning
`OBJECTTYPEID`	Varchar	Objekttypens ID (t.ex. är kontakter `0-1`).
`OBJECTID`	Number	ID för posten (t.ex. en kontaktpost med ID `123752`).
`NAME`	Varchar	Namnet på egenskapen.
`VALUE`	Tidsstämpel	Egenskapens värde.
`UPDATEDAT`	Tidsstämpel	Datum och tidpunkt då posten senast uppdaterades i HubSpot. Läs mer om datatyper för kolumner.
`INGESTEDAT`	Tidsstämpel	Datum och tidpunkt då data senast importerades av Snowflake.

Exempel 1

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

Fråga:

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åga:

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);

Resultat:

OBJECTTYPEID	OBJEKTID	FÖRNAMN	EFTERNAMN	LIVSCYKELSTADIUM
0-1	54325098	Hobbes	Baron	ledare
0–1	96805401	Milo	Guld	ledning
0–1	6922028	Henry	Riley	ledning
...	...	...	...	...

object_properties_history

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

Detta databasobjekt kan returnera följande kolumner:

Kolumnnamn	Typ	Beskrivning
`OBJECTTYPEID`	Varchar	Objekttypens ID (t.ex. är ”kontakter” `0-1`).
`OBJECTID`	Nummer	Postens ID (t.ex. en kontaktpost med ID `123752`).
`NAME`	Varchar	Namnet på egenskapen.
`VALUE`	Tidsstämpel	Egenskapens värde.
`UPDATEDAT`	Tidsstämpel	Datum och tidpunkt då uppgifterna senast uppdaterades i HubSpot. Läs mer om datatyper för kolumner.
`INGESTEDAT`	Tidsstämpel	Datum och tidpunkt då data senast importerades av Snowflake.

Exempel 1

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

Fråga:

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	UPDATEDAT
136493192	hs_predictivescoringtier	tier_1	2022-06-22 22:45:05.931
136493192	hs_prediktiv_poängsättningsnivå	nivå_2	2021-09-18 08:20:56.622
136493192	hs_prediktiv_poängsättningsnivå	nivå_3	2019-11-31 18:20:22.851
...	...	...	...

Exempel 2

Hämta det aktuella namnet på alla kontakter som någonsin har befunnit sig i livscykelstadiet Prenumerant.

Fråga:

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'
);

Resultat:

OBJEKT-ID	FÖRNAMN	EFTERNAMN
54325098	Hobbes	Baron
96805401	Milo	Gold
6922028	Henry	Riley
...	...	...

Associationsfrågor

Associeringsdata finns tillgängliga i ASSOCIATIONS. Filtrera efter combinedAssociationTypeId för att hämta en specifik associeringstyp. Koppla ihop ASSOCIATIONS med ASSOCIATION_DEFINITIONS för att identifiera relaterade objekttyper och associeringsdefinitioner.

association_definitions

Detta databasobjekt innehåller information om alla tillgängliga associationstyper mellan HubSpot-objekt, med en rad per associationstyp. Du kan koppla samman detta databasobjekt med databasobjektet associations 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 den association där ISMAINASSOCIATIONDEFINITION är true.

Detta databasobjekt kan returnera följande kolumner:

Kolumnnamn	Typ	Beskrivning
`COMBINEDASSOCIATIONTYPEID`	Varchar	Den unika identifieraren för associationsdefinitionen.
`CATEGORY`	Varchar	Källan till associeringstypen. Ett av följande: `HUBSPOT_DEFINED`, `USER_DEFINED`, `INTEGRATOR_DEFINED`
`ID`	Number	Identifieraren för associationsdefinitionen inom sin 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.
`NAME`	Varchar	Namnet på associationsdefinitionen.
`LABEL`	Varchar	Etiketten för associationsdefinitionen.
`ISMAINASSOCIATIONDEFINITION`	Boolean	Anger om associationsdefinitionen är huvudtypen. När värdet är sant är det denna definition som HubSpot visar på associerade poster.
`INGESTEDAT`	Tidsstämpel	Datum och tidpunkt då data senast importerades av Snowflake. Läs mer om kolumndatatyper.

Exempel 1

Hämta de associationstyper som finns tillgängliga i ditt konto.

Fråga:

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

Returnerar:

KOMBINERAD ASSOCIATIONSTYP	FRÅN OBJEKTTYP-ID	TILLOBJEKTTYPID	NAMN
0–1	0-1	0-2	KONTAKT_TILL_FÖRETAG
0-2	0-2	0-1	FÖRETAG_ATT_KONTAKTA
0–3	0–3	0–1	DEAL_TO_CONTACT
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 kopplingstyperna 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 FÖRENINGSTYP	FRÅN OBJEKTTYP-ID	TILL OBJEKTTYP-ID	NAMN
0–5	0–3	0-2	AFFÄR_TILL_FÖRETAG
0-271	0-3	0-2	AFFÄR_MED_HUVUDFÖRETAG
0-341	0-3	0-2	AFFÄR_MED_FÖRETAG_UTAN_BETECKNING

associations

Detta databasobjekt innehåller information om kopplingarna mellan specifika poster. Varje rad representerar en koppling från ett objekt till ett annat objekt. Rader kan finnas i detta databasobjekt även om de poster som refereras till har raderats. Du kan kontrollera om poster finns genom att koppla ihop med objekttabellen.

Detta databasobjekt innehåller kopplingsposter för alla kopplingstyper. Filtrera efter combinedAssociationTypeId och koppla ihop med ASSOCIATION_DEFINITIONS när du behöver metadata om kopplingar.

Detta databasobjekt kan returnera följande kolumner:

Kolumnnamn	Typ	Beskrivning
`COMBINEDASSOCIATIONTYPEID`	Varchar	Den unika identifieraren för associationsdefinitionen.
`FROMOBJECTID`	Number	Källobjektets ID.
`TOOBJECTID`	Tal	Målobjektets ID.
`INGESTEDAT`	Tidsstämpel	Datum och tidpunkt då data senast importerades 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	FRÅNOBJEKT-ID	TILLOBJEKTID
0–5	6626541373	233620335
0–5	6616436082	3866015468
0–5	6690805943	7132752747
...	...	...

Exempel 2

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

Fråga:

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

Resultat:

KOMBINERAD ASSOCIERINGSTYP	FRÅN OBJEKT-ID	TILL OBJEKT-ID
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 använder detta exempel en sammanfogning med 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;

Resultat:

KOMBINERAD ASSOCIERINGSTYP-ID	FRÅNOBJEKTID	TILL OBJEKT-ID
0–5	6626541373	233620335

Ägarfrågor

ägare

Detta databasobjekt innehåller information om användarna i ditt HubSpot-konto. Användare kan anges som rekordägare och innehåller både ett användar-ID och ett ägar-ID, beroende på sammanhanget. Båda ID:na kan användas för att identifiera samma användare.

Detta databasobjekt kan returnera följande kolumner:

Kolumnnamn	Typ	Beskrivning
`OWNERID`	Tal	Användarens ägar-ID.
`USERID`	Nummer	Användarens användar-ID. Användare med värdet NULL i denna kolumn har raderats.
`EMAIL`	Varchar	Användarens e-postadress.
`FIRSTNAME`	Varchar	Användarens förnamn.
`LASTNAME`	Varchar	Användarens efternamn.
`ARCHIVED`	Boolean	Om användaren har raderats.
`CREATEDAT`	Tidsstämpel	Datum och tidpunkt då användaren skapades i HubSpot. Se datatyper för kolumner för mer information.
`UPDATEDAT`	Tidsstämpel	Datum och tidpunkt då användaren senast uppdaterades i HubSpot. Se kolumnens datatyper för mer information.
`INGESTEDAT`	Tidsstämpel	Datum och tidpunkt då data senast importerades av Snowflake.

Exempel 1

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

Fråga:

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

Returnerar:

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

Exempel 2

Hämta en specifik ägare utifrån deras ägar-ID.

Fråga:

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

Resultat:

ÄGAR-ID	ANVÄNDAR-ID	E-POST	FÖRNAMN	EFTERNAMN
29584574	4621126	233620335	Hobbes	Baron

Exempel 3

Hämta alla kontakter och deras ägare. Denna fråga kopplar samman poster med ägare med hjälp av object_with_object_properties och kontaktattributet hubspot_owner_id.

SELECT

contact.objectId AS contact_id,

contact.properties:firstname::string AS contact_firstname,

contact.properties:lastname::string AS contact_lastname,

contact.properties:hubspot_owner_id::number AS contact_hubspot_owner_id,

owner.firstname AS owner_förnamn,

owner.lastname AS ägarens_efternamn,

ägare.e-post AS ägare_e-post

FRÅN objekt_med_objektegenskaper AS kontakt

JOIN ägare AS ägare

PÅ contact.properties:hubspot_owner_id::number = owner.ownerId

WHERE contact.objectTypeId = '0-1';

Returnerar:

KONTAKTID	CONTACT_FIRSTNAME	CONTACT_EFTERNAMN	CONTACT_HUBSPOT_ÄGARE_ID	ÄGARENS_FÖRNAMN	ÄGARENS_EFTERNAMN	ÄGARENS_E-POST
113834202	Richard	Greenfield	29584574	Hobbes	Baron	hobbes.b@business.com
53540801	Ford	Karl	30241125	Milo	Gold	milo.g@business.com
...	...	...	...	...	...	...

Teamfrågor

team

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

Detta databasobjekt innehåller information om teamen i ditt HubSpot-konto.

Detta databasobjekt kan returnera följande kolumner:

Kolumnnamn	Typ	Beskrivning
TEAMID	Nummer	Lagets ID.
TEAMNAME	Varchar	Lagets namn.
PARENTTEAMID	Number	ID för det överordnade laget.
CHILDTEAMIDS	Array	Team-ID:n för underordnade team.
PRIMARYOWNERMEMBERS	Varchar	ID:n för lagets primära medlemmar.
SEKUNDÄRA ÄGARMEDLEMMAR	Boolean	Ägar-ID:n för teamets sekundära medlemmar.
INGESTEDAT	Tidsstämpel	Datum och tidpunkt då data senast importerades av Snowflake.

Exempel 1

Hämta alla team.

Fråga:

SELECT teamId,teamName, primaryOwnerMembers

FROM teams

Returnerar:

LAG-ID	LAGNAMN	HUVUDÄGARE
29584574	Underlag	[233620335, 1234553]
30532717	Superlaget	[3866015468, 126221873]
3058032	A-laget	[7132752747]

owner_team

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

Detta databasobjekt kan returnera följande kolumner:

Kolumnnamn	Typ	Beskrivning
TEAMID	Nummer	Team-ID.
OWNERID	Nummer	Användarens ägar-ID.
ISTEAMPRIMARY	Boolesk	Anger om detta team är det primära teamet för denna ägare.
INGESTEDAT	Tidsstämpel	Datum och tidpunkt då data senast importerades av Snowflake.

Exempel 1

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

Fråga:

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

Returnerar

TEAMID	TEAMNAME	ÄR TEAMET PRIMÄRT
29584574	233620335	SANT
29584574	1234553	SANT

Pipeline-frågor

Nedan kan du lära dig hur du gör sökningar i data om affärs- och ärendepipelines, till exempel vilka tillgängliga pipelines som finns i ditt konto och deras olika steg.

Du kan koppla samman dessa data med objektdata för att få en fullständig översikt över dina pipelines. Du kan till exempel söka efter affärer och deras pipelines genom att koppla samman ` object_with_object_properties ` med pipelines`.

pipelines

Detta databasobjekt innehåller information om affärs- och ärendepipelines i ditt konto. Varje returnerad rad representerar en enskild pipeline.

Denna tabell kan returnera följande kolumner:

Kolumnnamn	Typ	Beskrivning
`PIPELINEID`	Varchar	Pipelinens ID.
`OBJECTTYPEID`	Varchar	ID för det objekt som pipelinen kan innehålla (t.ex. affärer eller ärenden).
`LABEL`	Varchar	Pipelinens namn i HubSpot.
`DISPLAYORDER`	Number	Den ordning i vilken pipelinen visas i HubSpot.
`ARCHIVED`	Boolesk	Om pipelinen har raderats.
`CREATEDAT`	Tidsstämpel	När pipelinen skapades.
`UPDATEDAT`	Tidsstämpel	Datum och tidpunkt då data senast uppdaterades i HubSpot. Läs mer om datatyper för kolumner.
`INGESTEDAT`	Tidsstämpel	Datum och tidpunkt då data senast importerades av Snowflake.

Exempel 1

Hämta alla tillgängliga affärspipelines, sorterade efter deras ordning i HubSpot.

Fråga:

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	Licenspipeline
0–3	75e28846-ad0d-4be2-a027-5e1da6590b98	Nya affärer
...	...	...

Exempel 2

Hämta affärer inom en specifik pipeline med hjälp avobject_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 omprofilering	Försäljningspipeline
604362473	Utveckling av Fresh Step-appen	Försäljningspipeline

pipeline_stages

Denna vy innehåller information om enskilda steg inom en pipeline. Identifiera steg genom att kombinera objekttyp-ID, pipeline-ID och steg-ID. Vid sammanfogning med pipelines ska du använda objekttyp-ID och pipeline-ID.

Detta databasobjekt kan returnera följande kolumner:

Kolumnnamn	Typ	Beskrivning
`PIPELINEID`	Varchar	Pipelinens ID.
`STAGEID`	Varchar	Stegets ID.
`LABEL`	Varchar	Scenens namn i HubSpot.
`DISPLAYORDER`	Nummer	Den ordning i vilken pipelinen visas i HubSpot.
`METADATA`	Variant	En beskrivning av steget i JSON-format, inklusive om det är öppet eller stängt
`ARCHIVED`	Boolesk	Om pipeline-steget har raderats.
`CREATEDAT`	Tidsstämpel	När pipeline-steget skapades.

Exempel 1

Hämta pipeline-steg för en affärspipeline med namnetSales pipeline.

Fråga:

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	STAGEID	LABEL
941650	941651	Kontaktad
941650	941652	Tidsbokning gjord
941650	941653	Faktura skickad
...	...	...

Exempel 2

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

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';

Resultat:

DEAL_ID	AFFÄRSNAMN	PIPELINE_NAME	PIPELINE_STAGE_NAME
605140072	Meowmix Global Registrering	Försäljningspipeline	Kontrakt skickat
605457408	Friskies omprofilering	Försäljningspipeline	Möte inbokat
604362473	Utveckling av Fresh Step-appen	Försäljningspipeline	Kontrakt tecknat
...	...	...	...

Fastighetsfrågor

property_definitions

Detta databasobjekt innehåller information om objektegenskaper och händelseegenskaper i ditt HubSpot-konto. Händelseegenskaper inkluderar standardhändelser, såsom öppnade e-postmeddelanden och klick, samt anpassade beteendehändelseegenskaper. Denna information kan vara till hjälp för att definiera värden som finns i data för objekt_egenskaper och händelser.

Du kan identifiera specifika egenskaper genom att kombinera deras objekttyp-ID och namn. Du kan hämta liknande information med hjälp av egenskaps-API:et.

Detta databasobjekt kan returnera följande kolumner:

Kolumnnamn	Typ	Beskrivning
`OBJECTYPEID`	Varchar	ID för det objekt som händelsen avser.
`NAME`	Varchar	Egenskapens interna namn.
`LABEL`	Varchar	Egenskapens etikett.
`DESCRIPTION`	Varchar	Fastighetens beskrivning.
`TYPE`	Varchar	Fastighetens typ (t.ex. sträng, tal, datum och tid).
`FIELDTYPE`	Varchar	Egenskapens fälttyp. Definierar hur egenskapen visas i HubSpot och i formulär (t.ex. kryssruta, rullgardinsmeny).
`DISPLAYORDER`	Tal	Egenskapens visningsordning.
`GROUPNAME`	Varchar	Fastighetens gruppnamn.
`OPTIONS`	Variant	För uppräkningsegenskaper, en matris med egenskapens alternativ, inklusive varje alternativs attribut (t.ex. visningsordning, etikett).
`CREATEDUSERID`	Tal	ID för den användare som skapade egenskapen.
`REFERENCEDOBJECTTYPE`	Varchar	Typen av objekt som egenskapen refererar till. Ägaregenskaper returnerar värdet OWNER.
`CALCULATED`	Boolean	Om egenskapen är en beräknad egenskap.
`EXTERNALOPTIONS`	Boolesk	Anger om egenskapens alternativ definieras i ett externt system.
`HASUNIQUEVALUE`	Boolesk	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`	Boolesk	Om värdet för en talegenskap formateras som en valuta.
`FORMFIELD`	Boolesk	Om denna egenskap kan användas i formulär.
`READONLYDEFINITION`	Boolesk	Om egenskapen kan redigeras i HubSpot.
`READONLYVALUE`	Boolesk	Om egenskapens värde kan redigeras i HubSpot.
`HUBSPOTDEFINED`	Boolesk	Om egenskapen skapades av HubSpot eller av en användare.
`ARCHIVED`	Boolesk	Om egenskapen har raderats.
`CREATEDAT`	Tidsstämpel	Datum och tidpunkt då egenskapen skapades i HubSpot.
`UPDATEDAT`	Tidsstämpel	Datum och tidpunkt då uppgifterna senast uppdaterades i HubSpot. Läs mer om datatyper för kolumner.
`INGESTEDAT`	Tidsstämpel	Datum och tidpunkt då data senast importerades av Snowflake.

Exempel 1

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

Fråga:

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

Returnerar:

NAME	ETIKETT	BESKRIVNING
entered_sql_stage	Gick in i SQL-steget	Starta räkningen av dagar i SQL-fasen.
namn_på_första_konverteringshändelsen	Första konverteringen	Det första formuläret som denna kontakt skickade in.
adress	Gatuadress	Kontaktens adress.

Händelsefrågor

Händelser inkluderar standardhändelser från HubSpot och anpassade beteendehändelser. Varje händelse har sitt eget databasobjekt, märkt som events_eventname.

Namn
EVENTS_AD_INTERACTION	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	Detaljer om en annons och dess prestationsmått.
EVENTS_CALL_MENTIONED_KEYWORD	Detaljer om nyckelord som nämnts av deltagare i samtal.
EVENTS_CLICKED_LINK_IN_EMAIL_V2	Länkar som kontakter har klickat på i marknadsföringsmejl.
EVENTS_CLICKED_LINK_IN_TRACKED_INBOX_EMAIL_V8	Länkar som kontakter har klickat på i e-postmeddelanden i Conversations-inkorgen.
EVENTS_COOKIE_BANNER_CLICKED	Kontakter som har klickat på cookies.
EVENTS_COOKIE_BANNER_VIEWED	Kontakter som har visat information om cookies.
EVENTS_DOCUMENT_SHARED_V2	Försäljningsdokument som delats med kontakter via en extern länk.
EVENTS_DOCUMENT_VIEWED_V2	Försäljningsdokument och kontakter som har visat dem genom att öppna den externa länken.
EVENTS_DOCUMENT_COMPLETED_V2	Försäljningsdokument och kontakter som har avslutat dem.
EVENTS_HS_SCHEDULED_EMAIL_V2	E-postmeddelanden som skickats till HubSpots e-postservrar för att skickas.
EVENTS_MTA_DELIVERED_EMAIL_V2	E-postmeddelanden som har levererats framgångsrikt till mottagarna via HubSpots e-postservrar.
EVENTS_MTA_BOUNCED_EMAIL_V2	Försök att leverera e-postmeddelanden som avvisats av mottagarens e-postserver.
EVENTS_OPENED_EMAIL_V2	E-postmeddelanden som öppnats av kontakter.
EVENTS_REPORTED_SPAM_EMAIL_V2	E-postmeddelanden som har markerats som skräppost av mottagarna.
EVENTS_UPDATED_EMAIL_SUBSCRIPTION_STATUS_V2	Ändringar av e-postprenumerationer gjorda av mottagare.
EVENTS_OPENED_TRACKED_INBOX_EMAIL_V8	Öppnade e-postmeddelanden i inkorgen av kontakter.
EVENTS_MB_MEDIA_PLAYED	Videouppspelningsaktivitet hos kontakter.
EVENTS_V2_CONTACT_BOOKED_MEETING_THROUGH_SEQUENCE	Kontakten har bokat ett möte via sekvensen.
EVENTS_V2_CONTACT_ENROLLED_IN_SEQUENCE	Kontakten har anmält sig till sekvensen.
EVENTS_V2_CONTACT_FINISHED_SEQUENCE	Sekvensen är avslutad.
EVENTS_V2_CONTACT_REPLIED_SEQUENCE_EMAIL	Kontakten har svarat på e-postmeddelandet (eller det inkommande e-postmeddelandet som avregistrerade sekvensen) som skickades via sekvensen.
EVENTS_V2_CONTACT_UNENROLLED_FROM_SEQUENCE	Kontakten har avregistrerats från sekvensen.
EVENTS_V2_CONTACT_UNENROLLED_MANUALLY_FROM_SEQUENCE	Användaren har manuellt avregistrerat kontakten.
EVENTS_V2_KONTAKT_AVREGISTRERAD_FRÅN_SEKVENS_E-POST	Kontakten har avslutat prenumerationen och avregistrerats från sekvensen.
EVENTS_V2_SEQUENCE_EMAIL_BOUNCED	Sekvensmejlet studsade tillbaka.
EVENTS_V2_SEQUENCE_ERRORED	Fel i sekvensen som ledde till avregistrering.
EVENTS_V2_SEQUENCE_STEP_EXECUTED	Sekvenssteg utfört.
EVENTS_VISITED_PAGE	Besök på webbplatsen av kontakter.
EVENTS_<INTEGRATION_EVENT_NAME>_<UNIQUE_IDENTIFIER>	Integrationshändelser (Timeline V3 API)

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

Observera: HubSpot har lagt till två nya kolumner i alla händelsetabeller och vyer:

occurredat
occurredatdateint

Dessa kolumner kommer att ersätta kolumnerna occuredat och occuredatdateint den 24 november 2022. Från och med det datumet kommer de gamla kolumnerna inte längre att vara tillgängliga, och försök att söka efter ett databasobjekt eller en vy som innehåller händelser med hjälp av dessa kolumner kommer att misslyckas. Läs mer om väsentliga ändringar för Snowflake-datadelningar.

Kolumnnamn	Typ	Beskrivning
`EVENTTYPEID`	Varchar	ID för händelsetypen, liknande OBJECTTYPEID Du kan söka efter alla händelsetyp-ID:n i ditt konto med hjälp av vyn object_and_event_type_definitions.
`ID`	Varchar	Detta är unikt för varje händelsetyp. Det finns inte två poster med samma ID inom en viss händelsetyp.
`OBJECTTYPEID`	Varchar	Typen av objekt som utlöste händelsen. Till exempel skulle ett klick på en länk i ett e-postmeddelande visa`0-1` i denna kolumn, vilket representerar kontaktobjektet.
`OBJECTID`	Number	ID för den post som utlöste händelsen.
`OCCURREDAT`	Tidsstämpel	När händelsen inträffade.
`OCCURREDATDATEINT`	Nummer	Ett tal som anger när händelsen inträffade. Innehåller samma data som kolumnen `OCCURREDAT`, men formaterat som ett tal och används som en del av tabellens klusternyckel. I de flesta fall kan du använda tidsstämpeln `OCCURREDAT` istället för detta tal.
`OCCUREDATDATEINT`	Tal	Ett tal som anger när händelsen inträffade. Innehåller samma data som kolumnen `OCCURREDAT`, men formaterad som ett tal och används som en del av tabellens klusternyckel. I de flesta fall kan du använda tidsstämpeln `OCCURREDAT` istället för detta tal. Observera: denna kolumn kommer att fasas ut den 24 november 2022 och ersättas med `OCCURREDATDATEINT`.
`OCCUREDAT`	Tidsstämpel	När händelsen inträffade. Observera: denna kolumn kommer att fasas ut den 24 november 2022 och ersättas med `OCCURREDAT`.
`INGESTEDAT`	Tidsstämpel	Datum och tidpunkt då data senast importerades av Snowflake. Läs mer om kolumndatatyper.
`PROPERTY_*`	Varchar	Enskilda kolumner som innehåller händelseegenskaperna.

Exempel 1

Hämta de 50 senaste e-postklickhändelserna.

Fråga:

SELECT eventTypeId, objectTypeId, objectId, occuredAt, property_hs_click_raw_url AS hs_click_raw_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 e-postklickhändelser från de kontakter som klickat. Denna fråga hämtar kontaktdata genom att sammanfoga med object_with_object_properties.

Fråga:

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;

Resultat:

KLICK_TIDSTÄMPEL	KLICK_URL	CONTACT_FIRSTNAME	CONTACT_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
...	...	...	...

Objekt- och händelsetypsfrågor

object_and_event_type_definitions

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

Detta databasobjekt kan returnera följande kolumner:

Kolumnnamn	Typ	Beskrivning
`OBJECTTYPEID`	Varchar	ID för det objekt som pipelinen kan innehålla (t.ex. affärer eller ärenden).
`FULLYQUALIFIEDNAME`	Varchar	Namnet på objektet eller händelsen.
`INGESTEDAT`	Tidsstämpel	Datum och tidpunkt då data senast importerades 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.

Fråga:

SELECT objectTypeId, fullyQualifiedName
FROM object_and_event_type_definitions;

Returnerar:

OBJECTTYPEID	FULLYQUALIFIEDNAME
0–1	CONTACT
0–8	LINE_ITEM
0-11	KONVERSATION
...	...

Segmentfrågor

Nedan kan du lära dig hur du gör sökningar i dina segment, till exempel de tillgängliga kontakt- och företagssegmenten samt 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 segmentinformation såsom segmentnamn, storlek och objekttypen för de poster som ingår. Innehåller inte information om de enskilda posterna inom varje segment (se segment_membership).

Detta databasobjekt kan returnera följande kolumner:

Kolumnnamn	Typ	Beskrivning
`OBJECTTYPEID`	Varchar	Typen av poster i segmentet (t.ex. kontakt eller företag).
`SEGMENTID`	Number	Segmentets ID. Kopplas till kolumnenSEGMENTID i tabellen för segmentmedlemskap.
`CLASSICSEGMENTID`	Tal	Ett ID som är specifikt för kontaktsegment och som stämmer överens med ID:t i segmentets URL i HubSpot.
`NAME`	Varchar	Segmentets namn.
`SIZE`	Number	Antalet poster i segmentet.
`CREATEDBYUSERID`	Antal	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 tidpunkt då segmentet senast uppdaterades i HubSpot. Läs mer om datatyper för kolumner.
`INGESTEDAT`	Tidsstämpel	Datum och tidpunkt då data senast importerades av Snowflake.

Exempel 1

Hämta alla kontaktsegment.

Fråga:

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

Returnerar:

SEGMENTSID	NAMN	STORLEK
118131	Veckovis utskick	103
66156	Bloggprenumeranter	455
771 852	De flest 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';

Resultat:

SEGMENTID	NAMN	STORLEK
771 852	De största prenumeranterna 2021	37

segment_membership

Detta databasobjekt innehåller information om vilka poster som ingår i vilka segment, med en rad per post i segmentet. Om du till exempel har ett segment med namnet ”Bloggprenumeranter” med 500 kontakter kommer databasobjektet att returnera 500 rader.

Innehåller endast segment-ID:n och objekt-ID:n. För mer information, koppla ihop med databasobjektet ”segments ”.

Detta databasobjekt kan returnera följande kolumner:

Kolumnnamn	Typ	Beskrivning
`SEGMENTID`	Varchar	Segmentets ID. Kopplas till kolumnen HS_SEGMENT_ID i tabellen segments.
`OBJECTID`	Varchar	ID för posten i segmentet.
`UPDATEDAT`	Tidsstämpel	Datum och tidpunkt då uppgifterna senast uppdaterades i HubSpot. Läs mer om datatyper för kolumner.
`INGESTEDAT`	Tidsstämpel	Datum och tidpunkt då data senast importerades av Snowflake.

Exempel 1

Hämta ID:n för alla kontakter i segmentet”Toppprenumeranter 2021 ”.

Fråga:

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 samt övriga uppgifter för kontakterna i segmentet ”Top subscribers 2021 ”.

Fråga:

SELECT

contact.objectId AS object_id,

contact.properties:firstname::string AS förnamn,

contact.properties:lastname::string AS efternamn

FRÅN objekt_med_objektegenskaper AS kontakt

INNER JOIN segmentmedlemskap AS medlemskap

ON kontakt.objekt-Id = medlemskap.objekt-Id

INNER JOIN segment

ON medlemskap.segmentId = segment.segmentId

WHERE kontakt.objekttyp-Id = '0-1'

OCH segments.objectTypeId = '0-1'

OCH segments.name = 'Toppabonnenter 2021';

Resultat:

OBJECTID	FÖRNAMN	EFTERNAMN
54325098	Hobbes	Baron
96805401	Milo	Gold
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 bör du titta på kolumnerna i den rapport du jämför med. Om rapporten inte är tabellformad kan du konvertera den till en tabell för att se vilka kolumner 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. Du kan göra detta genom att göra en sökning i property_definitions:

SELECT * FROM property_definitions

WHERE label = [column_name]

Det finns kanske inte alltid en exakt matchning, eftersom vissa egenskapsnamn vanligtvis omvandlas till ett mer beskrivande namn i appen. I sådana fall kan det hjälpa att göra en ungefärlig sökning med operatorn LIKE på kolumnen label (eller till och med description) i property_definitions.

När du har fastställt vilken objekttyp kolumnen tillhör är det enkelt att avgöra vad du ska söka efter. Gör en sökning i object_with_object_properties och filtrera efter objectTypeId för den typen. Läs av de nödvändiga egenskapsvärdena från JSON-kolumnen properties.

Hur kopplar jag samman den här datatypen med en annan, t.ex. hur hämtar jag formulär för en kampanj?

För att hämta formulär som är kopplade till varje kampanj, gör en sammanfogning av OBJECT_WITH_OBJECT_PROPERTIES, ASSOCIATIONS och ASSOCIATION_DEFINITIONS.

SELECT DISTINCT

campaigns.properties:hs_name::string AS kampanjnamn,

formulär.egenskaper:hs_form_id::sträng AS form_id

FRÅN objekt_med_objektegenskaper AS kampanjer

JOIN associationer AS förening

PÅ förening.frånObjektId = kampanjer.objektId

JOIN association_definitions AS definition

ON definition.combinedAssociationTypeId =

association.combinedAssociationTypeId

JOIN objekt_med_objekt_egenskaper AS formulär

ON forms.objectId = association.toObjectId

DÄR kampanjer.objekttyp-Id = '0-35'

OCH formulär.objekttyp-ID = '0-28'

OCH definition.frånObjekttyp-ID = '0-35'

OCH definition.toObjectTypeId = '0-28';

Hur får jag reda på statusen för HubSpot-Snowflake-integrationen?

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

SELECT * FROM hubspot.public.data_share_status LIMIT 1

Resultaten visas enligt följande:

STATUS	MEDDELANDE	UPPDATERADAT
OK	INGA KÄNDA HÄNDELSER FÖR NÄRVARANDE	2023-04-10 09:21:20.123

Denna vy visar uppdateringar om integrationsstatusen i omvänd kronologisk ordning. Genom att integrera resultaten från denna sökning 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.

Sök i HubSpot-data i Snowflake

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

Datafördröjning och regionen för ditt Snowflake-konto

Konfigurera din Snowflake-miljö

Dataöversikt

Begränsa och sortera returnerade data

Datatyper för kolumner

Omvandling av datatyper

Objektfrågor

object_with_object_properties

Exempel 1

Exempel 2

objekt

Exempel 1

object_properties

Exempel 1

Exempel 2

object_properties_history

Exempel 1

Exempel 2

Associationsfrågor

association_definitions

Exempel 1

Exempel 2

associations

Exempel 1

Exempel 2

Exempel 3

Ägarfrågor

ägare

Exempel 1

Exempel 2

Exempel 3

Teamfrågor

team

Exempel 1

owner_team

Exempel 1

Pipeline-frågor

pipelines

Exempel 1

Exempel 2

pipeline_stages

Exempel 1

Exempel 2

Fastighetsfrågor

property_definitions

Exempel 1

Händelsefrågor

Exempel 1

Exempel 2

Objekt- och händelsetypsfrågor

object_and_event_type_definitions

Exempel 1

Segmentfrågor

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

Hur får jag reda på statusen för HubSpot-Snowflake-integrationen?

Relaterat innehåll