Merk:: Denne artikkelen er oversatt av praktiske årsaker. Oversettelsen opprettes automatisk ved hjelp av oversettingsprogramvare, og det er ikke sikkert at den er korrekturlest. Den engelske versjonen av denne artikkelen skal regnes som den regjerende versjonen med den nyeste informasjonen. Du finner den her.

Søk etter HubSpot-data i Snowflake

Sist oppdatert: 3 september 2025

Tilgjengelig med et av følgende abonnementer, unntatt der det er angitt:

Data Hub Enterprise

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, eller du kan legge dem til manuelt.

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

Klikk på arbeidsarkets handlingsfelt 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 Skjema, og velg deretter skjemaet du vil bruke:

Når miljøet ditt er konfigurert, kan du gjøre spørringer til HubSpot-dataene dine uten å måtte legge til database- eller skjematypen 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

Dataoversikt

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

Objekter: standard og egendefinerte objekter, for eksempel kontakter, selskaper og produkter.
Poster: individuelle poster, 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.
Segmenter: HubSpot-kontakt- og bedriftssegmenter.
Eiere: brukere i HubSpot-kontoen din, i forhold til postene de er angitt som eier av.
Pipelines: avtale- og billettpipelines, inkludert pipelinefaser.
Properties: egenskaper og deres verdier på CRM-poster, inkludert egenskapshistorikk.

Finn ut mer om HubSpots 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 rekkefølge 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:I resten av dette dokumentet bruker vi begrepet databaseobjekt når konteksten gjelder både tabeller og visninger.

snowflake-sidebar-view-column-details0

Hvis du vil returnere en bestemt kolonne, inkluderer du den kolonnen i SELECT -feltet i spørringen. Følgende spørring vil for eksempel bare returnere 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 individuelle visningsdefinisjonene i artikkelen ovenfor.

OBJECTTYPEID: en VARCHAR-verdi som representerer et objekts type. For eksempel representerer 0-1 kontaktobjektet, 0-2 representerer selskapsobjektet, og 2-1232 kan representere et egendefinert objekt i kontoen din. I segmenter refererer dette til typen segment (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-tall som representerer en enkelt oppføring 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 inntakstidspunktet, 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 ønsket type 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

Objektspørringer

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 tilgjengelig 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 gjør en spørring, 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
Kontakter	0-1
Bedrifter	0-2
Linjeposter	0-8

Egendefinerte objekter får tildelt 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 er vanligvis egnet hvis du ønsker bedre spørringsytelse enn det som oppnås med objects_x-visninger. Se mer informasjon i object_with_object_properties, object_properties, objects og object_properties_history nedenfor.

objects_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 er navngitt 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, sammenkoblet 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 personer som interagerer med virksomheten din
COMPANY	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
TICKET	0-5	Representerer kundeforespørsler om hjelp eller støtte
QUOTE	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 er knyttet til en avtale, blir det en varelinje
CONVERSATION	0-11	Detaljer om innkommende meldinger fra flere kanaler.
LANDING_PAGE	0-25	Detaljer om landingssidene dine
TASK	0-27	Lagrer informasjon om oppgavelister
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å nettstedene dine
BLOG_POST	0-39	Data om blogginnlegg
OBJECT_SEGMENT	0-45	Informasjon om grupperinger av objektposter basert på deres egenskaper eller aktiviteter
CALL	0-48	Anrop foretatt av andre CRM-poster, f.eks. kontakter
INVOICE	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
TEMPLATE	0-62	Lagret e-postinnhold som kan gjenbrukes for å sende e-poster
DEAL_SPLIT	0-72	Deal splits brukes til å dele avtalekreditt mellom flere brukere
SALES_DOCUMENT	0-83	Salgsdokumenter bygger et bibliotek med innhold som hele teamet kan laste opp og dele dokumenter med kontaktene dine
FEEDBACK_SUBMISSION	0-19	Lagrer informasjon som er sendt inn til en tilbakemeldingsundersøkelse
ABONNEMENT	0-69	Abonnementer inneholder informasjon om tilbakevendende betalinger
HANDELSBETALING	0-101	Inneholder data om innsamlede midler fra kunder

Hvert databaseobjekt vil returnere følgende kolonner:

Navn på kolonnen	Type	Beskrivelse
OBJECTTYPEID	Varchar	ID-en til objekttypen (f.eks. kontakter er 0-1).
OBJECTID	Nummer	ID-en til posten (f.eks. en kontaktpost med ID 123752).
UPDATEDAT	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 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	FIRSTNAME	SISTNAVN	LIFECYCLESTAGE
54325098	Hobbes	Baron	leder
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

Henter transaksjonsnavn og -stadium for de tre beste transaksjonene etter beløp.

Forespørsel:

Siden data om avtalebeløp er tilgjengelig som en talldatatype, kan de brukes til bestilling uten at det er nødvendig å konvertere eller kaste dem.

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	Test Deal 123	14845019	8383663
38960439	Navn på avtale 1	closedwon	34199

object_with_object_properties

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

Denne visningen kan returnere følgende kolonner:

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

Merk: Den 25. 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 i resten 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	PROPERTIES
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

objekter

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 bare 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 visningene object_with_object_properties og objects_x 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:

Kolonnenavn	Type	Beskrivelse
`OBJECTTYPEID`	Varchar	ID-en til objekttypen (f.eks. kontakter er `0-1`).
`OBJECTID`	Number	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 noen 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:

Kolonnenavn	Type	Beskrivelse
`OBJECTTYPEID`	Varchar	ID-en til objekttypen (f.eks. kontakter er `0-1`).
`OBJECTID`	Number	ID-en til posten (f.eks. en kontaktpost med ID `123752`).
`NAME`	Varchar	Navnet på egenskapen.
`VALUE`	Tidsstempel	Verdien til egenskapen.
`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

Hent egenskapene fornavn, etternavn og by 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 til én rad per kontakt. Dette eksemplet bruker SQL PIVOT-syntaksen.

Spørring:

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	leder
0-1	96805401	Milo	Gull	bly
0-1	6922028	Henry	Riley	leder
...	...	...	...	...

object_properties_history

Dette databaseobjektet inneholder historiske egenskapsverdier. 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:

Kolonnenavn	Type	Beskrivelse
`OBJECTTYPEID`	Varchar	ID-en til objekttypen (f.eks. kontakter er `0-1`).
`OBJECTID`	Number	ID-en til posten (f.eks. en kontaktpost med ID `123752`).
`NAME`	Varchar	Navnet på egenskapen.
`VALUE`	Tidsstempel	Verdien til egenskapen.
`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 for en enkelt egenskap 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	UPDATEDAT
136493192	hs_prediktivepoengtrinn	tier_1	2022-06-22 22:45:05.931
136493192	hs_prediktivecoringnivå	tier_2	2021-09-18 08:20:56.622
136493192	hs_prediktivecoringnivå	nivå_3	2019-11-31 18:20:22.851
...	...	...	...

Eksempel 2

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

Spørring:

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	Gold
6922028	Henry	Riley
...	...	...

Assosiasjonsspørringer

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 gjør en spørring, må du derfor angi et filter som "WHERE combinedassociationtypeid='0-32'". Se mer i assosiasjoner og assosiasjonsdefinisjoner nedenfor.

associations_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 associations-databaseobjektet og inneholder bare poster med en spesifikk kombinert associationstypeid.

Hvert databaseobjekt returnerer følgende kolonner:

Kolonnenavn	Type	Beskrivelse
COMBINEDASSOCIATIONTYPEID	Varchar	Den unike identifikatoren for assosiasjonsdefinisjonen.
ASSOCIATIONCATEGORY	Varchar	Kilden til assosiasjonstypen. En av følgende: HUBSPOT_DEFINED, USER_DEFINED, INTEGRATOR_DEFINED
ASSOCIATIONTYPEID	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	Navnet på objekttypen som er destinasjonen for assosiasjonsdefinisjonen.
TOOBJECTTYPE	Varchar	Navnet på objekttypen som er destinasjonen for assosiasjonsdefinisjonen.
NAME	Varchar	Navnet på assosiasjonsdefinisjonen.
LABEL	Varchar	Assosiasjonsdefinisjonens beskrivelse.
ISMAINASSOCIATIONDEFINITION	Boolsk	Om assosiasjonsdefinisjonen 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 ASSOCIATIONS_CONTACTS_TO_DEALS view, 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 assosiasjoner_kontakter_til_avtaler

WHERE contactId = 6626541373

Returnerer:

CONTACT_OBJECTID	DEAL_OBJECTID
6626541373	233620335
6626541373	90253678

Eksempel 2

Hent alle kontakter basert i tidssonen Bogota og avtalene 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'

CONTACT_FIRSTNAME	KONTAKT_ETTERNAVN	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 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	CONTACT_EMAIL
98474793	johndoe@riverview.com
849488	sallymae@longford.com

association_definitions

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

Det kan finnes 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:

Kolonnens navn	Type	Beskrivelse
`COMBINEDASSOCIATIONTYPEID`	Varchar	Den unike identifikatoren for tilknytningsdefinisjonen.
`CATEGORY`	Varchar	Kilden til assosiasjonstypen. En av: `HUBSPOT_DEFINED`, `USER_DEFINED`, `INTEGRATOR_DEFINED`
`ID`	Number	Identifikatoren for assosiasjonsdefinisjonen innenfor sin kategori.
`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 assosiasjonsdefinisjonen er hovedtypen. Når true er valgt, er det definisjonen 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 assosiasjonstypene som er tilgjengelige i kontoen din.

Forespørsel:

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

Returnerer:

KOMBINERTASSOSIASJONSTYPE	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 tilknytningstypene 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:

COMBINEDASSOCIATIONTYPE	FROMOBJECTTYPEID	TOOBJECTTYPEID	NAME
0-5	0-3	0-2	DEAL_TO_COMPANY
0-271	0-3	0-2	AVTALE_TIL_PRIMÆRSELSKAP
0-341	0-3	0-2	AVTALE_TIL_SELSKAP_UMERKET

assosiasjoner

Dette databaseobjektet inneholder informasjon om assosiasjoner mellom spesifikke 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å kolonne	Type	Beskrivelse
`COMBINEDASSOCIATIONTYPEID`	Varchar	Den unike identifikatoren for tilknytningsdefinisjonen.
`FROMOBJECTID`	Number	ID-en til kildeobjektet.
`TOOBJECTID`	Number	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:

KOMBINERTASSOSIASJONSTYPEID	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:

COMBINEDASSOCIATIONTYPE	FROMOBJECTID	TOOBJECTID
0-5	6626541373	233620335

Eksempel 3

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

Spørring:

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

Eier-spørringer

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å kolonne	Type	Beskrivelse
`OWNERID`	Nummer	Brukerens eier-ID.
`USERID`	Nummer	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:

OWNERID	BRUKERID	EMAIL	FIRSTNAME	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:

OWNERID	USERID	EMAIL	FIRSTNAME	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:

CONTACTID	KONTAKT_FORNAVN	KONTAKT_ETTERNAVN	KONTAKT_HUBSPOT_EIER_ID	OWNER_FIRSTNAME	OWNER_LASTNAME	OWNER_EMAIL
113834202	Richard	Greenfield	29584574	Hobbes	Baron	hobbes.b@business.com
53540801	Ford	Karl	30241125	Milo	Gold	milo.g@business.com
...	...	...	...	...	...	...

Team-spørringer

team

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å kolonne	Type	Beskrivelse
TEAMID	Nummer	Lagets ID.
TEAMNAME	Varchar	Lagets navn.
PARENTTEAMID	Nummer	Lag-ID-en til foreldrelaget.
CHILDTEAMIDS	Array	Team-ID-ene til barneteamene.
PRIMARYOWNERMEMBERS	Varchar	Eier-ID-ene til teamets primære medlemmer.
SEKUNDÆREIERMEDLEMMER	Boolsk	Eier-ID-ene til teamets sekundære medlemmer.
INGESTEDAT	Tidsstempel	Datoen og klokkeslettet da dataene sist ble importert av Snowflake.

Eksempel 1

Hent alle team.

Forespørsel:

SELECT teamId,teamName, primaryOwnerMembers

FRA team

Returnerer:

TEAMID	TEAMNAME	PRIMARYOWNERMEMBERS
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å kolonne	Type	Beskrivelse
TEAMID	Nummer	Teamets ID.
OWNERID	Nummer	Brukerens eier-ID.
ISTEAMPRIMARY	Boolsk	Om dette teamet er det primære teamet for denne eieren.
INGESTEDAT	Tidsstempel	Datoen og klokkeslettet da dataene sist ble tatt inn av Snowflake.

Eksempel 1

Hent alle eiere for et gitt team.

Forespørsel:

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

Returnerer

TEAMID	TEAMNAME	ISTEAMPRIMARY
29584574	233620335	TRUE
29584574	1234553	SANT

Rørledningsspørringer

Nedenfor kan du lære hvordan du spør etter data om avtale- og billettpipeliner, for eksempel tilgjengelige pipeliner i kontoen din og stadiene de befinner seg på.

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 pipelines ved å koble sammen objects_deals_view eller object_with_object_properties-data med pipelines-data.

pipelines

Dette databaseobjektet inneholder informasjon om avtale- og billettpipelines i kontoen din. Hver rad som returneres representerer en 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`	Boolean	Hvorvidt 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. Finn ut mer om kolonnedatatatyper.
`INGESTEDAT`	Tidsstempel	Datoen og klokkeslettet da dataene sist ble tatt inn av Snowflake.

Eksempel 1

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

Forespørsel:

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	Salgsrørledning
0-3	12659678	Lisenser Pipeline
0-3	75e28846-ad0d-4be2-a027-5e1da6590b98	Ny virksomhet
...	...	...

Eksempel 2

Hent avtaler innenfor en bestemt pipeline. 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 eksempel 2 ovenfor, hent avtaler innenfor en spesifikk 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_stages

Denne visningen inneholder informasjon om individuelle stadier i en pipeline. Identifiser etapper ved å kombinere objekttype-ID, rørlednings-ID og etappe-ID. Ved sammenføyning med rørledninger bruker du objekttype-ID og rørlednings-ID.

Dette databaseobjektet kan returnere følgende kolonner:

Navn på kolonne	Type	Beskrivelse
`PIPELINEID`	Varchar	Rørledningens ID.
`STAGEID`	Varchar	Etappens ID.
`LABEL`	Varchar	Etappens navn i HubSpot.
`DISPLAYORDER`	Antall	Rekkefølgen pipelinen vises i i HubSpot.
`METADATA`	Variant	En JSON-formatert beskrivelse av fasen, inkludert om den er åpen eller lukket
`ARCHIVED`	Boolsk	Hvorvidt pipelinefasen har blitt slettet.
`CREATEDAT`	Tidsstempel	Når rørledningstrinnet ble opprettet.

Eksempel 1

Hent rørledningsfaser 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	LABEL
941650	941651	Kontaktet
941650	941652	Avtale planlagt
941650	941653	Faktura sendt
...	...	...

Eksempel 2

Hent alle avtaler og deres respektive pipelinetrinn.

Spørring:

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

Egenskapsspørringer

egenskap_definisjoner

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:

Kolonnens navn	Type	Beskrivelse
`OBJECTYPEID`	Varchar	ID-en til objektet som hendelsen gjelder.
`NAME`	Varchar	Egenskapens interne navn.
`LABEL`	Varchar	Egenskapens etikett.
`DESCRIPTION`	Varchar	Egenskapens beskrivelse.
`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`	Number	Egenskapens 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`	Nummer	ID-en til brukeren som opprettet egenskapen.
`REFERENCEDOBJECTTYPE`	Varchar	Objekttypen som egenskapen refererer til. Eieregenskaper vil returnere 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 egenskapen ble opprettet av HubSpot, eller om den ble opprettet av en bruker.
`ARCHIVED`	Boolsk	Om egenskapen har blitt slettet.
`CREATEDAT`	Tidsstempel	Dato og klokkeslett for når egenskapen 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

Hent navn og beskrivelser for alle kontaktegenskaper.

Forespørsel:

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

Returnerer:

NAVN	ETIKETT	BESKRIVELSE
entered_sql_stage	Påbegynt SQL-stadium	Starttelling av SQL-stadiedager.
første_konvertering_hendelse_navn	Første konvertering	Det første skjemaet denne kontakten sendte inn.
adresse	Adresse	Kontaktens adresse.

Hendelsesspørringer

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.
EVENTS_CALL_MENTIONED_KEYWORD	Detaljer om nøkkelord som er nevnt av deltakere i samtaler.
EVENTS_CLICKED_LINK_IN_EMAIL_V2	Lenker som kontakter har klikket på i markedsførings-e-poster.
EVENTS_CLICKED_LINK_IN_TRACKED_INBOX_EMAIL_V8	Lenker som kontakter har klikket på i Conversations Inbox-e-poster.
HENDELSER_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 er delt med kontakter via en ekstern lenke.
EVENTS_DOCUMENT_VIEWED_V2	Salgsdokumenter og kontakter som har sett på dem ved å åpne den eksterne lenken.
EVENTS_DOCUMENT_COMPLETED_V2	Salgsdokumenter og kontakter som har avsluttet dem.
EVENTS_HS_SCHEDULED_EMAIL_V2	E-poster som er sendt 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	E-poster som er åpnet av kontakter.
HENDELSER_RAPPORTERT_SPAM_EPOST_V2	E-poster som er merket som spam av mottakere.
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 av kontakter.
EVENTS_MB_MEDIA_PLAYED	Videoavspillingsaktivitet av kontakter.
EVENTS_V2_CONTACT_BOOKED_MEETING_THROUGH_SEQUENCE	Kontakt booket et møte gjennom sekvens.
EVENTS_V2_CONTACT_ENROLLED_IN_SEQUENCE	Kontakten er registrert fra sekvensen.
EVENTS_V2_CONTACT_FINISHED_SEQUENCE	Sekvensen er avsluttet.
EVENTS_V2_CONTACT_REPLIED_SEQUENCE_EMAIL	Kontakten har svart på e-post (eller innkommende e-post som avregistrerte sekvensen) sendt gjennom sekvensen.
EVENTS_V2_CONTACT_UNENROLLED_FROM_SEQUENCE	Kontakt avmeldt fra sekvens.
EVENTS_V2_CONTACT_UNENROLLED_MANUALLY_FROM_SEQUENCE	Kontakten ble avregistrert manuelt av brukeren.
EVENTS_V2_CONTACT_UNSUBSCRIBED_SEQUENCE_EMAIL	Kontakten meldte seg av abonnementet, og sekvensen ble avregistrert.
EVENTS_V2_SEQUENCE_EMAIL_BOUNCED	E-postadressen til sekvensen ble avvist.
EVENTS_V2_SEQUENCE_ERRORED	Feil i sekvensen som fører til avregistrering.
EVENTS_V2_SEQUENCE_STEP_EXECUTED	Sekvenstrinn utført.
EVENTS_VISITED_PAGE	Besøk på nettside av kontakter.
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.

Kolonne navn	Type	Beskrivelse
`EVENTTYPEID`	Varchar	ID-en til hendelsestypen, tilsvarende 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`	Number	ID-en til posten som fullførte hendelsen.
`OCCURREDAT`	Tidsstempel	Når hendelsen inntraff.
`OCCURREDATDATEINT`	Nummer	Et tall som representerer når hendelsen inntraff. Inneholder de samme dataene som kolonnen `OCCURREDAT`, men formatert som et tall og brukt som en del av clusternøkkelen i tabellen. I de fleste tilfeller kan du bruke `OCCURREDAT` tidsstempel i stedet for dette tallet.
`OCCUREDATDATEINT`	Nummer	Et tall som angir 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 utdatert 24. november 2022 og erstattet med `OCCURREDATDATEINT`.
`OCCUREDAT`	Tidsstempel	Når hendelsen inntraff. Merk: Denne kolonnen vil bli utdatert 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 e-postklikkhendelsene.

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.

Spørring:

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	Gold
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_type_definisjoner

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

Dette databaseobjektet kan returnere følgende kolonner:

Kolonnens navn	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	FULLT KVALIFISERT NAVN
0-1	CONTACT
0-8	LINE_ITEM
0-11	CONVERSATION
...	...

Segmenter spørringer

Nedenfor finner du informasjon om hvordan du søker i segmentene dine, for eksempel tilgjengelige kontakt- og bedriftssegmenter og postene som inngår i disse segmentene.

segmenter

Dette databaseobjektet inneholder informasjon om HubSpots kontakt- og bedriftssegmenter. Returnerer én rad per segment, og kolonnene inneholder segmentdetaljer som segmentnavn, størrelse og objekttypen til postene det inneholder. Inneholder ikke informasjon om de enkelte postene i hvert segment (se segment_membership).

Dette databaseobjektet kan returnere følgende kolonner:

Kolonnenavn	Type	Beskrivelse
`OBJECTTYPEID`	Varchar	Type poster i segmentet (f.eks. kontakt eller selskap).
`SEGMENTID`	Nummer	ID-en til segmentet. Kobles til SEGMENTID-kolonnen i tabellen segment-medlemskap.
`CLASSICSEGMENTID`	Nummer	En ID som er spesifikk for kontaktsegmenter, og som samsvarer med ID-en i URL-en til segmentet i HubSpot.
`NAME`	Varchar	Navnet på segmentet.
`SIZE`	Number	Antall poster i segmentet.
`CREATEDBYUSERID`	Number	ID-en til brukeren som opprettet segmentet.
`CREATEDAT`	Tidsstempel	Når segmentet ble opprettet i HubSpot.
`UPDATEDBYUSERID`	Nummer	ID-en til brukeren som sist oppdaterte segmentet.
`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 kontaktsegmenter.

Forespørsel:

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

Returnerer:

SEGMENTSID	NAVN	STØRRELSE
118131	Ukentlig oppsøkende virksomhet	103
66156	Bloggabonnenter	455
771852	Topp abonnenter 2021	37
...	...	...

Eksempel 2

Hent et spesifikt kontaktsegment med navnet Toppabonnenter 2021.

Spørring:

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

Returnerer:

SEGMENTID	NAME	SIZE
771852	Topp abonnenter 2021	37

segment_membership

Dette databaseobjektet inneholder informasjon om hvilke poster som er medlemmer av hvilke segmenter, med én rad per post i segmentet. Hvis du for eksempel har et Bloggabonnenter-segment med 500 kontakter, vil databaseobjektet returnere 500 rader.

Inneholder bare segment-ID-er og objekt-ID-er. Du finner mer informasjon ved å koble til databaseobjektet Segmenter.

Dette databaseobjektet kan returnere følgende kolonner:

Kolonnenavn	Type	Beskrivelse
`SEGMENTID`	Varchar	ID-en til segmentet. Kobles til kolonnen HS_SEGMENT_ID i segmenttabellen.
`OBJECTID`	Varchar	ID-en til posten i segmentet.
`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 kontakter i segmentet Top subscribers 2021.

Forespørsel:

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 etternavnene til kontaktene i segmentet Topp abonnenter 2021.

Spørring:

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	ETTERNAVN
54325098	Hobbes	Baron
96805401	Milo	Gold
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 bør 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 å søke i property_definitions:

SELECT * FROM property_definitions

WHERE label = [column_name]

Det er ikke alltid at det er en nøyaktig match, fordi noen egenskapsnavn vanligvis blir løst 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 for en kampanje?

Hvis du trenger å koble to eller flere ulike 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 å få vite 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 statusen til HubSpot-Snowflake-integrasjonen?

For å motta statusoppdateringer i sanntid om avbrudd og problemer for HubSpot-Snowflake-integrasjonen, spør du i data_share_status-visningen:

SELECT * FROM hubspot.public.data_share_status LIMIT 1

Resultatene vil vises som:

STATUS	MESSAGE	UPDATEDAT
OK	INGEN KJENT HENDELSE 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.

Var denne artikkelen nyttig?

Dette skjemaet brukes kun for tilbakemeldinger om dokumentasjon. Se hvordan du kan få hjelp med HubSpot.

Søk etter HubSpot-data i Snowflake

Tilgjengelig med et av følgende abonnementer, unntatt der det er angitt:

Datalag og Snowflake-kontoregionen din

Konfigurer Snowflake-miljøet ditt

Dataoversikt

Begrensning og rekkefølge av returnerte data

Datatyper for kolonner

Transformere datatyper

Objektspørringer

objects_x-visninger

Eksempel 1

Eksempel 2

Eksempel 3

object_with_object_properties

Eksempel 1

Eksempel 2

objekter

Eksempel 1

object_properties

Eksempel 1

Eksempel 2

object_properties_history

Eksempel 1

Eksempel 2

Assosiasjonsspørringer

associations_x_to_y-visninger

Eksempel 1

Eksempel 2

Eksempel 3

association_definitions

Eksempel 1

Eksempel 2

assosiasjoner

Eksempel 1

Eksempel 2

Eksempel 3

Eier-spørringer

eiere

Eksempel 1

Eksempel 2

Eksempel 3

Team-spørringer

team

Eksempel 1

eier_team

Eksempel 1

Rørledningsspørringer

pipelines

Eksempel 1

Eksempel 2

Eksempel 3

pipeline_stages

Eksempel 1

Eksempel 2

Egenskapsspørringer

egenskap_definisjoner

Eksempel 1

Hendelsesspørringer

Eksempel 1

Eksempel 2

Object_and_event_type_queries

objekt_og_hendelse_type_definisjoner

Eksempel 1

Segmenter spørringer

segmenter

Eksempel 1

Eksempel 2

segment_membership

Eksempel 1

Eksempel 2

Vanlige spørsmål

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

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

Hvordan vet jeg statusen til HubSpot-Snowflake-integrasjonen?

Relatert innhold