Forespørg på HubSpot-data i Snowflake

Skrevet af HubSpot Support | Jun 28, 2023 1:53:46 PM

Når du har forbundet Snowflake med din HubSpot-konto, kan du bruge Snowflakes Data Share til at forespørge på HubSpot-data fra din Snowflake-konto.

Datalag og din Snowflake-kontoregion

Du får adgang til V2_LIVE-skemaet, som opdateres hvert 15. minut, og V2_DAILY-skemaet, som opdateres hver dag.

Bemærk: Følgende visninger i V2_LIVE-skemaet opdateres kun dagligt: association_definitions, owners, pipelines og pipeline_stages.

Opsæt dit Snowflake-miljø

For at forespørge på dine HubSpot-data i Snowflake skal du vælge det lager, den database og det skema, du vil forespørge fra. Du kan enten indstille dem på regnearkniveau, så de automatisk indgår i dine forespørgsler, eller du kan tilføje dem manuelt.

Sådan vælger du dit lager, din database og dit skema på regnearkniveau:

I den øverste række af regnearket skal du klikke på regnearkets handlingslinje.
I pop op-vinduet:
- Klik på rullemenuen Warehouse, og vælg derefter dit lager.
- Klik på rullemenuen Database, og vælg derefter din HubSpot-database.
- Klik på rullemenuen Schema, og vælg derefter det skema, du vil bruge:

Når dit miljø er konfigureret, kan du lave forespørgsler til dine HubSpot-data uden at skulle tilføje din database- eller skematype til forespørgsler manuelt.

For manuelt at tilføje din database og skematype til forespørgsler skal du tilføje databasenavnet efterfulgt af skemaet i begyndelsen af feltet FROM. Det kan f.eks. være

SELECT objectTypeId, property_createddate
FROM hubspot_share_name.V2_LIVE.objects_deals

LIMIT 1

Dataoversigt

Forespørgsler konstrueres ved hjælp af SQL og kan bruges til at hente HubSpot-data som f.eks:

Objekter: standard- og brugerdefinerede objekter, f.eks. kontakter, virksomheder, produkter.
Poster: individuelle poster, f.eks. en individuel kontakt eller virksomhed.
Associationer: alle tilgængelige associationstyper og aktuelt associerede poster.
Begivenheder: Begivenhedsdata for både standard HubSpot-begivenheder, som f.eks. e-mailåbninger, og brugerdefinerede adfærdsbegivenheder.
Segmenter: HubSpot-kontakt- og virksomhedssegmenter.
Ejere: brugere på din HubSpot-konto i forhold til de poster, de er sat som ejer af.
Pipelines: Deal- og ticket-pipelines, herunder pipeline-stadier.
Egenskaber: egenskaber og deres værdier på CRM-poster, herunder egenskabshistorik.

Få mere at vide om HubSpots CRM-datamodel.

Bemærk: I takt med at vi udvikler datadelen, vil vi indføre ændringer, hvoraf nogle er af afgørende betydning. Det anbefales på det kraftigste at abonnere på HubSpots ændringslog for udviklere. Disse ændringer vil altid blive slået op i ændringsloggen forud for enhver opdatering.

Begrænsning og rækkefølge af returnerede data

Når du konstruerer forespørgsler, kan du kontrollere, hvor mange data der returneres, og i hvilken rækkefølge de returneres, ved at inkludere LIMIT og ORDER BY i din forespørgsel. Hvis du f.eks. vil forespørge på alle kontakter med deres egenskaber, men kun returnere tre resultater og bestille dem efter kontakt-ID, kan du konstruere din forespørgsel på følgende måde:

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

Datatyper for kolonner

Når du forespørger på data i Snowflake, afhænger de kolonner, der returneres, af de data, du forespørger på. Du kan se de tilgængelige kolonner for en given tabel eller visning i Snowflake ved at vælge visningen i venstre sidepanel.

Bemærk:I resten af dette dokument bruger vi udtrykket databaseobjekt, når konteksten gælder både tabeller og visninger.

For at returnere en bestemt kolonne skal du inkludere den pågældende kolonne i SELECT -feltet i din forespørgsel. For eksempel vil følgende forespørgsel kun returnere kolonnerne OBJECTID og UpdatedAt:

SELECTobjectId, updatedAt
FROM objects_contacts

Nedenfor er der generelle definitioner af kolonner, som en forespørgsel kan returnere. For andre definitioner, der ikke er medtaget nedenfor, se de individuelle visningsdefinitioner i artiklen ovenfor.

OBJECTTYPEID: en VARCHAR-værdi, der repræsenterer et objekts type. For eksempel repræsenterer 0-1 kontaktobjektet, 0-2 repræsenterer virksomhedsobjektet, og 2-1232 kan repræsentere et brugerdefineret objekt i din konto. I segmenter henviser dette til typen af segment (f.eks. kontakt eller virksomhed). Du kan forespørge på alle objekt- og hændelses-ID'er i din konto ved hjælp af visningen object_and_event_type_definitions.
OBJECTID: et BIGINT-nummer, der repræsenterer en enkelt post af en given type objekt i din HubSpot-konto. For at identificere en post skal du bruge både objekttype-id'et og objekt-id'et.
INGESTEDAT: Tidsstemplet for, hvornår en række data blev tilføjet til Snowflake, repræsenteret ved en TIMESTAMP_NTZ-værdi. Ikke relateret til det logiske tidsstempel for en oprettelses- eller opdateringsoperation i HubSpot.
- På grund af HubSpots interne behandling kan en rækkes tidsstempel for indlæsning blive opdateret, selvom ingen andre kolonner i rækken er blevet ændret.
- Når du opbygger ETL-processer, der kopierer nyligt ændrede data, anbefales det at basere dine forespørgsler på tidsstemplet for indlæsning. Hvis dit flow kopierer data dagligt, anbefales det desuden at kopiere data fra de foregående to dage for at tage højde for forsinkelser.
CREATEDAT og UPDATEDAT: Det logiske tidsstempel for, hvornår data blev oprettet eller opdateret i HubSpot, repræsenteret ved en TIMESTAMP_NTZ-værdi . Disse tidsstempler vil matche tidsstemplerne i HubSpot. For eksempel vil det tidspunkt, der vises i HubSpot for oprettelsesdatoen for en post, være det samme som tidsstemplet i CREATEDAT-kolonnen i Snowflake. Disse er ikke direkte relateret til tidsstemplet for indlæsning, og det anbefales ikke at basere ETL-processer på disse egenskaber.
COMBINEDASSOCIATIONTYPE: en VARCHAR-værdi, der entydigt identificerer en associationsdefinition.

Transformation af datatyper

Nogle gange returneres data fra en forespørgsel med VARCHAR-kolonner, hvor det ville være ønskeligt at have dem som en anden type. I sådanne tilfælde anbefales det at konvertere VARCHAR-datatypen til de ønskede typer ved hjælp af Snowflake-funktioner. For eksempel gemmes egenskaber for en objektpost som VARCHAR-datatyper i de fleste databaseobjekter, men indeholder nogle gange tal- og datetime-værdier. Funktioner som f.eks:
try_to_number, try_to_timestamp_ntz kan bruges til at konvertere disse VARCHAR-data til henholdsvis deres NUMBER- og DATETIME-typer:

SELECT objectid, value AS amount_str, try_to_number(value) AS amount
FROM object_properties WHERE objecttypeid='0-3' AND name='amount' LIMIT 1

Objektforespørgsler

Nedenfor kan du se, hvordan du forespørger på data fra specifikke HubSpot-objekter og -poster, samt hvilke data der returneres.

Objektdata af forskellige typer er organiseret og tilgængelige på to måder:

Individuel: Hver objekttype gemmes i sin egen visning og indeholder kun poster af samme objekttype, f.eks. indeholder objects_contacts kun kontaktposter. Dette eliminerer behovet for at angive et objekttype-id under forespørgsler. Disse visninger er nemmere at forespørge på, da man ikke behøver at kende ObjectTypeIds. De returnerer også data i et mere brugbart format, hvor hver række svarer til et objekt og den aktuelle version af dets egenskaber. Så længe du ikke oplever langsomme forespørgsler, er det tilrådeligt at bruge disse visninger til at hente objektdata. Se mere i Objects_X-visninger nedenfor.
Kombineret: Alle poster for alle objekttyper kombineres til ét databaseobjekt. Når du forespørger, skal du derfor angive et filter som "WHERE objectTypeId='0-1'. Du kan f.eks. bruge følgende objekttypeid'er, når du forespørger:

Objektets navn	ObjektTypeId
Kontaktpersoner	0-1
Virksomheder	0-2
Linjeartikler	0-8

Brugerdefinerede objekter får tildelt et ID på oprettelsestidspunktet og identificeres som 2-unique_ID. For eksempel 2-12345. Læs mere om object_and_event_type_definitions.

Disse databaseobjekter er generelt velegnede, hvis man ønsker bedre forespørgselsperformance end den, man kan opnå med objects_x views. Se flere detaljer i object_with_object_properties, object_properties, objects og object_properties_history nedenfor.

objects_x visninger

I dette databaseobjekt har hver tilgængelig objekttype, inklusive brugerdefinerede objekter, sin egen specifikke visning, og hver visning indeholder kun poster for objekter af den specifikke objekttype. Disse visninger navngives i formatet OBJECTS_<object type name>, hvor <object type name> er flertalsformen for objekttypen (bemærk, at hvis objekttypen ikke har nogen flertalsform, vil <object type name> blot være entalsformen for objekttypens navn sammenkædet med "S").

Forespørgsler til denne visning returnerer en række for hver post i et objekt, hvor hver egenskab i objektet er tilgængelig som en separat kolonne.

Se nedenfor den omfattende liste over tilgængelige HubSpot-objekttyper (dvs. ikke-brugerdefinerede), en kort beskrivelse af de data, de repræsenterer, og deres tilsvarende visninger:

HubSpot-objekttype	ObjektTypeId	Beskrivelse
KONTAKT	0-1	Oplysninger om personer, der interagerer med din virksomhed
VIRKSOMHED	0-2	Oplysninger om individuelle virksomheder eller organisationer
HANDEL	0-3	Detaljer om indtægtsmuligheder med en kontakt eller virksomhed
ENGAGEMENT	0-4	Gemmer data fra CRM-handlinger, herunder noter, opgaver, e-mails, møder og opkald
BILLET	0-5	Repræsenterer kundeanmodninger om hjælp eller support
QUOTE	0-14	Bruges til at dele prisoplysninger med potentielle købere
FORM_SUBMISSION	0-15	Detaljer for individuelle indsendelser til en HubSpot-formular
LINE_ITEM	0-8	Repræsenterer en delmængde af de produkter, der sælges i en aftale. Når et produkt er knyttet til en aftale, bliver det til en varelinje
KONVERSATION	0-11	Detaljer om indgående beskeder fra flere kanaler.
LANDING_PAGE	0-25	Detaljer om dine landingssider
TASK	0-27	Gemmer oplysninger om to-do-lister
FORM	0-28	Bruges til at indsamle lead-oplysninger om dine besøgende og kontakter
MARKETING_EMAIL	0-29	Detaljer om e-mails fra marketing hub
AD_ACCOUNT	0-30	Gemmer oplysninger om dine annoncekonti på Linkedin, Facebook og Google
AD_CAMPAIGN	0-31	Detaljer om dine annoncekampagner. En annoncekampagne kan indeholde en eller flere annoncer
AD_GROUP	0-32	Logisk gruppering af annoncer i en annoncekampagne
AD	0-33	Detaljer om individuelle annoncer
KAMPAGNE	0-35	Oplysninger om relaterede marketingaktiver og indhold, så du nemt kan måle effektiviteten af din samlede marketingindsats
SITE_PAGE	0-38	Data om individuelle sider på dine websites
BLOG_POST	0-39	Data om blogindlæg
OBJECT_SEGMENT	0-45	Oplysninger om grupperinger af objektposter baseret på deres egenskaber eller aktiviteter
CALL	0-48	Opkald foretaget af andre CRM-poster, f.eks. kontakter
INVOICE	0-53	Administrer og synkroniser fakturaer med eksterne regnskabssystemer
MEDIA_BRIDGE	0-57	Oplysninger om medieaktiver, der er importeret til Hubspot
SEQUENCE	0-58	En sekvens er en række målrettede, tidsbestemte e-mail-skabeloner til at pleje kontakter over tid
TEMPLATE	0-62	Gemt e-mailindhold, der kan genbruges til at sende e-mails
DEAL_SPLIT	0-72	Deal splits bruges til at dele deal credit mellem flere brugere
SALES_DOCUMENT	0-83	Salgsdokumenter opbygger et bibliotek med indhold, som hele dit team kan uploade og dele dokumenter med dine kontakter.
FEEDBACK_INDSENDELSE	0-19	Gemmer oplysninger, der er indsendt til en feedback-undersøgelse
ABONNEMENT	0-69	Abonnementer indeholder oplysninger om tilbagevendende betalinger
HANDELSBETALING	0-101	Indeholder data om midler indsamlet fra kunder

Hvert databaseobjekt returnerer følgende kolonner:

Navn på kolonne	Type	Beskrivelse
OBJECTTYPEID	Varchar	ID for objekttypen (f.eks. kontakter er 0-1).
OBJECTID	Nummer	Postens ID (f.eks. en kontaktpost med et ID på 123752).
UPDATEDAT	Tidsstempel	Den dato og det klokkeslæt, hvor dette objekt sidst blev opdateret i HubSpot.
INGESTEDAT	Tidsstempel	Den dato og det klokkeslæt, hvor dataene sidst blev indlæst af Snowflake.
PROPERTY_*	Varchar	Individuelle kolonner, der indeholder den seneste version af objektets egenskaber For hver objektegenskab, der har en dato- eller taltype (som specificeret af property_definitions), vil der være to kolonner: En kolonne, der indeholder egenskabsværdien som streng. Kolonnenavnet vil være property_unparsed_[name] . For eksempel vil DEAL-objektegenskaben deal_amount have kolonnen property_unparsed_deal_amount. En kolonne, der indeholder den værdi, der er konverteret til den oprindelige type. Kolonnen får navnet property_[name], f.eks. vil DEAL-objektet property, deal_amount have kolonnen property_deal_amount. Bemærk, at denne kolonne vil indeholde null, hvis konverteringen til den oprindelige type mislykkes på grund af ugyldige data.

Eksempel 1

Hent fornavn, efternavn og livscyklusstadie for alle kontakter.

Forespørgsel:

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

Returnerer:

OBJECTID	FØRSTENAVN	SIDSTENAVN	LIVSCYKLUSSTADIE
54325098	Hobbes	Baron	bly
96805401	Milo	Guld	bly
6922028	Henry	Riley	Bly

Eksempel 2

Hent deal-navn og -stadie for op til tre deals.

Query:

SELECT objectId, property_dealName, property_dealStage, property_amount AS dealAmount
FROM objects_deals LIMIT 3

Returnerer:

OBJECTID	PROPERTY_DEALNAME	PROPERTY_DEALSTAGE	PROPERTY_DEALAMOUNT
38960439	Navn på aftale 1	closedwon	34199
321740651	Testaftale 123	14845019	8383663
98392101	Pop-up baldakin	closedwon	9309007

Eksempel 3

Hent dealnavn og stadie for de tre bedste deals efter beløb.

Forespørgsel:

Da data om aftalebeløb er tilgængelige som en taldatatype, kan de bruges til at bestille uden behov for konvertering eller casting.

SELECT objectId, property_dealName, property_dealStage, property_amount AS dealAmount
FROM objects_deals ORDER BY property_amount DESC LIMIT 3

Returnerer:

OBJECTID	PROPERTY_DEALNAME	PROPERTY_DEALSTAGE	PROPERTY_DEALAMOUNT
98392101	Pop-up baldakin	closedwon	9309007
321740651	Testaftale 123	14845019	8383663
38960439	Navn på aftale 1	closedwon	34199

object_with_object_properties

Dette databaseobjekt indeholder data fra dine HubSpot-poster. Forespørgsler til dette databaseobjekt returnerer en række for hver post inden for en objekttype (f.eks. alle kontaktposter i kontaktobjekttypen). Alle egenskaber gemmes i kolonnen Properties, som er en Snowflake Variant/JSON-kolonne.

Denne visning kan returnere følgende kolonner:

Navn på kolonne	Type	Beskrivelse
`OBJECTTYPEID`	Varchar	Objekttypens ID (f.eks. er kontakter `0-1`).
`OBJECTID`	Nummer	Postens ID (f.eks. en kontaktpost med et ID på `123752`).
`PROPERTIES`	Variant	Postens egenskabsværdier.
`UPDATEDAT`	Tidsstempel	Den dato og det klokkeslæt, hvor posten sidst blev opdateret i HubSpot. Få mere at vide om kolonnedatatyper.
`INGESTEDAT`	Tidsstempel	Den dato og det klokkeslæt, hvor dataene sidst blev indlæst af Snowflake.

Bemærk: Den 25. januar 2022 vil kolonnen timestamp i tabellen og visningen object_with_object_properties, som repræsenterer den dato og det klokkeslæt, hvor objektposten sidst blev opdateret i HubSpot, være updatedat. Dette er for at tilpasse sig, hvordan datetime-data repræsenteres i resten af datadelen.

Da dette er en gennemgribende ændring, er den nye kolonne, updatedat, blevet tilføjet til tabellen og visningen. I de næste 90 dage vil disse to nye kolonner eksistere side om side med timestamp, som er de kolonner, de skal erstatte. Det giver dig mulighed for at skifte til de nye kolonner.

Efter 90 dage, den 25. januar 2022, vil kolonnen timestamp blive fjernet fra tabellen og visningen. Efter denne dato vil ethvert forsøg på at forespørge i tabellen eller visningen object_with_object_properties ved hjælp af timestamp-kolonner mislykkes.

Eksempel 1

Hent alle kontakter og deres egenskaber.

Forespørgsel:

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

Returnerer:

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

Eksempel 2

Hent aftalens navn og fase for op til tre aftaler.

Forespørgsel:

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

Returnerer:

OBJECTID	DEALNAME	DEALSTAGE	DEALAMOUNT
38960439	Navn på aftale 1	closedlost	7488939
321740651	Navn på aftale 1	closedwon	9292029
98392101	Navn på aftale 1	closedlost	62626528

objekter

Dette databaseobjekt er en delmængde af dataene i databaseobjektet object_with_object_properties. Hver returneret række returnerer objekt-ID'et for hver post. Dette databaseobjekt returnerer kun eksisterende poster. Når en post slettes i HubSpot, vil den blive fjernet fra dette databaseobjekt. Dette databaseobjekt er en delmængde af dataene i tabellen object_with_object_properties. Hver returneret række returnerer objekt-ID'et for hver post. Denne visning returnerer kun eksisterende poster. Når en post slettes i HubSpot, vil den blive fjernet fra denne visning.

Dette databaseobjekt kan være nyttigt, hvis din konto har en stor mængde data, som gør, at visningerne object_with_object_properties og objects_x fungerer langsomt. Ved at bruge dette databaseobjekt sammen med databaseobjektet object_properties er det muligt at replikere dataene i object_with_object_properties, samtidig med at man bevarer kontrollen over, hvilke egenskaber der returneres.

Dette databaseobjekt kan returnere følgende kolonner:

Navn på kolonne	Type	Beskrivelse
`OBJECTTYPEID`	Varchar	Objekttypens ID (f.eks. er kontakter `0-1`).
`OBJECTID`	Tal	Postens ID (f.eks. en kontaktpost med et ID på `123752`).
`INGESTEDAT`	Tidsstempel	Den dato og det klokkeslæt, hvor dataene sidst blev indlæst af Snowflake. Få mere at vide om kolonnedatatyper.

Eksempel 1

Hent alle kontaktoptegnelser.

Forespørgsel:

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

Returnerer:

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

object_properties

Dette databaseobjekt er en delmængde af databaseobjektet object_with_object_properties. Hver række indeholder den aktuelle egenskabsværdi, der er indstillet på en given post. En kontakt vil f.eks. have en række for egenskaben First name og en række for egenskaben Last name. Hvis en post ikke har en værdi for en egenskab, vil rækken enten blive vist med en tom streng eller slet ikke blive vist.

Dette databaseobjekt kan returnere følgende kolonner:

Navn på kolonne	Type	Beskrivelse
`OBJECTTYPEID`	Varchar	Objekttypens ID (f.eks. er kontakter `0-1`).
`OBJECTID`	Tal	Postens ID (f.eks. en kontaktpost med et ID på `123752`).
`NAME`	Varchar	Navnet på egenskaben.
`VALUE`	Tidsstempel	Værdien af egenskaben.
`UPDATEDAT`	Tidsstempel	Den dato og det klokkeslæt, hvor posten sidst blev opdateret i HubSpot. Få mere at vide om kolonnedatatyper.
`INGESTEDAT`	Tidsstempel	Den dato og det klokkeslæt, hvor dataene sidst blev indlæst af Snowflake.

Eksempel 1

Hent egenskaberne fornavn, efternavn og by for alle kontakter.

Forespørgsel:

SELECT objectTypeId, objectId, name, value
FROM object_properties
WHERE objectTypeId = '0-1'
AND name IN ('firstname', 'lastname', 'city')
ORDER BY objectId;

Returnerer:

OBJECTTYPEID	OBJECTID	NAVN	VÆRDI
0-1	10401	Fornavn	Brian
0-1	10401	By	Dublin
0-1	10401	Efternavn	Gallagher
0-1	23451	Fornavn	Fernando
0-1	23451	Efternavn	Fierro
0-1	25751	Fornavn	Charles
...	...	...	...

Eksempel 2

Hent fornavn, efternavn og livscyklusstadie for alle kontakter, og kombiner dem i én række pr. kontakt. Dette eksempel bruger SQL PIVOT-syntaksen.

Forespørgsel:

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

Returnerer:

OBJECTTYPEID	OBJECTID	FIRSTNAME	LASTNAME	LIFECYCLESTAGE
0-1	54325098	Hobbes	Baron	Føring
0-1	96805401	Milo	Guld	bly
0-1	6922028	Henry	Riley	bly
...	...	...	...	...

object_properties_history

Dette databaseobjekt indeholder historiske egenskabsværdier. For kontakter indeholder det de seneste 45 værdier. For alle andre objekter indeholder det de seneste 20 værdier. Viser en række for hver historisk egenskabsværdi. Den aktuelle værdi for en egenskab bestemmes af det seneste UPDATEDAT-tidsstempel i egenskabens historik.

Dette databaseobjekt kan returnere følgende kolonner:

Navn på kolonne	Type	Beskrivelse
`OBJECTTYPEID`	Varchar	Objekttypens ID (f.eks. er kontakter `0-1`).
`OBJECTID`	Tal	Postens ID (f.eks. en kontaktpost med et ID på `123752`).
`NAME`	Varchar	Navnet på egenskaben.
`VALUE`	Tidsstempel	Værdien af egenskaben.
`UPDATEDAT`	Tidsstempel	Den dato og det klokkeslæt, hvor dataene sidst blev opdateret i HubSpot. Få mere at vide om kolonnedatatyper.
`INGESTEDAT`	Tidsstempel	Den dato og det klokkeslæt, hvor dataene sidst blev indlæst af Snowflake.

Eksempel 1

Hent historikken for en enkelt egenskab for en enkelt kontakt.

Forespørgsel:

SELECT objectId, name, value, updatedAt
FROM object_properties_history
WHERE objectTypeId = '0-1'
AND objectId = 136493192
AND name = 'hs_predictivescoringtier'
ORDER BY UPDATEDAT DESC;

Returnerer:

OBJECTID	NAVN	VÆRDI	UPDATEDAT
136493192	hs_predictivescoringtier	tier_1	2022-06-22 22:45:05.931
136493192	hs_predictivescoringtier	tier_2	2021-09-18 08:20:56.622
136493192	hs_prediktivecoringtier	tier_3	2019-11-31 18:20:22.851
...	...	...	...

Eksempel 2

Hent det aktuelle navn på alle kontakter, der nogensinde har haft livscyklusstadiet Subscriber.

Forespørgsel:

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

Returnerer:

OBJECTID	FIRSTNAME	LASTNAME
54325098	Hobbes	Baron
96805401	Milo	Guld
6922028	Henry	Riley
...	...	...

Forespørgsler om associationer

Ligesom objektdata er associationsdata organiseret på to måder:

Individuel: Hver associationstype gemmes i sin egen visning og indeholder kun poster af den pågældende type. F.eks. indeholder associations_contacts_to_deals kun associationsposter mellem kontakt- og aftaleobjekter. Dette eliminerer behovet for at angive et associationstype-id under forespørgsler. Disse visninger er ret nemme at forespørge på, da de ikke kræver kendskab til CRM-datamodellen for at kunne bruges. De returnerer også en beriget beskrivelse af associationsposten mellem to objekter, som nemt kan bruges i joins med objects_x-visninger. Så længe du ikke oplever langsomme forespørgsler, er det tilrådeligt at bruge disse visninger til at hente associationsdata. Se mere i associations_x_to_y-visningerne nedenfor.
Kombineret: Alle poster for alle associationstyper kombineres til ét databaseobjekt. Når du forespørger, skal du derfor angive et filter som "WHERE combinedassociationtypeid='0-32' ". Se mere i associations og association_definitions nedenfor.

associations_x_to_y-visninger

Hver associationstype har sin egen visning, mærket som associations_<association type name>, f.eks. associations_contacts_to_deals. Hver visning er en delmængde af dataene i associations-databaseobjektet og indeholder kun poster med et specifikt combinedassociationtypeid.

Hvert databaseobjekt returnerer følgende kolonner:

Navn på kolonne	Type	Beskrivelse
KOMBINERETASSOCIATIONSTYPEID	Varchar	Den unikke identifikator for associationsdefinitionen.
ASSOCIATIONSKATEGORI	Varchar	Kilden til associationstypen. En af: HUBSPOT_DEFINED, USER_DEFINED, INTEGRATOR_DEFINED
ASSOCIATIONSTYPEID	Varchar	En unik identifikator for en associationsdefinition inden for en specifik associationskategori, dvs. at ikke to definitioner i en associationskategori vil have samme associationstypeid.
FROMOBJECTTYPEID	Varchar	Det objekttypeid, der er kilden til associationsdefinitionen.
FROMOBJECTTYPE	Varchar	Navnet på den objekttype, der er kilden til associationsdefinitionen.
TOOBJECTTYPEID	Varchar	Det objecttypeid, der er destinationen for associationsdefinitionen.
TOOBJECTTYPE	Varchar	Navnet på den objekttype, der er destinationen for associationsdefinitionen.
NAME	Varchar	Associeringsdefinitionens navn.
LABEL	Varchar	Associationsdefinitionens beskrivelse.
ISMAINASSOCIATIONDEFINITION	Boolsk	Om associationsdefinitionen er hovedtypen. Når true, er definitionen den, som HubSpot viser på associerede poster
[FROMOBJECTTYPE_OBJECTID] f.eks. for visningen ASSOCIATIONS_CONTACTS_TO_DEALS vil dette være CONTACT_OBJECTID	Antal	Objekt-ID for kildeobjektet.
[TOOBJECTTYPE_OBJECTID] f.eks. for ASSOCIATIONS_CONTACTS_TO_DEALS view, vil dette være DEAL_OBJECTID	Antal	Objekt-ID for destinationsobjektet.
INGESTEDAT	Tidsstempel	Den dato og det klokkeslæt, hvor dataene sidst blev indlæst af Snowflake.

Eksempel 1

Hent alle aftaler, der er knyttet til en bestemt kontakt.

Forespørgsel:

SELECT
contact_objectId, deal_objectId

FROM associations_contacts_to_deals

WHERE contactId = 6626541373

Returnerer:

KONTAKT_OBJEKTTID	DEAL_OBJECTID
6626541373	233620335
6626541373	90253678

Eksempel 2

Hent alle kontakter med base i tidszonen Bogota og deres aftaler.

SELECT contacts.property_firstname contact_firstname,

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

KONTAKT_FORNAVN	KONTAKT_EFTERNAVN	CONTACT_EMAIL	DEAL_TYPE	DEAL_AMOUNT
David	Magalhães	dmagalhaes@example.com	newbusiness	74848
Fernanda	Rodrigues	fmoreira@example.com	newbusiness	253530

Eksempel 3

Hent alle kontakter og den samlede sum af indgåede aftaler for hver 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

Returnerer:

TOTAL_CLOSED_AMOUNT	KONTAKT_EMAIL
98474793	johndoe@riverview.com
849488	sallymae@longford.com

association_definitions

Dette databaseobjekt indeholder oplysninger om alle tilgængelige associationstyper mellem HubSpot-objekter, med én række pr. associationstype. Du kan forbinde dette databaseobjekt med associations-databaseobjektet for at få postspecifikke associationsoplysninger.

Der kan være flere typer associationer mellem de samme objekter. Hovedassociationstypen, som er den type, der vises i HubSpot, når poster er associeret, bruger associationen, hvor ISMAINASSOCIATIONDEFINITION er true.

Dette databaseobjekt kan returnere følgende kolonner:

Kolonnens navn	Type	Beskrivelse
`COMBINEDASSOCIATIONTYPEID`	Varchar	Den unikke identifikator for associationsdefinitionen.
`CATEGORY`	Varchar	Kilden til associationstypen. En af: `HUBSPOT_DEFINED`, `USER_DEFINED`, `INTEGRATOR_DEFINED`
`ID`	Antal	Identifikatoren for associationsdefinitionen inden for dens kategori.
`FROMOBJECTTYPEID`	Varchar	ID for det objekt, der er kilden til associationsdefinitionen.
`TOOBJECTTYPEID`	Varchar	ID'et for det objekt, der er destinationen for associationsdefinitionen.
`NAME`	Varchar	Associeringsdefinitionens navn.
`LABEL`	Varchar	Associeringsdefinitionens etiket.
`ISMAINASSOCIATIONDEFINITION`	Boolsk	Om associationsdefinitionen er hovedtypen. Når det er sandt, er det definitionen, som HubSpot viser på tilknyttede poster.
`INGESTEDAT`	Tidsstempel	Den dato og det klokkeslæt, hvor dataene sidst blev indlæst af Snowflake. Få mere at vide om kolonnedatatyper.

Eksempel 1

Hent de typer af associationer, der er tilgængelige på din konto.

Forespørgsel:

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

Returnerer:

KOMBINERETASSOCIATIONSTYPE	FRAOBJEKTTYPEID	TOOBJECTTYPEID	NAVN
0-1	0-1	0-2	KONTAKT_TIL_VIRKSOMHED
0-2	0-2	0-1	VIRKSOMHED_TIL_KONTAKT
0-3	0-3	0-1	DEAL_TO_CONTACT
0-4	0-1	0-3	KONTAKT_TIL_AFTALE
0-5	0-3	0-2	DEAL_TO_COMPANY
...	...	...	...

Eksempel 2

Hent de tilgængelige associationstyper mellem aftaler og virksomheder.

Forespørgsel:

SELECTcombinedAssociationTypeId, fromObjectTypeId, toObjectTypeId, name
FROM association_definitions
WHERE fromObjectTypeId = '0-3' AND toObjectTypeId = '0-2' AND isMainAssociationDefinition = true
ORDER BY category, id

Returnerer:

COMBINEDASSOCIATIONTYPE	FROMOBJECTTYPEID	TOOBJECTTYPEID	NAVN
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

associationer

Dette databaseobjekt indeholder oplysninger om associationerne mellem specifikke poster. Hver række repræsenterer en tilknytning fra et objekt til et andet objekt. Rækker kan være til stede i dette databaseobjekt, selv om de poster, der henvises til, er blevet slettet. Du kan tjekke, om der findes poster ved at joine med objekttabellen.

Dette databaseobjekt kan være nyttigt, hvis din konto har en stor mængde data, hvilket fører til, at associations_x_to_y-visninger fungerer langsomt.

Dette databaseobjekt kan returnere følgende kolonner:

Navn på kolonne	Type	Beskrivelse
`COMBINEDASSOCIATIONTYPEID`	Varchar	Den unikke identifikator for associationsdefinitionen.
`FROMOBJECTID`	Antal	ID for kildeobjektet.
`TOOBJECTID`	Nummer	ID'et for destinationsobjektet.
`INGESTEDAT`	Tidsstempel	Den dato og det klokkeslæt, hvor dataene sidst blev indlæst af Snowflake. Få mere at vide om kolonnedatatyper.

Eksempel 1

Hent alle tilknyttede aftaler og kontakter.

Forespørgsel:

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

Returnerer:

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

Eksempel 2

Hent alle billetter, der er knyttet til en bestemt kontakt (kontakt-ID: 3005).

Forespørgsel:

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

Returnerer:

KOMBINERET ASSOCIATIONSTYPE	FROMOBJECTID	TOOBJECTID
0-5	6626541373	233620335

Eksempel 3

Hent alle aftaler, der er knyttet til en bestemt kontakt (kontakt-ID: 4464). I stedet for hårdkodning af combinedAssociationTypeId forbinder dette eksempel med association_definitions.

Forespørgsel:

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;

Returnerer:

COMBINEDASSOCIATIONTYPEID	FROMOBJECTID	TOOBJECTID
0-5	6626541373	233620335

Ejerforespørgsler

Ejere

Dette databaseobjekt indeholder oplysninger om brugerne på din HubSpot-konto. Brugere kan indstilles som ejere af poster og vil indeholde både et bruger-id og et ejer-id, afhængigt af deres kontekst. Begge ID'er kan bruges til at identificere den samme bruger.

Dette databaseobjekt kan returnere følgende kolonner:

Navn på kolonne	Type	Beskrivelse
`OWNERID`	Nummer	Brugerens ejer-ID.
`USERID`	Nummer	Brugerens bruger-ID. Brugere med NULL i denne kolonne er blevet slettet.
`EMAIL`	Varchar	Brugerens e-mailadresse.
`FIRSTNAME`	Varchar	Brugerens fornavn.
`LASTNAME`	Varchar	Brugerens efternavn.
`ARCHIVED`	Boolsk	Om brugeren er blevet slettet.
`CREATEDAT`	Tidsstempel	Den dato og det klokkeslæt, hvor brugeren blev oprettet i HubSpot. Se kolonnedatatyper for mere information.
`UPDATEDAT`	Tidsstempel	Den dato og det klokkeslæt, hvor brugeren sidst blev opdateret i HubSpot. Se kolonnedatatyper for mere information.
`INGESTEDAT`	Tidsstempel	Den dato og det klokkeslæt, hvor dataene sidst blev indlæst af Snowflake.

Eksempel 1

Hent alle brugere. Filteret WHERE archived = false fjerner slettede brugere fra de returnerede data.

Forespørgsel:

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

Returnerer:

EJERID	BRUGERID	EMAIL	FIRSTNAME	EFTERNAVN
29584574	4621126	233620335	Hobbes	Baron
30532717	4874784	3866015468	Pablo	Walters
30580321	925511	7132752747	Milo	Guld
...	...	...	...	...

Eksempel 2

Hent en bestemt ejer ved hjælp af dennes ejer-ID.

Forespørgsel:

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

Returnerer:

EJERID	BRUGERID	EMAIL	FIRSTNAME	EFTERNAVN
29584574	4621126	233620335	Hobbes	Baron

Eksempel 3

Hent alle kontakter og deres ejere. Denne forespørgsel forbinder poster med ejere med object_with_object_properties og kontaktegenskaben 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

Returnerer:

CONTACTID	KONTAKT_FORNAVN	KONTAKT_EFTERNAVN	KONTAKT_HUBSPOT_EJER_ID	OWNER_FIRSTNAME	OWNER_LASTNAME	EJER_EMAIL
113834202	Richard	Greenfield	29584574	Hobbes	Baron	hobbes.b@business.com
53540801	Ford	Karl	30241125	Milo	Guld	milo.g@business.com
...	...	...	...	...	...	...

Team-forespørgsler

Teams

Teams i HubSpot giver dig mulighed for at organisere dine brugere i grupper til organisatoriske og rapporteringsmæssige formål. Du kan have et hovedteam og ekstra teams.

Dette databaseobjekt indeholder oplysninger om holdene i din HubSpot-konto.

Dette databaseobjekt kan returnere følgende kolonner:

Navn på kolonne	Type	Beskrivelse
TEAMID	Nummer	Holdets ID.
TEAMNAME	Varchar	Holdets navn.
PARENTTEAMID	Antal	Forældreholdets hold-ID.
BARNTEAMID	Array	Team-ID'erne for de underordnede teams.
PRIMÆRE EJERMEDLEMMER	Varchar	Ejer-ID'erne for teamets primære medlemmer.
SEKUNDÆRE EJERMEDLEMMER	Boolsk	Ejer-ID'erne for teamets sekundære medlemmer.
INGESTEDAT	Tidsstempel	Den dato og det klokkeslæt, hvor dataene sidst blev indlæst af Snowflake.

Eksempel 1

Hent alle teams.

Forespørgsel:

SELECT teamId,teamName, primaryOwnerMembers

FRA teams

Returnerer:

TEAMID	TEAMNAME	PRIMÆRE EJERMEDLEMMER
29584574	Underholdningshold	[233620335, 1234553]
30532717	Superhold	[3866015468, 126221873]
3058032	A Team	[7132752747]

ejer_team

Dette databaseobjekt indeholder oplysninger om, hvilke ejere der svarer til hvilke teams i din HubSpot-konto.

Dette databaseobjekt kan returnere følgende kolonner:

Kolonnens navn	Type	Beskrivelse
TEAMID	Nummer	Teamets ID.
EJERID	Nummer	Brugerens ejer-id.
ISTEAMPRIMARY	Boolsk	Om dette team er det primære team for denne ejer.
INGESTEDAT	Tidsstempel	Den dato og det klokkeslæt, hvor dataene sidst blev indlæst af Snowflake.

Eksempel 1

Hent alle ejere for et givet team.

Forespørgsel:

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

Returnerer

TEAMID	TEAMNAME	ISTEAMPRIMARY
29584574	233620335	TRUE
29584574	1234553	SAND

Forespørgsler om pipeline

Nedenfor kan du se, hvordan du forespørger på pipelinedata for aftaler og billetter, f.eks. de tilgængelige pipelines på din konto og deres stadier.

Du kan kombinere disse data med objektdata for at få et fuldt overblik over dine pipelines. Du kan f.eks. forespørge på aftaler og deres pipelines ved at kombinere objects_deals_view eller object_with_object_properties-data med pipelinedata.

Pipelines

Dette databaseobjekt indeholder oplysninger om deal- og ticket-pipelines i din konto. Hver returneret række repræsenterer en enkelt pipeline.

Denne tabel kan returnere følgende kolonner:

Navn på kolonne	Type	Beskrivelse
`PIPELINEID`	Varchar	Rørledningens ID.
`OBJECTTYPEID`	Varchar	ID'et for det objekt, som pipelinen kan indeholde (f.eks. tilbud eller billetter).
`LABEL`	Varchar	Pipelinens navn i HubSpot.
`DISPLAYORDER`	Antal	Den rækkefølge, som pipelinen vises i i HubSpot.
`ARCHIVED`	Boolsk	Om pipelinen er blevet slettet.
`CREATEDAT`	Tidsstempel	Hvornår pipelinen blev oprettet.
`UPDATEDAT`	Tidsstempel	Den dato og det klokkeslæt, hvor dataene sidst blev opdateret i HubSpot. Få mere at vide om kolonnedatatyper.
`INGESTEDAT`	Tidsstempel	Den dato og det klokkeslæt, hvor dataene sidst blev indlæst af Snowflake.

Eksempel 1

Hent alle tilgængelige deal-pipelines, sorteret efter deres rækkefølge i HubSpot.

Forespørgsel:

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

Returnerer:

OBJECTTYPEID	PIPELINEID	LABEL
0-3	1bed503c-37f7-4f51-9d40-7598902673f4	Salgs-pipeline
0-3	12659678	Licenses Pipeline
0-3	75e28846-ad0d-4be2-a027-5e1da6590b98	Ny virksomhed
...	...	...

Eksempel 2

Hent tilbud inden for en bestemt pipeline. Sammenføjer object_with_object_properties og pipelines.

Forespørgsel:

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

Returnerer:

DEAL_ID	DEAL_NAME	PIPELINE_NAME
605140072	Meowmix global tilmelding	Salgspipeline
605457408	Friskies Rebrand	Salgspipeline
604362473	Fresh Step App Build	Salgspipeline

Eksempel 3

Samme som eksempel 2 ovenfor, hent tilbud inden for en bestemt pipeline. Men i stedet for at bruge objects_deals i joins, skal du bruge 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';

Returnerer:

DEAL_ID	DEAL_NAME	PIPELINE_NAME
605140072	Meowmix global tilmelding	Salgspipeline
605457408	Friskies Rebrand	Salgspipeline
604362473	Fresh Step App Build	Salgspipeline

pipeline_stages

Denne visning indeholder oplysninger om individuelle stadier i en pipeline. Identificer etaper ved at kombinere objekttype-ID, pipeline-ID og etape-ID. Ved sammenføjning med pipelines skal du bruge objekttype-ID og pipeline-ID.

Dette databaseobjekt kan returnere følgende kolonner:

Navn på kolonne	Type	Beskrivelse
`PIPELINEID`	Varchar	Pipelinens ID.
`STAGEID`	Varchar	Etapens ID.
`LABEL`	Varchar	Etapens navn i HubSpot.
`DISPLAYORDER`	Antal	Den rækkefølge, som pipelinen vises i i HubSpot.
`METADATA`	Variant	En JSON-formateret beskrivelse af fasen, herunder om den er åben eller lukket
`ARCHIVED`	Boolsk	Om pipelinetrinnet er blevet slettet.
`CREATEDAT`	Tidsstempel	Hvornår rørledningsetapen blev oprettet.

Eksempel 1

Hent pipelinetrin for en aftalepipeline med navnet Salgspipeline.

Forespørgsel:

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;

Returnerer:

PIPELINEID	STAGEID	LABEL
941650	941651	Kontaktet
941650	941652	Aftale planlagt
941650	941653	Faktura sendt
...	...	...

Eksempel 2

Hent alle aftaler og deres respektive pipelinetrin.

Forespørgsel:

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

Returnerer:

DEAL_ID	DEAL_NAME	PIPELINE_NAME	PIPELINE_STAGE_NAME
605140072	Meowmix global tilmelding	Salgs-pipeline	Kontrakt sendt
605457408	Friskies Rebrand	Salgspipeline	Aftale planlagt
604362473	Fresh Step App Build	Salgspipeline	Kontrakt underskrevet
...	...	...	...

Ejendomsforespørgsler

egenskaber_definitioner

Dette databaseobjekt indeholder oplysninger om objektegenskaber og hændelsesegenskaber i din HubSpot-konto. Begivenhedsegenskaber omfatter standardbegivenheder, som f.eks. e-mailåbninger og -klik, og brugerdefinerede adfærdsrelaterede begivenhedsegenskaber. Disse oplysninger kan være nyttige til at definere værdier, der findes i object_properties og hændelsesdata.

Du kan identificere specifikke egenskaber ved at kombinere deres objekttype-ID og navn. Du kan hente lignende oplysninger ved hjælp af properties-API'en.

Dette databaseobjekt kan returnere følgende kolonner:

Kolonne navn	Type	Beskrivelse
`OBJECTYPEID`	Varchar	ID for det objekt, som hændelsen vedrører.
`NAME`	Varchar	Egenskabens interne navn.
`LABEL`	Varchar	Egenskabens etiket.
`DESCRIPTION`	Varchar	Egenskabens beskrivelse.
`TYPE`	Varchar	Egenskabens type (f.eks. streng, tal, datetime).
`FIELDTYPE`	Varchar	Egenskabens felttype. Definerer, hvordan egenskaben vises i HubSpot og på formularer (f.eks. afkrydsningsfelt, vælg).
`DISPLAYORDER`	Antal	Egenskabens visningsrækkefølge.
`GROUPNAME`	Varchar	Egenskabens gruppenavn.
`OPTIONS`	Variant	For opremsningsegenskaber, et array af egenskabens muligheder, herunder hver enkelt muligheds attributter (f.eks. visningsrækkefølge, etiket).
`CREATEDUSERID`	Nummer	ID for den bruger, der har oprettet egenskaben.
`REFERENCEDOBJECTTYPE`	Varchar	Den type objekt, som egenskaben refererer til. Ejeregenskaber vil returnere værdien OWNER.
`CALCULATED`	Boolsk	Om egenskaben er en beregnet egenskab.
`EXTERNALOPTIONS`	Boolsk	Om egenskabens indstillinger er defineret i et eksternt system.
`HASUNIQUEVALUE`	Boolsk	Om egenskabens værdier er unikke. Kan kun indstilles, når man opretter en egenskab via API'en.
`HIDDEN`	Boolsk	Om egenskaben er skjult i HubSpot.
`SHOWCURRENCYSYMBOL`	Boolsk	Om en talegenskabs værdi er formateret som en valuta.
`FORMFIELD`	Boolsk	Om denne egenskab kan bruges i formularer.
`READONLYDEFINITION`	Boolsk	Om egenskaben kan redigeres i HubSpot.
`READONLYVALUE`	Boolsk	Om egenskabens værdi kan redigeres i HubSpot.
`HUBSPOTDEFINED`	Boolsk	Om egenskaben er oprettet af HubSpot, eller om den er oprettet af en bruger.
`ARCHIVED`	Boolsk	Om egenskaben er blevet slettet.
`CREATEDAT`	Tidsstempel	Den dato og det klokkeslæt, hvor ejendommen blev oprettet i HubSpot.
`UPDATEDAT`	Tidsstempel	Den dato og det klokkeslæt, hvor dataene sidst blev opdateret i HubSpot. Få mere at vide om kolonnedatatyper.
`INGESTEDAT`	Tidsstempel	Den dato og det klokkeslæt, hvor dataene sidst blev indlæst af Snowflake.

Eksempel 1

Hent navne og beskrivelser for alle kontaktegenskaber.

Forespørgsel:

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

Returnerer:

NAVN	ETIKET	BESKRIVELSE
indtastet_sql_stadie	Indtastet SQL-stadie	Starttælling af SQL-stadiedage.
første_konvertering_begivenhed_navn	Første konvertering	Den første formular, som denne kontakt indsendte.
Adresse	Adresse på gaden	Kontaktens adresse.

Begivenhedsforespørgsler

Begivenheder omfatter standard HubSpot-begivenheder og brugerdefinerede adfærdsbegivenheder. Hver begivenhed har sit eget databaseobjekt, mærket som events_eventname.

navn
BEGIVENHEDER_ANNONCE_INTERAKTION	Detaljer om en annonce og kontakter, der interagerede med den ved at klikke på annoncen eller indsende en formular efter at have interageret med den.
EVENTS_AD_METRICS_IMPORTED_V0	Detaljer om en annonce og dens præstationsmålinger.
EVENTS_CALL_MENTIONED_KEYWORD	Detaljer om nøgleord nævnt af deltagere i opkald.
EVENTS_CLICKED_LINK_IN_EMAIL_V2	Links, som kontakter har klikket på i marketing-e-mails.
EVENTS_CLICKED_LINK_IN_TRACKED_INBOX_EMAIL_V8	Links klikket på i Conversations Inbox e-mails af kontakter.
EVENTS_COOKIE_BANNER_CLICKED	Kontakter, der har klikket på cookies.
EVENTS_COOKIE_BANNER_VIEWED	Kontakter, der har set cookies.
EVENTS_DOCUMENT_SHARED_V2	Salgsdokumenter delt med kontakter via et eksternt link.
EVENTS_DOCUMENT_VIEWED_V2	Salgsdokumenter og kontakter, der har set dem ved at åbne det eksterne link.
EVENTS_DOCUMENT_COMPLETED_V2	Salgsdokumenter og kontakter, der har lukket dem.
EVENTS_HS_SCHEDULED_EMAIL_V2	E-mails, der er sendt til HubSpots e-mailservere for at blive sendt.
EVENTS_MTA_DELIVERED_EMAIL_V2	E-mails, der er leveret til modtagerne af HubSpots e-mailservere.
EVENTS_MTA_BOUNCED_EMAIL_V2	Forsøg på levering af e-mails, der blev afvist af modtagerens e-mailserver.
EVENTS_OPENED_EMAIL_V2	E-mails åbnet af kontakter.
EVENTS_REPORTED_SPAM_EMAIL_V2	E-mails markeret som spam af modtagere.
EVENTS_UPDATED_EMAIL_SUBSCRIPTION_STATUS_V2	Ændringer i modtagernes e-mail-abonnementer.
EVENTS_OPENED_TRACKED_INBOX_EMAIL_V8	Åbninger af e-mails i Conservations Inbox af kontakter.
EVENTS_MB_MEDIA_PLAYED	Kontaktpersoners videoafspilningsaktivitet.
EVENTS_V2_CONTACT_BOOKED_MEETING_THROUGH_SEQUENCE	Kontakt bookede et møde gennem en sekvens.
EVENTS_V2_CONTACT_ENROLLED_IN_SEQUENCE	Kontakten er tilmeldt fra sekvensen.
EVENTS_V2_CONTACT_FINISHED_SEQUENCE	Sekvensen er afsluttet.
EVENTS_V2_CONTACT_REPLIED_SEQUENCE_EMAIL	Kontakten svarede på en e-mail (eller en indgående e-mail, som afmeldte sekvensen) sendt gennem sekvensen.
EVENTS_V2_CONTACT_UNENROLLED_FROM_SEQUENCE	Kontakt afmeldt fra sekvens.
EVENTS_V2_CONTACT_UNENROLLED_MANUALLY_FROM_SEQUENCE	Brugeren har manuelt afmeldt kontakten.
EVENTS_V2_CONTACT_UNSUBSCRIBED_SEQUENCE_EMAIL	Kontakten afmeldte sig og fjernede tilmeldingen til sekvensen.
EVENTS_V2_SEQUENCE_EMAIL_BOUNCED	Sequence email bounced.
EVENTS_V2_SEQUENCE_ERRORED	Fejl i sekvensen forårsager afmelding.
EVENTS_V2_SEQUENCE_STEP_EXECUTED	Sekvenstrin udført.
BEGIVENHEDER_BESØGT_SIDE	Besøg på webside af kontakter.
EVENTS_<INTEGRATION_EVENT_NAME>_<UNIQUE_IDENTIFIER>	Integrationshændelser(Timeline V3 API)

Du kan identificere hændelser ved at kombinere deres hændelsestype-ID og ID. De kolonner, der returneres, afhænger af begivenheden, med en kolonne for hver begivenhedsegenskab. Alle begivenheder returnerer følgende kolonner:

Bemærk: HubSpot har tilføjet to nye kolonner til alle event-tabeller og -visninger:

occurredat
occurredatdateint

Disse kolonner erstatter kolonnerne occuredat og occuredatdateint den 24. november 2022. På den dato vil de gamle kolonner ikke længere være tilgængelige, og forsøg på at forespørge et databaseobjekt eller en visning, der indeholder begivenheder ved hjælp af disse kolonner, vil mislykkes. Få mere at vide om ændringer for Snowflake-datadele.

Kolonne navn	Type	Beskrivelse
`EVENTTYPEID`	Varchar	ID for hændelsestypen, svarende til OBJECTTYPEID Du kan forespørge på alle hændelsestype-ID'er i din konto ved hjælp af visningen object_and_event_type_definitions.
`ID`	Varchar	Dette er unikt for hver begivenhedstype. Ikke to poster vil have samme ID inden for en given eventtype.
`OBJECTTYPEID`	Varchar	Den type objekt, der gennemførte hændelsen. For eksempel vil et klik på et e-mail-link vise `0-1` i denne kolonne, som repræsenterer kontaktobjektet.
`OBJECTID`	Antal	ID'et for den post, der gennemførte begivenheden.
`OCCURREDAT`	Tidsstempel	Hvornår begivenheden fandt sted.
`OCCURREDATDATEINT`	Nummer	Et tal, der repræsenterer, hvornår begivenheden fandt sted. Indeholder de samme data som kolonnen `OCCURREDAT`, men er formateret som et tal og bruges som en del af tabellens klyngenøgle. I de fleste tilfælde kan du bruge `OCCURREDAT` -tidsstemplet i stedet for dette tal.
`OCCUREDATDATEINT`	Nummer	Et tal, der viser, hvornår begivenheden fandt sted. Indeholder de samme data som kolonnen `OCCURREDAT`, men er formateret som et tal og bruges som en del af klyngenøglen i tabellen. I de fleste tilfælde kan du bruge `OCCURREDAT` -tidsstemplet i stedet for dette tal. Bemærk: Denne kolonne udgår den 24. november 2022 og erstattes med `OCCURREDATDATEINT`.
`OCCUREDAT`	Tidsstempel	Hvornår hændelsen fandt sted. Bemærk: Denne kolonne udgår den 24. november 2022 og erstattes af `OCCURREDAT`.
`INGESTEDAT`	Tidsstempel	Den dato og det klokkeslæt, hvor dataene sidst blev indlæst af Snowflake. Få mere at vide om kolonnedatatyper.
`PROPERTY_*`	Varchar	Individuelle kolonner, der indeholder hændelsesegenskaberne.

Eksempel 1

Hent de 50 seneste e-mailklik-begivenheder.

Forespørgsel:

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

Returnerer:

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
...	...	...	...	...

Eksempel 2

Hent alle e-mailklikhændelser efter de kontakter, der klikkede. Denne forespørgsel henter kontaktdata ved at joine med object_with_object_properties.

Forespørgsel:

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;

Returnerer:

CLICK_TIMESTAMP	CLICK_URL	KONTAKT_FORNAVN	KONTAKT_EFTERNAVN
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

object_and_event_type_definitions

Dette databaseobjekt indeholder definitioner for alle objekter og begivenheder, der er tilgængelige på din HubSpot-konto.

Dette databaseobjekt kan returnere følgende kolonner:

Navn på kolonne	Type	Beskrivelse
`OBJECTTYPEID`	Varchar	ID for det objekt, som pipelinen kan indeholde (f.eks. aftaler eller billetter).
`FULLYQUALIFIEDNAME`	Varchar	Navnet på objektet eller begivenheden.
`INGESTEDAT`	Tidsstempel	Den dato og det klokkeslæt, hvor dataene sidst blev indlæst af Snowflake. Få mere at vide om kolonnedatatyper.

Eksempel 1

Hent alle objekter og hændelser, der er tilgængelige på din HubSpot-konto.

Forespørgsel:

SELECT objectTypeId, fullyQualifiedName
FROM object_and_event_type_definitions;

Returnerer:

OBJECTTYPEID	FULDT KVALIFICERET NAVN
0-1	KONTAKT
0-8	LINE_ITEM
0-11	SAMTALE
...	...

Forespørgsler om segmenter

Nedenfor kan du se, hvordan du forespørger på dine segmenter, f.eks. de tilgængelige kontakt- og virksomhedssegmenter og de poster, der indgår i disse segmenter.

Segmenter

Dette databaseobjekt indeholder oplysninger om HubSpot-kontakt- og virksomhedssegmenter. Returnerer én række pr. segment, og kolonnerne indeholder segmentoplysninger som f.eks. segmentnavn, størrelse og objekttypen for de poster, det indeholder. Indeholder ikke oplysninger om de enkelte poster i hvert segment (se segment_membership).

Dette databaseobjekt kan returnere følgende kolonner:

Navn på kolonne	Type	Beskrivelse
`OBJECTTYPEID`	Varchar	Typen af poster i segmentet (f.eks. kontakt eller virksomhed).
`SEGMENTID`	Antal	Segmentets ID. Forbinder med kolonnen SEGMENTID i tabellen segment-memberships.
`CLASSICSEGMENTID`	Nummer	Et ID, der er specifikt for kontaktsegmenter, og som matcher ID'et i segmentets URL i HubSpot.
`NAME`	Varchar	Navnet på segmentet.
`SIZE`	Antal	Antallet af poster i segmentet.
`CREATEDBYUSERID`	Antal	ID for den bruger, der har oprettet segmentet.
`CREATEDAT`	Tidsstempel	Hvornår segmentet blev oprettet i HubSpot.
`UPDATEDBYUSERID`	Nummer	ID for den bruger, der senest har opdateret segmentet.
`UPDATEDAT`	Tidsstempel	Den dato og det klokkeslæt, hvor datoen sidst blev opdateret i HubSpot. Få mere at vide om kolonnedatatyper.
`INGESTEDAT`	Tidsstempel	Den dato og det klokkeslæt, hvor dataene sidst blev indlæst af Snowflake.

Eksempel 1

Hent alle kontaktsegmenter.

Forespørgsel:

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

Returnerer:

SEGMENTSID	NAVN	STØRRELSE
118131	Ugentlig opsøgende indsats	103
66156	Blog-abonnenter	455
771852	De bedste abonnenter 2021	37
...	...	...

Eksempel 2

Hent et specifikt kontaktsegment med navnet Topabonnenter 2021.

Forespørgsel:

SELECT segmentId, name, size
FROM segments
WHERE objectTypeId = '0-1' ANDsegmentName = 'Top subscribers 2021';

Returnerer:

SEGMENTID	NAVN	STØRRELSE
771852	Bedste abonnenter 2021	37

segment_membership

Dette databaseobjekt indeholder oplysninger om, hvilke poster der er medlemmer af hvilke segmenter, med en række pr. post i segmentet. Hvis du f.eks. har et segment Blog subscribers med 500 kontakter, vil databaseobjektet returnere 500 rækker.

Indeholder kun segment-id'er og objekt-id'er. Du kan få flere oplysninger ved at koble dig på segment-databaseobjektet.

Dette databaseobjekt kan returnere følgende kolonner:

Kolonne navn	Type	Beskrivelse
`SEGMENTID`	Varchar	Segmentets ID. Forbinder med kolonnen HS_SEGMENT_ID i segmenttabellen.
`OBJECTID`	Varchar	ID'et for posten i segmentet.
`UPDATEDAT`	Tidsstempel	Den dato og det klokkeslæt, hvor dataene sidst blev opdateret i HubSpot. Få mere at vide om kolonnedatatyper.
`INGESTEDAT`	Tidsstempel	Den dato og det klokkeslæt, hvor dataene sidst blev indlæst af Snowflake.

Eksempel 1

Hent ID'erne for alle kontakter i segmentet Top subscribers 2021.

Forespørgsel:

SELECT objectId
FROM segment_memberships
INNER JOIN segments
ON segment_memberships.segmentId = segments.segmentId
WHERE segments.objectTypeId = '0-1'
AND segments.name = 'Top Subscribers 2021';

Returnerer:

OBJECTID

54325098

96805401

6922028

...

Eksempel 2

Hent for- og efternavn på detaljer om kontakter i segmentet Topabonnenter 2021.

Forespørgsel:

SELECT

contact.objectId AS objectid, contact.property_firstname AS firstname, contact.property_lastname AS lastname FROM objects_contacts contact INNER JOIN segment_memberships ON contact.objectId = segment_memberships.objectId INNER JOIN segments ON segments_memberships.segmentId = segments.segmentId WHERE segments.objectTypeId = '0-1' AND segments.name = 'Top Subscribers 2021'

Returnerer:

OBJECTID	FIRST NAME	EFTERNAVN
54325098	Hobbes	Baron
96805401	Milo	Guld
6922028	Henry	Riley
...	...	...

Ofte stillede spørgsmål

Jeg vil gerne generere data, der ligner en rapport fra Hubspot-appen, hvordan gør jeg det?

Generelt vil du gerne se på de kolonner, der findes i den rapport, du sammenligner med. Hvis rapportens visualisering ikke er i tabelform, kan du konvertere den til en tabel, så du kan se de kolonner, rapporten indeholder. Disse kolonner er normalt egenskaber for en objekttype eller en hændelsestype. Næste skridt er at finde ud af, hvilken objekttypeegenskab en kolonne svarer til. Det kan du gøre ved at spørge property_definitions:

SELECT * FROM property_definitions

WHERE label = [column_name]

Der er måske ikke altid et nøjagtigt match, fordi nogle egenskabsnavne normalt opløses til et mere beskrivende navn i appen. I sådanne tilfælde kan det hjælpe at foretage en uklar søgning ved hjælp af LIKE-operatoren på kolonnen label (eller endda description) i property_definitions.

Når man har fundet ud af, hvilken objekttype kolonnen tilhører, er det nemt at finde ud af, hvad man skal spørge om. Du kan simpelthen søge efter den object_x-visning, der svarer til typen.

Hvordan linker jeg denne datatype til en anden, f.eks. hvordan henter jeg formularer til en kampagne?

Hvis du har brug for at linke to eller flere forskellige poster til hinanden, skal du kigge på associationer. Associationer repræsenterer relationerne mellem objekter i HubSpot CRM. Alle de forskellige associationer, der er mulige mellem to typer, er listet i association_definitions. I eksemplet ovenfor skal du forespørge ASSOCIATIONS_CAMPAIGNS_TO_FORMS for at finde ud af, hvilke formularer en kampagne er knyttet til:

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

Hvordan kender jeg status for HubSpot-Snowflake-integrationen?

For at modtage statusopdateringer i realtid om udfald og problemer for HubSpot-Snowflake-integrationen skal du forespørge på data_share_status-visningen:

SELECT * FROM hubspot.public.data_share_status LIMIT 1

Resultaterne vil blive vist som:

STATUS	MESSAGE	UPDATEDAT
OK	INGEN KENDT HÆNDELSE I ØJEBLIKKET	2023-04-10 09:21:20.123

Denne visning giver opdateringer om integrationsstatus i omvendt kronologisk rækkefølge. Ved at integrere resultaterne af denne forespørgsel i et dashboard kan du spore integrationens ydeevne og opdage eventuel nedetid eller udfald.

Se hele indlægget