Hoppa till innehåll
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: 31 december 2025

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

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

Datalagring och din Snowflake-kontoregion

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

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

Konfigurera din Snowflake-miljö

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

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

  1. Klicka på verktygsfältetför arbetsbladet i den översta raden i arbetsbladet.

  2. I popup-fönstret:
    • Klicka på rullgardinsmenynLager och välj sedan dittlager.
    • Klicka på rullgardinsmenynDatabase och välj din HubSpot-databas.
    • Klicka på rullgardinsmenynSchema och välj sedan det schema du vill använda:
        • V2_DAILY: det dagliga schemat för att söka data baserat på tabeller. Data i detta schema uppdateras en gång per dag. Att använda detta schema resulterar i snabbare sökningar och rekommenderas för sökningar direkt i Snowflake.
        • V2_LIVE: det live-schema som baseras på Secure Views av HubSpot-data. Data i detta schema uppdateras upp till var 15:e minut. Om du söker i en stor datamängd kan sökningarna bli långsamma. I detta fall rekommenderas det att först kopiera data till din egen tabell med en ETL-process och sedan söka i den tabellen.


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

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


SELECT objectTypeId, property_createddate
FROM hubspot_share_name.V2_LIVE.objects_deals

LIMIT 1

Dataöversikt

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

  • Objekt: standardobjekt och anpassade objekt, såsom kontakter, företag, produkter. 
  • Poster: enskilda poster, såsom en enskild kontakt eller ett enskilt företag. 
  • Associationer: alla tillgängliga associationstyper och för närvarande associerade poster.
  • Händelser: händelsedata för både standardhändelser i HubSpot, såsom öppnade e-postmeddelanden, och anpassade beteendehändelser.
  • Segment: HubSpot-kontakt- och företagssegment.
  • Ägare: användare i ditt HubSpot-konto, i relation till de poster som de är angivna som ägare till.
  • Pipelines: affärs-och ärendepipelines, inklusive pipeline-stadier.
  • Egenskaper: egenskaper och deras värden i CRM-poster, inklusive egenskapshistorik.

Läs mer om HubSpots CRM-datamodell

Observera I takt med att vi utvecklar datadelningen kommer vi att införa förändringar, varav vissa är genomgripande. Vi rekommenderar starkt att du prenumererar på HubSpots förändringslogg för utvecklare. Dessa förändringar kommer alltid att publiceras i förändringsloggen före varje uppdatering.

Begränsa och sortera returnerade data

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


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

Datatyper för kolumner

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

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


För att returnera en specifik kolumn, inkludera den kolumnen i SELECT-fältet i din fråga. Till exempel kommer följande fråga endast att returnera kolumnerna OBJECTID och UpdatedAt:


SELECT
objectId, updatedAt
FROM objects_contacts

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

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

Omvandla datatyper

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


SELECT objectid, value AS amount_str, try_to_number(value) AS amount

FROM object_properties
WHERE objecttypeid='0-3' AND name='amount'
LIMIT 1

Objektfrågor

Nedan kan du lära dig hur du frågar data från specifika HubSpot-objekt och -poster, tillsammans med den data som returneras. 

Objektdata av olika typer organiseras och finns tillgängliga på två sätt: 

  • Individuell:Varje objekttyp lagras i sin egen vy och innehåller endast poster av samma objekttyp, t.ex. objects_contacts innehåller endast kontaktposter. Detta eliminerar behovet av att ange en objecttypeid vid sökning. Dessa vyer är enklare att söka i eftersom du inte behöver känna till ObjectTypeIds. De returnerar också data i ett mer användbart format där varje rad motsvarar ett objekt och den aktuella versionen av dess egenskaper. Så länge du inte upplever långsamma sökningar är det lämpligt att använda dessa vyer för att hämta objektdata. Se mer i Objects_X-vyer nedan. 
  • Kombinerade: Alla poster för alla objekttyper kombineras till ett databasobjekt. När du gör en sökning måste du därför ange ett filter som ”WHERE objectTypeId=’0-1’”. Du kan till exempel använda följande objecttypeids när du gör en sökning:
Objektnamn Objekttyp-ID
Kontakter 0-1
Företag 0-2
Rader 0-8

Anpassade objekt tilldelas ett ID när de skapas och identifieras som2-unique_ID. Till exempel2-12345. Läs mer om object_and_event_type_definitions.

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

objects_x-vyer

I detta databasobjekt har varje tillgänglig objekttyp, inklusive anpassade objekt, sin egen specifika vy, där varje vy endast innehåller poster för objekt av den specifika objekttypen. Dessa vyer namnges enligt formatet OBJECTS_<objekttypsnamn> där <objekttypsnamn> är pluralformen av objekttypen. (Observera att om objekttypen inte har någon pluralform, kommer <objekttypsnamn> helt enkelt att vara singularformen av objekttypsnamnet sammanfogat med ”S”).

Sökningar i denna vy returnerar en rad för varje post i ett objekt, där varje egenskap i objektet visas som en separat kolumn.

Nedan finns en omfattande lista över tillgängliga HubSpot-objekttyper (dvs. icke-anpassade), en kort beskrivning av de data de representerar och motsvarande vyer:

 

HubSpot Objekttyp

ObjectTypeId

Beskrivning

KONTAKT

0-1

Information om personer som interagerar med ditt företag.

FÖRETAG

0

Information om enskilda företag eller organisationer

AFFÄR

0

Detaljer om intäktsmöjligheter med en kontaktperson eller ett företag

ENGAGEMANG

0-4

Lagrar data från CRM-åtgärder, inklusive anteckningar, uppgifter, e-postmeddelanden, möten och samtal.

TICKET

0-5

Representerar kundernas förfrågningar om hjälp eller support

OFFERT

0-14

Används för att dela prisinformation med potentiella köpare

FORMULÄR

0-15

Detaljer för enskilda inlämningar för ett HubSpot-formulär

LINE_ITEM

0-8

Representerar en delmängd av produkter som säljs i en affär. När en produkt kopplas till en affär blir den en radpost.

CONVERSATION

0-11

Detaljer om inkommande meddelanden från flera kanaler.

LANDING_PAGE

0-25

Detaljer om dina landningssidor

 TASK

0

Lagrar information om att göra-listor

FORM

0-28

Används för att samla in leadinformation om dina besökare och kontakter

MARKETING_EMAIL

0-29

Detaljer om e-postmeddelanden från marknadsföringshubben

AD_ACCOUNT

0

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

Detaljer om enskilda annonser

KAMPANJ

0-35

Information om relaterade marknadsföringsresurser och innehåll, så att du enkelt kan mäta effektiviteten av dina samlade marknadsföringsinsatser.

SITE_PAGE

0-38

Data om enskilda sidor på dina webbplatser

BLOG_POST

0-39

Data om blogginlägg

OBJECT_SEGMENT

0-45

Information om grupperingar av objektposter baserat på deras egenskaper eller aktiviteter

CALL

0

Samtal som gjorts av andra CRM-poster, t.ex. kontakter

INVOICE

0

Hantera och synkronisera fakturor med externa redovisningssystem

MEDIA_BRIDGE

0

Information om medietillgångar som importerats till Hubspot

SEKVENS

0-58

En sekvens är en serie riktade, tidsinställda e-postmallar för att vårda kontakter över tid.

MALL

0-62

Sparat e-postinnehåll som kan återanvändas för att skicka e-postmeddelanden.

DEAL_SPLIT

0-72

Affärsuppdelningar används för att dela affärskrediter mellan flera användare

SALES_DOCUMENT

0-83

Försäljningsdokument skapar ett bibliotek med innehåll som hela teamet kan ladda upp och dela med sina kontakter.

FEEDBACK_SUBMISSION

0-19

Lagrar information som skickats in till en feedbackenkät.

SUBSCRIPTION

0

Prenumerationer innehåller information om återkommande betalningar.

HANDELSBETALNING

0

Innehåller data om medel som samlats in från kunder



Varje databasobjekt returnerar följande kolumner:

Kolumnnamn

Typ

Beskriv

OBJECTTYPEID

Varchar

ID för objekttypen (t.ex. kontakter är 0-1).

OBJECTID

Nummer

ID för posten (t.ex. en kontaktpost med ID 123752).

UPDATEDAT

Tidsstämpel

Datum och tidpunkt då detta objekt senast uppdaterades i HubSpot. 

INGESTEDAT

Tidsstämpel

Datum och tid då data senast importerades av Snowflake. 

PROPERTY_*

Varchar

Enskilda kolumner som innehåller den senaste versionen av objektets egenskaper. För varje objektegenskap som har en datum- eller taltyp (enligt specifikationen i property_definitions) finns det två kolumner: 

  1. En kolumn som innehåller egenskapsvärdet som sträng. Kolumnnamnet blir property_unparsed_[name] . Till exempel kommer DEAL-objektets egenskap deal_amount att ha kolumnen property_unparsed_deal_amount
  2. En kolumn som innehåller värdet konverterat till den ursprungliga typen. Kolumnen kommer att ha namnet property_[name]. Till exempel kommer DEAL-objektets egenskap deal_amount att ha kolumnen property_deal_amount. Observera att denna kolumn kommer att innehålla null 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.

Sökning:


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

FROM objects_contact

Returnerar:

OBJECTID

FIRSTNAME

LASTNAME

LIFECYCLESTAGE

54325098

Hobbes

Baron

led

96805401

Milo

Guld

bly

6922028

Henry

Riley

bly

Exempel 2

 

Hämta namnet och stadiet för upp till tre affärer.

Fråga:


SELECT objectId, property_dealName, property_dealStage,
property_amount AS dealAmount

FROM objects_deals

LIMIT 3

Returnerar:

OBJECTID

PROPERTY_DEALNAME

FASTIGHETSTRANSAKTIONSFAS

FASTIGHETSTRANSAKTIONSBELOPP

38960439

Affärens namn 1

closedwon

34199

321740651

Testaffär 123

14845019

8383663

98392101

Pop-up-tält

closedwon

9309007

 

Exempel 3

 

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

Fråga:

Eftersom affärsvärdet finns tillgängligt som ett numeriskt datatyp kan det användas för sortering utan att behöva konverteras eller omvandlas.


SELECT objectId, property_dealName, property_dealStage,
property_amount AS dealAmount

FROM objects_deals
ORDER BY property_amount DESC
LIMIT 3


Returnerar:

OBJECTID

PROPERTY_DEALNAME

FASTIGHETSTRANSAKTIONSFAS

FASTIGHETSTRANSAKTIONSBELOPP

98392101

Pop-up-tält

closedwon

9309007

321740651

Test Deal 123

14845019

8383663

38960439

Affärens namn 1

closedwon

34199

objekt_med_objektegenskaper

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

Denna vy kan returnera följande kolumner:

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

Observera Den 25 januari 2022 kommer kolumnen timestamp i tabellen och vyn object_with_object_properties, som representerar datum och tid då objektposten senast uppdaterades i HubSpot, att uppdateras. Detta för att anpassa sig till hur datetime-data representeras i resten av datadelningen.

Eftersom detta är en genomgripande förändring har den nya kolumnen updatedat lagts till i tabellen och vyn. Under de kommande 90 dagarna kommer dessa två nya kolumner att existera parallellt med timestamp, de kolumner som de ska ersätta. Detta ger dig möjlighet att byta till att använda de nya kolumnerna.

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

Exempel 1

Hämta alla kontakter och deras egenskaper.

Fråga:


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


Returnerar:

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

Exempel 2

Hämta namnet och stadiet för upp till tre affärer.

Fråga:


SELECT

objectId,
egenskaper:affärsnamn::sträng SOM affärsnamn,
egenskaper:affärsstadium::sträng SOM affärsstadium,
egenskaper:belopp::tal SOM affärsbelopp
FROM objekt_med_objektegenskaper
DÄR objectTypeId = '0-3'
LIMIT 3;


Returnerar:

OBJECTID DEALNAME DEALSTAGE DEALAMOUNT
38960439 Affärens namn 1 avslutadförlorad 7488939
321740651 Affärens namn 1 avslutadvunnen 9292029
98392101 Affärens namn 1 avslutadförlorad 62626528

objekt

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

Detta databasobjekt kan vara användbart om ditt konto har en stor mängd data, vilket leder till att vyerna object_with_object_properties och objects_x fungerar långsamt. Genom att använda detta databasobjekt tillsammans med databasobjektet object_properties är det möjligt att replikera data i object_with_object_properties, samtidigt som du behåller kontrollen över vilka egenskaper som returneras.

Detta databasobjekt kan returnera följande kolumner:

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

Exempel 1

Hämta alla kontaktposter.

Fråga:


VÄLJ objectTypeId, objectId
FRÅN objekt
DÄR objectTypeId = '0-1'


Returnerar:

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

object_properties

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

Detta databasobjekt kan returnera följande kolumner:

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

Exempel 1

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

Fråga:


VÄLJ objectTypeId, objectId, namn, värde
FRÅN object_properties
DÄR objectTypeId = '0-1'
OCH namn I ('förnamn', 'efternamn', 'stad')
ORDER BY objectId;


Returnerar:

OBJECTTYPEID OBJECTID NAME VÄRDE
0 10401 förnamn Brian
0-1 10401 stad Dublin
0-1 10401 efternamn Gallagher
0-1 23451 förnamn Fernando
0-1 23451 efternamn Fierro
0-1 25751 förnamn Charles
... ... ... ...

Exempel 2

Hämta förnamn, efternamn och livscykelstadium för alla kontakter och kombinera dem till en rad per kontakt. I det här exemplet används SQL PIVOT-syntax.

Fråga:


VÄLJ objectId, förnamn, efternamn, livscykelstadium
FROM
(
VÄLJ objectId, namn, värde
FROM objekt_egenskaper
DÄR objectTypeId = '0-1'
OCH namn I ('förnamn', 'efternamn', 'livscykelstadium')
)
PIVOT(MAX(värde) FÖR namn I ('förnamn', 'efternamn', 'livscykelstadium')) SOM p(objektId, förnamn, efternamn, livscykelstadium);

 

Returnerar:

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

object_properties_history

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

Detta databasobjekt kan returnera följande kolumner:

Kolumnnamn Typ Beskrivning
OBJECTTYPEID Varchar ID för objekttypen (t.ex. kontakter är 0-1).
OBJECTID Nummer ID för posten (t.ex. en kontaktpost med ID 123752).
NAME Varchar Namnet på egenskapen.
VALUE Tidsstämpel Värdet på egenskapen.
UPPDATERAD Tidsstämpel Datum och tidpunkt då data senast uppdaterades i HubSpot. Läs mer om kolumnens datatyper.
INGESTEDAT Tidsstämpel Datum och tidpunkt då data senast importerades av Snowflake. 

Exempel 1

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

Fråga:


VÄLJ objectId, namn, värde, uppdaterad vid
FROM objekt_egenskaper_historik
DÄR objectTypeId = '0-1'
OCH objectId = 136493192
OCH namn = 'hs_predictivescoringtier'
ORDER BY UPDATEDAT DESC;

 
Returnerar:

OBJECTID NAME VALUE UPPDATERAD

136493192

hs_predictivescoringtier

tier_1

2022-06-22 22:45:05.931

136493192

hs_predictivescoringtier

tier_2

2021-09-18 08:20:56.622

136493192

hs_predictivescoringtier

tier_3

2019-11-31 18:20:22.851

...

...

...

...

Exempel 2

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

Fråga:


VÄLJ
objectId,
egenskaper:förnamn::sträng SOM förnamn,
egenskaper:efternamn::sträng SOM efternamn
FROM objekt_med_objektegenskaper
DÄR objekt_med_objektegenskaper.objekttypId = '0-1'
OCH objectId I (
VÄLJ objectId
FRÅN objekt_egenskaper_historik
DÄRobjekt_egenskaper_historik.objekttypId = '0-1'
OCH object_properties_history.name = 'livscykelstadium'
OCH object_properties_history.värde = 'abonnent'
);


Returnerar:

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

Associeringsfrågor

Precis som objektdata organiseras associationsdata på två sätt:

  • Individuell: Varje associationstyp lagras i sin egen vy och innehåller endast poster av den typen. Till exempel innehåller associations_contacts_to_deals endast associationsposter mellan kontakt- och affärsobjekt. Detta eliminerar behovet av att ange en associationtypeid vid sökning. Dessa vyer är ganska lätta att söka i eftersom de inte kräver någon kunskap om CRM-datamodellen för att kunna användas. De returnerar också en utökad beskrivning av associationsposten mellan två objekt som enkelt kan användas i sammanfogningar med objects_x-vyer. Så länge du inte upplever långsamma sökningar är det lämpligt att använda dessa vyer för att hämta associationsdata. Se mer i associations_x_to_y-vyer nedan. 
  • Kombinerade: Alla poster för alla associationstyper kombineras till ett databasobjekt. När du gör en sökning måste du därför ange ett filter som ”WHERE combinedassociationtypeid=’0-32’ ”. Se mer i associations och association_definitions nedan.

associations_x_to_y-vyer

Varje associationstyp har sin egen vy, märkt som associations_<associationstypens namn>, t.ex. associations_contacts_to_deals. Varje vy är en delmängd av data i associationsdatabasobjektet och innehåller endast poster med en specifik combinedassociationtypeid.

Varje databasobjekt returnerar följande kolumner:

Kolumnnamn

Typ

Beskrivning

COMBINEDASSOCIATIONTYPEID

Varchar

Den unika identifieraren för associationsdefinitionen.

ASSOCIATIONCATEGORY

Varchar

Källan till associationstypen. En av följande: HUBSPOT_DEFINED, USER_DEFINED, INTEGRATOR_DEFINED

ASSOCIATIONTYPEID

Varchar

En unik identifierare för en associeringsdefinition inom en specifik associeringskategori, dvs. inga två definitioner i en associeringskategori kan ha samma associationtypeid. 

FROMOBJECTTYPEID

Varchar

Den objecttypeid som är källan till associationsdefinitionen.

FROMOBJECTTYPE

Varchar

Namnet på den objekttyp som är källan till associationsdefinitionen.

TOOBJECTTYPEID

Varchar

Objekttyp-id som är destinationen för associationsdefinitionen.

TOOBJECTTYPE

Varchar

Namnet på objektet som är destinationen för associationsdefinitionen.

NAME

Varchar

Namnet på associationsdefinitionen.

LABEL

Varchar

Beskrivningen av associationsdefinitionen.

ISMAINASSOCIATIONDEFINITION

Boolesk

Om associationsdefinitionen är huvudtypen. Om true är definitionen den som HubSpot visar på associerade poster

[FROMOBJECTTYPE_OBJECTID] t.ex. för vyn ASSOCIATIONS_CONTACTS_TO_DEALS blir detta CONTACT_OBJECTID

Number

Källobjektets objekt-ID.

[TOOBJECTTYPE_OBJECTID] t.ex. för vyn ASSOCIATIONS_CONTACTS_TO_DEALS är detta DEAL_OBJECTID.

Nummer

Objekt-ID för måletobjektet.

INGESTEDAT

Tidsstämpel

Datum och tidpunkt då data senast importerades av Snowflake.

Exempel 1

 

Hämta alla affärer som är associerade med en specifik kontakt.

Fråga:


SELECT
contact_objectId, deal_objectId

FROM associations_contacts_to_deals

WHERE contactId = 6626541373

 

Returnerar:

CONTACT_OBJECTID

DEAL_OBJECTID

6626541373

233620335

6626541373

90253678

Exempel 2

 

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


SELECT contacts.property_firstname contact_firstname,

kontakter.fastighets_efternamn kontakt_efternamn,
kontakter.fastighets_e-post kontakt_e-post,
affärer.fastighetsaffärstyp affärstyp, affärer.fastighetsbelopp affärsbelopp
FROM objects_kontakter kontakter
JOIN associations_kontakter_till_affärer assoc på
assoc.kontakt_objektid=kontakter.objektid
JOIN objects_deals deals på deals.objectid=assoc.deal_objectid
där contacts.property_hs_timezone='america_slash_bogota'

 

KONTAKT_FÖRNAMN

KONTAKT_EFTERNAMN

KONTAKT_EMAIL

AFFÄRSTYP

AFFÄRSBELOPP

David

Magalhães

dmagalhaes@example.com

nyverksamhet

74848

Fernanda

Rodrigues

fmoreira@example.com

newbusiness

253530

Exempel 3

 

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


VÄLJ SUM(affärer.fastighets_hs_stängningsbelopp) SOM
total_closed_amount, contacts.property_email contact_email
FROM objects_contacts kontakter
JOIN associations_contacts_to_deals assoc på
assoc.contact_objectid=kontakter.objectid
JOIN objects_deals deals på deals.objectid=assoc.deal_objectid
GROUP BY kontakt_e-post
ORDER BY total_closed_amount DESC

 

Returnerar:

TOTAL_CLOSED_AMOUNT

CONTACT_EMAIL

98474793

johndoe@riverview.com

849488

sallymae@longford.com

association_definitions

Detta databasobjekt innehåller information om alla tillgängliga associationstyper mellan HubSpot-objekt, med en rad per associationstyp. Du kan koppla detta databasobjekt till associationsdatabasobjektet för att få registerspecifik associationsinformation.

Det kan finnas flera typer av associationer mellan samma objekt. Den huvudsakliga associationstypen, som är den typ som visas i HubSpot när poster är associerade, använder associationen där ISMAINASSOCIATIONDEFINITION är sant.

Detta databasobjekt kan returnera följande kolumner:

Kolumnnamn Typ Beskrivning
COMBINEDASSOCIATIONTYPEID Varchar Den unika identifieraren för associationsdefinitionen.
KATEGORI Varchar Källan till associeringstypen. En av följande: HUBSPOT_DEFINED, USER_DEFINED, INTEGRATOR_DEFINED
ID Nummer Identifieraren för associationsdefinitionen inom sin kategori.
FROMOBJECTTYPEID Varchar ID för objektet som är källan till associationsdefinitionen.
TOOBJECTTYPEID Varchar ID för objektet som är destinationen för associationsdefinitionen.
NAME Varchar Namnet på associationsdefinitionen.
LABEL Varchar Associationsdefinitionens etikett.
ISMAINASSOCIATIONDEFINITION Boolesk Om associationsdefinitionen är huvudtypen. Om true är definitionen den som HubSpot visar på associerade poster.
INGESTEDAT Tidsstämpel Datum och tidpunkt då data senast importerades av Snowflake. Läs mer om kolumndatatyper.

Exempel 1 

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

Fråga:


VÄLJ combinedAssociationTypeId, fromObjectTypeId, toObjectTypeId, namn
FROM associationsdefinitioner
ORDER BY kategori, id

 
Returnerar:

COMBINEDASSOCIATIONTYPE FROMOBJECTTYPEID TOOBJECTTYPEID NAME
0 0 0-2 KONTAKT_TILL_FÖRETAG
0-2 0-2 0-1 FÖRETAG_ATT_KONTAKTA
0-3 0-3 0-1 AFFÄR_ATT_KONTAKTA
0-4 0-1 0-3 KONTAKT_TILL_AFFÄR
0-5 0-3 0-2 AFFÄR_TILL_FÖRETAG
... ... ... ...

Exempel 2

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

Fråga:


VÄLJkombineradAssociationTypeId, frånObjectTypeId, tillObjectTypeId, namn
FRÅN association_definitions
DÄR fromObjectTypeId = '0-3' OCH toObjectTypeId = '0-2'
OCH isMainAssociationDefinition = true

ORDER BY kategori, id


Returnerar:

KOMBINERAD ASSOCIERINGSTYP FRÅNOBJEKTTYPID TILLOBJEKTTYPID NAMN
0-5 0 0-2 DEAL_TO_COMPANY
0-271 0-3 0-2 DEAL_TO_PRIMARY_COMPANY
0-341 0-3 0-2 DEAL_TO_COMAPNY_UNLABELED

associationer

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

Detta databasobjekt kan vara användbart om ditt konto har en stor mängd data, vilket leder till att associations_x_to_y-vyerna fungerar långsamt.

Detta databasobjekt kan returnera följande kolumner:

Kolumnnamn Typ Beskrivning
COMBINEDASSOCIATIONTYPEID Varchar Den unika identifieraren för associationsdefinitionen.
FROMOBJECTID ID för källobjektet.
TOOBJECTID Nummer ID för målet.
INGESTEDAT Tidsstämpel Datum och tidpunkt då data senast importerades av Snowflake. Läs mer om kolumnens datatyper.

Exempel 1

Hämta alla associerade affärer och kontakter.

Fråga:


VÄLJ combinedAssociationTypeId, fromObjectId, toObjectId
FRÅN associations
DÄR combinedAssociationTypeId = '0-5'

 
Returnerar: 

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

Exempel 2 

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

Fråga:


VÄLJ combinedAssociationTypeId, fromObjectId, toObjectId
FRÅN associations
DÄR associationCategory = 'HUBSPOT_DEFINED'
OCH combinedAssociationTypeId = '0-15'
OCH fromObjectId = 3005;


Returnerar:

KOMBINERAD ASSOCIATIONSTYP FRÅNOBJEKTID TILLOBJEKTID
0-5 6626541373 233620335

Exempel 3 

Hämta alla affärer som är kopplade till en specifik kontakt (kontakt-ID: 4464). I stället för att hårdkoda combinedAssociationTypeId, sammanfogar detta exempel med association_definitions.

Fråga:


VÄLJ combinedAssociationTypeId, fromObjectId toObjectId,
FRÅN associationer
DÄR
kombineradAssociationTypeId = (
SELECT combinedAssociationTypeId
FRÅN association_definitions
DÄR fromObjectTypeId = '0-1'
OCH toObjectTypeId = '0-3'
OCH isMainAssociationDefinition)
OCH fromObjectId = 4464;


Returnerar:

KOMBINERAD ASSOCIERINGSTYPID FROMOBJECTID TILLOBJEKTID
0-5 6626541373 233620335

Ägarfrågor

ägare

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

Detta databasobjekt kan returnera följande kolumner:

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

Exempel 1 

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

Sökning:


VÄLJ ägar-ID, användar-ID, e-postadress, förnamn, efternamn
FRÅN ägare
DÄR arkiverad = falsk

 
Returnerar: 

OWNERID USERID 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:


VÄLJ ägar-ID, användar-ID, e-postadress, förnamn, efternamn
FRÅN ägare
DÄR ägar-ID = 29584574;


Returnerar: 

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

Exempel 3

Hämta alla kontakter och deras ägare. Denna fråga sammanfogar poster till ägare med object_with_object_properties och kontaktattributet hubspot_owner_id.


SELECT
kontakt.objektId kontaktid,
kontakt.egendom_förnamn kontakt_förnamn,
kontakt.egenskap_efternamn kontakt_efternamn,
kontakt.egendom_hubspot_ägare_id kontakt_hubspot_ägare_id,
ägare.förnamn ägarens_förnamn,
ägare.efternamn ägarens efternamn,
ägare.e-post ägare_e-post
FROM objects_contacts kontakt

JOIN ägare ägare PÅ kontakt.property_hubspot_owner_id = ägare.ägareId


Returnerar: 

CONTACTID KONTAKTNAMN KONTAKTNAMN KONTAKT_HUBSPOT_ÄGAR_ID ÄGARENS FORNAMN ÄGARENS EFTERNAMN ÄGARENS_E-POSTADRESS
113834202 Richard Greenfield 29584574 Hobbes Baron hobbes.b@business.com
53540801 Ford Karl 30241125 Milo Guld milo.g@business.com
... ... ... ... ... ... ...

Teamfrågor

team

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

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

Detta databasobjekt kan returnera följande kolumner:

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

Exempel 1

Hämta alla team.

Fråga:

VÄLJ teamId,teamName, primaryOwnerMembers

FRÅN team

Returnerar:

TEAMID TEAMNAME PRIMÄRA ÄGARE
29584574 Underteam [233620335, 1234553]
30532717 Superteam [3866015468, 126221873]
3058032 A-laget [7132752747]

owner_team

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

Detta databasobjekt kan returnera följande kolumner:

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

Exempel 1

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

Fråga:

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

Returnerar

TEAMID TEAMNAME ISTEAMPRIMARY
29584574 233620335 SANT
29584574 1234553 SANT 

Pipeline-frågor

Nedan kan du lära dig hur du gör förfrågningar om affärs- och ärendepipeline-data, till exempel tillgängliga pipelines i ditt konto och deras stadier.

Du kan koppla samman dessa data med objektdata för att få en fullständig bild av dina pipelines. Du kan till exempel söka efter affärer och deras pipelines genom att koppla samman data från objects_deals_view eller object_with_object_properties med pipeline-data.

pipelines

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

Denna tabell kan returnera följande kolumner:

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

Exempel 1

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

Fråga:


VÄLJ objectTypeId, pipelineId, label
FRÅN pipelines
DÄR objectTypeId = '0-3'
OCH inte arkiverad
ORDER BY displayorder;

 
Returnerar: 

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

Exempel 2

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

Fråga:


VÄLJ

affärer.objektId affär_id,
affärer.fastighetsaffärsnamn affärsnamn,
pipelines.label pipeline_name
FROM objects_deals deals
INNER JOIN pipelines
ON deals.objectTypeId = pipelines.objectTypeId
OCH deals.property_pipeline = pipelines.pipelineid
DÄR pipelines.objekttypId = '0-3';


Returnerar: 

DEAL_ID DEAL_NAME PIPELINE_NAME
605140072 Meowmix Global Registrering Försäljningspipeline
605457408 Friskies omprofilering Försäljningspipeline
604362473 Fresh Step App Build Försäljningspipeline

 

Exempel 3

 

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


SELECT
affärer.objektId affär_id,
affärer.egenskaper:affärsnamn::varchar affärsnamn,
pipelines.label pipeline_name
FROM objekt_med_objektegenskaper affärer
INNER JOIN pipelines
ON deals.objectTypeId = pipelines.objectTypeId
AND deals.properties:pipeline::string = pipelines.pipelineid
DÄR deals.objecttypeId = '0-3'
OCH pipelines.objekttypId = '0-3';

 

Returnerar: 

DEAL_ID

DEAL_NAME

PIPELINE_NAME

605140072

Meowmix Global Registrering

Försäljningspipeline

605457408

Friskies omprofilering

Försäljningspipeline

604362473

Fresh Step App Build

Försäljningspipeline

pipeline_stages

Denna vy innehåller information om enskilda steg inom en pipeline. Identifiera steg genom att kombinera objekttyp-ID, pipeline-ID och steg-ID. När du sammanfogar med pipelines använder du objekttyp-ID och pipeline-ID.

Detta databasobjekt kan returnera följande kolumner:

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

Exempel 1 

Hämta pipeline-steg för en affärspipeline med namnetFörsäljningspipeline.

Fråga:


VÄLJ pipelineid, stageId, label
FROM pipeline_stages
DÄR inte arkiverat
OCH pipelineid = (
VÄLJ pipelineid
FROM pipelines
DÄR objectTypeId = '0-3'
OCH inte arkiverad
OCH etikett = 'Försäljningspipeline' BEGRÄNSNING 1)
ORDER BY displayorder;

 
Returnerar: 

PIPELINEID STAGEID LABEL
941650 941651 Kontakt
941650 941652 Möte inbokat
941650 941653 Faktura skickad
... ... ...

Exempel 2

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

Fråga:


VÄLJ

affärer.objektId affär_id,
affärer.egenskaper:affärsnamn::varchar affärsnamn,
pipelines.label pipeline_name,
pipeline_stages.label pipeline_stage_name
FROM objekt_med_objektegenskaper affärer
INNER JOIN pipelines
ON deals.objectTypeId = pipelines.objectTypeId
AND deals.egenskaper:pipeline::sträng = pipelines.pipelineid
INNER JOIN pipeline_stages
ON deals.objectTypeId = pipeline_stages.pipelineid
OCH deals.properties:pipeline::string = pipeline_stages.pipelineid
OCH deals.properties:dealstage::string = pipeline_stages.stageId
DÄR deals.objecttypeId = '0-3';


Returnerar: 

DEAL_ID DEAL_NAME PIPELINE_NAME PIPELINE_STAGE_NAME
605140072 Meowmix Global Registrering Försäljningspipeline Kontrakt skickat
605457408 Friskies omprofilering Försäljningspipeline Möte inbokat
604362473 Fresh Step App-utveckling Försäljningspipeline Kontrakt undertecknat
... ... ... ...

Fastighetsfrågor

property_definitions

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

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

Detta databasobjekt kan returnera följande kolumner:

Kolumnnamn Typ Beskrivning
OBJECTYPEID Varchar ID för det objekt som händelsen avser.
NAME Varchar Egenskapens interna namn.
LABEL Varchar Egenskapens etikett.
BESKRIVNING Varchar Egenskapsbeskrivningen.
TYP Varchar Egenskapens typ (t.ex. sträng, tal, datum och tid).
FIELDTYPE Varchar Egenskapens fälttyp. Definierar hur egenskapen visas i HubSpot och i formulär (t.ex. kryssruta, rullgardinsmeny).
DISPLAYORDER Number Egenskapens visningsordning.
GROUPNAME Varchar Fastighetens gruppnamn.
OPTIONS Variant För uppräkningsegenskaper, en matris med egenskapens alternativ, inklusive varje alternativs attribut (t.ex. visningsordning, etikett).
CREATEDUSERID ID för den användare som skapade egenskapen.
REFERENCEDOBJECTTYPE Varchar Den typ av objekt som egenskapen refererar till. Ägaregenskaper returnerar värdet OWNER.
CALCULATED Boolean Om egenskapen är en beräknad egenskap.
EXTERNALOPTIONS Boolesk Om egenskapens alternativ definieras i ett externt system.
HASUNIQUEVALUE Boolesk Om egenskapens värden är unika. Kan endast ställas in när en egenskap skapas via API.
HIDDEN Boolesk Om egenskapen är dold i HubSpot.
SHOWCURRENCYSYMBOL Boolesk Om ett numeriskt egenskapsvärde är formaterat som valuta.
FORMFIELD Boolesk Om denna egenskap kan användas i formulär.
READONLYDEFINITION Boolesk Om egenskapen kan redigeras i HubSpot.
READONLYVALUE Boolesk Om egenskapens värde kan redigeras i HubSpot.
HUBSPOTDEFINED Boolesk Om egenskapen skapades av HubSpot eller av en användare.
ARKIVERAD Boolesk Om egenskapen har raderats.
CREATEDAT Tidsstämpel Datum och tid då egenskapen skapades i HubSpot.
UPDATEDAT Tidsstämpel Datum och tid då data senast uppdaterades i HubSpot. Läs mer om kolumnens datatyper.
INGESTEDAT Tidsstämpel Datum och tidpunkt då data senast importerades av Snowflake. 

Exempel 1

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

Fråga:


VÄLJ namn, etikett, beskrivning
FROM fastighetsdefinitioner
DÄR objectTypeId = '0-1'

 
Returnerar:

NAME LABEL BESKRIVNING
entered_sql_stage Inmatad SQL-fas Starta räkningen av SQL-stegdagar.
first_conversion_event_name
Första konvertering Det första formuläret som denna kontakt skickade in.
adress Gatuadress Kontaktens adress.

Händelsefrågor

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

Nam  
EVENTS_AD_INTERACTION Detaljer om en annons och kontakter som interagerat med den genom att klicka på annonsen eller skicka in ett formulär efter att ha engagerat sig i den.
EVENTS_AD_METRICS_IMPORTED_V0

Detaljer om en annons och dess prestationsmått.
EVENTS_CALL_MENTIONED_KEYWORD Detaljer om nyckelord som nämnts av deltagare i samtal.
EVENTS_CLICKED_LINK_IN_EMAIL_V2

Länkar som klickats på i marknadsföringsmejl av kontakter.
EVENTS_CLICKED_LINK_IN_TRACKED_INBOX_EMAIL_V8 Länkar som klickats på i e-postmeddelanden i konversationsinkorgen av kontakter.
EVENTS_COOKIE_BANNER_CLICKED Kontakter som klickat på cookies.
EVENTS_COOKIE_BANNER_VIEWED Kontakter som har visat cookies.
EVENTS_DOCUMENT_SHARED_V2 Försäljningsdokument som delats med kontakter via en extern länk.
EVENTS_DOCUMENT_VIEWED_V2 Försäljningsdokument och kontakter som har visat dem genom att öppna den externa länken.
EVENTS_DOCUMENT_COMPLETED_V2 Försäljningsdokument och kontakter som har avslutat dem.
EVENTS_HS_SCHEDULED_EMAIL_V2 E-postmeddelanden som skickats till HubSpots e-postservrar för att skickas.
EVENTS_MTA_DELIVERED_EMAIL_V2 E-postmeddelanden som framgångsrikt har levererats till mottagarna av HubSpots e-postservrar.
EVENTS_MTA_BOUNCED_EMAIL_V2 E-postleveransförsök som avvisats av mottagarens e-postserver.
EVENTS_OPENED_EMAIL_V2 E-postmeddelanden som öppnats av kontakter.
EVENTS_REPORTED_SPAM_EMAIL_V2 E-postmeddelanden som markerats som skräppost av mottagarna.
EVENTS_UPDATED_EMAIL_SUBSCRIPTION_STATUS_V2 Ändringar av e-postprenumerationer av mottagare.
EVENTS_OPENED_TRACKED_INBOX_EMAIL_V8 Öppnade e-postmeddelanden i inkorgen för konversationer av kontakter.
EVENTS_MB_MEDIA_PLAYED Videouppspelningsaktivitet av kontakter.
EVENTS_V2_CONTACT_BOOKED_MEETING_THROUGH_SEQUENCE Kontakten bokade ett möte via sekvens.
EVENTS_V2_CONTACT_ENROLLED_IN_SEQUENCE Kontakten har anmält sig från sekvensen.
EVENTS_V2_CONTACT_FINISHED_SEQUENCE Sekvensen avslutad.
EVENTS_V2_CONTACT_REPLIED_SEQUENCE_EMAIL Kontakt svarade på e-post (eller inkommande e-post som avregistrerade sekvensen) som skickades via sekvensen.
EVENTS_V2_CONTACT_AVREGISTRERAD_FRÅN_SEKVENS Kontakten har avregistrerat sig från sekvensen.
EVENTS_V2_CONTACT_UNENROLLED_MANUALLY_FROM_SEQUENCE Användaren har manuellt avregistrerat kontakten.
EVENTS_V2_CONTACT_UNSUBSCRIBED_SEQUENCE_EMAIL Kontakten har avslutat prenumerationen och avregistrerats från sekvensen.
EVENTS_V2_SEQUENCE_EMAIL_BOUNCED Sekvensens e-post har studsat tillbaka.
EVENTS_V2_SEQUENCE_ERRORED Sekvensfel som orsakar avregistrering.
EVENTS_V2_SEQUENCE_STEP_EXECUTED Sekvenssteg utfört.
EVENTS_VISITED_PAGE Besök på webbplatsen av kontakter.
EVENTS_<INTEGRATION_EVENT_NAME>_<UNIQUE_IDENTIFIER> Integrationshändelser (Timeline V3 API)

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

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

  • inträffade
  • 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 viktiga ändringar för Snowflake-datadelning.



Kolumnnamn Typ Beskrivning
EVENTTYPEID Varchar ID för händelsetypen, liknande OBJECTTYPEID
Du kan söka efter alla händelsetyps-ID:n i ditt konto med hjälp av vyn object_and_event_type_definitions.
ID Varchar Detta är unikt för varje händelsetyp. Inga två poster kan ha samma ID inom en given händelsetyp.
OBJECTTYPEID Varchar Den typ av objekt som slutförde händelsen. Till exempel skulle ett klick på en e-postlänk visa0-1 i denna kolumn, vilket representerar kontaktsobjektet.
OBJECTID Number ID för den post som slutförde händelsen.
OCCURREDAT Tidsstämpel När händelsen inträffade.

OCCURREDATDATEINT

 

Nummer Ett nummer som representerar när händelsen inträffade. Innehåller samma data som kolumnen OCCURREDAT, men formaterad som ett nummer och används som en del av tabellens klusternyckel. I de flesta fall kan du använda tidsstämpeln OCCURREDAT istället för detta nummer.

OCCUREDATDATEINT

Nummer

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 kolumnens datatyper.
PROPERTY_* Varchar Enskilda kolumner som innehåller händelseegenskaperna.

Exempel 1

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

Fråga:


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

LIMIT 50;


Returnerar: 

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

Exempel 2

Hämta alla e-postklickhändelser från de kontakter som klickat. Denna fråga hämtar kontaktdata genom att koppla ihop med object_with_object_properties.

Sökning:


SELECT
klick.occuredat klick_timestamp,
klick.egenskap_hs_klick_rå_url klick_url,
contact.properties:firstname::varchar contact_firstname,
contact.properties:lastname::varchar contact_lastname
FROM events_clicked_link_in_email_V2 klick
LEFT JOIN objekt_med_objektegenskaper kontakt
ON click.objectTypeId = contact.objectTypeId
AND klick.objektId = kontakt.objektId
LIMIT 3;


Returnerar: 

KLICKTID KLICK_URL KONTAKT_FÖRNAMN KONTAKT_EFTERNAMN
2019-01-04 22:35:41.264 https://help.website.com/articles/tutorial/how-to-use-email-tool?utm_source=hs_automation&utm_medium=email&utm_content=68042217 Hobbes Baron
2018-11-08 09:37:41.400 https://www.website.net/webinar-case-study?utm_source=hs_automation&utm_medium=email&utm_content=55200164 Milo Gold
2018-11-08 09:37:41.426 https://www.website.net/contact?utm_source=hs_automation&utm_medium=email&utm_content=55200164 Harlow Villari
... ... ... ...

Object_and_event_type_queries

object_and_event_type_definitions

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

Detta databasobjekt kan returnera följande kolumner:

Kolumnnamn Typ Beskrivning
OBJECTTYPEID Varchar ID för objektet som pipeline kan innehålla (t.ex. affärer eller biljetter).
FULLYQUALIFIEDNAME Varchar Namnet på objektet eller händelsen.
INGESTEDAT Tidsstämpel Datum och tidpunkt då data senast importerades av Snowflake. Läs mer om kolumndatatyper.

Exempel 1

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

Sökning:


VÄLJ objectTypeId, fullständigtNamn
FRÅN objekt-och-händelsetypdefinitioner;

 
Returnerar: 

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

Segmentfrågor

Nedan kan du lära dig hur du söker i dina segment, till exempel tillgängliga kontakt- och företagssegment och de poster som ingår i dessa segment.

segment

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

Detta databasobjekt kan returnera följande kolumner:

Kolumnnamn Typ Beskrivning
OBJECTTYPEID Varchar Typ av poster i segmentet (t.ex. kontakt eller företag).
SEGMENTID Nummer Segmentets ID. Kopplas till kolumnenSEGMENTID i tabellen segment-medlemskap.
CLASSICSEGMENTID Nummer Ett ID som är specifikt för kontaktsegment och som matchar ID:t i URL:en för segmentet i HubSpot.
NAME Varchar Segmentets namn.
STORLEK Antal Antalet poster i segmentet.
CREATEDBYUSERID Antal ID för den användare som skapade segmentet.
CREATEDAT Tidsstämpel När segmentet skapades i HubSpot.
UPPDATERAD AV ANVÄNDAR-ID Nummer ID för den användare som senast uppdaterade segmentet.
UPPDATERAD Tidsstämpel Datum och tidpunkt då segmentet senast uppdaterades i HubSpot. Läs mer om kolumnens datatyper
INGESTEDAT Tidsstämpel Datum och tidpunkt då data senast importerades av Snowflake.

Exempel 1

Hämta alla kontaktsegment.

Fråga:


VÄLJ segmentId, namn, storlek
FRÅN segment
DÄR objectTypeId = '0-1';

 
Returnerar: 

SEGMENTSID NAME SIZE
118131 Veckans räckvidd 103
66156 Bloggprenumeranter 455
771852 De mest populära prenumeranterna 2021 37
... ... ...

Exempel 2

Hämta ett specifikt kontaktsegment med namnet Top subscribers 2021

Fråga:


VÄLJ segmentId, namn, storlek 
FRÅN segment
DÄR objectTypeId = '0-1'
OCH
segmentName = 'Top subscribers 2021';


Returnerar: 

SEGMENTID NAMN STORLEK
771852 De mest populära prenumeranterna 2021 37

segment_membership

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

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

Detta databasobjekt kan returnera följande kolumner:

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

Exempel 1

Hämta ID:n för alla kontakter i segmentetTop prenumeranter 2021.

Fråga:


VÄLJ objektId
FRÅN segmentmedlemskap
INNER JOIN segment
ON segment_memberships.segmentId = segments.segmentId
WHERE segments.objectTypeId = '0-1'
OCH segments.name = 'Top Subscribers 2021';

 
Returnerar: 

OBJECTID
54325098
96805401
6922028
...

Exempel 2

Hämta för- och efternamn för kontakter i segmentet Top subscribers 2021.

Fråga:


VÄLJ

contact.objectId AS objectid,
contact.property_firstname AS firstname,
contact.property_lastname AS lastname
FROM objects_contacts kontakt
INNER JOIN segmentmedlemskap PÅ kontakt.objektId = segmentmedlemskap.objektId
INNER JOIN segment PÅ segment_medlemskap.segmentId = segment.segmentId
DÄR segment.objekttypId = '0-1'
OCH segments.name = 'Top Subscribers 2021'


Returnerar: 

OBJECTID

FÖRNAMN

EFTERNAMN

54325098

Hobbes

Baron

96805401

Milo

Gold

6922028

Henry

Riley

...

...

...

Vanliga

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


I allmänhet bör du titta på kolumnerna i den rapport du jämför med. Om rapporten inte är tabellformad kan du konvertera den till en tabell för att visa kolumnerna i rapporten. Dessa kolumner är vanligtvis egenskaper för en objekttyp eller en händelsetyp. Nästa steg är att ta reda på vilken objekttypsegenskap en kolumn motsvarar. Du kan göra detta genom att fråga property_definitions:


VÄLJ * FRÅN egenskapsdefinitioner

DÄR etikett = [kolumnnamn]

 

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

När du har fastställt vilken objekttyp kolumnen tillhör är det enkelt att avgöra vad du ska söka efter. Du kan helt enkelt söka efter den object_x-vy som motsvarar typen.

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


Om du behöver länka två eller flera olika poster till varandra kan du titta på associationer. Associationer representerar relationerna mellan objekt i HubSpot CRM. Alla olika associationer som är möjliga mellan två typer listas i association_definitions. I exemplet ovan måste du fråga ASSOCIATIONS_CAMPAIGNS_TO_FORMS för att få reda på alla formulär som en kampanj är länkad till:


VÄLJ kampanjer.property_hs_name kampanjnamn,
formulär.fastighets-hs-formulär-id formulär-id
FROM objects_campaigns kampanjer
JOIN associations_campaigns_to_forms assoc ON
assoc.kampanjobjektid=kampanjer.objektid
JOIN objects_forms forms ON forms.objectid=assoc.form_objectid
GROUP BY kampanjnamn

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

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

SELECT * FROM hubspot.public.data_share_status
LIMIT 1

Resultaten visas som:

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

Denna vy visar uppdateringar om integrationsstatusen i omvänd kronologisk ordning. Genom att integrera resultaten från denna fråga i en instrumentpanel kan du spåra integrationens prestanda och upptäcka eventuella driftstopp eller avbrott. 

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