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 HubSpot-data i Snowflake

Senast uppdaterad: februari 1, 2024

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

Operations Hub Enterprise

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

Datalagring och din Snowflake-kontoregion

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

Konfigurera din Snowflake-miljö

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

För att välja lager, databas och schema på kalkylbladsnivå:

  • I den övre raden i kalkylbladet klickar du på fältet Åtgärder för kalkylblad.

    snowflake-worksheet-settings0
  • I popup-fönstret:
    • Klicka på rullgardinsmenyn Lager och välj sedan ditt lager.
    • Klicka på rullgardinsmenyn Databas och välj sedan din HubSpot-databas.
    • Klicka på rullgardinsmenyn Schema och välj sedan det schema du vill använda:
        • V2_DAILY: det dagliga schemat för att fråga efter data baserat på tabeller. Data i detta schema uppdateras en gång per dag. Det här schemat ger snabbare förfrågningar och rekommenderas för förfrågningar direkt i Snowflake.
        • V2_LIVE: live-schema baserat på säkra vyer av HubSpot-data. Data i detta schema uppdateras upp till var 15:e minut. Om du frågar efter en stor uppsättning data kan förfrågningarna vara långsamma. I så fall rekommenderar vi att du först kopierar data till en egen tabell med en ETL-process och sedan ställer frågor till den tabellen.


      snowflake-worksheet-settings-window0

Med din miljö konfigurerad kan du göra förfrågningar till dina HubSpot-data utan att behöva lägga till din databas eller schematyp till förfrågningar manuellt.

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


SELECT objectTypeId, property_createddate
FROM hubspot_share_name.V2_LIVE.objects_deals

LIMIT 1

Översikt över data

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

  • Objekt: standardobjekt och anpassade objekt, t.ex. kontakter, företag, produkter.
  • Register: enskildaregister , t.ex. en enskild kontakt eller ett enskilt företag.
  • Associations: alla tillgängliga associationstyper och för närvarande associerade poster.
  • Händelser: händelsedata för både HubSpot-standardhändelser, t.ex. öppnade e-postmeddelanden, och anpassade beteendehändelser.
  • Listor: HubSpot kontakt- och företagslistor.
  • Ägare: användare i ditt HubSpot-konto, i förhållande till de poster som de är angivna som ägare till.
  • Pipelines: pip elines för affärer och ärenden, inklusive pipeline-steg.
  • Fastigheter: fastigheter och deras värden i CRM-poster, inklusive fastighetshistorik.

Läs mer om HubSpots CRM-datamodell.

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

Begränsa och beställa returnerade data

När du konstruerar frågor kan du styra hur mycket data som returneras, samt i vilken ordning de returneras, genom att inkludera LIMIT 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 sortera dem efter kontakt-ID, kan du konstruera din fråga på följande sätt:


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

Datatyper för kolumner

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

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

snowflake-sidebar-view-column-details0


Om du vill returnera en specifik kolumn inkluderar du den kolumnen i SELECT -fältet i din fråga. Följande fråga returnerar till exempel endast 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 finns med nedan, se de enskilda vydefinitionerna i artikeln ovan.

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

Omvandling av datatyper

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


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

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

Objektfrågor

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

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

  • Individuell: Varje objekttyp lagras i en egen vy och innehåller endast poster av samma objekttyp, t.ex. innehåller objects_contacts endast kontaktposter. Detta eliminerar behovet av att ange ett objecttypeid när du ställer frågor. Dessa vyer är enklare att fråga efter eftersom du inte behöver känna till ObjectTypeIds. De returnerar också data i ett mer användbart format där varje rad motsvarar ett objekt och den aktuella versionen av dess egenskaper. Så länge du inte upplever långsamma förfrågningar är det lämpligt att använda dessa vyer för att hämta objektdata. Se mer i Objects_X-vyer nedan.
  • Kombinerad: Alla poster för alla objekttyper kombineras till ett databasobjekt. När du ställer en fråga måste du därför ange ett filter som "WHERE objectTypeId='0-1'. Du kan till exempel använda följande objekttyp-ID när du ställer frågor:
Objektets namn ObjektTypId
Kontakter 0-1
Företag 0-2
Poster 0-8

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

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

objekt_x vyer

I detta databasobjekt har varje tillgänglig objekttyp, inklusive anpassade objekt, sin egen specifika vy och varje vy innehåller endast poster för objekt av den specifika objekttypen. Dessa vyer namnges enligt formatet OBJECTS_<object type name> där <object type name> är objekttypens pluralform.(Observera att om objekttypen inte har någon pluralform, kommer <object type name> helt enkelt att vara objekttypens singularform med ett "S" som konkateneras).

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

Se nedan den omfattande listan över tillgängliga HubSpot-objekttyper (dvs. icke-anpassade), en kort beskrivning av de data de representerar och deras motsvarande vyer:

HubSpot Objekttyp

ObjektTypId

Beskrivning

KONTAKT

0-1

Information om individer som interagerar med ditt företag

FÖRETAG

0-2

Information om enskilda företag eller organisationer

DEAL

0-3

Information om intäktsmöjligheter med en kontakt eller ett företag.

ENGAGEMANG

0-4

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

BILJETT

0-5

Ta hand om kundernas förfrågningar om hjälp eller support.

CITAT

0-14

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

FORMULÄR_SUBMISSION

0-15

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

LINE_ITEM

0-8

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

KONVERSATION

0-11

Detaljer om inkommande meddelanden från flera kanaler.

LANDNINGSSIDA

0-25

Detaljer om dina landningssidor

UPPGIFT

0-27

Lagrar information om att-göra-listor

FORM

0-28

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

MARKNADSFÖRING_E-POST

0-29

Information om e-post från marknadsföringsnav

AD_ACCOUNT

0-30

Lagrar information om dina annonskonton på Linkedin, Facebook och Google

AD_CAMPAIGN

0-31

Detaljer om dina annonskampanjer. En annonskampanj kan innehålla en eller flera annonser

AD_GROUP

0-32

Logisk gruppering av annonser inom en annonskampanj

AD

0-33

Detaljer om enskilda annonser

KAMPANJ

0-35

Information om relaterade marknadsföringstillgångar och innehåll, så att ni enkelt kan mäta effektiviteten i era gemensamma marknadsföringsinsatser.

SITE_PAGE

0-38

Uppgifter om enskilda sidor på dina webbplatser

BLOGG_POST

0-39

Data om blogginlägg

OBJEKTLISTA

0-45

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

RING

0-48

Samtal från andra CRM-poster, t.ex. kontakter

INVOICE

0-53

Hantera och synkronisera fakturor med externa redovisningssystem

MEDIA_BRIDGE

0-57

Information om mediatillgångar som importerats till Hubspot

SEQUENS

0-58

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

DEAL_SPLIT

0-72

Deal splits används för att fördela krediter mellan flera användare

SALES_DOKUMENT

0-83

Försäljningsdokument skapar ett bibliotek med innehåll för hela ditt team som kan ladda upp och dela dokument med dina kontakter.

FEEDBACK_SUBMISSION

0-19

Lagrar information som lämnats i en feedbackundersökning.

PRENUMERATION

0-69

Prenumerationer innehåller uppgifter om återkommande betalningar

HANDEL BETALNING

0-101

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



Varje databasobjekt returnerar följande kolumner:

Kolumnnamn

Typ

Beskrivning

OBJECTTYPEID

Varchar

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

OBJECTID

Antal

Postens ID (t.ex. en kontaktpost med ID 123752).

UPPDATERADAT

Tidsstämpel

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

INGESTEDAT

Tidsstämpel

Datum och tid då data senast togs emot av Snowflake.

PROPERTY_*

Varchar

Enskilda kolumner som innehåller den senaste versionen av objektets egenskaper.För varje objektsegenskap som har en datum- eller taltyp (enligt property_definitions) kommer det att finnas två kolumner:

  1. En kolumn som innehåller egenskapens värde som sträng. Kolumnnamnet kommer att vara property_unparsed_[name] . Till exempel kommer egenskapen deal_amount för DEAL-objektet 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], t.ex. kommer DEAL-objektegenskapen deal_amount att ha kolumnen property_deal_amount. Observera att denna kolumn kommer att innehålla null om konverteringen till ursprunglig typ misslyckas på grund av ogiltiga data.

Exempel 1


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

Förfrågan:


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

FROM objects_contact

Returnerar:

OBJECTID

FÖRNAMN

EFTERNAMN

LIFECYCLESTAGE

54325098

Hobbes

Baron

leda

96805401

Milo

Guld

leda

6922028

Henry

Riley

leda

Exempel 2

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

Query:


SELECT objectId, property_dealName, property_dealStage,
property_amount AS dealAmount

FROM objects_deals

LIMIT 3

Returnerar:

OBJECTID

FASTIGHET_HANDELSNAMN

FASTIGHET_DEALSTAGE

FASTIGHET_DEALAMOUNT

38960439

Avtalets namn 1

stängt won

34199

321740651

Testavtal 123

14845019

8383663

98392101

Pop-up-baldakin

stängt won

9309007

Exempel 3

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

Fråga:

Eftersom uppgifter om avtalsbelopp är tillgängliga som en numerisk datatyp kan de användas för beställning utan att konvertering eller casting behöver göras.


SELECT objectId, property_dealName, property_dealStage,
property_amount AS dealAmount

FROM objects_deals
ORDER BY property_amount DESC
LIMIT 3


Returnerar:

OBJECTID

FASTIGHET_HANDELSNAMN

FASTIGHET_DEALSTAGE

FASTIGHET_DEALAMOUNT

98392101

Pop-up-baldakin

stängt won

9309007

321740651

Testavtal 123

14845019

8383663

38960439

Avtalets namn 1

stängt won

34199

objekt_med_objekt_egenskaper

Detta databasobjekt innehåller data från dina HubSpot-poster. Förfrågningar 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 Properties, 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 Antal Postens ID (t.ex. en kontaktpost med ett ID på 123752).
PROPERTIES Variant Postens fastighetsvärden.
UPDATEDAT Tidsstämpel Datum och tid då posten senast uppdaterades i HubSpot. Läs mer om datatyper för kolumner.
INGESTEDAT Tidsstämpel Datum och tidpunkt för när data- När data senast ingick i 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 vara updatedat. Detta för att anpassa sig till hur datetime-data representeras i resten av datadelningen.

Eftersom detta är en genomgripande ändring har den nya kolumnen, updatedat, lagts till i tabellen och v
yn. 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 en möjlighet att gå över 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 kolumner för tidsstämpel 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-1 38960439 {"createdate": "1504656970152"...}
0-1 321740651 { "Skapat datum": "1590183081949"...}
0-1 98392101 { "Skapat datum": "1533566477279"...}
... ... ...

Exempel 2

Hämta avtalets namn och stadium för upp till tre avtal.

Fråga:


SELECT

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


Returnerar:

OBJECTID DEALNAME DEALSTAGE DEALAMOUNT
38960439 Avtalets namn 1 stängd förlust 7488939
321740651 Avtalets namn 1 stängt won 9292029
98392101 Avtalets namn 1 stängd förlust 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 kommer den att tas bort från detta databasobjekt. Detta databasobjekt är en delmängd av data i tabellen object_with_object_properties. Varje returnerad rad returnerar objekt-ID för varje post. Den här vyn returnerar endast befintliga poster. När en post raderas i HubSpot kommer den att tas bort från den här vyn.

Detta databasobjekt kan vara användbart om ditt konto har en stor mängd data, vilket leder till att object_with_object_properties och objects_x-vyerna fungerar långsamt. Genom att använda detta databasobjekt med databasobjektet object_properties blir det möjligt att replikera data i object_with_object_properties, samtidigt som man 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 Antal Postens ID (t.ex. en kontaktpost med ett ID på 123752).
INGESTEDAT Tidsstämpel Datum och tid då data senast ingick i Snowflake. Läs mer om datatyper för kolumner.

Exempel 1

Hämta alla kontaktuppgifter.

Fråga:


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


Returnerar:

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

objekt_egenskaper

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

Detta databasobjekt kan returnera följande kolumner:

Kolumnnamn Typ Beskrivning
OBJECTTYPEID Varchar ID för objekttypen (t.ex. kontakter är 0-1).
OBJECTID Antal Postens ID (t.ex. en kontaktpost med ett ID på 123752).
NAME Varchar Namnet på fastigheten.
VALUE Tidsstämpel Fastighetens värde.
UPDATEDAT Tidsstämpel Datum och tid då posten senast uppdaterades i HubSpot. Läs mer om datatyper för kolumner.
INGESTEDAT Tidsstämpel Datum och tidpunkt för när data- När data senast ingick i Snowflake.

Exempel 1

Hämta egenskaperna förnamn, efternamn och stad 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);

Returnerar:

OBJECTTYPEID OBJECTID FÖRNAMN EFTERNAMN LIFECYCLESTAGE
0-1 54325098 Hobbes Baron leda
0-1 96805401 Milo Guld leda
0-1 6922028 Henry Riley leda
... ... ... ... ...

objekt_egenskaper_historik

Detta databasobjekt innehåller historiska fastighetsvärden. För kontakter innehåller det de senaste 45 värdena. För alla andra objekt innehåller det de senaste 20 värdena. Visar en rad för varje historiskt egenskapsvärde. Det aktuella värdet för en egenskap bestäms av den senaste UPDATEDAT-tidsstämpeln i 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 Antal Postens ID (t.ex. en kontaktpost med ett ID på 123752).
NAME Varchar Namnet på fastigheten.
VALUE Tidsstämpel Fastighetens värde.
UPDATEDAT Tidsstämpel Datum och tid då data senast uppdaterades i HubSpot. Läs mer om datatyper för kolumner.
INGESTEDAT Tidsstämpel Datum och tid då data senast togs emot av Snowflake.

Exempel 1

Hämta historiken för en enskild fastighet 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 UPPDATERADAT

136493192

hs_prediktivcoringtier

nivå_1

2022-06-22 22:45:05.931

136493192

hs_prediktivcoringtier

nivå_2

2021-09-18 08:20:56.622

136493192

hs_prediktivcoringtier

nivå_3

2019-11-31 18:20:22.851

...

...

...

...

Exempel 2

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

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


Returnerar:

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

Föreningens frågor

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

  • Individuell: Varje associationstyp lagras i en egen vy och innehåller endast poster av den typen. Till exempel innehåller associations_contacts_to_deals endast associationsposter mellan kontakt- och deal-objekt. Detta eliminerar behovet av att ange ett associationtypeid när du ställer frågor. Dessa vyer är ganska enkla att använda eftersom de inte kräver att man är bekant med CRM-datamodellen för att kunna använda dem. De returnerar också en berikad 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 frågor är det tillrådligt att använda dessa vyer för att hämta associationsdata. Se mer i associations_x_to_y-vyerna nedan.
  • Kombinerad: Alla poster för alla associationstyper kombineras till ett databasobjekt. När du ställer en fråga måste du därför ange ett filter som "WHERE combinedassociationtypeid='0-32' ". Se mer om associationer och association_definitions nedan.

föreningar_x_to_y visningar

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 ett specifikt kombinerat associationtypeid.

Varje databasobjekt returnerar följande kolumner:

Kolumnnamn

Typ

Beskrivning

KOMBINERAD FÖRENINGSTYPID

Varchar

Den unika identifieraren för associationsdefinitionen.

FÖRENINGSKATEGORI

Varchar

Källan till associationstypen. En av följande: HUBSPOT_DEFINIERAD, USER_DEFINIERAD, INTEGRATOR_DEFINIERAD

ASSOCIATIONSTYPID

Varchar

En unik identifierare för en associationsdefinition inom en specifik associationskategori, dvs. inga två definitioner i en associationskategori kommer att ha samma associationstypeid.

FRÅNOBJEKTTYPID

Varchar

Den objekttypid som är källan till associationsdefinitionen.

FROMOBJECTTYPE

Varchar

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

TOOBJECTTYPEID

Varchar

Den objekttypid som är destination för associationsdefinitionen.

TOOBJECTTYPE

Varchar

Namnet på den objekttyp som är destination för associationsdefinitionen.

NAMN

Varchar

Namn på föreningens definition.

ETIKETT

Varchar

Beskrivning av föreningens definition.

DEFINITION AV HUVUDFÖRENING

Boolesk

Huruvida associationsdefinitionen är huvudtypen. När det är sant är definitionen den som HubSpot visar på associerade poster

[FROMOBJECTTYPE_OBJECTID] t.ex. för vyn ASSOCIATIONS_CONTACTS_TO_DEALS kommer detta att vara CONTACT_OBJECTID

Antal

Objekt-ID för källobjektet.

[TOOBJECTTYPE_OBJECTID] t.ex. för vyn ASSOCIATIONS_CONTACTS_TO_DEALS kommer detta att vara DEAL_OBJECTID

Antal

Objekt-ID för destinationsobjektet.

INGESTEDAT

Tidsstämpel

Datum och tid då data senast togs emot av Snowflake.

Exempel 1

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

Fråga:


SELECT
kontakt_objektId, affär_objektId

FROM associations_contacts_to_deals

WHERE contactId = 6626541373

Returnerar:

KONTAKT_OBJEKTID

DEAL_OBJECTID

6626541373

233620335

6626541373

90253678

Exempel 2

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


SELECT contacts.property_firstname contact_firstname,

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

KONTAKT_FÖRNAMN

KONTAKT_ EFTERNAMN

KONTAKT_EMIL

DEAL_TYPE

DEAL_AMOUNT

David

Magalhães

dmagalhaes@example.com

ny verksamhet

74848

Fernanda

Rodrigues

fmoreira@example.com

ny verksamhet

253530

Exempel 3

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


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

Returnerar:

TOTALT_STÄNGT_BELOPP

KONTAKT_EMIL

98474793

johndoe@riverview.com

849488

sallymae@longford.com

associations_definitioner

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

Det kan finnas flera olika typer av associationer mellan samma objekt. Den huvudsakliga associationstypen, som är den typ som visas i HubSpot när poster associeras, använder associationen 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 associationstypen. En av följande: HUBSPOT_DEFINED, USER_DEFINED, INTEGRATOR_DEFINED
ID Antal Identifierare av associationsdefinitionen inom dess kategori.
FROMOBJECTTYPEID Varchar ID för det objekt som är källan till associationsdefinitionen.
TOOBJECTTYPEID Varchar ID för det objekt som är destination för associationsdefinitionen.
NAME Varchar Namn på föreningens definition.
LABEL Varchar Sammanslutningsdefinitionens etikett.
ISMAINASSOCIATIONDEFINITION Boolesk Huruvida associationsdefinitionen är huvudtypen. När det är sant är definitionen den som HubSpot visar på associerade poster.
INGESTEDAT Tidsstämpel Datum och tid då data senast ingick i Snowflake. Läs mer om datatyper för kolumner.

Exempel 1

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

Fråga:


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


Returnerar:

KOMBINERAD FÖRENINGSTYP FRÅNOBJEKTTYPID TOOBJECTTYPEID NAMN
0-1 0-1 0-2 KONTAKT_TILL_FÖRETAG
0-2 0-2 0-1 FÖRETAG_TILL_KONTAKT
0-3 0-3 0-1 AVTAL_TILL_KONTAKT
0-4 0-1 0-3 KONTAKT_TILL_AFFÄR
0-5 0-3 0-2 DEAL_TO_COMPANY
... ... ... ...

Exempel 2

Hämta tillgängliga associationstyper 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ÅNOBJEKTTYPID TOOBJECTTYPEID NAMN
0-5 0-3 0-2 DEAL_TO_COMPANY
0-271 0-3 0-2 DEAL_TO_PRIMARY_COMPANY
0-341 0-3 0-2 DEAL_TO_COMAPNY_UNLABELED

föreningar

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 gå med i objekttabellen.

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

Detta databasobjekt kan returnera följande kolumner:

Kolumnnamn Typ Beskrivning
COMBINEDASSOCIATIONTYPEID Varchar Den unika identifieraren för associationsdefinitionen.
FROMOBJECTID Antal ID för källobjektet.
TOOBJECTID Antal ID för destinationsobjektet.
INGESTEDAT Tidsstämpel Datum och tid då data senast ingick i Snowflake. Läs mer om datatyper för kolumner.

Exempel 1

Hämta alla tillhörande avtal och kontakter.

Fråga:


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


Returnerar:

KOMBINERAD FÖRENINGSTYPID FROMOBJECTID TOOBJECTID
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;


Returnerar:

KOMBINERAD FÖRENINGSTYP FROMOBJECTID TOOBJECTID
0-5 6626541373 233620335

Exempel 3

Hämta alla avtal som är associerade med en specifik kontakt (kontakt-ID: 4464). I stället för att hårdkoda combinedAssociationTypeId ansluter detta exempel till association_definitions.

Fråga:


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


Returnerar:

KOMBINERAD FÖRENINGSTYPID FROMOBJECTID TOOBJECTID
0-5 6626541373 233620335

Frågor från ägaren

ägare

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

Detta databasobjekt kan returnera följande kolumner:

Kolumnnamn Typ Beskrivning
OWNERID Antal Användarens ägar-ID.
USERID Antal Användarens användar-ID. Användare med NULL i denna kolumn har raderats.
EMAIL Varchar Användarens e-postadress.
FIRSTNAME Varchar Användarens förnamn.
LASTNAME Varchar Användarens efternamn.
ARCHIVED Boolesk Om användaren har raderats.
CREATEDAT Tidsstämpel Datum och tid då användaren skapades i HubSpot. Se kolumndatatyper för mer information.
UPDATEDAT Tidsstämpel Datum och tid då användaren senast uppdaterades i HubSpot. Se kolumndatatyper för mer information.
INGESTEDAT Tidsstämpel Datum och tid då data senast togs emot av Snowflake.

Exempel 1

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

Fråga:


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


Returnerar:

ÄGARID 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 med hjälp av ägarens ID.

Fråga:


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


Returnerar:

ÄGARID USERID EMAIL FÖRNAMN EFTERNAMN
29584574 4621126 233620335 Hobbes Baron

Exempel 3

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


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

JOIN owners owner ON contact.property_hubspot_owner_id = owner.ownerId


Returnerar:

CONTACTID KONTAKT_FÖRNAMN KONTAKT_ EFTERNAMN KONTAKT_HUBSPOT_ÄGARE_ID ÄGARE_FÖRNAMN ÄGARENS EFTERNAMN ÄGARE_EMAIL
113834202 Richard Greenfield 29584574 Hobbes Baron hobbes.b@business.com
53540801 Ford Karl 30241125 Milo Guld milo.g@business.com
... ... ... ... ... ... ...

Frågor från teamet

team

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

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

Detta databasobjekt kan returnera följande kolumner:

Kolumnnamn Typ Beskrivning
TEAMID Antal Teamets ID.
TEAMNAMN Varchar Lagets namn.
PARENTTEAMID Antal Team-ID för det överordnade teamet.
BARN MOT AIDS Array Team-ID:n för de underordnade teamen.
PRIMÄRÄGARE MEDLEMMAR Varchar Ägar-ID:n för teamets primära medlemmar.
SEKUNDÄRA ÄGARMEDLEMMAR Boolesk Ägar-ID:n för teamets sekundära medlemmar.
INGESTEDAT Tidsstämpel Datum och tid då data senast togs emot av Snowflake.

Exempel 1

Hämta alla team.

Fråga:

SELECT teamId,teamName, primaryOwnerMembers

Från team

Returnerar:

TEAMID TEAMNAMN PRIMÄRÄGARE MEDLEMMAR
29584574 Undergrupp [233620335, 1234553]
30532717 Super Team [3866015468, 126221873]
3058032 Ett team [7132752747]

ägare_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 Antal Teamets ID.
ÄGARID Antal Användarens ägar-ID.
ISTEAMPRIMARY Boolesk Huruvida detta team är det primära teamet för denna ägare.
INGESTEDAT Tidsstämpel Datum och tid då data senast togs emot av Snowflake.

Exempel 1

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

Fråga:

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

Avkastning

TEAMID TEAMNAMN ISTEAMPRIMARY
29584574 233620335 SANT
29584574 1234553 SANT

Pipeline-förfrågningar

Nedan kan du läsa om hur du söker efter pipeline-data för affärer och ärenden, t.ex. tillgängliga pipelines i ditt konto och deras stadier.

Du kan koppla samman dessa data med objektdata för att få en fullständig vy över dina pipelines. Du kan t.ex. ställa frågor om avtal och deras pipelines genom att koppla ihop objects_deals_view eller object_with_object_properties-data med pipeline-data.

rörledningar

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 Rörledningens ID.
OBJECTTYPEID Varchar ID för det objekt som pipelinen kan innehålla (t.ex. erbjudanden eller biljetter).
LABEL Varchar Pipelinens namn i HubSpot.
DISPLAYORDER Antal Den ordning i vilken pipelinen visas i HubSpot.
ARCHIVED Boolesk Om rörledningen har tagits bort.
CREATEDAT Tidsstämpel När pipelinen skapades.
UPDATEDAT Tidsstämpel Datum och tid då data senast uppdaterades i HubSpot. Läs mer om datatyper för kolumner.
INGESTEDAT Tidsstämpel Datum och tid då data senast togs emot 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 ETIKETT
0-3 1bed503c-37f7-4f51-9d40-7598902673f4 Pipeline för försäljning
0-3 12659678 Licenser Pipeline
0-3 75e28846-ad0d-4be2-a027-5e1da6590b98 Nya ärenden
... ... ...

Exempel 2

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

Fråga:


SELECT

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


Returnerar:

DEAL_ID DEAL_NAME PIPELINE_NAME
605140072 Meowmix global registrering Pipeline för försäljning
605457408 Nytt varumärke för Friskies Pipeline för försäljning
604362473 Fresh Step App Bygga Pipeline för försäljning

Exempel 3

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


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

Returnerar:

DEAL_ID

DEAL_NAME

PIPELINE_NAME

605140072

Meowmix global registrering

Pipeline för försäljning

605457408

Nytt varumärke för Friskies

Pipeline för försäljning

604362473

Fresh Step App Bygga

Pipeline för försäljning

pipeline_steg

Den här vyn innehåller information om enskilda steg i en pipeline. Identifiera steg genom att kombinera objekttyps-ID, pipeline-ID och steg-ID. När du ansluter till pipelines använder du objekttyps-ID och pipeline-ID.

Detta databasobjekt kan returnera följande kolumner:

Kolumnnamn Typ Beskrivning
PIPELINEID Varchar Rörledningens ID.
STAGEID Varchar ID för scenen.
LABEL Varchar Stadiets namn i HubSpot.
DISPLAYORDER Antal Den ordning i vilken pipelinen visas i HubSpot.
METADATA Variant En JSON-formaterad beskrivning av scenen, inklusive om den är öppen eller stängd
ARCHIVED Boolesk Om rörledningssteget har tagits bort.
CREATEDAT Tidsstämpel När pipelinefasen skapades.

Exempel 1

Hämta pipeline-stadier för en affärspipeline med namnet Försäljningspipeline.

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 ETIKETT
941650 941651 Kontaktad
941650 941652 Appt planerad
941650 941653 Faktura skickad
... ... ...

Exempel 2

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

Fråga:


SELECT

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


Returnerar:

DEAL_ID DEAL_NAME PIPELINE_NAME PIPELINE_STAGE_NAME
605140072 Meowmix global registrering Pipeline för försäljning Kontrakt skickat
605457408 Nytt varumärke för Friskies Pipeline för försäljning Appt planerad
604362473 Fresh Step App Bygga Pipeline för försäljning Kontrakt undertecknat
... ... ... ...

Frågor om egendom

fastighets_definitioner

Detta databasobjekt innehåller information om objektegenskaper och händelseegenskaper i ditt HubSpot-konto. Händelseegenskaper inkluderar standardhändelser, t.ex. e-postöppningar och klick, och 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 objekttyps-ID och namn. Du kan hämta liknande information med hjälp av API:et för egenskaper.

Detta databasobjekt kan returnera följande kolumner:

Kolumnnamn Typ Beskrivning
OBJECTYPEID Varchar ID för det objekt som händelsen är relaterad till.
NAME Varchar Fastighetens interna namn.
LABEL Varchar Fastighetens etikett.
DESCRIPTION Varchar Beskrivning av boendet.
TYPE Varchar Egenskapens typ (t.ex. sträng, nummer, datetime).
FIELDTYPE Varchar Egenskapens fälttyp. Definierar hur egenskapen visas i HubSpot och på formulär (t.ex. kryssruta, välj).
DISPLAYORDER Antal Fastighetens 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 Antal ID för den användare som skapade egenskapen.
REFERENCEDOBJECTTYPE Varchar Den typ av objekt som egenskapen refererar till. Ägaregenskaper returnerar ett värde på OWNER.
CALCULATED Boolesk Om fastigheten är en beräknad fastighet.
EXTERNALOPTIONS Boolesk Huruvida fastighetens optioner är definierade i ett externt system.
HASUNIQUEVALUE Boolesk Om egenskapens värden är unika. Kan endast anges när du skapar en egenskap via API.
HIDDEN Boolesk Om egenskapen är dold i HubSpot.
SHOWCURRENCYSYMBOL Boolesk Huruvida ett talegenskapsvärde ska formateras som en valuta.
FORMFIELD Boolesk Huruvida 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 fastigheten skapades av HubSpot, kontra skapad av en användare.
ARCHIVED Boolesk Om egenskapen har raderats.
CREATEDAT Tidsstämpel Datum och tid då fastigheten skapades i HubSpot.
UPDATEDAT Tidsstämpel Datum och tid då data senast uppdaterades i HubSpot. Läs mer om datatyper för kolumner.
INGESTEDAT Tidsstämpel Datum och tid då data senast togs emot av Snowflake.

Exempel 1

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

Fråga:


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


Returnerar:

NAMN ETIKETT BESKRIVNING
in_sql_stage Gått in i SQL-stadiet Starta räkning SQL steg dagar.
första_konvertering_händelse_namn
Första konvertering Det första formuläret som denna kontakt skickade in.
adress Gatuadress Kontaktens adress.

Frågor om evenemang

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

Namn
HÄNDELSER_AD_INTERAKTION Detaljer om en annons och kontakter som interagerade med den genom att klicka på annonsen eller skicka in ett formulär efter att ha interagerat med den.
EVENEMANG_AD_METRICS_IMPORTED_V0

Detaljer om en annons och dess prestandamätningar.
EVENEMANG_SAMTAL_OMNÄMNT_NYCKELORD Uppgifter om nyckelord som nämnts av deltagare i samtalen.
HÄNDELSER_KLICKAD_LÄNK_I_E-POST_V2

Länkar som klickats på i marknadsföringsmejl av kontakter.
EVENTS_CLICKED_LINK_IN_TRACKED_INBOX_EMAIL_V8 Länkar som kontakter klickat på i e-postmeddelanden i Conversations Inbox.
EVENTS_COOKIE_BANNER_CLICKED Kontakter som klickat på cookies.
EVENEMANG_COOKIE_BANNER_VISAD Kontakter som sett cookies.
HÄNDELSER_DOKUMENT_DELAT_V2 Försäljningsdokument som delas med kontakter via en extern länk.
HÄNDELSER_DOKUMENT_VISADE_V2 Försäljningsdokument och kontakter som har visats av dem genom att öppna den externa länken.
HÄNDELSER_DOKUMENT_KOMPLETTERADE_V2 Försäljningsdokument och kontakter som har avslutat dem.
HÄNDELSER_HS_SCHEMALAGD_E-POST_V2 E-postmeddelanden som skickas till HubSpot e-postservrar för att skickas.
HÄNDELSER_MTA_LEVERERAD_E-POST_V2 E-postmeddelanden som framgångsrikt levererats till mottagarna av HubSpot e-postservrar.
HÄNDELSER_MTA_BOUNCED_EMAIL_V2 Försök att leverera e-post som avvisades av mottagarens e-postserver.
HÄNDELSER_ÖPPNAD_E-POST_V2 E-post öppnas av kontakter.
HÄNDELSER_RAPPORTERAT_SPAM_E-POST_V2 E-postmeddelanden som markerats som skräppost av mottagarna.
HÄNDELSER_UPPDATERAD_E-POST_PRENUMERATION_STATUS_V2 Ändringar av mottagarnas prenumerationer på e-post.
HÄNDELSER_ÖPPNAD_SPÅRAD_INKORG_E-POST_V8 Conservations Inbox e-post öppnas av kontakter.
EVENEMANG_MB_MEDIA_PLAYED Videouppspelningsaktivitet efter kontakter.
EVENTS_V2_KONTAKT_BOKAT_MÖTE_GENOM_SEKVENS Kontakt bokade ett möte genom sekvens.
EVENTS_V2_CONTACT_ENROLLED_IN_SEQUENCE Kontakt registrerad från sekvens.
HÄNDELSER_V2_KONTAKT_AVSLUTAD_SEKVENS Sekvensen avslutad.
EVENTS_V2_CONTACT_REPLIED_SEQUENCE_EMAIL Kontakten svarade på e-post (eller inkommande e-post som avregistrerade sekvensen) som skickats genom sekvensen.
EVENTS_V2_CONTACT_UNENROLLED_FROM_SEQUENCE Kontakt avregistrerad från sekvens.
EVENTS_V2_CONTACT_UNENROLLED_MANUALLY_FROM_SEQUENCE Användaren avregistrerade kontakten manuellt.
EVENTS_V2_CONTACT_UNSUBSCRIBED_SEQUENCE_EMAIL Kontakten avslutade prenumerationen och avregistrerade sekvensen.
EVENTS_V2_SEQUENCE_EMAIL_BOUNCED E-postmeddelandet om sekvensen studsade.
EVENTS_V2_SEQUENCE_ERRORED Sekvensfel orsakade avregistrering.
HÄNDELSER_V2_SEKVENS_STEG_UTFÖRD Sekvenssteg utfört.
HÄNDELSER_BESÖKT_SIDA Besök på webbplatsens sidor per kontakt.
HÄNDELSER_<INTEGRATION_EVENT_NAME>_<UNIK_IDENTIFIERARE> 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 evenemangstabeller och vyer:

  • occurredat
  • occurredatdateint

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



Kolumnnamn Typ Beskrivning
EVENTTYPEID Varchar ID för händelsetypen, liknande OBJECTTYPEID
Du kan fråga efter alla händelsetyp-ID:n i ditt konto med hjälp av vyn object_and_event_type_definitions.
ID Varchar Detta är unikt per händelsetyp. Inga två poster kommer att ha samma ID inom en viss händelsetyp.
OBJECTTYPEID Varchar Den typ av objekt som slutförde händelsen. Om du t.ex. klickar på en e-postlänk visas 0-1 i den här kolumnen, vilket representerar kontaktobjektet.
OBJECTID Antal ID för den post som slutförde händelsen.
OCCURREDAT Tidsstämpel När händelsen inträffade.

OCCURREDATDATEINT

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

OCCUREDATDATEINT

Antal

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

Observera: denna kolumn kommer att upphöra att gälla den 24 november 2022 och ersättas med OCCURREDATDATEINT.

OCCUREDAT Tidsstämpel

När händelsen inträffade.

Observera: denna kolumn kommer att upphöra att gälla den 24 november 2022 och ersättas med OCCURREDAT.

INGESTEDAT Tidsstämpel Datum och tid då data senast ingick i Snowflake. Läs mer om datatyper för kolumner.
PROPERTY_* Varchar Enskilda kolumner som innehåller händelseegenskaperna.

Exempel 1

Hämta de 50 senaste klickhändelserna via e-post.

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

Exempel 2

Hämta alla klickhändelser i e-postmeddelanden efter de kontakter som klickade. Den här frågan hämtar kontaktdata genom att gå med i 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;


Returnerar:

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

Objekt_och_händelse_typ_förfrågningar

definitioner av objekt_och_händelsetyp

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

Detta databasobjekt kan returnera följande kolumner:

Kolumnnamn Typ Beskrivning
OBJECTTYPEID Varchar ID för det objekt som pipelinen kan innehålla (t.ex. erbjudanden eller biljetter).
FULLYQUALIFIEDNAME Varchar Namnet på objektet eller händelsen.
INGESTEDAT Tidsstämpel Datum och tid då data senast ingick i 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 FULLT KVALIFICERAT NAMN
0-1 KONTAKT
0-8 LINE_ITEM
0-11 KONVERSATION
... ...

Listor frågor

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

listor

Detta databasobjekt innehåller information om HubSpots kontakt- och företagslistor. Returnerar en rad per lista, och kolumnerna innehåller listinformation som listnamn, storlek och objekttyp för de poster som den innehåller. Innehåller inte information om de enskilda posterna i varje lista (se list_membership).

Detta databasobjekt kan returnera följande kolumner:

Kolumnnamn Typ Beskrivning
OBJECTTYPEID Varchar Typ av poster i listan (t.ex. kontakt eller företag).
LISTID Antal ID för listan. Kopplas till kolumnen LISTID i tabellen list-memberships.
CLASSICLISTID Antal Ett ID som är specifikt för kontaktlistor och som matchar ID:t i listans URL i HubSpot.
NAME Varchar Namnet på listan.
SIZE Antal Antal poster i listan.
CREATEDBYUSERID Antal ID för den användare som skapade listan.
CREATEDAT Tidsstämpel När listan skapades i HubSpot.
UPDATEDBYUSERID Antal ID för den användare som senast uppdaterade listan.
UPDATEDAT Tidsstämpel Datum och tid då datumet senast uppdaterades i HubSpot. Läs mer om datatyper för kolumner.
INGESTEDAT Tidsstämpel Datum och tid då data senast togs emot av Snowflake.

Exempel 1

Hämta alla kontaktlistor.

Fråga:


SELECT listId, name, size
FROM lists
WHERE objectTypeId = '0-1';


Returnerar:

LISTID NAMN STORLEK
118131 Uppsökande verksamhet varje vecka 103
66156 Prenumeranter på bloggen 455
771852 De största abonnenterna 2021 37
... ... ...

Exempel 2

Hämta en specifik kontaktlista med namnet Top subscribers 2021.

Fråga:


SELECT listId, name, size 
FROM lists
WHERE objectTypeId = '0-1'
AND
listName = 'Top subscribers 2021';


Returnerar:

LISTID NAMN STORLEK
771852 De största abonnenterna 2021 37

lista_medlemmar

Detta databasobjekt innehåller information om vilka poster som är medlemmar i vilka listor, med en rad per post i listan. Om du t.ex. har en lista med bloggprenumeranter med 500 kontakter kommer databasobjektet att returnera 500 rader.

Innehåller endast list-ID och objekt-ID. För mer information, gå med i databasobjektet för listor.

Detta databasobjekt kan returnera följande kolumner:

Kolumnnamn Typ Beskrivning
LISTID Varchar ID för listan. Kopplas till kolumnen HS_LIST_ID i tabellen lists.
OBJECTID Varchar ID för posten i listan.
UPDATEDAT Tidsstämpel Datum och tid då data senast uppdaterades i HubSpot. Läs mer om datatyper för kolumner.
INGESTEDAT Tidsstämpel Datum och tid då data senast togs emot av Snowflake.

Exempel 1

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

Fråga:


SELECT objectId
FROM list_memberships
INNER JOIN lists
ON list_memberships.listId = lists.listId
WHERE lists.objectTypeId = '0-1'
AND lists.name = 'Top Subscribers 2021';


Returnerar:

OBJECTID
54325098
96805401
6922028
...

Exempel 2

Hämta för- och efternamn på kontaktpersoner i listan Top subscribers 2021.

Fråga:


SELECT

contact.objectId AS objectid,
contact.property_firstname AS firstname,
contact.property_lastname AS lastname
FROM objects_contacts contact
INNER JOIN list_memberships ON contact.objectId = list_memberships.objectId
INNER JOIN lists ON list_memberships.listId = lists.listId
WHERE lists.objectTypeId = '0-1'
AND lists.name = 'Top Subscribers 2021'


Returnerar:

OBJECTID

FÖRNAMN

EFTERNAMN

54325098

Hobbes

Baron

96805401

Milo

Guld

6922028

Henry

Riley

...

...

...

Vanliga frågor

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


I allmänhet vill man titta på de kolumner som finns i den rapport man jämför med. Om rapportvisualiseringen inte är i tabellform kan du konvertera den till en tabell för att visa 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 objekttypsegenskap en kolumn motsvarar. Du kan göra detta genom att fråga property_definitions:


SELECT * FROM property_definitions

WHERE label = [column_name]

Det kanske inte alltid finns en exakt matchning eftersom vissa egenskapsnamn vanligtvis löses 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 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 trivialt att avgöra vad du ska fråga 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 ta en titt på associationer. Associationer representerar relationerna mellan objekt i HubSpot CRM. Alla olika associationer som är möjliga mellan två typer listas i association_definitions. I exemplet ovan behöver du fråga ASSOCIATIONS_CAMPAIGNS_TO_FORMS om du vill veta alla formulär som en kampanj är länkad till:


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

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

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

SELECT * FROM hubspot.public.data_share_status
LIMIT 1

Resultaten kommer att visas som:

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

Denna vy ger uppdateringar om integrationsstatus i omvänd kronologisk ordning. Genom att integrera resultaten av 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.