Søk etter HubSpot-data i Snowflake

Skrevet av HubSpot Support | Jun 28, 2023 10:38:42 AM

Når du har koblet Snowflake til HubSpot-kontoen din, kan du bruke Snowflakes Data Share til å søke etter HubSpot-data fra Snowflake-kontoen din.

Datalag og Snowflake-kontoregionen din

Du får tilgang til V2_LIVE-skjemaet, som oppdateres hvert 15. minutt, og V2_DAILY-skjemaet, som oppdateres hver dag.

Merk: Følgende visninger i V2_LIVE-skjemaet oppdateres bare daglig: association_definitions, owners, pipelines og pipeline_stages.

Konfigurer Snowflake-miljøet ditt

For å søke etter HubSpot-data i Snowflake må du velge lager, database og skjema som du vil søke fra. Du kan enten angi dem på regnearknivå for å inkludere dem automatisk i spørringene dine, eller du kan legge dem til manuelt.

Slik velger du lager, database og skjema på regnearknivå:

Klikk på Arbeidsarkhandlinger i øverste rad i regnearket.
I popup-vinduet:
- Klikk på rullegardinmenyen Lager, og velg deretter lageret ditt.
- Klikk på rullegardinmenyen Database, og velg deretter HubSpot-databasen din.
- Klikk på nedtrekksmenyen Schema, og velg deretter skjemaet du vil bruke:

Når miljøet er konfigurert, kan du gjøre spørringer til HubSpot-dataene dine uten å måtte legge til database- eller skjematypen din i spørringene manuelt.

Hvis du vil legge til databasen og skjematypen manuelt i spørringer, legger du til databasenavnet etterfulgt av skjemaet i begynnelsen av FROM -feltet. For eksempel

SELECT objectTypeId, property_createddate
FROM hubspot_share_name.V2_LIVE.objects_deals

LIMIT 1

Oversikt over data

Spørringer er konstruert ved hjelp av SQL, og kan brukes til å hente HubSpot-data som f.eks:

Objekter: standardobjekter og egendefinerte objekter, for eksempel kontakter, selskaper og produkter.
Registreringer: individuelle registreringer, for eksempel en individuell kontakt eller et selskap.
Assosiasjoner: alle tilgjengelige assosiasjonstyper og tilknyttede poster.
Hendelser: Hendelsesdata for både standard HubSpot-hendelser, for eksempel e-poståpninger, og egendefinerte atferdshendelser.
Lister: HubSpots kontakt- og selskapslister.
Eiere: brukere i HubSpot-kontoen din, i forhold til postene de er angitt som eier av.
Pipelines: avtale- og billettpipelines, inkludert pipelinefaser.
Egenskaper: egenskaper og deres verdier i CRM-poster, inkludert eiendomshistorikk.

Finn ut mer omHubSpots CRM-datamodell.

Merk: Etter hvert som vi utvikler datadelingen, vil vi introdusere endringer, og noen av dem kan være brudd. Det anbefales på det sterkeste å abonnere på HubSpots endringslogg for utviklere. Disse endringene vil alltid bli lagt ut i endringsloggen i forkant av enhver oppdatering.

Begrensning og sortering av returnerte data

Når du konstruerer spørringer, kan du kontrollere hvor mye data som returneres, og i hvilken rekkefølge de returneres, ved å inkludere LIMIT og ORDER BY i spørringen. Hvis du for eksempel vil søke etter alle kontaktene med tilhørende egenskaper, men bare returnere tre resultater og sortere dem etter kontakt-ID, kan du konstruere spørringen på følgende måte:

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

Datatyper for kolonner

Når du spør etter data i Snowflake, avhenger kolonnene som returneres, av hvilke data du spør etter. Du kan se de tilgjengelige kolonnene for en gitt tabell eller visning i Snowflake ved å velge visningen i venstre sidefelt.

Merk: Iresten av dette dokumentet bruker vi begrepet databaseobjekt når konteksten gjelder både tabeller og visninger.

Hvis du vil returnere en bestemt kolonne, inkluderer du den kolonnen i SELECT -feltet i spørringen. Følgende spørring returnerer for eksempel bare kolonnene OBJECTID og UpdatedAt:

SELECTobjectId, updatedAt
FROM objects_contacts

Nedenfor finner du generelle definisjoner for kolonner som en spørring kan returnere. For andre definisjoner som ikke er inkludert nedenfor, se de enkelte visningsdefinisjonene i artikkelen ovenfor.

OBJECTTYPEID: en VARCHAR-verdi som representerer et objekts type. For eksempel representerer 0-1 kontaktobjektet, 0-2 representerer firmaobjektet, og 2-1232 kan representere et egendefinert objekt i kontoen din. I lister refererer dette til listetypen (f.eks. kontakt eller selskap). Du kan søke etter alle objekt- og hendelses-ID-er i kontoen din ved hjelp av visningen object_and_event_type_definitions.
OBJECTID: et BIGINT-nummer som representerer en enkelt post av en gitt type objekt i HubSpot-kontoen din. For å identifisere en post må du bruke både objekttype-ID-en og objekt-ID-en.
INGESTEDAT: tidsstempelet for når en datarad ble lagt til i Snowflake, representert ved en TIMESTAMP_NTZ-verdi. Ikke relatert til det logiske tidsstempelet for en opprettings- eller oppdateringsoperasjon i HubSpot.
- På grunn av HubSpots interne behandling kan tidsstempelet for inntak av en rad oppdateres selv om ingen andre kolonner på raden har endret seg.
- Når du bygger ETL-prosesser som kopierer nylig endrede data, anbefales det å basere spørringene på inntaksstempelet. Hvis flyten din kopierer data daglig, anbefales det dessuten å kopiere data fra de to foregående dagene for å ta høyde for forsinkelser.
CREATEDAT og UPDATEDAT: det logiske tidsstempelet for når data ble opprettet eller oppdatert i HubSpot, representert ved en TIMESTAMP_NTZ-verdi . Disse tidsstemplene vil samsvare med tidsstemplene i HubSpot. For eksempel vil klokkeslettet som vises i HubSpot for opprettelsesdatoen for en post, være det samme som tidsstempelet i CREATEDAT-kolonnen i Snowflake. Disse er ikke direkte relatert til tidsstempelet for inntak, og det anbefales ikke å basere ETL-prosesser på disse egenskapene.
COMBINEDASSOCIATIONTYPE: en VARCHAR-verdi som unikt identifiserer en assosiasjonsdefinisjon.

Transformere datatyper

Noen ganger returneres data fra en spørring med VARCHAR-kolonner når det ville være ønskelig å ha dem som en annen type. I slike tilfeller anbefales det å konvertere VARCHAR-datatypen til de ønskede typene ved hjelp av Snowflake-funksjoner. For eksempel lagres egenskapene til en objektpost som VARCHAR-datatyper i de fleste databaseobjekter, men noen ganger inneholder de tall- og datetime-verdier. Funksjoner som f.eks:
try_to_number, try_to_timestamp_ntz kan brukes til å konvertere disse VARCHAR-dataene til henholdsvis NUMBER- og DATETIME-typen:

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ørsler

Nedenfor kan du se hvordan du spør etter data fra spesifikke HubSpot-objekter og -poster, samt hvilke data som returneres.

Objektdata av ulike typer er organisert og tilgjengelige på to måter:

Individuell: Hver objekttype lagres i sin egen visning og inneholder bare poster av samme objekttype, f.eks. inneholder objects_contacts bare kontaktposter. Dette eliminerer behovet for å spesifisere en objekttypeid når du spør. Disse visningene er enklere å spørre i, siden du ikke trenger å kjenne til ObjectTypeIds. De returnerer også data i et mer brukervennlig format, der hver rad tilsvarer et objekt og den gjeldende versjonen av objektets egenskaper. Så lenge du ikke opplever trege spørringer, anbefales det å bruke disse visningene for å hente ut objektdata. Se mer i Objects_X-visningene nedenfor.
Kombinert: Alle poster for alle objekttyper kombineres til ett databaseobjekt. Når du spør, må du derfor angi et filter som "WHERE objectTypeId='0-1'". Du kan for eksempel bruke følgende objekttypeid når du spør:

Objektets navn	ObjectTypeId
Kontaktpersoner	0-1
Bedrifter	0-2
Linjeposter	0-8

Egendefinerte objekter tildeles en ID når de opprettes, og identifiseres som 2-unique_ID. For eksempel 2-12345. Finn ut mer om object_and_event_type_definitions.

Disse databaseobjektene egner seg generelt godt hvis du ønsker bedre spørringsytelse enn det du kan oppnå med objects_x-visninger. Se flere detaljer i object_with_object_properties, object_properties, objects og object_properties_history nedenfor.

objekter_x visninger

I dette databaseobjektet har hver tilgjengelige objekttype, inkludert egendefinerte objekter, sin egen spesifikke visning, og hver visning inneholder bare poster for objekter av den spesifikke objekttypen. Disse visningene navngis i formatet OBJECTS_<objekttypenavn>, der <objekttypenavn> er flertallsformen for objekttypen (merk at hvis objekttypen ikke har noen flertallsform, vil <objekttypenavn> ganske enkelt være entallsformen for objekttypenavnet, sammenkjedet med "S").

Spørringer til denne visningen returnerer én rad for hver post i et objekt, med hver egenskap for objektet tilgjengelig som en egen kolonne.

Nedenfor finner du en omfattende liste over tilgjengelige HubSpot-objekttyper (det vil si ikke-tilpassede), en kort beskrivelse av dataene de representerer og de tilhørende visningene:

HubSpot Objekttype	ObjectTypeId	Beskrivelse
KONTAKT	0-1	Informasjon om enkeltpersoner som samhandler med virksomheten din
SELSKAP	0-2	Informasjon om enkeltbedrifter eller organisasjoner
DEAL	0-3	Detaljer om inntektsmuligheter med en kontakt eller et selskap.
ENGASJEMENT	0-4	Lagrer data fra CRM-handlinger, inkludert notater, oppgaver, e-post, møter og samtaler.
BILLETT	0-5	Representere kundeforespørsler om hjelp eller support.
SITAT	0-14	Brukes til å dele prisinformasjon med potensielle kjøpere.
FORM_SUBMISSION	0-15	Detaljer for individuelle innsendinger for et HubSpot-skjema.
LINE_ITEM	0-8	Representerer en delmengde av produkter som selges i en avtale. Når et produkt knyttes til en avtale, blir det en varelinje.
SAMTALE	0-11	Detaljer om innkommende meldinger fra flere kanaler.
LANDING_PAGE	0-25	Detaljer om landingssidene dine
OPPGAVE	0-27	Lagrer informasjon om gjøremålslister
FORM	0-28	Brukes til å samle inn informasjon om besøkende og kontakter
MARKETING_EMAIL	0-29	Detaljer om e-poster fra markedsføringshuben
AD_ACCOUNT	0-30	Lagrer informasjon om annonsekontoene dine på Linkedin, Facebook og Google
AD_CAMPAIGN	0-31	Detaljer om annonsekampanjene dine. En annonsekampanje kan inneholde én eller flere annonser
AD_GROUP	0-32	Logisk gruppering av annonser i en annonsekampanje
AD	0-33	Detaljer om individuelle annonser
KAMPANJE	0-35	Informasjon om relaterte markedsføringsressurser og -innhold, slik at du enkelt kan måle effektiviteten av den samlede markedsføringsinnsatsen.
SITE_PAGE	0-38	Data om individuelle sider på nettsidene dine
BLOGG_POST	0-39	Data om blogginnlegg
OBJECT LIST	0-45	Informasjon om grupperinger av objektposter basert på egenskaper eller aktiviteter
RING	0-48	Anrop foretatt av andre CRM-poster, f.eks. kontakter
FAKTURA	0-53	Administrer og synkroniser fakturaer med eksterne regnskapssystemer
MEDIA_BRIDGE	0-57	Informasjon om medieressurser som importeres til Hubspot
SEQUENCE	0-58	En sekvens er en serie målrettede, tidsbestemte e-postmaler for å pleie kontakter over tid
DEAL_SPLIT	0-72	Deling av avtaler brukes til å dele avtalekreditten mellom flere brukere
SALES_DOKUMENT	0-83	Salgsdokumenter bygger et bibliotek med innhold som hele teamet kan laste opp og dele dokumenter med kontaktene dine.
TILBAKEMELDING_INNSENDING	0-19	Lagrer informasjon som er sendt inn i en tilbakemeldingsundersøkelse.
ABONNEMENT	0-69	Abonnementer inneholder informasjon om tilbakevendende betalinger
HANDELSBETALING	0-101	Inneholder data om innsamlede midler fra kunder

Hvert databaseobjekt returnerer følgende kolonner:

Navn på kolonnen	Type	Beskrivelse
OBJECTTYPEID	Varchar	ID-en til objekttypen (f.eks. kontakter er 0-1).
OBJECTID	Antall	ID-en til posten (f.eks. en kontaktpost med ID 123752).
OPPDATERTAT	Tidsstempel	Datoen og klokkeslettet da dette objektet sist ble oppdatert i HubSpot.
INGESTEDAT	Tidsstempel	Datoen og klokkeslettet da dataene sist ble tatt inn av Snowflake.
PROPERTY_*	Varchar	Individuelle kolonner som inneholder den nyeste versjonen av objektets egenskaper For hver objektegenskap som har en dato- eller talltype (som spesifisert av property_definitions), vil det være to kolonner: En kolonne som inneholder egenskapsverdien som en streng. Kolonnenavnet vil være property_unparsed_[name] . For eksempel vil DEAL-objektegenskapen deal_amount ha kolonnen property_unparsed_deal_amount En kolonne som inneholder verdien konvertert til den opprinnelige typen. Kolonnen vil ha navnet property_[name], for eksempel vil DEAL-objektegenskapen deal_amount ha kolonnen property_deal_amount. Merk at denne kolonnen vil inneholde null hvis konverteringen til opprinnelig type mislykkes på grunn av ugyldige data.

Eksempel 1

Hent fornavn, etternavn og livssyklusstadium for alle kontakter.

Forespørsel:

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

Returnerer:

OBJECTID	FORNAVN	ETTERNAVN	LIVSLØPSFASEN
54325098	Hobbes	Baron	bly
96805401	Milo	Gull	bly
6922028	Henry	Riley	bly

Eksempel 2

Hent avtalens navn og stadium for opptil tre avtaler.

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å avtale 1	closedwon	34199
321740651	Testavtale 123	14845019	8383663
98392101	Pop-up baldakin	closedwon	9309007

Eksempel 3

Hent avtalens navn og stadium for de tre beste avtalene etter beløp.

Forespørsel:

Siden data om avtalebeløp er tilgjengelig som en talldatatype, kan de brukes til bestilling uten 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	Testavtale 123	14845019	8383663
38960439	Navn på avtale 1	closedwon	34199

objekt_med_objektegenskaper

Dette databaseobjektet inneholder data fra HubSpot-postene dine. Spørringer til dette databaseobjektet returnerer én rad for hver post innenfor en objekttype (f.eks. alle kontaktposter i kontaktobjekttypen). Alle egenskaper lagres i kolonnen Properties, som er en Snowflake Variant/JSON-kolonne.

Denne visningen kan returnere følgende kolonner:

Navn på kolonnen	Type	Beskrivelse
`OBJECTTYPEID`	Varchar	ID-en til objekttypen (f.eks. kontakter er `0-1`).
`OBJECTID`	Antall	ID-en til posten (f.eks. en kontaktpost med ID `123752`).
`PROPERTIES`	Variant	Postens eiendomsverdier.
`UPDATEDAT`	Tidsstempel	Datoen og klokkeslettet da posten sist ble oppdatert i HubSpot. Lær mer om kolonnedatatatyper.
`INGESTEDAT`	Tidsstempel	Datoen og klokkeslettet da dataene sist ble tatt inn av Snowflake.

Merk: Den25. januar 2022 vil kolonnen tidsstempel i tabellen og visningen object_with_object_properties, som representerer datoen og klokkeslettet da objektoppføringen sist ble oppdatert i HubSpot , være updatedat . Dette er for åtilpasse seg hvordan datatidsdata representeres iresten av datadelen.

Siden dette er en ny endring, har den nye kolonnen updatedat blitt lagt til i tabellen og visningen. I de neste 90 dagene vil disse to nye kolonnene eksistere side om side med timestamp, kolonnene de er ment å erstatte. Dette gir deg muligheten til å gå over til å bruke de nye kolonnene.

Etter 90 dager, den 25. januar 2022, vil kolonnen timestamp bli fjernet fra tabellen og visningen. Etter denne datoen vil ethvert forsøk på å søke i tabellen eller visningen object_with_object_properties ved hjelp av tidsstempelkolonner mislykkes.

Eksempel 1

Hent alle kontakter og deres egenskaper.

Forespørsel:

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

Returnerer:

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

Eksempel 2

Hent avtalens navn og stadium for opptil tre avtaler.

Forespørsel:

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å avtale 1	closedlost	7488939
321740651	Navn på avtale 1	closedwon	9292029
98392101	Navn på avtale 1	closedlost	62626528

gjenstander

Dette databaseobjektet er en delmengde av dataene i databaseobjektet object_with_object_properties. Hver rad som returneres, returnerer objekt-ID-en for hver post. Dette databaseobjektet returnerer kun eksisterende poster. Når en post slettes i HubSpot, blir den fjernet fra dette databaseobjektet. Dette databaseobjektet er en delmengde av dataene i tabellen object_with_object_properties. Hver rad som returneres, returnerer objekt-ID-en for hver post. Denne visningen returnerer bare eksisterende poster. Når en post slettes i HubSpot, blir den fjernet fra denne visningen.

Dette databaseobjektet kan være nyttig hvis kontoen din har en stor mengde data, noe som fører til at object_with_object_properties og objects_x-visningene fungerer sakte. Ved å bruke dette databaseobjektet sammen med databaseobjektet object_properties er det mulig å replikere dataene i object_with_object_properties, samtidig som man beholder kontrollen over hvilke egenskaper som returneres.

Dette databaseobjektet kan returnere følgende kolonner:

Navn på kolonnen	Type	Beskrivelse
`OBJECTTYPEID`	Varchar	ID-en til objekttypen (f.eks. kontakter er `0-1`).
`OBJECTID`	Antall	ID-en til posten (f.eks. en kontaktpost med ID `123752`).
`INGESTEDAT`	Tidsstempel	Datoen og klokkeslettet da dataene sist ble tatt inn av Snowflake. Finn ut mer om kolonnedatatatyper.

Eksempel 1

Hent alle kontaktoppføringer.

Forespørsel:

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

Returnerer:

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

object_properties

Dette databaseobjektet er en delmengde av databaseobjektet object_with_object_properties. Hver rad inneholder den gjeldende egenskapsverdien som er angitt på en gitt post. En kontakt vil for eksempel ha én rad for egenskapen First name og én rad for egenskapen Last name. Hvis en post ikke har en verdi for en egenskap, vil raden enten vises med en tom streng eller ikke vises i det hele tatt.

Dette databaseobjektet kan returnere følgende kolonner:

Navn på kolonnen	Type	Beskrivelse
`OBJECTTYPEID`	Varchar	ID-en til objekttypen (f.eks. kontakter er `0-1`).
`OBJECTID`	Antall	ID-en til posten (f.eks. en kontaktpost med ID `123752`).
`NAME`	Varchar	Navnet på eiendommen.
`VALUE`	Tidsstempel	Verdien av eiendommen.
`UPDATEDAT`	Tidsstempel	Datoen og klokkeslettet da posten sist ble oppdatert i HubSpot. Lær mer om kolonnedatatatyper.
`INGESTEDAT`	Tidsstempel	Datoen og klokkeslettet da dataene sist ble tatt inn av Snowflake.

Eksempel 1

Henter fornavn, etternavn og byegenskaper for alle kontakter.

Forespørsel:

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	VERDI
0-1	10401	fornavn	Brian
0-1	10401	by	Dublin
0-1	10401	etternavn	Gallagher
0-1	23451	fornavn	Fernando
0-1	23451	etternavn	Fierro
0-1	25751	fornavn	Charles
...	...	...	...

Eksempel 2

Hent fornavn, etternavn og livssyklusstadium for alle kontakter, og kombiner dem i én rad per kontakt. Dette eksemplet bruker SQL PIVOT-syntaksen.

Forespørsel:

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	FORNAVN	ETTERNAVN	LIVSLØPSFASEN
0-1	54325098	Hobbes	Baron	bly
0-1	96805401	Milo	Gull	bly
0-1	6922028	Henry	Riley	bly
...	...	...	...	...

object_properties_history

Dette databaseobjektet inneholder historiske eiendomsverdier. For kontakter inneholder det de siste 45 verdiene. For alle andre objekter inneholder det de 20 siste verdiene. Viser en rad for hver historiske egenskapsverdi. Den gjeldende verdien for en egenskap bestemmes av det siste UPDATEDAT-tidsstempelet i egenskapens historikk.

Dette databaseobjektet kan returnere følgende kolonner:

Navn på kolonnen	Type	Beskrivelse
`OBJECTTYPEID`	Varchar	ID-en til objekttypen (f.eks. kontakter er `0-1`).
`OBJECTID`	Antall	ID-en til posten (f.eks. en kontaktpost med ID `123752`).
`NAME`	Varchar	Navnet på eiendommen.
`VALUE`	Tidsstempel	Verdien av eiendommen.
`UPDATEDAT`	Tidsstempel	Datoen og klokkeslettet da dataene sist ble oppdatert i HubSpot. Lær mer om kolonnedatatatyper.
`INGESTEDAT`	Tidsstempel	Datoen og klokkeslettet da dataene sist ble tatt inn av Snowflake.

Eksempel 1

Hent historikken til en enkelt eiendom for en enkelt kontakt.

Forespørsel:

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	VERDI	OPPDATERTAT
136493192	hs_prediktivecoringnivå	nivå_1	2022-06-22 22:45:05.931
136493192	hs_prediktivecoringnivå	nivå_2	2021-09-18 08:20:56.622
136493192	hs_prediktivecoringnivå	nivå_3	2019-11-31 18:20:22.851
...	...	...	...

Eksempel 2

Henter det nåværende navnet på alle kontakter som noen gang har hatt livssyklusstadiet Subscriber.

Forespørsel:

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	FORNAVN	ETTERNAVN
54325098	Hobbes	Baron
96805401	Milo	Gull
6922028	Henry	Riley
...	...	...

Forespørsler om assosiasjoner

I likhet med objektdata er assosiasjonsdata organisert på to måter:

Individuell: Hver assosiasjonstype lagres i sin egen visning og inneholder bare poster av den typen. For eksempel inneholder associations_contacts_to_deals bare assosiasjonsposter mellom kontakt- og avtaleobjekter. Dette eliminerer behovet for å spesifisere en assosiasjonstypeid når du spør. Disse visningene er ganske enkle å søke i, siden de ikke krever kjennskap til CRM-datamodellen for å kunne brukes. De returnerer også en beriket beskrivelse av assosiasjonsposten mellom to objekter, som enkelt kan brukes i sammenkoblinger med objects_x-visninger. Så lenge du ikke opplever trege spørringer, anbefales det å bruke disse visningene til å hente ut assosiasjonsdata. Se mer i associations_x_to_y-visningene nedenfor.
Kombinert: Alle poster for alle assosiasjonstyper kombineres til ett databaseobjekt. Når du spør, må du derfor spesifisere et filter som "WHERE combinedassociationtypeid='0-32'". Se mer under assosiasjoner og assosiasjonsdefinisjoner nedenfor.

assosiasjoner_x_to_y visninger

Hver assosiasjonstype har sin egen visning, merket som associations_<association type name>, f.eks. associations_contacts_to_deals. Hver visning er en delmengde av dataene i assosiasjonsdatabaseobjektet og inneholder bare poster med en bestemt kombinert assosiasjonstypeid.

Hvert databaseobjekt returnerer følgende kolonner:

Navn på kolonnen	Type	Beskrivelse
COMBINEDASSOCIATIONTYPEID	Varchar	Den unike identifikatoren for tilknytningsdefinisjonen.
FORENINGSKATEGORI	Varchar	Kilden til tilknytningstypen. En av følgende: HUBSPOT_DEFINED, USER_DEFINED, INTEGRATOR_DEFINED
FORENINGSTYPEID	Varchar	En unik identifikator for en assosiasjonsdefinisjon innenfor en bestemt assosiasjonskategori, dvs. at ingen to definisjoner i en assosiasjonskategori vil ha samme associationtypeid.
FROMOBJECTTYPEID	Varchar	Objekttypeid som er kilden til assosiasjonsdefinisjonen.
FROMOBJECTTYPE	Varchar	Navnet på objekttypen som er kilden til assosiasjonsdefinisjonen.
TOOBJECTTYPEID	Varchar	Objekttypeid som er destinasjonen for assosiasjonsdefinisjonen.
TOOBJECTTYPE	Varchar	Navnet på objekttypen som er destinasjonen for assosiasjonsdefinisjonen.
NAVN	Varchar	Navnet på assosiasjonsdefinisjonen.
MERK	Varchar	Foreningsdefinisjonens beskrivelse.
ISMAINASSOCIATIONDEFINITION	Boolsk	Om tilknytningsdefinisjonen er hovedtypen. Når true, er definisjonen den som HubSpot viser på tilknyttede poster.
[FROMOBJECTTYPE_OBJECTID] f.eks. for ASSOCIATIONS_CONTACTS_TO_DEALS-visningen vil dette være CONTACT_OBJECTID	Antall	Objekt-ID-en til kildeobjektet.
[TOOBJECTTYPE_OBJECTID] f.eks. for visningen ASSOCIATIONS_CONTACTS_TO_DEALS vil dette være DEAL_OBJECTID	Antall	Objekt-ID-en til destinasjonsobjektet.
INGESTEDAT	Tidsstempel	Datoen og klokkeslettet da dataene sist ble tatt inn av Snowflake.

Eksempel 1

Hent alle avtaler som er knyttet til en bestemt kontakt.

Forespørsel:

SELECT
kontakt_objektId, avtale_objektId

FROM foreninger_kontakter_til_avtaler

WHERE contactId = 6626541373

Returnerer:

KONTAKT_OBJEKTID	DEAL_OBJECTID
6626541373	233620335
6626541373	90253678

Eksempel 2

Hent alle kontakter basert i tidssonen Bogota og tilbudene deres.

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_ETTERNAVN	KONTAKT_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 totale summen av inngåtte avtaler 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:

TOTALT_AVSLUTTET_BELØP	KONTAKT_EMAIL
98474793	johndoe@riverview.com
849488	sallymae@longford.com

assosiasjon_definisjoner

Dette databaseobjektet inneholder informasjon om alle tilgjengelige assosiasjonstyper mellom HubSpot-objekter, med én rad per assosiasjonstype. Du kan koble dette databaseobjektet til assosiasjonsdatabaseobjektet for å få postspesifikk assosiasjonsinformasjon.

Det kan være flere typer assosiasjoner mellom de samme objektene. Hovedassosiasjonstypen, som er den typen som vises i HubSpot når poster er assosiert, bruker assosiasjonen der ISMAINASSOCIATIONDEFINITION er true.

Dette databaseobjektet kan returnere følgende kolonner:

Navn på kolonnen	Type	Beskrivelse
`COMBINEDASSOCIATIONTYPEID`	Varchar	Den unike identifikatoren for tilknytningsdefinisjonen.
`CATEGORY`	Varchar	Kilden til tilknytningstypen. En av følgende: `HUBSPOT_DEFINED`, `USER_DEFINED`, `INTEGRATOR_DEFINED`
`ID`	Antall	Identifikatoren for assosiasjonsdefinisjonen innenfor kategorien.
`FROMOBJECTTYPEID`	Varchar	ID-en til objektet som er kilden til assosiasjonsdefinisjonen.
`TOOBJECTTYPEID`	Varchar	ID-en til objektet som er destinasjonen for assosiasjonsdefinisjonen.
`NAME`	Varchar	Navnet på assosiasjonsdefinisjonen.
`LABEL`	Varchar	Assosiasjonsdefinisjonens etikett.
`ISMAINASSOCIATIONDEFINITION`	Boolsk	Om tilknytningsdefinisjonen er hovedtypen. Når true, er definisjonen den som HubSpot viser på tilknyttede poster.
`INGESTEDAT`	Tidsstempel	Datoen og klokkeslettet da dataene sist ble tatt inn av Snowflake. Finn ut mer om kolonnedatatatyper.

Eksempel 1

Hent frem hvilke typer tilknytninger som er tilgjengelige i kontoen din.

Forespørsel:

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

Returnerer:

KOMBINERTFORENINGSTYPE	FROMOBJECTTYPEID	TOOBJECTTYPEID	NAVN
0-1	0-1	0-2	KONTAKT_TIL_BEDRIFT
0-2	0-2	0-1	SELSKAP_TIL_KONTAKT
0-3	0-3	0-1	AVTALE_TIL_KONTAKT
0-4	0-1	0-3	KONTAKT_TIL_AVTALE
0-5	0-3	0-2	DEAL_TO_COMPANY
...	...	...	...

Eksempel 2

Hent de tilgjengelige assosiasjonstypene mellom avtaler og selskaper.

Forespørsel:

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

Returnerer:

KOMBINERTFORENINGSTYPE	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	AVTALE_TIL_SELSKAP_UMERKET

foreninger

Dette databaseobjektet inneholder informasjon om assosiasjonene mellom bestemte poster. Hver rad representerer en assosiasjon fra et objekt til et annet objekt. Det kan finnes rader i dette databaseobjektet selv om de refererte postene er slettet. Du kan sjekke om det finnes poster ved å koble dem til objekttabellen.

Dette databaseobjektet kan være nyttig hvis kontoen din har en stor mengde data, noe som fører til at associations_x_to_y-visningene fungerer sakte.

Dette databaseobjektet kan returnere følgende kolonner:

Navn på kolonnen	Type	Beskrivelse
`COMBINEDASSOCIATIONTYPEID`	Varchar	Den unike identifikatoren for tilknytningsdefinisjonen.
`FROMOBJECTID`	Antall	ID-en til kildeobjektet.
`TOOBJECTID`	Antall	ID-en til destinasjonsobjektet.
`INGESTEDAT`	Tidsstempel	Datoen og klokkeslettet da dataene sist ble tatt inn av Snowflake. Finn ut mer om kolonnedatatatyper.

Eksempel 1

Hent alle tilknyttede avtaler og kontakter.

Forespørsel:

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

Returnerer:

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

Eksempel 2

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

Forespørsel:

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

Returnerer:

KOMBINERTFORENINGSTYPE	FROMOBJECTID	TOOBJECTID
0-5	6626541373	233620335

Eksempel 3

Hent alle avtaler som er knyttet til en bestemt kontakt (kontakt-ID: 4464). I stedet for å hardkode combinedAssociationTypeId, kobler dette eksempelet til association_definitions.

Forespørsel:

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

Forespørsler fra eierne

eiere

Dette databaseobjektet inneholder informasjon om brukerne i HubSpot-kontoen din. Brukere kan angis som eiere av poster, og vil inneholde både en bruker-ID og en eier-ID, avhengig av konteksten. Begge ID-ene kan brukes til å identifisere samme bruker.

Dette databaseobjektet kan returnere følgende kolonner:

Navn på kolonnen	Type	Beskrivelse
`OWNERID`	Antall	Brukerens eier-ID.
`USERID`	Antall	Brukerens bruker-ID. Brukere med NULL i denne kolonnen er slettet.
`EMAIL`	Varchar	Brukerens e-postadresse.
`FIRSTNAME`	Varchar	Brukerens fornavn.
`LASTNAME`	Varchar	Brukerens etternavn.
`ARCHIVED`	Boolsk	Om brukeren har blitt slettet.
`CREATEDAT`	Tidsstempel	Dato og klokkeslett for når brukeren ble opprettet i HubSpot. Se kolonnedatatatyper for mer informasjon.
`UPDATEDAT`	Tidsstempel	Datoen og klokkeslettet da brukeren sist ble oppdatert i HubSpot. Se kolonnedatatatyper for mer informasjon.
`INGESTEDAT`	Tidsstempel	Datoen og klokkeslettet da dataene sist ble tatt inn av Snowflake.

Eksempel 1

Hent alle brukere. Filteret WHERE archived = false fjerner slettede brukere fra de returnerte dataene.

Forespørsel:

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

Returnerer:

EIERID	USERID	E-POST	FORNAVN	ETTERNAVN
29584574	4621126	233620335	Hobbes	Baron
30532717	4874784	3866015468	Pablo	Walters
30580321	925511	7132752747	Milo	Gull
...	...	...	...	...

Eksempel 2

Hent en spesifikk eier ved hjelp av eier-ID-en.

Forespørsel:

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

Returnerer:

EIERID	USERID	E-POST	FORNAVN	ETTERNAVN
29584574	4621126	233620335	Hobbes	Baron

Eksempel 3

Hent alle kontakter og deres eiere. Denne spørringen kobler poster til eiere med object_with_object_properties og kontaktegenskapen hubspot_owner_id.

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

JOIN owners owner ON contact.property_hubspot_owner_id = owner.ownerId

Returnerer:

KONTAKTTID	KONTAKT_FORNAVN	KONTAKT_ETTERNAVN	KONTAKT_HUBSPOT_EIER_ID	EIER_FORNAVN	EIER_ETERNAVN	EIER_EMAIL
113834202	Richard	Greenfield	29584574	Hobbes	Baron	hobbes.b@business.com
53540801	Ford	Karl	30241125	Milo	Gull	milo.g@business.com
...	...	...	...	...	...	...

Forespørsler fra teamet

lag

Med team i HubSpot kan du organisere brukerne dine i grupper for organisasjons- og rapporteringsformål. Du kan ha et hovedteam og ekstra team.

Dette databaseobjektet inneholder informasjon om teamene i HubSpot-kontoen din.

Dette databaseobjektet kan returnere følgende kolonner:

Navn på kolonnen	Type	Beskrivelse
TEAMID	Antall	Team-ID-en.
TEAMNAME	Varchar	Lagnavnet.
PARENTTEAMID	Antall	Lag-ID-en til det overordnede laget.
CHILDTEAMIDS	Array	Lag-ID-ene til barnelagene.
PRIMÆREIERMEDLEMMER	Varchar	Eier-ID-ene til de primære teammedlemmene.
SEKUNDÆRE EIERMEDLEMMER	Boolsk	Eier-ID-ene til de sekundære teammedlemmene.
INGESTEDAT	Tidsstempel	Datoen og klokkeslettet da dataene sist ble tatt inn av Snowflake.

Eksempel 1

Hent alle lagene.

Forespørsel:

SELECT teamId,teamName, primaryOwnerMembers

FRA team

Returnerer:

TEAMID	TEAMNAME	PRIMÆREIERMEDLEMMER
29584574	Underteam	[233620335, 1234553]
30532717	Super Team	[3866015468, 126221873]
3058032	A Team	[7132752747]

eier_team

Dette databaseobjektet inneholder informasjon om hvilke eiere som korresponderer med hvilke team i HubSpot-kontoen din.

Dette databaseobjektet kan returnere følgende kolonner:

Navn på kolonnen	Type	Beskrivelse
TEAMID	Antall	Team-ID-en.
EIERID	Antall	Brukerens eier-ID.
ISTEAMPRIMARY	Boolsk	Om dette laget er det primære laget for denne eieren.
INGESTEDAT	Tidsstempel	Datoen og klokkeslettet da dataene sist ble tatt inn av Snowflake.

Eksempel 1

Hent alle eiere for et gitt lag.

Forespørsel:

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

Retur

TEAMID	TEAMNAME	ISTEAMPRIMARY
29584574	233620335	SANT
29584574	1234553	SANT

Rørledningsspørringer

Nedenfor finner du informasjon om hvordan du søker etter data om avtale- og billettpipelines, for eksempel tilgjengelige pipelines i kontoen din og stadiene de befinner seg i.

Du kan koble disse dataene med objektdata for å få en fullstendig oversikt over rørledningene dine. Du kan for eksempel søke etter avtaler og deres rørledninger ved å koble sammen objects_deals_view eller object_with_object_properties-dataene med rørledningsdataene.

rørledninger

Dette databaseobjektet inneholder informasjon om avtale- og billettrørledningene i kontoen din. Hver rad som returneres, representerer én enkelt pipeline.

Denne tabellen kan returnere følgende kolonner:

Navn på kolonnen	Type	Beskrivelse
`PIPELINEID`	Varchar	Rørledningens ID.
`OBJECTTYPEID`	Varchar	ID-en til objektet som rørledningen kan inneholde (f.eks. avtaler eller billetter).
`LABEL`	Varchar	Rørledningens navn i HubSpot.
`DISPLAYORDER`	Antall	Rekkefølgen pipelinen vises i i HubSpot.
`ARCHIVED`	Boolsk	Om rørledningen har blitt slettet.
`CREATEDAT`	Tidsstempel	Når rørledningen ble opprettet.
`UPDATEDAT`	Tidsstempel	Datoen og klokkeslettet da dataene sist ble oppdatert i HubSpot. Lær mer om kolonnedatatatyper.
`INGESTEDAT`	Tidsstempel	Datoen og klokkeslettet da dataene sist ble tatt inn av Snowflake.

Eksempel 1

Hent alle tilgjengelige avtalepipelines, sortert etter rekkefølgen i HubSpot.

Forespørsel:

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

Returnerer:

OBJECTTYPEID	PIPELINEID	MERK
0-3	1bed503c-37f7-4f51-9d40-7598902673f4	Salgspipeline
0-3	12659678	Lisenser Pipeline
0-3	75e28846-ad0d-4be2-a027-5e1da6590b98	Ny virksomhet
...	...	...

Eksempel 2

Henter avtaler innenfor en spesifikk rørledning. Kobler sammen object_with_object_properties og pipelines.

Forespørsel:

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 Registrering	Salgspipeline
605457408	Friskies Rebrand	Salgspipeline
604362473	Fresh Step App Build	Salgspipeline

Eksempel 3

Samme som i eksempel 2 ovenfor, hent avtaler i en bestemt pipeline. Men i stedet for å bruke objects_deals i sammenføyninger, bruker 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';

Returnerer:

DEAL_ID	DEAL_NAME	PIPELINE_NAME
605140072	Meowmix Global Registrering	Salgspipeline
605457408	Friskies Rebrand	Salgspipeline
604362473	Fresh Step App Build	Salgspipeline

pipeline_stadier

Denne visningen inneholder informasjon om de enkelte trinnene i en rørledning. Identifiser etapper ved å kombinere objekttype-ID, rørlednings-ID og etappe-ID. Når du kobler sammen med rørledninger, bruker du objekttype-ID og rørlednings-ID.

Dette databaseobjektet kan returnere følgende kolonner:

Navn på kolonnen	Type	Beskrivelse
`PIPELINEID`	Varchar	Rørledningens ID.
`STAGEID`	Varchar	Scenens ID.
`LABEL`	Varchar	Navnet på scenen i HubSpot.
`DISPLAYORDER`	Antall	Rekkefølgen pipelinen vises i i HubSpot.
`METADATA`	Variant	En JSON-formatert beskrivelse av scenen, inkludert om den er åpen eller lukket
`ARCHIVED`	Boolsk	Om rørledningstrinnet er slettet.
`CREATEDAT`	Tidsstempel	Når rørledningstrinnet ble opprettet.

Eksempel 1

Hent pipelinefaser for en avtalepipeline med navnet Salgspipeline.

Forespørsel:

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	MERK
941650	941651	Kontaktet
941650	941652	Avtale planlagt
941650	941653	Faktura sendt
...	...	...

Eksempel 2

Hent alle avtaler og deres respektive pipeline-stadier.

Forespørsel:

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 Registrering	Salgspipeline	Kontrakt sendt
605457408	Friskies Rebrand	Salgspipeline	Avtale planlagt
604362473	Fresh Step App Build	Salgspipeline	Kontrakt signert
...	...	...	...

Forespørsler om eiendom

property_definitions

Dette databaseobjektet inneholder informasjon om objektegenskaper og hendelsesegenskaper i HubSpot-kontoen din. Hendelsesegenskaper inkluderer standardhendelser, for eksempel e-poståpninger og -klikk, og egendefinerte atferdsmessige h endelsesegenskaper. Denne informasjonen kan være nyttig for å definere verdier som finnes i object_properties og hendelsesdata.

Du kan identifisere spesifikke egenskaper ved å kombinere objekttype-ID og navn. Du kan hente lignende informasjon ved hjelp av API-et for egenskaper.

Dette databaseobjektet kan returnere følgende kolonner:

Navn på kolonnen	Type	Beskrivelse
`OBJECTYPEID`	Varchar	ID-en til objektet som hendelsen gjelder.
`NAME`	Varchar	Egenskapens interne navn.
`LABEL`	Varchar	Eiendommens etikett.
`DESCRIPTION`	Varchar	Beskrivelse av eiendommen.
`TYPE`	Varchar	Egenskapens type (f.eks. streng, tall, datetime).
`FIELDTYPE`	Varchar	Egenskapens felttype. Definerer hvordan egenskapen vises i HubSpot og på skjemaer (f.eks. avkrysningsboks, velg).
`DISPLAYORDER`	Antall	Eiendommens visningsrekkefølge.
`GROUPNAME`	Varchar	Egenskapens gruppenavn.
`OPTIONS`	Variant	For oppregningsegenskaper, en matrise med egenskapens alternativer, inkludert hvert alternativs attributter (f.eks. visningsrekkefølge, etikett).
`CREATEDUSERID`	Antall	ID-en til brukeren som opprettet egenskapen.
`REFERENCEDOBJECTTYPE`	Varchar	Objekttypen som egenskapen refererer til. Eieregenskaper returnerer verdien OWNER.
`CALCULATED`	Boolsk	Om egenskapen er en beregnet egenskap.
`EXTERNALOPTIONS`	Boolsk	Om egenskapens alternativer er definert i et eksternt system.
`HASUNIQUEVALUE`	Boolsk	Om egenskapens verdier er unike. Kan bare angis når du oppretter en egenskap via API-et.
`HIDDEN`	Boolsk	Om egenskapen er skjult i HubSpot.
`SHOWCURRENCYSYMBOL`	Boolsk	Om en tallegenskapsverdi er formatert som en valuta.
`FORMFIELD`	Boolsk	Om denne egenskapen kan brukes i skjemaer.
`READONLYDEFINITION`	Boolsk	Om egenskapen kan redigeres i HubSpot.
`READONLYVALUE`	Boolsk	Om egenskapens verdi kan redigeres i HubSpot.
`HUBSPOTDEFINED`	Boolsk	Om eiendommen ble opprettet av HubSpot eller av en bruker.
`ARCHIVED`	Boolsk	Om egenskapen har blitt slettet.
`CREATEDAT`	Tidsstempel	Datoen og klokkeslettet da eiendommen ble opprettet i HubSpot.
`UPDATEDAT`	Tidsstempel	Datoen og klokkeslettet da dataene sist ble oppdatert i HubSpot. Lær mer om kolonnedatatatyper.
`INGESTEDAT`	Tidsstempel	Datoen og klokkeslettet da dataene sist ble tatt inn av Snowflake.

Eksempel 1

Henter navn og beskrivelser for alle kontaktegenskaper.

Forespørsel:

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

Returnerer:

NAVN	MERK	BESKRIVELSE
entered_sql_stage	Gikk inn i SQL-stadiet	Starttelling SQL-etappedager.
første_konvertering_hendelse_navn	Første konvertering	Det første skjemaet denne kontakten sendte inn.
adresse	Gateadresse	Kontaktens adresse.

Spørsmål om hendelser

Hendelser inkluderer standard HubSpot-hendelser og egendefinerte atferdshendelser. Hver hendelse har sitt eget databaseobjekt, merket som events_eventname.

Navn
HENDELSER_ANNONSE_INTERAKSJON	Detaljer om en annonse og kontakter som interagerte med den ved å klikke på annonsen eller sende inn et skjema etter å ha interagert med den.
EVENTS_AD_METRICS_IMPORTED_V0	Detaljer om en annonse og dens ytelsesberegninger.
HENDELSER_ANROP_NEVNT_NØKKELORD	Detaljer om nøkkelord som nevnes av deltakere i samtaler.
HENDELSER_KLIKKET_PÅ_LENKE_I_EPOST_V2	Lenker som kontakter har klikket på i markedsførings-e-poster.
HENDELSER_KLIKKET_PÅ_LENKE_I_SPORET_INNBOKS_EPOST_V8	Lenker som kontakter har klikket på i e-poster i Conversations Inbox.
EVENTS_COOKIE_BANNER_KLIKKET PÅ	Kontakter som har klikket på informasjonskapsler.
EVENTS_COOKIE_BANNER_VIEWED	Kontakter som har sett på informasjonskapsler.
EVENTS_DOCUMENT_SHARED_V2	Salgsdokumenter som deles med kontakter via en ekstern lenke.
EVENTS_DOCUMENT_VIEWED_V2	Salgsdokumenter og kontakter som de har sett ved å åpne den eksterne lenken.
HENDELSER_DOKUMENT_FULLFØRT_V2	Salgsdokumenter og kontakter som har avsluttet dem.
EVENTS_HS_SCHEDULED_EMAIL_V2	E-poster som sendes til HubSpots e-postservere for å bli sendt.
EVENTS_MTA_DELIVERED_EMAIL_V2	E-poster som er levert til mottakerne av HubSpots e-postservere.
EVENTS_MTA_BOUNCED_EMAIL_V2	Forsøk på e-postlevering som ble avvist av mottakerens e-postserver.
HENDELSER_ÅPNET_EPOST_V2	Åpninger av e-post fra kontakter.
HENDELSER_RAPPORTERT_SPAM_EPOST_V2	E-poster som er merket som søppelpost av mottakerne.
EVENTS_UPDATED_EMAIL_SUBSCRIPTION_STATUS_V2	Endringer i e-postabonnementer av mottakere.
EVENTS_OPENED_TRACKED_INBOX_EMAIL_V8	Åpninger av e-poster i Conservations Inbox etter kontaktperson.
EVENTS_MB_MEDIA_PLAYED	Videoavspillingsaktivitet etter kontakter.
EVENTS_V2_KONTAKT_BOOKET_MØTE_GJENNOM_SEKVENS	Kontakten booket et møte gjennom sekvens.
EVENTS_V2_KONTAKT_INNMELDT_I_SEKVENS	Kontakt innskrevet fra sekvens.
EVENTS_V2_KONTAKT_AVSLUTTET_SEKVENS	Sekvensen er ferdig.
EVENTS_V2_KONTAKT_BESVART_SEKVENS_EPOST	Kontakten svarte på e-post (eller innkommende e-post som avmeldte sekvensen) som ble sendt gjennom sekvensen.
HENDELSER_V2_KONTAKT_AVMELDT_FRA_SEKVENS	Kontakt avmeldt fra sekvensen.
EVENTS_V2_KONTAKT_AVMELDT_MANUELT_FRA_SEKVENS	Brukeren opphevet registreringen av kontakten manuelt.
EVENTS_V2_CONTACT_UNSUBSCRIBED_SEQUENCE_EMAIL	Kontakten melder seg av, og sekvensen avregistreres.
EVENTS_V2_SEQUENCE_EMAIL_BOUNCED	Sekvens-e-posten ble avvist.
EVENTS_V2_SEQUENCE_ERRORED	Feil i sekvensen førte til avregistrering.
EVENTS_V2_SEQUENCE_STEP_EXECUTED	Sekvenstrinn utført.
HENDELSER_BESØKT_SIDE	Besøk på nettsidene etter kontaktpersoner.
EVENTS_<INTEGRATION_EVENT_NAME>_<UNIQUE_IDENTIFIER>	Integrasjonshendelser(Tidslinje V3 API)

Du kan identifisere hendelser ved å kombinere ID for hendelsestype og ID. Hvilke kolonner som returneres, avhenger av hendelsen, med én kolonne for hver hendelsesegenskap. Alle hendelser returnerer følgende kolonner:

Merk: HubSpot har lagt til to nye kolonner i alle hendelsestabeller og -visninger:

occurredat
occurredatdateint

Disse kolonnene vil erstatte occuredat og occuredatdateint den 24. november 2022. På denne datoen vil de gamle kolonnene ikke lenger være tilgjengelige, og forsøk på å spørre et databaseobjekt eller en visning som inneholder hendelser som bruker disse kolonnene, vil mislykkes. Finn ut mer om endringer for Snowflake-datadelinger.

Navn på kolonnen	Type	Beskrivelse
`EVENTTYPEID`	Varchar	ID-en til hendelsestypen, på samme måte som OBJECTTYPEID Du kan søke etter alle hendelsestype-ID-er i kontoen din ved hjelp av visningen object_and_event_type_definitions.
`ID`	Varchar	Denne er unik for hver hendelsestype. Ingen to poster vil ha samme ID innenfor en gitt hendelsestype.
`OBJECTTYPEID`	Varchar	Objekttypen som fullførte hendelsen. For eksempel vil et klikk på en e-postlenke vise `0-1` i denne kolonnen, som representerer kontaktobjektet.
`OBJECTID`	Antall	ID-en til posten som fullførte hendelsen.
`OCCURREDAT`	Tidsstempel	Når hendelsen inntraff.
`OCCURREDATDATEINT`	Antall	Et tall som representerer når hendelsen inntraff. Inneholder de samme dataene som kolonnen `OCCURREDAT`, men er formatert som et tall og brukes som en del av tabellens klyngenøkkel. I de fleste tilfeller kan du bruke `OCCURREDAT` tidsstempel i stedet for dette tallet.
`OCCUREDATDATEINT`	Antall	Et tall som representerer når hendelsen inntraff. Inneholder de samme dataene som kolonnen `OCCURREDAT`, men er formatert som et tall og brukes som en del av tabellens klyngenøkkel. I de fleste tilfeller kan du bruke `OCCURREDAT` tidsstempel i stedet for dette tallet. Merk: Denne kolonnen vil bli utfaset 24. november 2022 og erstattet med `OCCURREDATDATEINT`.
`OCCUREDAT`	Tidsstempel	Når hendelsen inntraff. Merk: Denne kolonnen vil bli utfaset 24. november 2022 og erstattet med `OCCURREDAT`.
`INGESTEDAT`	Tidsstempel	Datoen og klokkeslettet da dataene sist ble tatt inn av Snowflake. Finn ut mer om kolonnedatatatyper.
`PROPERTY_*`	Varchar	Individuelle kolonner som inneholder hendelsesegenskapene.

Eksempel 1

Hent de 50 siste klikkhendelsene på e-post.

Forespørsel:

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-postklikkhendelser etter kontaktene som klikket. Denne spørringen henter kontaktdata ved å koble til object_with_object_properties.

Forespørsel:

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:

KLIKK_TIDSSTEMPEL	CLICK_URL	KONTAKT_FORNAVN	KONTAKT_ETTERNAVN
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	Gull
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

objekt_og_hendelse_typedefinisjoner

Dette databaseobjektet inneholder definisjoner for alle objekter og hendelser som er tilgjengelige i HubSpot-kontoen din.

Dette databaseobjektet kan returnere følgende kolonner:

Navn på kolonnen	Type	Beskrivelse
`OBJECTTYPEID`	Varchar	ID-en til objektet som rørledningen kan inneholde (f.eks. avtaler eller billetter).
`FULLYQUALIFIEDNAME`	Varchar	Navnet på objektet eller hendelsen.
`INGESTEDAT`	Tidsstempel	Datoen og klokkeslettet da dataene sist ble tatt inn av Snowflake. Finn ut mer om kolonnedatatatyper.

Eksempel 1

Hent alle objekter og hendelser som er tilgjengelige i HubSpot-kontoen din.

Forespørsel:

SELECT objectTypeId, fullyQualifiedName
FROM object_and_event_type_definitions;

Returnerer:

OBJECTTYPEID	FULLKVALIFISERT NAVN
0-1	KONTAKT
0-8	LINE_ITEM
0-11	SAMTALE
...	...

Lister over forespørsler

Nedenfor finner du informasjon om hvordan du søker i listene dine, for eksempel tilgjengelige kontakt- og firmalister og postene som er inkludert i disse listene.

lister

Dette databaseobjektet inneholder informasjon om HubSpots kontakt- og selskapslister. Returnerer én rad per liste, og kolonnene inneholder listeopplysninger som listenavn, størrelse og objekttypen til postene den inneholder. Inneholder ikke informasjon om de individuelle postene i hver liste (se list_membership).

Dette databaseobjektet kan returnere følgende kolonner:

Navn på kolonnen	Type	Beskrivelse
`OBJECTTYPEID`	Varchar	Type oppføringer i listen (f.eks. kontakt eller selskap).
`LISTID`	Antall	ID-en til listen. Kobles til LISTID-kolonnen i tabellen list-emberships.
`CLASSICLISTID`	Antall	En ID som er spesifikk for kontaktlister, og som samsvarer med ID-en i URL-en til listen i HubSpot.
`NAME`	Varchar	Navnet på listen.
`SIZE`	Antall	Antall poster i listen.
`CREATEDBYUSERID`	Antall	ID-en til brukeren som opprettet listen.
`CREATEDAT`	Tidsstempel	Når listen ble opprettet i HubSpot.
`UPDATEDBYUSERID`	Antall	ID-en til brukeren som sist oppdaterte listen.
`UPDATEDAT`	Tidsstempel	Datoen og klokkeslettet da datoen sist ble oppdatert i HubSpot. Lær mer om kolonnedatatatyper.
`INGESTEDAT`	Tidsstempel	Datoen og klokkeslettet da dataene sist ble tatt inn av Snowflake.

Eksempel 1

Hent alle kontaktlister.

Forespørsel:

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

Returnerer:

LISTID	NAVN	STØRRELSE
118131	Ukentlig oppsøkende virksomhet	103
66156	Blogg-abonnenter	455
771852	Topp abonnenter 2021	37
...	...	...

Eksempel 2

Hent en spesifikk kontaktliste med navnet Toppabonnenter 2021.

Forespørsel:

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

Returnerer:

LISTID	NAVN	STØRRELSE
771852	Topp abonnenter 2021	37

list_membership

Dette databaseobjektet inneholder informasjon om hvilke poster som er medlemmer av hvilke lister, med én rad per post i listen. Hvis du for eksempel har en bloggabonnentliste med 500 kontakter, vil databaseobjektet returnere 500 rader.

Inneholder bare liste-ID-er og objekt-ID-er. Du finner mer informasjon ved å koble deg til databaseobjektet lists.

Dette databaseobjektet kan returnere følgende kolonner:

Navn på kolonnen	Type	Beskrivelse
`LISTID`	Varchar	ID-en til listen. Linker til kolonnen HS_LIST_ID i tabellen lists.
`OBJECTID`	Varchar	ID-en til posten i listen.
`UPDATEDAT`	Tidsstempel	Datoen og klokkeslettet da dataene sist ble oppdatert i HubSpot. Lær mer om kolonnedatatatyper.
`INGESTEDAT`	Tidsstempel	Datoen og klokkeslettet da dataene sist ble tatt inn av Snowflake.

Eksempel 1

Hent ID-ene til alle kontaktene i listen Toppabonnenter 2021.

Forespørsel:

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

Returnerer:

OBJECTID

54325098

96805401

6922028

...

Eksempel 2

Hent for- og etternavn på kontaktopplysninger i listen Toppabonnenter 2021.

Forespørsel:

SELECT

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

Returnerer:

OBJECTID	FORNAVN	ETTERNAVN
54325098	Hobbes	Baron
96805401	Milo	Gull
6922028	Henry	Riley
...	...	...

Vanlige spørsmål

Jeg ønsker å generere data som ligner på en rapport fra Hubspot-appen, hvordan gjør jeg det?

Vanligvis vil du se på kolonnene i rapporten du sammenligner med. Hvis rapportvisualiseringen ikke er i tabellform, kan du konvertere den til en tabell for å vise kolonnene rapporten inneholder. Disse kolonnene er vanligvis egenskaper for en objekttype eller en hendelsestype. Neste trinn er å finne ut hvilken objekttypeegenskap en kolonne tilsvarer. Dette kan du gjøre ved å spørre property_definitions:

SELECT * FROM property_definitions

WHERE label = [column_name]

Det er ikke alltid det er en nøyaktig match, fordi noen egenskapsnavn vanligvis løses opp til et mer beskrivende navn i appen. I slike tilfeller kan det hjelpe å gjøre et uklart søk ved å bruke LIKE-operatoren på kolonnen label (eller til og med description) i property_definitions.

Når du har funnet ut hvilken objekttype kolonnen tilhører, er det enkelt å finne ut hva du skal spørre etter. Du kan ganske enkelt søke etter object_x-visningen som tilsvarer typen.

Hvordan kobler jeg denne datatypen til en annen, f.eks. hvordan henter jeg skjemaer til en kampanje?

Hvis du trenger å koble to eller flere forskjellige poster til hverandre, kan du ta en titt på assosiasjoner. Assosiasjoner representerer relasjonene mellom objekter i HubSpot CRM. Alle mulige assosiasjoner mellom to typer er oppført i association_definitions. I eksempelet ovenfor må du spørre ASSOCIATIONS_CAMPAIGNS_TO_FORMS for å finne ut alle skjemaene en kampanje 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 vet jeg status for HubSpot-Snowflake-integrasjonen?

Hvis du vil motta statusoppdateringer i sanntid om avbrudd og problemer for HubSpot-Snowflake-integrasjonen, kan du søke i data_share_status-visningen:

SELECT * FROM hubspot.public.data_share_status LIMIT 1

Resultatene vises som følger:

STATUS	MELDING	OPPDATERTAT
OK	INGEN KJENTE HENDELSER FOR ØYEBLIKKET	2023-04-10 09:21:20.123

Denne visningen gir oppdateringer om integrasjonsstatusen i omvendt kronologisk rekkefølge. Ved å integrere resultatene av denne spørringen i et dashbord kan du følge med på integrasjonens ytelse og oppdage eventuelle driftsstanser eller avbrudd.

Vis hele posten