Hoppa till innehåll
Observera: Översättningen av denna artikel är endast avsedd att underlätta för dig. Översättningen har skapats automatiskt med hjälp av en översättningsprogramvara och har eventuellt inte korrekturlästs. Den engelska versionen av denna artikel bör därför betraktas som den gällande versionen med den senaste informationen. Du kan komma åt den här.

Fråga efter HubSpot-data i Snowflake

Senast uppdaterad: februari 27, 2023

Gäller för:

Operations Hub Enterprise

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

Datafördröjning och din Snowflake-kontoregion

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

Konfigurera din Snowflake-miljö

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

Om du vill välja lager, databas och schema på kalkylbladsnivå:

  • Klicka på Åtgärdsfältet för arbetsbladet på den övre raden i arbetsbladet.

    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 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 sökningar och det rekommenderas för sökningar direkt i Snowflake.
        • V2_LIVE: Live-schemat 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 mängd data kan sökningarna bli långsamma. I det här fallet rekommenderas att du först kopierar data till en egen tabell med en ETL-process och sedan frågar i den tabellen.


      snowflake-worksheet-settings-window0

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

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


SELECT objectTypeId, property_createddate
FROM hubspot_share_name.V2_LIVE.objects_deals

LIMIT 1

Översikt över uppgifter

Förfrågningar konstrueras med hjälp av SQL och kan användas för att hämta HubSpot-data, t.ex:

  • Objekt: standardobjekt och anpassade objekt, t.ex. kontakter, företag och produkter.
  • Register: enskilda register, t.ex. en enskild kontaktperson eller ett företag.
  • Associationer: alla tillgängliga associationstyper och för närvarande associerade poster.
  • Händelser: Händelsedata för både standardhändelser i HubSpot, t.ex. öppning av 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 ägare till.
  • Pipelines: pipelines för affärer och biljetter, inklusive pipeline-steg.
  • Egenskaper: Egenskaper och deras värden i CRM-poster, inklusive egenskapshistorik.

Läs mer om HubSpots CRM-datamodell.

Observera: I takt medatt vi utvecklar datautbytet kommer vi att införa ändringar, varav en del är brytande. Det rekommenderas starkt att du prenumererar på HubSpots ändringslogg för utvecklare. Dessa ändringar kommer alltid att publiceras i ändringsloggen före varje uppdatering.

Begränsning och ordnande av returnerade uppgifter

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


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

Datatyper för kolumner

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

Observera:I resten av den här dokumentationen använder vi termen databasobjekt när det gäller både tabeller och vyer.

snowflake-sidebar-view-column-details0


Om du vill returnera en specifik kolumn inkluderar du den kolumnen i SELECT-fältet i din fråga. Följande fråga returnerar till exempel endast kolumnerna OBJECTID och UpdatedAt:


SELECTobjectId
, updatedAt
FROM objects_contacts

Nedan finns allmänna definitioner av kolumner som en fråga kan ge tillbaka. För andra definitioner som inte finns med nedan, se de enskilda vydefinitionerna i artikeln ovan.

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

Omvandling av datatyper

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


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

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

Förfrågningar om objekt

Nedan får du veta hur du frågar efter data från specifika HubSpot-objekt och -poster och vilka data som returneras.

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

  • Individuellt: Varje objekttyp lagras i en egen vy och innehåller endast poster av samma objekttyp, t.ex. objects_contacts innehåller endast kontaktposter. Detta eliminerar behovet av att ange ett objekttypid vid sökning. Dessa vyer är lättare att fråga 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. Mer information finns i vyerna Objects_X nedan.
  • Kombinerad: Alla poster för alla objekttyper kombineras till ett databasobjekt. När du gör en sökning måste du alltså ange ett filter som "WHERE objectTypeId='0-1'. Du kan t.ex. använda följande objekttypsid vid sökning:
Objektnamn ObjectTypeId
Kontakter 0-1
Företag 0-2
Poster 0-8

Anpassade objekt kommer att tilldelas ett ID när de skapas och identifieras som 2-unique_ID. Till exempel 2-12345. Läs mer om object_and_event_type_definitions.

De här databasobjekten är i allmänhet lämpliga om du vill ha bättre prestanda än vad som kan uppnås med objects_x-vyer. Mer information finns i object_with_object_properties, object_properties, objects och object_properties_history nedan.

objects_x views

I det här databasobjektet har varje tillgänglig objekttyp, inklusive anpassade objekt, sin egen specifika vy där varje vy endast innehåller poster för objekt av den specifika objekttypen. Dessa vyer namnges enligt formatet OBJECTS_<objekttypnamn> där <objekttypnamn> är objekttypens pluralform(observera att om objekttypen inte har någon pluralform kommer <objekttypnamn> helt enkelt att vara objekttypens singularformsbeteckning med ett "S").

Förfrågningar till den här vyn returnerar en rad för varje post i ett objekt med varje egenskap i objektet som en separat kolumn.

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

HubSpot Objekttyp

ObjectTypeId

Beskrivning

KONTAKT

0-1

Information om personer som interagerar med ditt företag

FÖRETAG

0-2

Information om enskilda företag eller organisationer

DEAL

0-3

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

ENGAGEMANG

0-4

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

BILJETT

0-5

Svara för kundernas förfrågningar om hjälp eller stöd.

QUOTE

0-14

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

FORM_SUBMISSION

0-15

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

LINE_ITEM

0-8

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

KONVERSATION

0-11

Detaljer om inkommande meddelanden från flera kanaler.

LANDING_PAGE

0-25

Uppgifter om dina landningssidor

UPPGIFT

0-27

Lagrar information om att göra-listor

FORM

0-28

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

MARKETING_EMAIL

0-29

Uppgifter om e-postmeddelanden från marknadsföringscentralen

AD_ACCOUNT

0-30

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

AD_CAMPAIGN

0-31

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

AD_GROUP

0-32

Logisk gruppering av annonser inom en annonskampanj

AD

0-33

Information om enskilda annonser

KAMPANJ

0-35

Information om relaterade marknadsföringstillgångar och innehåll, så att du enkelt kan mäta hur effektiva dina gemensamma marknadsföringsinsatser är.

SITE_PAGE

0-38

Uppgifter om enskilda sidor på dina webbplatser

BLOG_POST

0-39

Uppgifter om blogginlägg

OBJECT LIST

0-45

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

CALL

0-48

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

FAKTURA

0-53

Hantera och synkronisera fakturor med externa redovisningssystem

MEDIA_BRIDGE

0-57

Information om medietillgångar som importeras till Hubspot

SEQUENCE

0-58

En sekvens är en serie målinriktade, tidsbestämda e-postmallar för att vårda kontakter över tid.

DEAL_SPLIT

0-72

Affärsuppdelningar används för att dela upp affärskredit mellan flera användare.

SALES_DOCUMENT

0-83

Försäljningsdokument bygger upp ett innehållsbibliotek där hela teamet kan ladda upp och dela dokument med dina kontakter.

FEEDBACK_SUBMISSION

0-19

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

ABONNEMANG

0-69

Prenumerationer innehåller uppgifter om återkommande betalningar.

BETALNING FÖR HANDEL

0-101

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



Varje databasobjekt returnerar följande kolumner:

Namn på kolumnen

Typ

Beskrivning

OBJECTTYPEID

Varchar

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

OBJECTID

Antal

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

UPDATEDAT

Tidsstämpel

Datum och tid då det här objektet senast uppdaterades i HubSpot.

INGESTEDAT

Tidsstämpel

Datum och tid då uppgifterna senast togs in av Snowflake.

PROPERTY_*

Varchar

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

  1. En kolumn som innehåller egenskapsvärdet i form av en sträng. Kolonnens namn blir property_unparsed_[name] . Till exempel kommer egenskapen deal_amount i DEAL-objektet att ha kolumnen property_unparsed_deal_amount.
  2. En kolumn som innehåller värdet som konverterats till den ursprungliga typen. Kolumnen kommer att ha namnet property_[name].Exempelvis kommer DEAL object property, deal_amount att ha kolumnen property_deal_amount. Observera att denna kolumn kommer att innehålla noll om konverteringen till den ursprungliga typen misslyckas på grund av ogiltiga data.

Exempel 1


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

Förfrågan:


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

FROM objects_contact

Returnerar:

OBJECTID

FÖRNAMN

LASTNAME

LIVSCYKELSTADIUM

54325098

Hobbes

Baron

bly

96805401

Milo

Guld

bly

6922028

Henry

Riley

bly

Exempel 2

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

Query:


SELECT objectId, property_dealName, property_dealStage,
property_amount AS dealAmount

FROM objects_deals

LIMIT 3

Returnerar:

OBJECTID

PROPERTY_DEALNAME

EGENDOM_DEALSTAGE

PROPERTY_DEALAMOUNT

38960439

Namn på affären 1

stängdvunnit

34199

321740651

Test Deal 123

14845019

8383663

98392101

Pop-Up skärmtak

stängdvunnit

9309007

Exempel 3

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

Fråga:

Eftersom uppgifter om deal amount finns tillgängliga som en datatyp för tal kan de användas för beställning utan att behöva konverteras eller gjutas.


SELECT objectId, property_dealName, property_dealStage,
property_amount AS dealAmount

FROM objects_deals
ORDER BY property_amount DESC
LIMIT 3


Returnerar:

OBJECTID

PROPERTY_DEALNAME

EGENDOM_DEALSTAGE

PROPERTY_DEALAMOUNT

98392101

Pop-Up skärmtak

stängdvunnit

9309007

321740651

Test Deal 123

14845019

8383663

38960439

Namn på affären 1

stängdvunnit

34199

object_with_object_properties

Det här databasobjektet innehåller data från dina HubSpot-poster. Förfrågningar till det här databasobjektet returnerar en rad för varje post inom en objekttyp (t.ex. alla kontaktposter i objekttypen contacts). Alla egenskaper lagras i kolumnen Egenskaper, som är en Snowflake Variant/JSON-kolumn.

Denna vy kan visa följande kolumner:

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

Observera: Den 25 januari 2022 kommer kolumnen timestamp i tabellen object_with_object_properties och vyn, som representerar det datum och den tid då objektet senast uppdaterades i HubSpot, att vara updatedat. Detta för att anpassa sig till hur datumtidsdata representeras i resten av datadelarna.

Eftersom detta är en brytande ä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 övergå 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 object_with_object_properties eller vyn med hjälp av kolumner med tidsstämpel att misslyckas.

Exempel 1

Hämta alla kontakter och deras egenskaper.

Fråga:


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


Returnerar:

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

Exempel 2

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

Fråga:


VÄLJ

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


Returnerar:

OBJECTID DEALNAME DEALSTAGE DEALAMOUNT
38960439 Namn på affären 1
closedlost
7488939
321740651 Namn på affären 1
stängdvunnit
9292029
98392101 Namn på affären 1
closedlost
62626528

objekt

Detta databasobjekt är en delmängd av uppgifterna i databasobjektet object_with_object_properties. Varje returnerad rad returnerar objekt-ID för varje post. Detta databasobjekt returnerar endast befintliga poster. När en post tas bort i HubSpot tas den bort från detta databasobjekt. Det här databasobjektet är en delmängd av uppgifterna i tabellen object_with_object_properties. Varje returnerad rad returnerar objekt-ID för varje post. Den här vyn returnerar endast befintliga poster. När en post tas bort i HubSpot tas den bort från den här vyn.

Det här databasobjektet kan vara användbart om kontot har en stor mängd data, vilket gör att object_with_object_properties och objects_x-vyer fungerar långsamt. Om du använder det här databasobjektet tillsammans med databasobjektet object_properties kan du replikera data i object_with_object_properties, samtidigt som du behåller kontrollen över vilka egenskaper som returneras.

Detta databasobjekt kan returnera följande kolumner:

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

Exempel 1

Hämta alla kontaktuppgifter.

Fråga:


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


Returnerar:

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

objekt_egenskaper

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

Detta databasobjekt kan returnera följande kolumner:

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

Exempel 1

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

Fråga:


SELECT objectTypeId, objectId, namn, värde
FROM object_properties
WHERE objectTypeId = '0-1'
AND name IN ("firstname", "lastname", "city")
ORDER BY objectId;


Returnerar:

OBJECTTYPEID OBJECTID NAMN VÄRDE
0-1 10401 Förnamn Brian
0-1 10401 staden Dublin
0-1 10401 efternamn Gallagher
0-1 23451 Förnamn Fernando
0-1 23451 efternamn Fierro
0-1 25751 Förnamn Charles
... ... ... ...

Exempel 2

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

Fråga:


SELECT objectId, förnamn, efternamn, livscykelstadium
FROM
(
SELECT objectId, namn, värde
FROM object_properties
WHERE objectTypeId = "0-1
AND name IN ('firstname', 'lastname', 'lifecyclestage')
)
PIVOT(MAX(value) FOR name IN ('firstname', 'lastname', 'lifecyclestage')) AS p(objectId, förnamn, efternamn, livscykel);

Returnerar:

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

object_properties_history

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

Detta databasobjekt kan returnera följande kolumner:

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

Exempel 1

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

Fråga:


SELECT objectId, namn, värde, updatedAt
FROM object_properties_history
WHERE objectTypeId = "0-1
AND objectId = 136493192
AND name = "hs_predictivescoringtier".
ORDER BY UPDATEDAT DESC;


Returnerar:

OBJECTID NAMN VÄRDE UPDATEDAT

136493192

hs_predictivescoringtier

nivå_1

2022-06-22 22:45:05.931

136493192

hs_predictivescoringtier

nivå_2

2021-09-18 08:20:56.622

136493192

hs_predictivescoringtier

nivå_3

2019-11-31 18:20:22.851

...

...

...

...

Exempel 2

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

Fråga:


VÄLJ
objectId,
properties:firstname::string AS firstname,
properties:lastname::string AS lastname
FROM object_with_object_properties
WHERE object_with_object_properties.objectTypeId = "0-1
AND objectId IN (
SELECT objectId
FROM object_properties_history
WHEREobject_properties_history.objectTypeId = "0-1
AND object_properties_history.name = "lifecyclestage".
AND object_properties_history.value = "subscriber".
);


Returnerar:

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

Förfrågningar om sammanslutningar

Liksom uppgifter om objekt organiseras uppgifter om sammanslutningar på två sätt:

  • Enskilda personer: Varje associationstyp lagras i en egen vy och innehåller endast poster av den typen. Till exempel innehåller associations_contacts_to_deals endast associationsposter mellan kontakt- och avtalsobjekt. Detta gör att man inte behöver ange ett associationtypeid vid sökning. De här vyerna är ganska enkla att fråga efter eftersom de inte kräver kännedom om CRM-datamodellen för att kunna användas. De returnerar också en berikad beskrivning av associationsposten mellan två objekt som lätt kan användas i föreningar med objects_x-vyer. Så länge du inte upplever långsamma frågor är det lämpligt att använda dessa vyer för att hämta associationsdata. Mer information finns i vyerna associations_x_to_y nedan.
  • Kombinerad: Alla poster för alla associationsformer kombineras i ett databasobjekt. När du gör en sökning måste du ange ett filter som "WHERE combinedassociationtypeid='0-32' ". Se mer om associationer och association_definitioner nedan.

associations_x_to_y views

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

Varje databasobjekt returnerar följande kolumner:

Namn på kolumnen

Typ

Beskrivning

COMBINEDASSOCIATIONTYPEID

Varchar

Den unika identiteten för definitionen av en sammanslutning.

FÖRENINGSKATEGORI

Varchar

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

ASSOCIATIONTYPEID

Varchar

En unik identifierare av en associationsdefinition inom en specifik associationskategori, dvs. två definitioner inom en associationskategori kan inte ha samma associationtypeid.

FROMOBJECTTYPEID

Varchar

Den objekttyp som är källan till definitionen av föreningen.

FRÅNOBJEKTTYP

Varchar

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

TOOBJECTTYPEID

Varchar

Den objekttyp som är destinationen för associationsdefinitionen.

TOOBJECTTYPE

Varchar

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

NAMN

Varchar

Föreningsdefinitionens namn.

ETIKETT

Varchar

Beskrivningen av definitionen av föreningen.

ISMAINASSOCIATIONDEFINITION

Boolean

Om definitionen av föreningen är huvudtypen. När det är sant är det definitionen som HubSpot visar på associerade poster.

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

Antal

Objekt-ID för källobjektet.

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

Antal

Objekt-ID för destinationsobjektet.

INGESTEDAT

Tidsstämpel

Datum och tid då uppgifterna senast togs in av Snowflake.

Exempel 1

Hämta alla affärer som är kopplade till en specifik kontakt.

Fråga:


VÄLJ
contact_objectId, deal_objectId

FROM associations_contacts_to_deals

WHERE contactId = 6626541373

Returnerar:

KONTAKT_OBJEKTID

DEAL_OBJECTID

6626541373

233620335

6626541373

90253678

Exempel 2

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


SELECT contacts.property_förnamn contact_förnamn,

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

KONTAKT_FÖRNAMN

KONTAKT_EFTERNAMN

KONTAKT_EMAIL

DEAL_TYPE

DEAL_AMOUNT

David

Magalhães

dmagalhaes@example.com

nyföretagande

74848

Fernanda

Rodrigues

fmoreira@example.com

nyföretagande

253530

Exempel 3

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


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

TOTAL_CLOSED_AMOUNT

KONTAKT_EMAIL

98474793

johndoe@riverview.com

849488

sallymae@longford.com

association_definitioner

Det här databasobjektet innehåller information om alla tillgängliga associationstyper mellan HubSpot-objekt, med en rad per associationstyp. Du kan koppla ihop det här databasobjektet med databasobjektet Associations för att få information om specifika associationer.

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

Detta databasobjekt kan returnera följande kolumner:

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

Exempel 1

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

Fråga:


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


Returnerar:

KOMBINERAD FÖRENINGSTYP FROMOBJECTTYPEID TOOBJECTTYPEID NAMN
0-1 0-1 0-2 KONTAKT_TILL_FÖRETAG
0-2 0-2 0-1 FÖRETAG_TILL_KONTAKT
0-3 0-3 0-1 DEAL_TO_CONTACT
0-4 0-1 0-3 KONTAKT_TILL_DEAL
0-5 0-3 0-2 DEAL_TO_COMPANY
... ... ... ...

Exempel 2

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

Fråga:


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 FROMOBJECTTYPEID TOOBJECTTYPEID NAMN
0-5 0-3 0-2 DEAL_TO_COMPANY
0-271 0-3 0-2 DEAL_TO_PRIMARY_COMPANY
0-341 0-3 0-2 DEAL_TO_COMAPNY_UNLABELED

föreningar

Det här databasobjektet innehåller information om sambanden mellan specifika poster. Varje rad representerar ett samband från ett objekt till ett annat objekt. Rader kan finnas i detta databasobjekt även om de refererade posterna har tagits bort. Du kan kontrollera om det finns poster genom att göra en sammanfogning med objekttabellen.

Det här databasobjektet kan vara användbart om kontot har en stor mängd data, vilket leder till att associations_x_to_y-vyerna fungerar långsamt.

Detta databasobjekt kan returnera följande kolumner:

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

Exempel 1

Hämta alla associerade affärer och kontakter.

Fråga:


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


Returnerar:

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

Exempel 2

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

Fråga:


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


Returnerar:

KOMBINERAD FÖRENINGSTYP FROMOBJECTID TOOBJECTID
0-5 6626541373 233620335

Exempel 3

Hämta alla affärer som är kopplade till en specifik kontakt (kontakt-ID: 4464). I stället för att hårdkoda combinedAssociationTypeId används association_definitions i det här exemplet.

Fråga:


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


Returnerar:

COMBINEDASSOCIATIONTYPEID FROMOBJECTID TOOBJECTID
0-5 6626541373 233620335

Förfrågningar från ägaren

ägare

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

Detta databasobjekt kan returnera följande kolumner:

Namn på kolumnen Typ Beskrivning
OWNERID Antal Användarens ägar-ID.
USERID Antal Användarens användar-ID. Användare med NULL i den här kolumnen har tagits bort.
EMAIL Varchar Användarens e-postadress.
FÖRNAMN Varchar Användarens förnamn.
LASTNAME Varchar Användarens efternamn.
ARKIVERAD Boolean Om användaren har tagits bort.
CREATEDAT Tidsstämpel Datum och tid då användaren skapades i HubSpot. Se kolumndatatyper för mer information.
UPDATEDAT Tidsstämpel Datum och tid då användaren senast uppdaterades i HubSpot. Se kolumndatatyper för mer information.
INGESTEDAT Tidsstämpel Datum och tid då uppgifterna senast togs in av Snowflake.

Exempel 1

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

Fråga:


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


Returnerar:

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

Exempel 2

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

Fråga:


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


Returnerar:

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

Exempel 3

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


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

JOIN owners owner ON contact.property_hubspot_owner_id = owner.ownerId


Returnerar:

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

Förfrågningar om rörledningar

Nedan får du veta hur du söker efter data om affärer och biljettpipelines, till exempel vilka pipelines som finns tillgängliga på ditt konto och deras stadier.

Du kan kombinera dessa data med objektdata för att få en fullständig bild av dina pipelines. Du kan t.ex. fråga efter affärer och deras pipelines genom att koppla samman objects_deals_view eller object_with_object_properties-data med pipelines-data.

rörledningar

Det här databasobjektet innehåller information om affärs- och biljettpipelines i ditt konto. Varje rad som returneras representerar en enskild pipeline.

Tabellen kan visa följande kolumner:

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

Exempel 1

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

Fråga:


SELECT objectTypeId, pipelineId, label
FROM pipelines
WHERE objectTypeId = "0-3"
AND not archived
ORDER BY displayorder;


Returnerar:

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

Exempel 2

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

Fråga:


VÄLJ

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


Returnerar:

DEAL_ID DEAL_NAME PIPELINE_NAME
605140072 Meowmix global registrering Försäljningspipeline
605457408 Friskies byter varumärke Försäljningspipeline
604362473 Nya steg för att bygga en app Försäljningspipeline

Exempel 3

Samma som exempel 2 ovan, men hämta affärer inom en specifik pipeline. Men i stä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

Försäljningspipeline

605457408

Friskies byter varumärke

Försäljningspipeline

604362473

Nya steg för att bygga en app

Försäljningspipeline

pipeline_stages

Den här vyn innehåller information om enskilda steg i en pipeline. Identifiera etapper genom att kombinera objekttyp-ID, pipeline-ID och etapp-ID. När du ansluter dig till rörledningar använder du objekttyp-ID och rörlednings-ID.

Detta databasobjekt kan returnera följande kolumner:

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

Exempel 1

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

Fråga:


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


Returnerar:

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

Exempel 2

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

Fråga:


VÄLJ

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


Returnerar:

DEAL_ID DEAL_NAME PIPELINE_NAME PIPELINE_STAGE_NAME
605140072 Meowmix global registrering Försäljningspipeline Avtal skickat
605457408 Friskies byter varumärke Försäljningspipeline Tidsplanerad tid
604362473 Nya steg för att bygga en app Försäljningspipeline Kontrakt undertecknat
... ... ... ...

Förfrågningar om fastigheter

Egendomsdefinitioner

Det här databasobjektet innehåller information om objekt- och händelseegenskaper i ditt HubSpot-konto. Händelseegenskaperna omfattar standardhändelser, t.ex. öppningar och klick i e-postmeddelanden, och anpassade beteendehändelseegenskaper. Den här informationen kan vara till hjälp för att definiera värden som finns i object_properties och händelsedata.

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

Detta databasobjekt kan returnera följande kolumner:

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

Exempel 1

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

Fråga:


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


Returnerar:

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

Förfrågningar om evenemang

Händelser inkluderar standardhändelser från HubSpot och anpassade beteendehändelser. Varje händelse har ett eget databasobjekt som kallas events_eventname.

Namn
EVENTS_AD_INTERACTION Uppgifter om en annons och kontakter som interagerade med annonsen genom att klicka på annonsen eller skicka in ett formulär efter att ha varit i kontakt med annonsen.
EVENTS_AD_METRICS_IMPORTED_V0

Information om en annons och dess prestanda.
EVENTS_CALL_MENTIONED_KEYWORD (NYCKELORD) Uppgifter om nyckelord som nämns av deltagare i samtalen.
EVENTS_CLICKED_LINK_IN_EMAIL_V2

Länkar som kontakterna klickat på i marknadsföringsmeddelanden.
EVENTS_CLICKED_LINK_IN_TRACKED_INBOX_EMAIL_V8 Länkar som klickats av kontakter i e-postmeddelanden från Conversations Inbox.
EVENTS_COOKIE_BANNER_CLICKED Kontakter som klickat på cookies.
EVENTS_COOKIE_BANNER_VIEWED Kontakter som har tittat på cookies.
EVENTS_DOCUMENT_SHARED_V2 Försäljningsdokument som delas med kontakter via en extern länk.
EVENTS_DOCUMENT_VIEWED_V2 Försäljningsdokument och kontakter som de har tittat på genom att öppna den externa länken.
EVENTS_DOCUMENT_COMPLETED_V2 Försäljningsdokument och kontakter som har avslutat dem.
EVENTS_HS_SCHEDULED_EMAIL_V2 E-postmeddelanden som skickas till HubSpot e-postservrar för att skickas.
EVENTS_MTA_DELIVERED_EMAIL_V2 E-postmeddelanden som HubSpot e-postservrar lyckats leverera till mottagarna.
EVENTS_MTA_BOUNCED_EMAIL_V2 Försök att leverera e-post som avvisades av mottagarens e-postserver.
EVENTS_OPENED_EMAIL_V2 E-post öppnas av kontakter.
EVENTS_REPORTED_SPAM_EMAIL_V2 E-postmeddelanden som markerats som skräppost av mottagarna.
EVENTS_UPDATED_EMAIL_SUBSCRIPTION_STATUS_V2 Ändringar av mottagarnas e-postabonnemang.
EVENTS_OPENED_TRACKED_INBOX_EMAIL_V8 E-postmeddelanden från Conservations Inbox öppnas av kontakter.
EVENTS_MB_MEDIA_PLAYED Aktivitet för videouppspelning av kontakter.
EVENTS_V2_CONTACT_BOOKED_MEETING_THROUGH_SEQUENCE Kontakt bokade ett möte genom sekvens.
EVENTS_V2_CONTACT_ENROLLED_IN_SEQUENCE Kontakt registrerad från sekvensen.
EVENTS_V2_CONTACT_FINISHED_SEQUENCE (HÄNDELSER_V2_KONTAKT_AVSLUTAD_FÖLJD) Sekvensen är avslutad.
EVENTS_V2_CONTACT_REPLIED_SEQUENCE_EMAIL Kontakten svarade på e-post (eller inkommande e-post som avregistrerade sekvensen) som skickades genom sekvensen.
EVENTS_V2_CONTACT_UNENROLLED_FROM_SEQUENCE Kontakt som avregistrerats från sekvensen.
EVENTS_V2_CONTACT_UNENROLLED_MANUALLY_FROM_SEQUENCE Användaren avregistrerade kontakten manuellt.
EVENTS_V2_CONTACT_UNSUBSCRIBED_SEQUENCE_EMAIL Kontakten har avregistrerat sig, vilket innebär att sekvensen inte längre är registrerad.
EVENTS_V2_SEQUENCE_EMAIL_BOUNCED E-postmeddelandet om sekvenser har avvisats.
EVENTS_V2_SEQUENCE_ERRORED Fel i sekvensen som orsakade avregistrering.
EVENTS_V2_SEQUENCE_STEP_EXECUTED Sekvenssteget har utförts.
EVENTS_VISITED_PAGE Sidbesök på webbplatsen av kontakter.

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

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

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

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



Namn på kolumnen Typ Beskrivning
EVENTTYPEID Varchar ID för händelsetypen, liknande OBJECTTYPEID.
Du kan fråga efter alla ID:n för händelsetyper i ditt konto med hjälp av vyn object_and_event_type_definitions.
ID Varchar Detta är unikt för varje evenemangstyp. Det finns inte två poster med samma ID inom en viss händelsetyp.
OBJECTTYPEID Varchar Den typ av objekt som avslutade händelsen. Om du till exempel klickar på en e-postlänk visas 0-1 i den här kolumnen, vilket representerar kontaktobjektet.
OBJECTID Antal ID för den post som avslutade händelsen.
OCCURREDAT Tidsstämpel När händelsen inträffade.

INTRÄFFADE VID EN TIDPUNKT I

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

INTRÄFFADE PÅ

Antal

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

Observera att den här kolumnen kommer att upphöra att användas den 24 november 2022 och ersättas med OCCURREDATDATEINT.

OCCUREDAT Tidsstämpel

När händelsen inträffade.

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

INGESTEDAT Tidsstämpel Datum och tid då uppgifterna senast togs in av Snowflake. Läs mer om kolumndatatyper.
PROPERTY_* Varchar Enskilda kolumner som innehåller händelsens egenskaper.

Exempel 1

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

Fråga:


SELECT eventTypeId, objectTypeId, objectId, occuredAt, property_hs_click_raw_url AS hs_click_raw_url
FROM events_clicked_link_in_email_V2
ORDER BY 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 kontaktuppgifter genom att gå samman 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;


Returnerar:

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

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

Object_and_event_type_definitions

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

Detta databasobjekt kan returnera följande kolumner:

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

Exempel 1

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

Fråga:


SELECT objectTypeId, fullyQualifiedName
FROM object_and_event_type_definitions;


Returnerar:

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

Listor förfrågningar

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

förteckningar

Det här databasobjektet innehåller information om HubSpot kontakt- och företagslistor. Det returnerar en rad per lista och kolumnerna innehåller information om listan, t.ex. listnamn, storlek och objekttyp för de poster som ingår. Innehåller inte information om de enskilda posterna i varje lista (se list_membership).

Detta databasobjekt kan returnera följande kolumner:

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

Exempel 1

Hämta alla kontaktlistor.

Fråga:


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


Returnerar:

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

Exempel 2

Hämta en specifik kontaktlista som heter Toppabonnenter 2021.

Fråga:


SELECT listId, namn, storlek
FROM listor
WHERE objectTypeId = "0-1"
ANDlistName
= "Top subscribers 2021";


Returnerar:

LISTID NAMN STORLEK
771852 Bästa prenumeranter 2021 37

list_membership

Det här databasobjektet innehåller information om vilka poster som ingår i vilka listor, med en rad per post i listan. Om du till exempel har en lista över bloggprenumeranter med 500 kontakter kommer databasobjektet att ge 500 rader.

Innehåller endast list-ID och objekt-ID. För mer information, gå samman med databasobjektet lists.

Detta databasobjekt kan returnera följande kolumner:

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

Exempel 1

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

Fråga:


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


Returnerar:

OBJECTID
54325098
96805401
6922028
...

Exempel 2

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

Fråga:


VÄLJ

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


Returnerar:

OBJECTID

FÖRNAMN

EFTERNAMN

54325098

Hobbes

Baron

96805401

Milo

Guld

6922028

Henry

Riley

...

...

...

Vanliga frågor

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


I allmänhet vill du titta på kolumnerna i den rapport du jämför med. Om rapportens visualisering inte är tabellformad, kan du konvertera den till en tabell för att visa de kolumner som rapporten innehåller. Dessa kolumner är vanligtvis egenskaper för en objekttyp eller en händelsetyp. Nästa steg är att ta reda på vilken objekttypegenskap en kolumn motsvarar. Detta kan du göra genom att fråga efter property_definitions:


SELECT * FROM property_definitions

WHERE label = [column_name]

Det kanske inte alltid är en exakt matchning eftersom vissa egenskapsnamn brukar lösas upp till ett mer beskrivande namn i appen. I sådana fall kan det hjälpa att göra en oklar sökning med hjälp av LIKE-operatorn på kolumnen label (eller till och med description) i property_definitions.

Efter att ha bestämt vilken objekttyp kolumnen tillhör är det trivialt att bestämma vad som ska efterfrågas. Du kan helt enkelt söka efter den object_x-vy som motsvarar typen.

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


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


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

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