Fråga efter HubSpot-data i Snowflake
Senast uppdaterad: maj 31, 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 fråga HubSpot-data från ditt Snowflake-konto.
Datafördröjning och din Snowflake-kontoregion
Du kommer att ha tillgång till V2_LIVE-schemat som uppdateras var 15:e minut och V2_DAILY-schemat som uppdateras varje dag.
Observera: följande vyer i V2_LIVE-schemat uppdateras endast dagligen: association_definitions, owners, pipelines och pipeline_stages.
Konfigurera din Snowflake-miljö
Om du vill ställa frågor om dina HubSpot-data i Snowflake måste du välja det lager, den databas och det 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.
Så här väljer du lager, databas och schema på kalkylbladsnivå:
- I den övre raden i kalkylbladet klickar du på kalkylbladets åtgärdsfält.
- I popup-fönstret:
- Klicka på rullgardinsmenyn Warehouse och välj sedan ditt lager.
- Klicka på rullgardinsmenyn Database 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 söka data baserat på tabeller. Data i det här schemat uppdateras en gång per dag. Om du använder det här schemat får du snabbare frågor och det rekommenderas för frågor direkt i Snowflake.
- V2_LIVE: live-schemat baserat på Secure Views av HubSpot-data. Data i det här schemat uppdateras upp till var 15:e minut. Om du ställer frågor om en stor uppsättning data kan det gå långsamt. I så fall rekommenderas att du först kopierar data till din egen tabell med en ETL-process och sedan ställer frågor till den tabellen.
När du har konfigurerat din miljö kan du göra frågor till dina HubSpot-data utan att behöva lägga till din databas eller schematyp i frågor manuellt.
Om du manuellt vill lägga till din databas och schematyp i frågor lägger du till databasnamnet följt av schemat i början av fältet FROM
. 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 och produkter.
- Register: enskilda register, t.ex. en enskild kontakt eller ett enskilt företag.
- Associations: alla tillgängliga associationstyper och aktuella associerade poster.
- Händelser: Händelsedata för både standardhändelser i HubSpot, t.ex. öppnade e-postmeddelanden, och anpassade beteendehändelser.
- Listor: HubSpots kontakt- och företagslistor.
- Ägare: användare i ditt HubSpot-konto, i förhållande till de poster som de har angetts som ägare till.
- Pipelines: pipelines för affärer och ärenden, inklusive pipelinefaser.
- Properties: egenskaper och deras värden i CRM-poster, inklusive fastighetshistorik.
Läs mer omHubSpots CRM-datamodell.
Observera: Itakt med att vi utvecklar datadelningen kommer vi att införa ändringar, varav vissa är banbrytande.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 returnerad data
När du konstruerar frågor kan du styra hur mycket data som ska returneras och i vilken ordning de ska returneras genom att inkludera LIMIT
och ORDER BY
i din fråga. Om du till exempel vill fråga efter alla kontakter med deras egenskaper, men bara returnera tre resultat och ordna dem efter kontakt-ID, kan du konstruera din fråga på följande sätt:
SELECT objectTypeId, updatedAt, ingestedAt
FROM objects_deals
ORDER BY objectId
LIMIT 10;
Datatyper för kolumner
När du frågar efter data i Snowflake beror de kolumner som returneras på vilka data du frågar efter. Du kan visa de tillgängliga kolumnerna för en viss tabell eller vy i Snowflake genom att välja vyn i det vänstra sidofältet.
Observera: iresten av detta dokument använder vi termen databasobjekt när sammanhanget gäller både tabeller och vyer.
Om du vill returnera en viss kolumn anger du den kolumnen i fältet SELECT
i din fråga. Följande fråga returnerar till exempel endast kolumnerna OBJECTID
och UpdatedAt
:
SELECTobjectId, updatedAt
FROM objects_contacts
Nedan finns allmänna definitioner för kolumner som en fråga kan returnera. För andra definitioner som inte ingår nedan, se de enskilda vydefinitionerna i artikeln ovan.
- OBJECTTYPEID: ett VARCHAR-värde som representerar ett objekts typ. Exempel: 0-1 representerar kontaktobjektet, 0-2 representerar företagsobjektet och 2-1232 kan representera ett anpassat objekt i ditt konto. I listor hänvisar detta till listans typ (t.ex. kontakt eller företag). Du kan ställa frågor om alla objekt- och händelse-ID:n i ditt konto med hjälp av vyn object_and_event_type_definitions.
- OBJECTID: ett BIGINT-nummer som representerar en enda post av en viss typ av objekt i ditt HubSpot-konto. För att identifiera en post måste du använda både objekttyp-ID och objekt-ID.
- INGESTEDAT: tidsstämpeln för när en datarad lades till i Snowflake, representerad av ett TIMESTAMP_NTZ-värde. Inte relaterat till den logiska tidsstämpeln för en create- eller update-operation i HubSpot.
- På grund av HubSpots interna bearbetning kan en rads tidsstämpel för inmatning uppdateras även om inga andra kolumner på raden har ändrats.
- När du bygger ETL-processer som kopierar nyligen ändrade data rekommenderas det att du baserar dina frågor på tidsstämpeln för ingestion. Om ditt flöde kopierar data dagligen rekommenderas det dessutom att kopiera data från de två föregående dagarna för att ta hänsyn till förseningar.
- CREATEDAT och UPDATEDAT: den logiska tidsstämpeln för när data skapades eller uppdaterades i HubSpot, representerad av ett TIMESTAMP_NTZ-värde . Dessa tidsstämplar kommer att matcha tidsstämplarna i HubSpot. Till exempel kommer den tid som visas i HubSpot för en posts skapandedatum att vara densamma som tidsstämpeln i kolumnen CREATEDAT i Snowflake. Dessa egenskaper är inte direkt relaterade till tidsstämpeln för inmatning, och det rekommenderas inte att basera ETL-processer på dessa egenskaper.
- COMBINEDASSOCIATIONTYPE: ett VARCHAR-värde som unikt identifierar en associationsdefinition.
Omvandling av datatyper
Ibland returneras data från en fråga med VARCHAR-kolumner när det skulle vara önskvärt att ha dem som en annan typ. I sådana fall rekommenderas att VARCHAR-datatypen konverteras till önskad typ med hjälp av Snowflake-funktioner. Exempelvis lagras egenskaper för en objektpost som VARCHAR-datatyper i de flesta databasobjekt, men ibland innehåller de tal- och datetime-värden. Funktioner som t.ex:
try_to_number, try_to_timestamp_ntz kan användas för att konvertera dessa VARCHAR-data till deras NUMBER- respektive DATETIME-typer:
SELECT objectid, value AS amount_str, try_to_number(value) AS amountFROM object_properties
WHERE objecttypeid='0-3' AND name='amount'
LIMIT 1
Frågor om objekt
Nedan kan du läsa om hur du söker data från specifika HubSpot-objekt och poster, samt vilka data som returneras.
Objektdata av olika slag är organiserade och tillgängliga på två sätt:
- Individuell: Varje objekttyp lagras i sin egen vy och innehåller endast poster av samma objekttyp, t.ex. innehåller objects_contacts endast kontaktposter. Detta eliminerar behovet av att ange ett objecttypeid när du ställer en fråga. Dessa vyer är enklare att fråga eftersom du inte behöver känna till ObjectTypeIds. De returnerar också data i ett mer användbart format där varje rad motsvarar ett objekt och den aktuella versionen av dess egenskaper. Så länge du inte upplever långsamma frågor är det lämpligt att använda dessa vyer för att hämta objektdata. Se mer i Objects_X-vyerna nedan.
- Kombinerad: Alla poster för alla objekttyper kombineras till ett databasobjekt. När du ställer en fråga måste du därför ange ett filter som "WHERE objectTypeId='0-1'. Du kan t.ex. använda följande objekttypid när du ställer frågor:
Objektets namn | ObjektTypId |
Kontaktpersoner | 0-1 |
Företag | 0-2 |
Linjeposter | 0-8 |
Anpassade objekt tilldelas ett ID när de skapas och identifieras som 2-unique_ID. Till exempel 2-12345. Läs mer om definitioner av objekt- och händelsetyper.
Dessa databasobjekt är i allmänhet lämpliga om du vill ha bättre sökprestanda än vad som kan erhållas från objects_x-vyer. Se mer information i object_with_object_properties, object_properties, objects och object_properties_history nedan.
objekt_x vyer
I det här databasobjektet har varje tillgänglig objekttyp, inklusive anpassade objekt, sin egen specifika vy där varje vy endast innehåller poster för objekt av den specifika objekttypen. Dessa vyer namnges enligt formatet OBJECTS_<objekttypens namn> där <objekttypens namn> är objekttypens etikett i pluralform(observera att om objekttypen inte har någon pluralform kommer <objekttypens namn> helt enkelt att vara objekttypens etikett i singularform som sammankopplas med "S").
Frågor till denna vy returnerar en rad för varje post inom ett objekt med varje egenskap hos objektet tillgänglig som en separat kolumn.
Se nedan den omfattande listan över tillgängliga HubSpot-objekttyper (som inte är kundanpassade), en kort beskrivning av de data de representerar och deras motsvarande vyer:
HubSpot Objekttyp |
ObjektTypId |
Beskrivning |
0-1 |
Information om personer som interagerar med ditt företag |
|
0-2 |
Information om enskilda företag eller organisationer |
|
0-3 |
Detaljer om intäktsmöjligheter med en kontakt eller ett företag. |
|
0-4 |
Lagrar data från CRM-åtgärder, inklusive anteckningar, uppgifter, e-postmeddelanden, möten och samtal. |
|
0-5 |
Representera kundförfrågningar om hjälp eller support. |
|
0-14 |
Används för att dela prisinformation med potentiella köpare. |
|
0-15 |
Detaljer för individuella inlämningar för ett HubSpot-formulär. |
|
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 post. |
|
0-11 |
Detaljer om inkommande meddelanden från flera kanaler. |
|
0-25 |
Detaljer om dina målsidor |
|
0-27 |
Lagrar information om att-göra-listor |
|
0-28 |
Används för att samla in leadinformation om dina besökare och kontakter |
|
0-29 |
Detaljer om e-postmeddelanden från marknadsföringshubben |
|
AD_ACCOUNT |
0-30 |
Lagrar information om dina annonskonton på Linkedin, Facebook och Google |
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 |
0-35 |
Information om relaterade marknadsföringstillgångar och innehåll, så att du enkelt kan mäta effektiviteten i dina gemensamma marknadsföringsinsatser. |
|
SITE_PAGE |
0-38 |
Uppgifter om enskilda sidor på dina webbplatser |
0-39 |
Data om blogginlägg |
|
OBJECT LIST |
0-45 |
Information om grupperingar av objektposter baserat på deras egenskaper eller aktiviteter |
0-48 |
Samtal som görs av andra CRM-poster, t.ex. kontakter |
|
FAKTURA |
0-53 |
Hantera och synkronisera fakturor med externa redovisningssystem |
0-57 |
Information om medietillgångar som importerats till Hubspot |
|
0-58 |
En sekvens är en serie riktade, tidsbestämda e-postmallar för att vårda kontakter över tid |
|
0-72 |
Deal splits används för att fördela deal credit mellan flera användare |
|
0-83 |
Försäljningsdokument skapar ett innehållsbibliotek för hela ditt team som kan ladda upp och dela dokument med dina kontakter. |
|
0-19 |
Lagrar information som lämnats i en feedbackundersökning. |
|
0-69 |
Prenumerationer innehåller information om återkommande betalningar |
|
0-101 |
Innehåller data om medel som samlats in från kunder |
Varje databasobjekt kommer att returnera följande kolumner:
Kolumnens namn |
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). |
UPPDATERAD |
Tidsstämpel |
Datum och tid då detta objekt senast uppdaterades i HubSpot. |
INGESTEDAT |
Tidsstämpel |
Datum och tid då data senast togs in av Snowflake. |
PROPERTY_* |
Varchar |
Enskilda kolumner som innehåller den senaste versionen av objektets egenskaper För varje objektsegenskap som har en datum- eller nummertyp (enligt property_definitions) kommer det att finnas två kolumner:
|
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 lifecyclestageFROM objects_contact
Återvänder:
OBJECTID |
FÖRNAMN |
EFTERNAMN |
LIFECYCLESTAGE |
54325098 |
Hobbes |
Baron |
bly |
96805401 |
Milo |
Guld |
bly |
6922028 |
Henry |
Riley |
bly |
Exempel 2
Hämta affärsnamn och stadium för upp till tre affärer.
Query:
SELECT objectId, property_dealName, property_dealStage,
property_amount AS dealAmountFROM objects_deals
LIMIT 3
Återvänder:
OBJECTID |
FASTIGHETS_AFFÄRSNAMN |
FASTIGHET_DEALSTAGE |
EGENDOM_DEALAMOUNT |
38960439 |
Avtalets namn 1 |
stängt |
34199 |
321740651 |
Testavtal 123 |
14845019 |
8383663 |
98392101 |
Pop-Up skärmtak |
stängt |
9309007 |
Exempel 3
Hämta affärsnamn och steg för de tre bästa affärerna efter belopp.
Fråga:
Eftersom data om affärsbelopp finns tillgängliga som en datatyp för tal kan de användas för beställning utan att man behöver göra konvertering eller casting.
SELECT objectId, property_dealName, property_dealStage,
property_amount AS dealAmountFROM objects_deals
ORDER BY property_amount DESC
LIMIT 3
Återvänder:
OBJECTID |
FASTIGHETS_AVTALSNAMN |
FASTIGHET_DEALSTAGE |
EGENDOM_DEALAMOUNT |
98392101 |
Pop-Up skärmtak |
stängt |
9309007 |
321740651 |
Testavtal 123 |
14845019 |
8383663 |
38960439 |
Avtalets namn 1 |
stängt |
34199 |
objekt_med_objekt_egenskaper
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 Properties, som är en Snowflake Variant / JSON-kolumn.
Denna vy kan returnera följande kolumner:
Kolumnens namn | 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 ). |
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 tid då data senast togs emot av Snowflake. |
Observera: Den25 januari 2022 kommer kolumnen, timestamp i tabellen ochvyn 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 datatidsdata representeras iresten av datadelningen.
Eftersom detta är en genomgripande ändring har den nya kolumnen, updatedat, lagts till i tabellen och vyn. Under de kommande 90 dagarna kommer dessa två nya kolumner att samexistera med timestamp, de kolumner som de försöker ersätta. Detta ger dig en möjlighet att byta till att använda de nya kolumnerna.
Efter 90 dagar, den 25 januari 2022, kommer kolumnen timestamp att tas bort från tabellen och vyn. Efter detta datum kommer alla försök att ställa frågor till tabellen eller vyn object_with_object_properties med hjälp av kolumner med tidsstämpel att misslyckas.
Exempel 1
Hämta alla kontakter och deras egenskaper.
Fråga:
SELECT objectTypeId, objectId, properties
FROM object_with_object_properties
WHERE objectTypeId = '0-1'
Återvänder:
OBJECTTYPEID | OBJECTID | FASTIGHETER |
0-1 | 38960439 | {"createdate": "1504656970152"...} |
0-1 | 321740651 | { "createdate": "1590183081949"...} |
0-1 | 98392101 | { "createdate": "1533566477279"...} |
... | ... | ... |
Exempel 2
Hämta affärsnamn och steg för upp till tre affärer.
Fråga:
SELECTobjectId,
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;
Återvänder:
OBJECTID | DEALNAME | DEALSTAGE | DEALAMOUNT |
38960439 | Avtalets namn 1 | stängd förlust | 7488939 |
321740651 | Avtalets namn 1 | stängt | 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 rad som returneras innehåller 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. Denna vy returnerar endast befintliga poster. När en post raderas i HubSpot kommer den att tas bort från den här vyn.
Det här databasobjektet 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 tillsammans med databasobjektet object_properties kan man replikera data i object_with_object_properties och samtidigt behålla kontrollen över vilka egenskaper som returneras.
Detta databasobjekt kan returnera följande kolumner:
Kolumnens namn | Typ | Beskrivning |
OBJECTTYPEID |
Varchar | ID för objekttypen (t.ex. kontakter är 0-1 ). |
OBJECTID |
Antal | Postens ID (t.ex. en kontaktpost med ID 123752 ). |
INGESTEDAT |
Tidsstämpel | Datum och tid då data senast togs in av 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'
Återvänder:
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 som ställts in för en viss post. En kontakt har t.ex. en rad för egenskapen First name och en rad för egenskapen Last name. Om en post inte har något värde för en egenskap kommer raden antingen att visas med en tom sträng eller inte visas alls.
Detta databasobjekt kan returnera följande kolumner:
Kolumnens namn | Typ | Beskrivning |
OBJECTTYPEID |
Varchar | ID för objekttypen (t.ex. kontakter är 0-1 ). |
OBJECTID |
Antal | Postens ID (t.ex. en kontaktpost med ID 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 tid då data senast togs emot av Snowflake. |
Exempel 1
Hämta egenskaper för 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;
Återvänder:
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);
Återvänder:
OBJECTTYPEID | OBJECTID | FÖRNAMN | EFTERNAMN | LIFECYCLESTAGE |
0-1 | 54325098 | Hobbes | Baron | bly |
0-1 | 96805401 | Milo | Guld | bly |
0-1 | 6922028 | Henry | Riley | bly |
... | ... | ... | ... | ... |
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:
Kolumnens namn | 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 ). |
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 in 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;
Återvänder:
OBJECTID | NAMN | VÄRDE | UPPDATERAD |
136493192 |
hs_prediktivescoringtier |
nivå_1 |
2022-06-22 22:45:05.931 |
136493192 |
hs_prediktivescoringtier |
nivå_2 |
2021-09-18 08:20:56.622 |
136493192 |
hs_prediktivescoringtier |
nivå_3 |
2019-11-31 18:20:22.851 |
... |
... |
... |
... |
Exempel 2
Hämta det aktuella namnet på alla kontakter som någonsin har haft ett livscykelstadium som Subscriber.
Frå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
WHERE
object_properties_history.objectTypeId = '0-1'
AND object_properties_history.name = 'lifecyclestage'
AND object_properties_history.value = 'subscriber'
);
Återvänder:
OBJECTID | FÖRNAMN | EFTERNAMN |
54325098 | Hobbes | Baron |
96805401 | Milo | Guld |
6922028 | Henry | Riley |
... | ... | ... |
Föreningens förfrågningar
Precis som objektdata är associationsdata organiserad på två sätt:
- Individuell: Varje associationstyp lagras i sin egen vy och innehåller endast poster av den typen. Exempelvis innehåller associations_contacts_to_deals endast associationsposter mellan kontakt- och avtalsobjekt. Detta eliminerar behovet av att ange ett associationstypeid när man ställer en fråga. Dessa vyer är ganska enkla att ställa frågor till eftersom de inte kräver kännedom om CRM-datamodellen för att kunna användas. De returnerar också en berikad beskrivning av associationsposten mellan två objekt som enkelt kan användas i joins med objects_x-vyer. Så länge du inte upplever långsamma frågor är det tillrådligt att använda dessa vyer för att hämta associationsdata. Se mer i associations_x_to_y-vyerna nedan.
- Kombinerad: Alla poster för alla associationstyper kombineras till ett databasobjekt. När du gör en sökning måste du därför ange ett filter som "WHERE combinedassociationtypeid='0-32'". Se mer om associations och association_definitions nedan.
associationer_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 combinedassociationtypeid.
Varje databasobjekt kommer att returnera följande kolumner:
Kolumnens namn |
Typ |
Beskrivning |
KOMBINERAD FÖRENINGSTYPID |
Varchar |
Den unika identifieraren för associationsdefinitionen. |
FÖRENINGSKATEGORI |
Varchar |
Källan till associationstypen. En av följande: HUBSPOT_DEFINED, USER_DEFINED, INTEGRATOR_DEFINED |
ASSOCIATIONSTYPID |
Varchar |
En unik identifierare för en associationsdefinition inom en specifik associationskategori, dvs. inga två definitioner i en associationskategori kommer att ha samma associationtypeid. |
FRÅNOBJEKTTYPID |
Varchar |
Det objekttypid som är källan till associationsdefinitionen. |
FROMOBJECTTYPE |
Varchar |
Namnet på den objekttyp som är källan till associationsdefinitionen. |
TOOBJECTTYPEID |
Varchar |
Det objekttypid som är destinationen för associationsdefinitionen. |
TOOBJECTTYPE |
Varchar |
Namnet på den objekttyp som är destination för associationsdefinitionen. |
NAMN |
Varchar |
Namnet på associationsdefinitionen. |
ETIKETT |
Varchar |
Beskrivning av associationsdefinitionen. |
ISMAINASSOCIATIONDEFINITION |
Boolean |
Om associationsdefinitionen är huvudtypen. När detta ä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 in av Snowflake. |
Exempel 1
Hämta alla avtal som är kopplade till en viss kontakt.
Fråga:
SELECT
contact_objectId, deal_objectId
FROM föreningar_kontakter_till_affärer
WHERE contactId = 6626541373
Återvänder:
KONTAKT_OBJEKTID |
DEAL_OBJECTID |
6626541373 |
233620335 |
6626541373 |
90253678 |
Exempel 2
Hämta alla kontakter som är baserade i tidszonen Bogota och deras erbjudanden.
SELECT kontakter.egendom_förnamn kontakt_förnamn,
contacts.property_lastname contact_lastname,
contacts.property_email contact_email,
deals.property_dealtype deal_type, deals.property_amount deal_amount
FROM objects_contacts contacts
JOIN associations_contacts_to_deals assoc on
assoc.contact_objectid=contacts.objectid
JOIN objects_deals deals on deals.objectid=assoc.deal_objectid
where contacts.property_hs_timezone='america_slash_bogota'
KONTAKT_FÖRNAMN |
KONTAKT_EFTERNAMN |
KONTAKT_EMILJÖ |
DEAL_TYPE |
DEAL_AMOUNT |
David |
Magalhães |
dmagalhaes@example.com |
nya affärer |
74848 |
Fernanda |
Rodrigues |
fmoreira@example.com |
nya affärer |
253530 |
Exempel 3
Hämta alla kontakter och den totala summan av avslutade affärer för varje kontakt.
SELECT SUM(deals.property_hs_closed_amount) AS
total_closed_amount, contacts.property_email contact_email
FROM objects_contacts contacts
JOIN associations_contacts_to_deals assoc on
assoc.contact_objectid=contacts.objectid
JOIN objects_deals deals on deals.objectid=assoc.deal_objectid
GROUP BY contact_email
ORDER BY total_closed_amount DESC
Återvänder:
TOTALT_SLUTET_BELOPP |
KONTAKT_EMILJÖ |
98474793 |
johndoe@riverview.com |
849488 |
sallymae@longford.com |
associationer_definitioner
Det här databasobjektet innehåller information om alla tillgängliga associationstyper mellan HubSpot-objekt, med en rad per associationstyp. Du kan koppla ihop detta databasobjekt med associationsdatabasobjektet 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 är associerade, använder associationen där ISMAINASSOCIATIONDEFINITION
är true
.
Detta databasobjekt kan returnera följande kolumner:
Kolumnens namn | Typ | Beskrivning |
COMBINEDASSOCIATIONTYPEID |
Varchar | Den unika identifieraren för associationsdefinitionen. |
CATEGORY |
Varchar | Källan till associationstypen. En av: HUBSPOT_DEFINED , USER_DEFINED , INTEGRATOR_DEFINED |
ID |
Antal | Identifieraren för associationsdefinitionen inom dess kategori. |
FROMOBJECTTYPEID |
Varchar | ID för det objekt som är källan till associationsdefinitionen. |
TOOBJECTTYPEID |
Varchar | ID för det objekt som är destination för associationsdefinitionen. |
NAME |
Varchar | Namnet på associationsdefinitionen. |
LABEL |
Varchar | Associationsdefinitionens etikett. |
ISMAINASSOCIATIONDEFINITION |
Boolean | Om associationsdefinitionen är huvudtypen. När detta är sant är definitionen den som HubSpot visar på associerade poster. |
INGESTEDAT |
Tidsstämpel | Datum och tid då data senast togs in av Snowflake. Läs mer om datatyper för kolumner. |
Exempel 1
Hämta de typer av föreningar som finns tillgängliga på ditt konto.
Fråga:
SELECT combinedAssociationTypeId, fromObjectTypeId, toObjectTypeId, name
FROM association_definitions
ORDER BY category, id
Återvänder:
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 | AVTAL_TILL_FÖRETAG |
... | ... | ... | ... |
Exempel 2
Hämta de tillgängliga associationstyperna mellan affärer och företag.
Fråga:
SELECT
combinedAssociationTypeId, fromObjectTypeId, toObjectTypeId, name
FROM association_definitions
WHERE fromObjectTypeId = '0-3' AND toObjectTypeId = '0-2'
AND isMainAssociationDefinition = trueORDER BY category, id
Återvänder:
KOMBINERAD FÖRENINGSTYP | FRÅNOBJEKTTYPID | TOOBJECTTYPEID | NAMN |
0-5 | 0-3 | 0-2 | AVTAL_TILL_FÖRETAG |
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 det här databasobjektet även om de refererade posterna har tagits bort. Du kan kontrollera om posterna finns genom att göra en join med tabellen objects.
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:
Kolumnens namn | 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 togs in av 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'
Återvänder:
KOMBINERAD FÖRENINGSTYPID | FRÅNOBJECTID | TOOBJECTID |
0-5 | 6626541373 | 233620335 |
0-5 | 6616436082 | 3866015468 |
0-5 | 6690805943 | 7132752747 |
... | ... | ... |
Exempel 2
Hämta alla biljetter som är kopplade till en viss kontakt (kontakt-ID: 3005).
Fråga:
SELECT combinedAssociationTypeId, fromObjectId, toObjectId
FROM associations
WHERE associationCategory = 'HUBSPOT_DEFINED'
AND combinedAssociationTypeId = '0-15'
AND fromObjectId = 3005;
Återvänder:
KOMBINERAD FÖRENINGSTYP | FRÅNOBJECTID | TOOBJECTID |
0-5 | 6626541373 | 233620335 |
Exempel 3
Hämta alla avtal som är kopplade till en viss kontakt (kontakt-ID: 4464). Istället för hårdkodning av combinedAssociationTypeId, ansluter detta exempel till association_definitions.
Frå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;
Återvänder:
KOMBINERAD FÖRENINGSTYPID | FRÅNOBJECTID | 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 ägare till poster och kommer att innehålla både ett användar-ID och ett ägar-ID, beroende på sammanhanget. Båda ID:n kan användas för att identifiera samma användare.
Detta databasobjekt kan returnera följande kolumner:
Kolumnens namn | Typ | Beskrivning |
OWNERID |
Antal | Användarens ägar-ID. |
USERID |
Antal | Användarens användar-ID. Användare med NULL i denna kolumn har tagits bort. |
EMAIL |
Varchar | Användarens e-postadress. |
FIRSTNAME |
Varchar | Användarens förnamn. |
LASTNAME |
Varchar | Användarens efternamn. |
ARCHIVED |
Boolean | Om användaren har tagits bort. |
CREATEDAT |
Tidsstämpel | Datum och tid då användaren skapades i HubSpot. Se kolumndatatyper för mer information. |
UPDATEDAT |
Tidsstämpel | Datum och tid då användaren senast uppdaterades i HubSpot. Se kolumndatatyper för mer information. |
INGESTEDAT |
Tidsstämpel | Datum och tid då data senast togs in 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
Återvänder:
ÄGAREID | ANVÄNDARIDENTITET | 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 via dennes ägar-ID.
Fråga:
SELECT ownerId, userId, email, firstname, lastname
FROM owners
WHERE ownerId = 29584574;
Återvänder:
ÄGAREID | ANVÄNDARIDENTITET | 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
Återvänder:
KONTAKTTID | KONTAKT_FÖRNAMN | KONTAKT_EFTERNAMN | KONTAKT_HUBSPOT_ÄGAR_ID | ÄGARE_FÖRNAMN | ÄGARE_SISTNAMN | ÄGARE_EMILJÖ |
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
lag
Med Teams 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:
Kolumnens namn | Typ | Beskrivning |
TEAMID | Antal | Teamets ID. |
TEAMNAMN | Varchar | Lagets namn. |
PARENTTEAMID | Antal | Team-ID för föräldrateamet. |
BARNTEAMIDS | Array | Team-ID:n för de underordnade teamen. |
PRIMÄRÄGARE MEDLEMMAR | Varchar | Ägar-ID för de primära medlemmarna i teamet. |
SEKUNDÄRA ÄGARMEDLEMMAR | Boolean | Ägar-ID:n för teamets sekundära medlemmar. |
INGESTEDAT | Tidsstämpel | Datum och tid då data senast togs in av Snowflake. |
Exempel 1
Hämta alla lag.
Fråga:
SELECT teamId,teamName, primaryOwnerMembers
FRÅN team
Återvänder:
TEAMID | TEAMNAMN | PRIMÄRÄGARE MEDLEMMAR |
29584574 | Underteam | [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:
Kolumnens namn | Typ | Beskrivning |
TEAMID | Antal | Teamets ID. |
ÄGAREID | Antal | Användarens ägar-ID. |
ISTEAMPRIMARY | Boolean | Om det här laget är det primära laget för den här ägaren. |
INGESTEDAT | Tidsstämpel | Datum och tid då data senast togs in 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 |
Förfrågningar om rörledningar
Nedan beskrivs hur du söker efterdata om pipelines 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. söka efter affärer 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 pipelines för avtal och ärenden i ditt konto. Varje rad som returneras representerar en enskild pipeline.
Denna tabell kan returnera följande kolumner:
Kolumnens namn | 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 | Namnet på pipelinen i HubSpot. |
DISPLAYORDER |
Antal | Den ordning i vilken pipelinen visas i HubSpot. |
ARCHIVED |
Boolean | Om pipelinen har tagits bort. |
CREATEDAT |
Tidsstämpel | När pipelinen skapades. |
UPDATEDAT |
Tidsstämpel | 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 in av Snowflake. |
Exempel 1
Hämta alla tillgängliga deal pipelines, sorterade efter deras ordning i HubSpot.
Fråga:
SELECT objectTypeId, pipelineId, label
FROM pipelines
WHERE objectTypeId = '0-3'
AND not archived
ORDER BY displayorder;
Återvänder:
OBJECTTYPEID | PIPELINEID | ETIKETT |
0-3 | 1bed503c-37f7-4f51-9d40-7598902673f4 | Försäljningspipeline |
0-3 | 12659678 | Licenser Pipeline |
0-3 | 75e28846-ad0d-4be2-a027-5e1da6590b98 | Nya ärenden |
... | ... | ... |
Exempel 2
Hämta erbjudanden 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';
Återvänder:
DEAL_ID | DEAL_NAME | PIPELINE_NAME |
605140072 | Meowmix Global Registrering | Försäljningspipeline |
605457408 | Friskies nya varumärke | Försäljningspipeline |
604362473 | Fresh Step App Build | Försäljningspipeline |
Exempel 3
Samma sak som i exempel 2 ovan, hämta erbjudanden inom en specifik pipeline. Men istället för att använda objects_deals i joins, använd object_with_object_properties.
SELECT
deals.objectId deal_id,
deals.properties:dealname::varchar deal_name,
pipelines.label pipeline_name
FROM object_with_object_properties deals
INNER JOIN pipelines
ON deals.objectTypeId = pipelines.objectTypeId
AND deals.properties:pipeline::string = pipelines.pipelineid
WHERE deals.objecttypeId = '0-3'
AND pipelines.objectTypeId = '0-3';
Återvänder:
DEAL_ID |
DEAL_NAME |
PIPELINE_NAME |
605140072 |
Meowmix Global Registrering |
Försäljningspipeline |
605457408 |
Friskies nya varumärke |
Försäljningspipeline |
604362473 |
Fresh Step App Build |
Försäljningspipeline |
pipeline_stadier
Den här vyn innehåller information om enskilda steg i en pipeline. Identifiera etapper genom att kombinera objekttyp-ID, pipeline-ID och etapp-ID. När du ansluter till pipelines använder du objekttyp-ID och pipeline-ID.
Detta databasobjekt kan returnera följande kolumner:
Kolumnens namn | Typ | Beskrivning |
PIPELINEID |
Varchar | Rörledningens ID. |
STAGEID |
Varchar | Scenens ID. |
LABEL |
Varchar | Etappens 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 |
Boolean | Om pipeline-etappen har tagits bort. |
CREATEDAT |
Tidsstämpel | När pipelinefasen skapades. |
Exempel 1
Hämta pipelinefaser för en affärspipeline med namnet Sales pipeline.
Fråga:
SELECT pipelineid, stageId, label
FROM pipeline_stages
WHERE not archived
AND pipelineid = (
SELECT pipelineid
FROM pipelines
WHERE objectTypeId = '0-3'
AND not archived
AND label = 'Sales Pipeline' LIMIT 1)
ORDER BY displayorder;
Återvänder:
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:
SELECTdeals.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';
Återvänder:
DEAL_ID | DEAL_NAME | PIPELINE_NAME | NAMN_PÅ_RÖRLEDNING |
605140072 | Meowmix Global Registrering | Försäljningspipeline | Kontrakt skickat |
605457408 | Friskies nya varumärke | Försäljningspipeline | Appt planerad |
604362473 | Fresh Step App Build | Försäljningspipeline | Kontrakt undertecknat |
... | ... | ... | ... |
Frågor om fastigheter
fastighets_definitioner
Detta databasobjekt innehåller information om objektsegenskaper och händelseegenskaper i ditt HubSpot-konto. Händelseegenskaper inkluderar standardhändelser, t.ex. öppningar och klick på e-postmeddelanden, och anpassade beteendemässiga händelse egenskaper. Den här informationen kan vara till hjälp för att definiera värden som finns i object_properties och händelsedata.
Du kan identifiera specifika egenskaper genom att kombinera deras 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:
Kolumnens namn | Typ | Beskrivning |
OBJECTYPEID |
Varchar | ID för det objekt som händelsen avser. |
NAME |
Varchar | Fastighetens interna namn. |
LABEL |
Varchar | Fastighetens etikett. |
DESCRIPTION |
Varchar | Beskrivning av fastigheten. |
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 array med egenskapens alternativ, inklusive varje alternativs attribut (t.ex. visningsordning, etikett). |
CREATEDUSERID |
Antal | ID för den användare som skapade fastigheten. |
REFERENCEDOBJECTTYPE |
Varchar | Den typ av objekt som egenskapen refererar till. Ägande egenskaper kommer att returnera ett värde av OWNER. |
CALCULATED |
Boolean | Om fastigheten är en beräknad fastighet. |
EXTERNALOPTIONS |
Boolean | Om fastighetens optioner är definierade i ett externt system. |
HASUNIQUEVALUE |
Boolean | Om egenskapens värden är unika. Kan endast anges när du skapar en egenskap via API:et. |
HIDDEN |
Boolean | Om egenskapen är dold i HubSpot. |
SHOWCURRENCYSYMBOL |
Boolean | Om ett talegenskapsvärde ska formateras som en valuta. |
FORMFIELD |
Boolean | Om denna egenskap kan användas i formulär. |
READONLYDEFINITION |
Boolean | Om fastigheten kan redigeras i HubSpot. |
READONLYVALUE |
Boolean | Om egenskapens värde kan redigeras i HubSpot. |
HUBSPOTDEFINED |
Boolean | Om fastigheten skapades av HubSpot, eller om den skapades av en användare. |
ARCHIVED |
Boolean | Om fastigheten har tagits bort. |
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 in 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'
Återvänder:
NAMN | ETIKETT | BESKRIVNING |
in_i_sql_stadiet | Gått in i SQL-stadiet | Starträkning SQL-stegdagar. |
första_omvandlingen_händelsens_namn
|
Första konverteringen | Det första formuläret som denna kontakt skickade. |
adress | Gatuadress | Kontaktpersonens adress. |
Frågor om evenemang
Händelser inkluderar standard HubSpot-händelser och anpassade beteendemässiga händelser. Varje händelse har sitt eget databasobjekt, märkt som events_eventname
.
Namn | |
HÄNDELSER_AD_INTERAKTION | Uppgifter om en annons och kontakter som interagerade med den genom att klicka på annonsen eller skicka in ett formulär efter att ha interagerat med den. |
EVENTS_AD_METRICS_IMPORTED_V0 |
Detaljer om en annons och dess prestandamätvärden. |
EVENEMANG_SAMTAL_OMNÄMNT_NYCKELORD | Uppgifter om nyckelord som nämnts av deltagare i samtal. |
HÄNDELSER_KLICKAD_LÄNK_I_EMAIL_V2 |
Länkar som klickats på i marknadsföringsmeddelanden av kontakter. |
EVENTS_CLICKED_LINK_IN_TRACKED_INBOX_EMAIL_V8 | Länkar som kontakter har klickat på i e-postmeddelanden i Conversations Inbox. |
EVENTS_COOKIE_BANNER_CLICKED | Kontakter som klickade på cookies. |
HÄNDELSER_COOKIE_BANNER_VISAD | Kontakter som tittat på cookies. |
HÄNDELSER_DOKUMENT_DELAT_V2 | Försäljningsdokument som delas med kontakter via en extern länk. |
HÄNDELSER_DOKUMENT_VISAT_V2 | Försäljningsdokument och kontakter som har visats av dem genom att öppna den externa länken. |
HÄNDELSER_DOKUMENT_AVSLUTADE_V2 | Försäljningsdokument och kontakter som har avslutat dem. |
EVENTS_HS_SCHEDULED_EMAIL_V2 | E-postmeddelanden som skickas till HubSpots e-postservrar för att skickas. |
EVENTS_MTA_DELIVERED_EMAIL_V2 | E-postmeddelanden som framgångsrikt levererats till mottagarna av HubSpots e-postservrar. |
EVENTS_MTA_BOUNCED_EMAIL_V2 | Försök att leverera e-post som avvisades av mottagarens e-postserver. |
HÄNDELSER_ÖPPNADE_E-POSTMEDDELANDEN_V2 | E-post öppnas av kontakter. |
HÄNDELSER_RAPPORTERAD_SPAM_EMAIL_V2 | E-postmeddelanden som markerats som skräppost av mottagarna. |
EVENTS_UPDATED_EMAIL_SUBSCRIPTION_STATUS_V2 | Ändringar av mottagarnas e-postprenumerationer. |
EVENTS_ÖPPNAD_SPÅRAD_INKORG_E-POST_V8 | Conservations Inbox e-post öppnas av kontakter. |
HÄNDELSER_MB_MEDIA_SPELAD | Videouppspelning aktivitet av kontakter. |
EVENTS_V2_KONTAKT_BOKAT_MÖTE_GENOM_SEKVENS | Kontakten bokade ett möte genom sequence. |
EVENTS_V2_KONTAKT_INSKRIVEN_I_FÖLJD | Kontakt registrerad från sekvens. |
HÄNDELSER_V2_KONTAKT_AVSLUTAD_SEKVENS | Sekvensen är klar. |
EVENTS_V2_KONTAKT_BESVARAD_SEKVENS_EMAIL | Kontakten svarade på e-postmeddelandet (eller inkommande e-postmeddelande som avregistrerade sekvensen) som skickades via sekvensen. |
EVENTS_V2_CONTACT_UNROLLED_FROM_SEQUENCE | Kontakten avregistreras från sekvensen. |
EVENTS_V2_CONTACT_UNENROLLED_MANUALLY_FROM_SEQUENCE | Användaren avregistrerade kontakten manuellt. |
EVENTS_V2_CONTACT_UNSUBSCRIBED_SEQUENCE_EMAIL | Kontakten avanmälde sig och sekvensen avregistrerades. |
EVENTS_V2_SEKVENS_EMAIL_BOUNCED | Sequence email studsade. |
HÄNDELSER_V2_SEKVENS_ERRORED | Fel i sekvensen orsakade avregistrering. |
EVENTS_V2_SEQUENCE_STEP_EXECUTED | Sekvenssteg utfört. |
HÄNDELSER_BESÖKTA_SIDOR | Besök på webbsidor per kontaktperson. |
EVENTS_<INTEGRATION_EVENT_NAME>_<UNIQUE_IDENTIFIER> | Integrationshändelser(Timeline V3 API) |
Du kan identifiera händelser genom att kombinera deras ID för händelsetyp och ID. De kolumner som returneras beror på händelsen, med en kolumn för varje händelseegenskap. Alla händelser returnerar följande kolumner:
Observera: HubSpot har lagt till två nya kolumner i alla eventtabeller och vyer:
occurredat
occurredatdateint
Dessa kolumner kommer att ersätta kolumnerna occuredat
och occuredatdateint
den 24 november 2022. På det datumet kommer de gamla kolumnerna inte längre att vara tillgängliga, och försök att fråga ett databasobjekt eller en vy som innehåller händelser som använder dessa kolumner kommer att misslyckas. Läs mer om ändringar för Snowflake-datadelar.
Kolumnens namn | Typ | Beskrivning |
EVENTTYPEID |
Varchar | ID för händelsetypen, liknande OBJECTTYPEID Du kan fråga efter alla ID:n för händelsetyper i ditt konto med hjälp av vyn object_and_event_type_definitions. |
ID |
Varchar | Detta är unikt för varje evenemangstyp. 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 till exempel klickar på en e-postlänk visas 0-1 i den här kolumnen, vilket representerar kontaktobjektet. |
OBJECTID |
Antal | ID för den post som slutförde händelsen. |
OCCURREDAT |
Tidsstämpel | När händelsen inträffade. |
|
Antal | Ett nummer som anger när händelsen inträffade. Innehåller samma data som kolumnen OCCURREDAT , men formaterad som ett nummer och används som en del av klusternyckeln i tabellen. I de flesta fall kan du använda tidsstämpeln OCCURREDAT i stället för det här numret. |
|
Antal | Ett nummer som anger när händelsen inträffade. Innehåller samma data som kolumnen Observera att den här kolumnen kommer att tas bort den 24 november 2022 och ersättas med |
OCCUREDAT |
Tidsstämpel | När händelsen inträffade. Observera att den här kolumnen kommer att tas bort den 24 november 2022 och ersättas med |
INGESTEDAT |
Tidsstämpel | Datum och tid då data senast togs in av Snowflake. Läs mer om datatyper för kolumner. |
PROPERTY_* |
Varchar | Enskilda kolumner som innehåller händelseegenskaperna. |
Exempel 1
Hämta de 50 senaste klickhändelserna i e-postmeddelanden.
Fråga:
SELECT eventTypeId, objectTypeId, objectId, occuredAt, property_hs_click_raw_url AS hs_click_raw_url
FROM events_clicked_link_in_email_V2
ORDER BY occuredAt
LIMIT 50;
Återvänder:
EVENTTYPEID | OBJECTTYPEID | OBJECTID | OCCUREDAT | HS_CLICK_RAW_URL |
4-666288 | 0-1 | 45318579 | 2016-08-04 21:06:43.245 | http://website.com?utm_campaign=Launch&utm_source=hs_email&utm_medium=email&utm_content=32520579 |
4-666288 | 0-1 | 80701 | 2016-08-29 13:31:28.622 | https://cta-image-cms2.hubspot.com/ctas/v2/public/cs/ci/?pg=f0f6585a-08fc-4273-8422-49cfaddcf8d8&pid=1976760&ecid=ACsprvtkRbakerw4BiWlaDL7xFAqau1aW9m1_PAqSfQiWarY69X7Ds42zHGYTCfhHJLrXUP86Nxu |
4-666288 | 0-1 | 26146013 | 2017-11-30 14:27:11.528 | https://hubs.ly/H097a37a?utm_source=hs_email&utm_medium=email&utm_content=58251290 |
... | ... | ... | ... | ... |
Exempel 2
Hämta alla klickhändelser i e-postmeddelanden efter de kontakter som klickade. Den här frågan hämtar kontaktdata genom att sammanfoga med object_with_object_properties.
Frå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;
Återvänder:
KLICK_TIDSSTÄMPEL | 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 | 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ändelsetyp_förfrågningar
objekt_och_händelsetyp_definitioner
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:
Kolumnens namn | 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 togs in av Snowflake. Läs mer om datatyper för kolumner. |
Exempel 1
Hämta alla objekt och händelser som finns tillgängliga i ditt HubSpot-konto.
Fråga:
SELECT objectTypeId, fullyQualifiedName
FROM object_and_event_type_definitions;
Återvänder:
OBJECTTYPEID | FULLSTÄNDIGT KVALIFICERAT NAMN |
0-1 | KONTAKT |
0-8 | LINJE_ITEM |
0-11 | KONVERSATION |
... | ... |
Listor frågor
Nedan beskrivs hur du söker i dina listor, t.ex. de tillgängliga kontakt- och företagslistorna och de poster som ingår i dessa listor.
listor
Detta databasobjekt innehåller information om HubSpots kontakt- och företagslistor. Returnerar en rad per lista, och kolumnerna innehåller listdetaljer 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:
Kolumnens namn | Typ | Beskrivning |
OBJECTTYPEID |
Varchar | Typ av poster i listan (t.ex. kontakt eller företag). |
LISTID |
Antal | ID för listan. Länkar till kolumnen LISTID i tabellen list-memberships. |
CLASSICLISTID |
Antal | Ett ID som är specifikt för kontaktlistor och som matchar ID:t i URL:en för listan 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 | Det datum och den tid som datumet senast uppdaterades i HubSpot. Läs mer om datatyper för kolumner. |
INGESTEDAT |
Tidsstämpel | Datum och tid då data senast togs in av Snowflake. |
Exempel 1
Hämta alla kontaktlistor.
Fråga:
SELECT listId, name, size
FROM lists
WHERE objectTypeId = '0-1';
Återvänder:
LISTID | NAMN | STORLEK |
118131 | Uppsökande verksamhet varje vecka | 103 |
66156 | Prenumeranter på blogg | 455 |
771852 | Bästa abonnenter 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'
ANDlistName = 'Top subscribers 2021';
Återvänder:
LISTID | NAMN | STORLEK |
771852 | Bästa abonnenter 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 över bloggprenumeranter med 500 kontakter, kommer databasobjektet att returnera 500 rader.
Innehåller endast list-ID:n och objekt-ID:n. Mer information finns i länkningen till databasobjektet lists.
Detta databasobjekt kan returnera följande kolumner:
Kolumnens namn | Typ | Beskrivning |
LISTID |
Varchar | ID för listan. Länkar 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 in 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';
Återvänder:
OBJECTID |
54325098 |
96805401 |
6922028 |
... |
Exempel 2
Hämta för- och efternamn på detaljer om kontakter 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'
Återvänder:
OBJECTID |
FÖRNAMN |
EFTERNAMN |
54325098 |
Hobbes |
Baron |
96805401 |
Milo |
Guld |
6922028 |
Henry |
Riley |
... |
... |
... |
Vanliga frågor
Jag vill generera data som liknar en rapport från Hubspot-appen, hur gör jag det?
I allmänhet vill du titta på de kolumner som finns i den rapport du jämför med. Om rapportvisualiseringen inte är tabellformad kan du konvertera den till en tabell för att visa de kolumner som rapporten innehåller. Dessa kolumner är vanligtvis egenskaper för en objekttyp eller en händelsetyp. Nästa steg är att ta reda på vilken objekttypsegenskap som en kolumn motsvarar. Det kan du göra genom att fråga property_definitions:
SELECT * FROM property_definitions
WHERE label = [column_name]
Det kanske inte alltid finns en exakt matchning eftersom vissa egenskapsnamn vanligtvis löses upp 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.
Efter att ha bestämt vilken objekttyp kolumnen tillhör är det trivialt att bestämma vad man ska fråga. Du kan helt enkelt söka efter den object_x-vy som motsvarar typen.
Hur länkar jag den här datatypen till en annan, t.ex. hur hämtar jag formulär för en kampanj?
Om du behöver länka två eller flera olika poster till varandra kan du ta en titt på associationer. Associationer representerar relationerna mellan objekt i HubSpot CRM. Alla olika associationer som är möjliga mellan två typer listas i association_definitions. I exemplet ovan måste du fråga ASSOCIATIONS_CAMPAIGNS_TO_FORMS om du vill veta alla formulär som en kampanj är länkad till:
SELECT campaigns.property_hs_name campaign_name,
forms.property_hs_form_id form_id
FROM objects_campaigns campaigns
JOIN associations_campaigns_to_forms assoc ON
assoc.campaign_objectid=campaigns.objectid
JOIN objects_forms forms ON forms.objectid=assoc.form_objectid
GROUP BY campaign_name
Hur vet jag statusen för integrationen mellan HubSpot och Snowflake?
För att få statusuppdateringar i realtid om avbrott och problem för HubSpot-Snowflake-integrationen, fråga vyn data_share_status:
SELECT * FROM hubspot.public.data_share_status
LIMIT 1
Resultaten kommer att visas som:
STATUS | MEDDELANDE | UPPDATERAD |
OK | INGEN KÄND INCIDENT FÖR NÄRVARANDE | 2023-04-10 09:21:20.123 |
Den här vyn ger uppdateringar om integrationens status i omvänd kronologisk ordning. Genom att integrera resultaten av den här frågan i en instrumentpanel kan du följa integrationens prestanda och upptäcka eventuella driftstopp eller avbrott.