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: 31 desember 2025

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

Data Hub Enterprise

Etter at 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-kontoens region

Du vil ha 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 kun daglig: association_definitions, owners, pipelines og pipeline_stages.

Konfigurer Snowflake-miljøet

For å spørre HubSpot-dataene dine i Snowflake, må du velge lageret, databasen og skjemaet du vil spørre 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å verktøylinjenfor arbeidsark i øverste rad i arbeidsarket.
I popup-vinduet:
- Klikk på rullegardinmenyenLager, og velg deretterlageret ditt.
- Klikk på rullegardinmenyenDatabase, og velg deretter HubSpot-databasen din.
- Klikk på rullegardinmenyenSkjema, og velg deretter skjemaet du vil bruke:

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

For å legge til databasen og skjematypen manuelt i spørsmålene, legger du til databasenavnet etterfulgt av skjematypen i begynnelsen av FROM-feltet. For eksempel:

SELECT objectTypeId, property_createddate
FROM hubspot_share_name.V2_LIVE.objects_deals

LIMIT 1

Dataoversikt

Spørringer konstrueres ved hjelp av SQL og kan brukes til å hente HubSpot-data som:

Objekter: standard- og tilpassede objekter, for eksempel kontakter, selskaper, produkter.
Poster: individuelle poster, for eksempel en individuell kontakt eller bedrift.
Assosiasjoner: alle tilgjengelige assosiasjonstyper og for øyeblikket assosierte poster.
Hendelser: hendelsesdata for både standard HubSpot-hendelser, for eksempel åpning av e-post, og tilpassede atferdshendelser.
Segmenter: HubSpot-kontakt- og bedriftssegmenter.
Eiere: brukere i HubSpot-kontoen din, i forhold til postene de er angitt som eiere av.
Pipelines: avtale-og billettpipelines, inkludert pipeline-stadier.
Egenskaper: egenskaper og verdiene deres på CRM-poster, inkludert egenskapshistorikk.

Lær mer om HubSpots CRM-datamodell.

Merk Etter hvert som vi utvikler datadelingen, vil vi innføre endringer, hvorav noen vil være vesentlige. Vi anbefaler på det sterkeste å abonnere på HubSpots endringslogg for utviklere. Disse endringene vil alltid bli lagt ut i endringsloggen før oppdateringen.

Begrense og sortere returnerte data

Når du konstruerer spørsmål, kan du kontrollere hvor mye data som returneres, samt rekkefølgen de returneres i, ved å inkludereLIMIT og ORDER BY i spørsmålet. Hvis du for eksempel vil spørre om alle kontakter med deres egenskaper, men bare returnere tre resultater og sortere dem etter kontakt-ID, kan du konstruere spørsmålet slik:

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

Kolonnedatatyper

Når du spørrer om data i Snowflake, avhenger kolonnene som returneres av dataene du spør om. 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

For å returnere en bestemt kolonne, inkluderer du den kolonnen i SELECT-feltet i spørringen. For eksempel vil følgende spørring 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 enkelte 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 tilpasset objekt i kontoen din. I segmenter refererer dette til segmenttypen (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 post av en gitt objekttype i HubSpot-kontoen din. For å identifisere en post må du bruke både objekttype-ID og objekt-ID.
INGESTEDAT: tidsstempelet for når en datarad ble lagt til Snowflake, representert av en TIMESTAMP_NTZ-verdi. Ikke relatert til det logiske tidsstempelet for en opprettelses- eller oppdateringsoperasjon i HubSpot.
- På grunn av HubSpots interne behandling kan en rads inntakstidsstempel oppdateres selv om ingen andre kolonner i raden har endret seg.
- Når du bygger ETL-prosesser som kopierer nylig endrede data, anbefales det å basere spørsmålene dine på tidsstemplet for innlesing. I tillegg, hvis flyten din kopierer data daglig, anbefales det å kopiere data fra de to foregående dagene for å ta hensyn til forsinkelser.
CREATEDAT og UPDATEDAT: den logiske tidsstemplingen for når data ble opprettet eller oppdatert i HubSpot, representert av en TIMESTAMP_NTZ-verdi . Disse tidsstemplingene vil samsvare med tidsstemplingene i HubSpot. For eksempel vil tiden som vises i HubSpot for opprettelsesdatoen til en post være den samme som tidsstemplet i CREATEDAT-kol onnen i Snowflake. Disse er ikke direkte relatert til tidsstemplet for innlesing, og det anbefales ikke å basere ETL-prosesser på disse egenskapene.
COMBINEDASSOCIATIONTYPE: en VARCHAR -verdi som entydig identifiserer en tilknytningsdefinisjon.

Transformere datatyper

Noen ganger returneres data fra en spørring med VARCHAR-kolonner, mens 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:
try_to_number, try_to_timestamp_ntz kan brukes til å konvertere disse VARCHAR-dataene til henholdsvis NUMBER - og DATETIME -typer:

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

Objektforespørsler

Nedenfor kan du lære hvordan du spørrer data fra spesifikke HubSpot-objekter og -poster, sammen med dataene som returneres.

Objektdata av forskjellige typer er organisert og tilgjengelig på to måter:

Individuell:Hver objekttype lagres i sin egen visning og inneholder kun poster av samme objekttype, f.eks. inneholder objects_contacts kun kontaktposter. Dette eliminerer behovet for å spesifisere en objecttypeid ved søk. Disse visningene er enklere å søke i, siden du ikke trenger å kjenne ObjectTypeIds. De returnerer også data i et mer brukbart format, hvor hver rad tilsvarer et objekt og den gjeldende versjonen av dets egenskaper. Så lenge du ikke opplever langsomme søk, er det lurt å bruke disse visningene til å hente objektdata. Se mer i Objects_X-visninger nedenfor.
Kombinert: Alle poster for alle objekttyper kombineres i ett databaseobjekt. Når du søker, må du derfor spesifisere et filter som «WHERE objectTypeId=’0-1’. Du kan for eksempel bruke følgende objecttypeids når du søker:

Objektnavn	Objekttype-ID
Kontakter	0-1
Bedrifter	0-2
Linjeposter	0-8

Tilpassede objekter tildeles en ID når de opprettes, og identifiseres som2-unique_ID. For eksempel2-12345. Les mer om object_and_event_type_definitions.

Disse databaseobjektene er generelt egnet hvis du ønsker bedre spørringsytelse enn det som er mulig å oppnå fra objects_x-visninger. Se flere detaljer i object_with_object_properties, object_properties, objects og object_properties_history nedenfor.

objects_x-visninger

I dette databaseobjektet har hver tilgjengelig objekttype, inkludert tilpassede objekter, sin egen spesifikke visning, hvor hver visning bare inneholder poster for objekter av den spesifikke objekttypen. Disse visningene er navngitt etter formatet OBJECTS_<objekttypenavn>, der <objekttypenavn> er flertallsformen av objekttypen. (Merk at hvis objekttypen ikke har noen flertallsform, vil <objekttypenavn> ganske enkelt være entallsformen av objekttypenavnet sammenkoblet med «S»).

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

Se nedenfor for en omfattende liste over tilgjengelige HubSpot-objekttyper (dvs. ikke-tilpassede), en kort beskrivelse av dataene de representerer og tilhørende visninger:

HubSpot Objekttype	ObjektTypeId	Beskrivelse
KONTAKT	0-1	Informasjon om personer som har kontakt med virksomheten din
SELSKAP	0	Informasjon om enkeltbedrifter eller organisasjoner
AVTALE	0-3	Detaljer om inntektsmuligheter med en kontaktperson eller et selskap
ENGASJEMENT	0-4	Lagrer data fra CRM-handlinger, inkludert notater, oppgaver, e-poster, møter og samtaler
BILLETT	0-5	Representerer kundeforespørsler om hjelp eller støtte
TILBUD	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 undergruppe av produkter som selges i en avtale. Når et produkt knyttes til en avtale, blir det en linjepost.
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 lead-informasjon om besøkende og kontakter
MARKETING_EMAIL	0-29	Detaljer om e-poster fra markedsføringssenteret
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 innenfor 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 dine samlede markedsføringstiltak.
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	Anrop fra andre CRM-poster, f.eks. kontakter
INVOICE	0	Administrer og synkroniser fakturaer med eksterne regnskapssystemer
MEDIA_BRIDGE	0	Informasjon om medieelementer importert til Hubspot
SEKVENS	0-58	En sekvens er en serie målrettede, tidsbestemte e-postmaler for å pleie kontakter over tid.
MAL	0-62	Lagret e-postinnhold som kan gjenbrukes til å sende e-post.
DEAL_SPLIT	0-72	Deal splits brukes til å dele avtalekreditt mellom flere brukere
SALES_DOCUMENT	0-83	Salgsdokumenter bygger opp et bibliotek med innhold som hele teamet ditt kan laste opp og dele med kontaktene dine
FEEDBACK_SUBMISSION	0-19	Lagrer informasjon som er sendt inn til en tilbakemeldingsundersøkelse.
SUBSCRIPTION	0-69	Abonnementer inneholder detaljer om gjentatte betalinger.
HANDEL BETALING	0	Inneholder data om midler som er innkrevd fra kunder

Hvert databaseobjekt vil returnere følgende kolonner:

Kolonnenavn
OBJECTTYPEID	Varchar	ID-en til objekttypen (f.eks. kontakter er 0-1).
OBJECTID	Tall	ID-en til posten (f.eks. en kontaktpost med ID 123752).
UPDATEDAT	Tidsstempel	Dato og klokkeslett for når dette objektet sist ble oppdatert i HubSpot.
INGESTEDAT	Tidsstempel	Dato og klokkeslett for når dataene sist ble importert av Snowflake.
PROPERTY_*	Varchar	Individuelle kolonner som inneholder den nyeste versjonen av objektets egenskaper. For hver objektegenskap som har en dato- eller talltype (som angitt 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-objektets egenskap 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-objektets egenskap deal_amount ha kolonnen property_deal_amount. Merk at denne kolonnen vil inneholde null hvis konverteringen til den opprinnelige typen mislykkes på grunn av ugyldige data.

Eksempel 1

Hent fornavn, etternavn og livssyklusfase for alle kontakter.

Spørring:

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

Returnerer:

OBJECTID	FIRSTNAME	LASTNAME	LIFECYCLESTAGE
54325098	Hobbes	Baron	bly
96805401	Milo	Gull	bly
6922028	Henry	Riley	bly

Eksempel 2

Hent navnet og fasen på opptil tre avtaler.

Spørring:

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

Returnerer:

OBJECTID	PROPERTY_DEALNAME	PROPERTY_DEALSTAGE	EIENDOMSFORHANDLINGSBELØP
38960439	Avtalenavn 1	avsluttetvunnet	34199
321740651	Testavtale 123	14845019	8383663
98392101	Pop-up-telt	closedwon	9309007

Eksempel 3

Hent navnet og fasen på de tre største avtalene etter beløp.

Spørring:

Siden data om avtaleverdi er tilgjengelig som talltype, kan den brukes til sortering uten at det er nødvendig å konvertere eller omforme den.

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

Returnerer:

OBJECTID	PROPERTY_DEALNAME	PROPERTY_DEALSTAGE	EIENDOMSFORRETNINGSBELØP
98392101	Pop-up-telt	closedwon	9309007
321740651	Testavtale 123	14845019	8383663
38960439	Avtalenavn 1	avsluttetvunnet	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 objekttypen kontakter). Alle egenskaper lagres i kolonnen Properties, som er en Snowflake Variant / JSON-kolonne.

Denne visningen kan returnere følgende kolonner:

Kolonnenavn	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`).
`EGENSKAPER`	Variant	Postens egenskapsverdier.
`OPPDATERINGS`	Tidsstempel	Dato og klokkeslett for når posten sist ble oppdatert i HubSpot. Lær mer om kolonnedatatyper.
`INGESTEDAT`	Tidsstempel	Dato og klokkeslett for når dataene ble sist importert av Snowflake.

Merk 25. januar 2022 vil kolonnen timestamp i tabellen og visningen object_with_object_properties, som representerer datoen og klokkeslettet da objektposten sist ble oppdatert i HubSpot, bli oppdatert. Dette er for å samsvare med hvordan datetime-data representeres i resten av datadelingen.

Siden dette er en vesentlig endring, er den nye kolonnen updatedat lagt til i tabellen og visningen. I løpet av de neste 90 dagene vil disse to nye kolonnene eksistere side om side med timestamp, kolonnene de skal erstatte. Dette gir deg muligheten til å bytte til å bruke de nye kolonnene.

Etter 90 dager, 25. januar 2022, vil kolonnen timestamp bli fjernet fra tabellen og visningen. Etter denne datoen vil alle forsøk på å spørre tabellen eller visningen object_with_object_properties ved hjelp av timestamp-kolonner mislykkes.

Eksempel 1

Hent alle kontakter og deres egenskaper.

Spørring:

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

Returnerer:

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

Eksempel 2

Hent navnet og fasen på opptil tre avtaler.

Spørsmål:

SELECT
objectId,
egenskaper:dealname::string AS dealname,
egenskaper:avtalestadium::streng AS avtalestadium,
egenskaper:beløp::tall AS avtale beløp
FRA objekt_med_objekt_egenskaper
WHERE objektTypeId = '0-3'
BEGRENSE 3;

Returnerer:

OBJECTID	DEALNAME	AVTALESTADIE	DEALAMOUNT
38960439	Avtalenavn 1	avsluttet tapt	7488939
321740651	Avtalenavn 1	lukketvunnet	9292029
98392101	Avtalenavn 1	lukket tapt	62626528

objekter

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

Dette databaseobjektet kan være nyttig hvis kontoen din har store datamengder, noe som fører til at visningene object_with_object_properties og objects_x fungerer tregt. Ved å bruke dette databaseobjektet sammen med databaseobjektet object_properties er det mulig å replikere dataene i object_with_object_properties, samtidig som du 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`	Tall	ID-en til posten (f.eks. en kontaktpost med ID `123752`).
`INGESTEDAT`	Tidsstempel	Dato og klokkeslett for når dataene sist ble importert av Snowflake. Les mer om kolonnedatatyper.

Eksempel 1

Hent alle kontaktposter.

Spørring:

VELG objectTypeId, objectId
FRA objekter
Hvor objektTypeId = '0-1'

Returnerer:

OBJECTTYPEID	OBJECTID
0	36721864
0	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 for en gitt post. For eksempel vil en kontakt ha én rad for egenskapen Fornavn og én rad for egenskapenEtternavn. 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:

Kolonnenavn	Type	Beskrivelse
`OBJECTTYPEID`	Varchar	ID-en til objekttypen (f.eks. kontakter er `0-1`).
`OBJECTID`	Tall	ID-en til posten (f.eks. en kontaktpost med ID `123752`).
`NAME`	Varchar	Navnet på eiendommen.
`VERDI`	Tidsstempel	Verdien av egenskapen.
`OPPDATERINGS`	Tidsstempel	Dato og klokkeslett for når posten sist ble oppdatert i HubSpot. Lær mer om kolonnedatatyper.
`INGESTEDAT`	Tidsstempel	Dato og klokkeslett for når dataene ble sist importert av Snowflake.

Eksempel 1

Hent egenskapene fornavn, etternavn og by for alle kontakter.

Spørring:

VELG objectTypeId, objectId, navn, verdi
FRA object_properties
WHERE objektTypeId = '0-1'
OG navn I ('fornavn', 'etternavn', 'by')
ORDER BY objectId;

Returnerer:

OBJECTTYPEID	OBJECTID	NAME	VERDI
0	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 livssyklusfase for alle kontakter, og kombiner dem i én rad per kontakt. Dette eksemplet bruker SQL PIVOT-syntaksen.

Spørring:

VELG objectId, fornavn, etternavn, livssyklusfase
FRA
(
VELG objectId, navn, verdi
FROM objekt_egenskaper
WHERE objektTypeId = '0-1'
OG navn I ('fornavn', 'etternavn', 'livssyklusfase')
)
PIVOT(MAX(verdi) FOR navn IN ('fornavn', 'etternavn', 'livssyklusfase')) AS p(objektId, fornavn, etternavn, livssyklusfase);

Returnerer:

OBJECTTYPEID	OBJECTID	FORNAVN	ETTERNAVN	LIVSSYKLUSFASE
0-1	54325098	Hobbes	Baron	bly
0-1	96805401	Milo	Gull	ledelse
0-1	6922028	Henry	Riley	ledelse
...	...	...	...	...

object_properties_history

Dette databaseobjektet inneholder historiske egenskapsverdier. For kontakter inneholder det de 45 siste verdiene. For alle andre objekter inneholder det de 20 siste verdiene. Viser en rad for hver historisk egenskapsverdi. Den gjeldende verdien for en egenskap bestemmes av den siste UPDATEDAT-tidsstemplingeni 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`	Tall	ID-en til posten (f.eks. en kontaktpost med ID `123752`).
`NAME`	Varchar	Navnet på eiendommen.
`VERDI`	Tidsstempel	Verdien av egenskapen.
`OPPDATERINGS DATO`	Tidsstempel	Dato og klokkeslett for når dataene sist ble oppdatert i HubSpot. Lær mer om kolonnedatatyper.
`INGESTEDAT`	Tidsstempel	Dato og klokkeslett for når dataene sist ble innhentet av Snowflake.

Eksempel 1

Hent historikken til en enkelt egenskap for en enkelt kontakt.

Spørring:

VELG objectId, navn, verdi, oppdatert
FROM objekt_egenskaper_historikk
WHERE objektTypeId = '0-1'
OG objectId = 136493192
OG navn = 'hs_predictivescoringtier'
ORDER BY UPDATEDAT DESC;

Returnerer:

OBJECTID	NAME	VERDI	OPPDATERINGS
136493192	hs_predictivescoringtier	tier_1	2022-06-22 22:45:05.931
136493192	hs_predictivescoringtier	tier_2	2021-09-18 08:20:56.622
136493192	hs_predictivescoringtier	tier_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,
egenskaper:fornavn::streng AS fornavn,
egenskaper:etternavn::streng AS etternavn
FROM objekt_med_objekt_egenskaper
WHERE objekt_med_objekt_egenskaper.objektTypeId = '0-1'
OG objectId I (
VELG objektId
FRA objekt_egenskaper_historikk
WHEREobjekt_egenskaper_historikk.objektTypeId = '0-1'
OG object_properties_history.name = 'livssyklusfase'
OG object_properties_history.value = 'abonnent'
);

Returnerer:

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

Assosiasjonsspørsmål

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

Individuell: Hver assosiasjonstype lagres i sin egen visning og inneholder kun poster av den typen. For eksempel inneholder associations_contacts_to_deals kun assosiasjonsposter mellom kontakt- og avtaleobjekter. Dette eliminerer behovet for å spesifisere en associationtypeid under spørringen. Disse visningene er ganske enkle å spørre, siden de ikke krever kjennskap til CRM-datamodellen for å kunne brukes. De returnerer også en utvidet beskrivelse av assosiasjonsposten mellom to objekter, som enkelt kan brukes i sammenføyninger med objects_x-visninger. Så lenge du ikke opplever langsomme søk, anbefales det å bruke disse visningene til å hente assosiasjonsdata. Se mer i associations_x_to_y-visninger nedenfor.
Kombinert: Alle poster for alle assosiasjonstyper kombineres i ett databaseobjekt. Når du søker, må du derfor spesifisere et filter som «WHERE combinedassociationtypeid=’0-32’ ». Se mer i associations og association_definitions nedenfor.

associations_x_to_y-visninger

Hver assosiasjonstype har sin egen visning, merket som associations_<assosiasjonstypenavn>, f.eks. associations_contacts_to_deals. Hver visning er en delmengde av dataene i assosiasjonsdatabaseobjektet og inneholder bare poster med en spesifikk combinedassociationtypeid.

Hvert databaseobjekt vil returnere 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	Objekttype-ID-en som er kilden til assosiasjonsdefinisjonen.
FROMOBJECTTYPE	Varchar	Navnet på objektetypen som er kilden til assosiasjonsdefinisjonen.
TOOBJECTTYPEID	Varchar	Objekttype-ID-en som er målet for assosiasjonsdefinisjonen.
TOOBJECTTYPE	Varchar	Navnet på objektetypen som er destinasjonen for tilknytningsdefinisjonen.
NAME	Varchar	Navnet på assosiasjonsdefinisjonen.
LABEL	Varchar	Beskrivelsen av tilknytningsdefinisjonen.
ISMAINASSOCIATIONDEFINITION	Boolean	Om assosiasjonsdefinisjonen er hovedtypen. Når dette er sant, er definisjonen den som HubSpot viser på tilknyttede poster
[FROMOBJECTTYPE_OBJECTID] f.eks. for visningen ASSOCIATIONS_CONTACTS_TO_DEALS vil dette være CONTACT_OBJECTID	Tall	Objekt-ID for kildeobjektet.
[TOOBJECTTYPE_OBJECTID] For eksempel for visningen ASSOCIATIONS_CONTACTS_TO_DEALS vil dette være DEAL_OBJECTID.	Nummer	Objekt-ID for destinasjonsobjektet.
INGESTEDAT	Tidsstempel	Dato og klokkeslett for når dataene sist ble importert av Snowflake.

Eksempel 1

Hent alle avtaler knyttet til en bestemt kontakt.

Spørring:

SELECT
contact_objectId, deal_objectId

FROM associations_contacts_to_deals

WHERE contactId = 6626541373

Returnerer:

CONTACT_OBJECTID	DEAL_OBJECTID
6626541373	233620335
6626541373	90253678

Eksempel 2

Henter alle kontakter basert i tidssonen Bogota og deres avtaler.

SELECT contacts.property_firstname contact_firstname,

kontakter.eiendom_etternavn kontakt_etternavn,
kontakter.eiendom_e-post kontakt_e-post,
avtaler.eiendom_avtaletype avtaletype, avtaler.eiendom_beløp avtalebeløp
FRA objekter_kontakter kontakter
JOIN assosiasjoner_kontakter_til_avtaler assoc på
assoc.kontakt_objektid=kontakter.objektid
JOIN objekter_avtaler avtaler på avtaler.objektid=assoc.avtale_objektid
hvor contacts.property_hs_timezone='america_slash_bogota'

CONTACT_FIRSTNAME	KONTAKT_ETTERNAVN	KONTAKT_EMAIL	AVTALETYPE	AVTALEBELØP
David	Magalhães	dmagalhaes@example.com	nyvirksomhet	74848
Fernanda	Rodrigues	fmoreira@example.com	nyvirksomhet	253530

Eksempel 3

Hent alle kontakter og den totale summen av avtalte beløp for hver kontakt.

VELG SUM(avtaler.eiendom_hs_avsluttet_beløp) SOM
total_closed_amount, contacts.property_email contact_email
FRA objekter_kontakter kontakter
JOIN associations_contacts_to_deals assoc på
assoc.kontakt_objektid=kontakter.objektid
JOIN objekter_avtaler avtaler på avtaler.objektid=assoc.avtale_objektid
GRUPPER ETTER kontakt_e-post
ORDER BY total_closed_amount DESC

Returnerer:

TOTAL_CLOSED_AMOUNT	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 til assosiasjonsdatabaseobjektet for å få opptaksspesifikk 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 sann.

Dette databaseobjektet kan returnere følgende kolonner:

Kolonnenavn	Type	Beskrivelse
`COMBINEDASSOCIATIONTYPEID`	Varchar	Den unike identifikatoren for assosiasjonsdefinisjonen.
`KATEGORI`	Varchar	Kilden til assosiasjonstypen. En av følgende: `HUBSPOT_DEFINED`, `USER_DEFINED`, `INTEGRATOR_DEFINED`
`ID`	Tall	Identifikatoren for tilknytningsdefinisjonen 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å tilknytningsdefinisjonen.
`LABEL`	Varchar	Etiketten til assosiasjonsdefinisjonen.
`ISMAINASSOCIATIONDEFINITION`	Boolsk	Om assosiasjonsdefinisjonen er hovedtypen. Når dette er sant, er definisjonen den som HubSpot viser på tilknyttede poster.
`INGESTEDAT`	Tids	Dato og klokkeslett for når dataene sist ble importert av Snowflake. Lær mer om kolonnedatatyper.

Eksempel 1

Hent typene assosiasjoner som er tilgjengelige i kontoen din.

Spørring:

VELG combinedAssociationTypeId, fromObjectTypeId, toObjectTypeId, navn
FROM assosiasjonsdefinisjoner
ORDER BY kategori, id

Returnerer:

COMBINEDASSOCIATIONTYPE	FROMOBJECTTYPEID	TOOBJECTTYPEID	NAME
0	0	0-2	KONTAKT_TIL_SELSKAP
0-2	0-2	0-1	SELSKAP_TIL_KONTAKT
0-3	0-3	0-1	AVTALE_Å_KONTAKTE
0-4	0-1	0-3	KONTAKT_TIL_AVTALE
0-5	0-3	0-2	AVTALE_MED_SELSKAP
...	...	...	...

Eksempel 2

Hent tilgjengelige assosiasjonstyper mellom avtaler og selskaper.

Spørsmål:

VELGkombinertAssosiasjonstypeId, fraObjekttypeId, tilObjekttypeId, navn
FRA association_definitions
WHERE fraObjekttypeId = '0-3' OG tilObjekttypeId = '0-2' OG isMainAssociationDefinition = true
ORDER BY kategori, id

Returnerer:

KOMBINERT ASSOSIASJONSTYPE	FRAOBJEKTTYPEID	TILOBJEKTTYPEID	NAME
0-5	0	0-2	AVTALE_MED_SELSKAP
0-271	0-3	0-2	AVTALE_MED_PRIMÆRT_SELSKAP
0-341	0-3	0-2	AVTALE_TIL_SELSKAP_UTEN_ETIKETT

tilknytninger

Dette databaseobjektet inneholder informasjon om tilknytningene mellom bestemte poster. Hver rad representerer en tilknytning fra ett objekt til et annet objekt. Det kan være rader i dette databaseobjektet selv om de refererte postene er slettet. Du kan sjekke om postene eksisterer ved å koble til objekttabellen.

Dette databaseobjektet kan være nyttig hvis kontoen din har store datamengder, noe som fører til at associations_x_to_y-visninger kjører sakte.

Dette databaseobjektet kan returnere følgende kolonner:

Kolonnenavn	Type	Beskrivelse
`COMBINEDASSOCIATIONTYPEID`	Varchar	Den unike identifikatoren for assosiasjonsdefinisjonen.
`FROMOBJECTID`	Tall	ID-en til kildeobjektet.
`TOOBJECTID`	Tall	ID-en til destinasjonsobjektet.
`INGESTEDAT`	Tidsstempel	Dato og klokkeslett for når dataene sist ble importert av Snowflake. Les mer om kolonnedatatyper.

Eksempel 1

Hent alle tilknyttede avtaler og kontakter.

Spørring:

VELG kombinertAssosiasjonstypeId, fraObjektId, tilObjektId
FRA assosiasjoner
WHERE kombinertAssosiasjonstypeId = '0-5'

Returnerer:

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

Eksempel 2

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

Spørring:

VELG kombinertAssosiasjonstypeId, fraObjektId, tilObjektId
FRA tilknytninger
WHERE assosiasjonskategori = 'HUBSPOT_DEFINED'
OG combinedAssociationTypeId = '0-15'
OG fraObjektId = 3005;

Returnerer:

KOMBINERT ASSOSIASJONSTYPE	FRAOBJEKTID	TILOBJEKTID
0-5	6626541373	233620335

Eksempel 3

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

Spørring:

VELG combinedAssociationTypeId, fromObjectId toObjectId,
FRA tilknytninger
WHERE
kombinertAssosiasjonstypeId = (
SELECT kombinertAssosiasjonstypeId
FRA assosiasjonsdefinisjoner
WHERE fraObjekttypeId = '0-1'
OG tilObjekttypeId = '0-3'
OG isMainAssociationDefinition)
OG fraObjektId = 4464;

Returnerer:

KOMBINERT ASSOSIASJONSTYPEID	FROMOBJECTID	TILOBJEKTID
0-5	6626541373	233620335

Eierforespørsler

eiere

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

Dette databaseobjektet kan returnere følgende kolonner:

Kolonnenavn	Type	Beskrivelse
`EIERID`	Nummer	Brukerens eier-ID.
`USERID`	Nummer	Brukerens bruker-ID. Brukere med NULL i denne kolonnen er slettet.
`EMAIL`	Varchar	Brukerens e-postadresse.
`FORNAVN`	Varchar	Brukerens fornavn.
`ETTERNAVN`	Varchar	Brukers etternavn.
`ARKIVERT`	Boolean	Om brukeren er slettet.
`CREATEDAT`	Tidsstempel	Dato og klokkeslett da brukeren ble opprettet i HubSpot. Se kolonnedatatyper for mer informasjon.
`OPPDATERINGSDATO`	Tidsstempel	Dato og klokkeslett da brukeren sist ble oppdatert i HubSpot. Se kolonnedatatyper for mer informasjon.
`INGESTEDAT`	Tidsstempel	Dato og klokkeslett for når dataene sist ble importert av Snowflake.

Eksempel 1

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

Spørring:

VELG eier-ID, bruker-ID, e-postadresse, fornavn, etternavn FRA eiere WHERE arkivert = falsk

Returnerer:

OWNERID	USERID	EMAIL	FORNAVN	ETTERNAVN
29584574	4621126	233620335	Hobbes	Baron
30532717	4874784	3866015468	Pablo	Walters
30580321	925511	7132752747	Milo	Gull
...	...	...	...	...

Eksempel 2

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

Spørsmål:

VELG eier-ID, bruker-ID, e-post, fornavn, etternavn
FRA eiere
WHERE eier-ID = 29584574;

Returnerer:

EIERID	BRUKERID	EMAIL	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 kontakt-egenskapen hubspot_owner_id.

SELECT kontakt.objektId kontaktid, kontakt.egenskap_fornavn kontakt_fornavn, kontakt.egenskap_etternavn kontakt_etternavn, kontakt.eiendom_hubspot_eier_id kontakt_hubspot_eier_id, eier.fornavn eier_fornavn, eier.etternavn eier_etternavn, eier.e-post eier_e-post FROM objekter_kontakter kontakt

JOIN eiere eier PÅ kontakt.property_hubspot_owner_id = eier.ownerId

Returnerer:

CONTACTID	CONTACT_FIRSTNAME	CONTACT_LASTNAME	CONTACT_HUBSPOT_OWNER_ID	EIER_FORNAVN	EIER_ETTERNAVN	EIER_EMAIL
113834202	Richard	Greenfield	29584574	Hobbes	Baron	hobbes.b@business.com
53540801	Ford	Karl	30241125	Milo	Gull	milo.g@business.com
...	...	...	...	...	...	...

Teamspørsmål

team

Team i HubSpot lar deg 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:

Kolonnenavn	Type	Beskrivelse
TEAMID	Nummer	Team-ID.
TEAMNAME	Varchar	Lagets navn.
PARENTTEAMID	Nummer	Team-ID-en til det overordnede teamet.
CHILDTEAMIDS	Array	Team-ID-ene til underordnede team.
PRIMARYOWNERMEMBERS	Varchar	Eier-ID-ene til teamets primære medlemmer.
SECONDARYOWNERMEMBERS	Boolean	Eier-ID-ene til teamets sekundære medlemmer.
INGESTEDAT	Tidsstempel	Dato og klokkeslett for når dataene sist ble importert av Snowflake.

Eksempel 1

Hent alle team.

Spørring:

VELG teamId,teamName, primaryOwnerMembers

FRA lag

Returnerer:

TEAMID	TEAMNAME	PRIMÆREIERE
29584574	Underteam	[233620335, 1234553]
30532717	Superteam	[3866015468, 126221873]
3058032	A-laget	[7132752747]

owner_team

Dette databaseobjektet inneholder informasjon om hvilke eiere som tilhører hvilke lag i HubSpot-kontoen din.

Dette databaseobjektet kan returnere følgende kolonner:

Kolonnenavn	Type	Beskrivelse
TEAMID	Nummer	Team-ID.
OWNERID	Nummer	Brukerens eier-ID.
ISTEAMPRIMARY	Boolsk	Om dette teamet er det primære teamet for denne eieren.
INGESTEDAT	Tidsstempel	Dato og klokkeslett for når dataene sist ble importert av Snowflake.

Eksempel 1

Hent alle eiere for et gitt team.

Spørring:

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

Returnerer

TEAMID	TEAMNAME	ISTEAMPRIMARY
29584574	233620335	TRUE
29584574	1234553	SANT

Pipeline-spørsmål

Nedenfor kan du lære hvordan du spør avtale- og billettpipeline-data, for eksempel tilgjengelige pipeline-prosesser i kontoen din og deres stadier.

Du kan koble disse dataene til objektdata for å få en fullstendig oversikt over pipelineene dine. Du kan for eksempel forespørre om avtaler og deres pipeline ved å koble dataene objects_deals_view eller object_with_object_properties til pipeline-dataene.

rørledninger

Dette databaseobjektet inneholder informasjon om avtale- og billettpipelines i kontoen din. Hver returnerte rad representerer en enkelt pipeline.

Denne tabellen kan returnere følgende kolonner:

Kolonnenavn	Type	Beskrivelse
`PIPELINEID`	Varchar	Pipelineens ID.
`OBJECTTYPEID`	Varchar	ID-en til objektet som rørledningen kan inneholde (f.eks. avtaler eller billetter).
`LABEL`	Varchar	Navnet på pipelinen i HubSpot.
`DISPLAYORDER`	Tall	Rekkefølgen rørledningen vises i HubSpot.
`ARKIVERT`	Boolsk	Om pipelinen er slettet.
`CREATEDAT`	Tidsstempel	Når rørledningen ble opprettet.
`UPDATEDAT`	Tidsstempel	Dato og klokkeslett for når dataene sist ble oppdatert i HubSpot. Lær mer om kolonnedatatyper.
`INGESTEDAT`	Tidsstempel	Dato og klokkeslett for når dataene sist ble innhentet av Snowflake.

Eksempel 1

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

Spørring:

VELG objektTypeId, pipelineId, etikett
FRA rørledninger
WHERE objektTypeId = '0-3'OG ikke arkivert
ORDER BY displayorder;

Returnerer:

OBJECTTYPEID	PIPELINEID	LABEL
0-3	1bed503c-37f7-4f51-9d40-7598902673f4	Salgspipeline
0-3	12659678	Lisenspipeline
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.

Spørring:

VELG

avtaler.objektId avtale_id, avtaler.eiendom_avtalenavn avtalenavn, pipelines.label pipeline_name FROM objekter_avtaler avtaler INNER JOIN rørledninger ON deals.objectTypeId = pipelines.objectTypeId OG deals.property_pipeline = pipelines.pipelineid WHERE rørledninger.objekttypeId = '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 bestemt pipeline. Men i stedet for å bruke objects_deals i sammenføyninger, bruk object_with_object_properties.

SELECT avtaler.objektId avtale_id, avtaler.egenskaper:avtalenavn::varchar avtalenavn, rørledninger.etikett rørledningsnavn FROM objekt_med_objekt_egenskaper avtaler INNER JOIN rørledninger ON deals.objectTypeId = pipelines.objectTypeId OG deals.properties:pipeline::string = pipelines.pipelineid WHERE avtaler.objekttypeId = '0-3' OG pipelines.objekttypeId = '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 stadier ved å kombinere objekttype-ID, pipeline-ID og stadium-ID. Når du kobler til pipelines, bruk objekttype-ID og pipeline-ID.

Dette databaseobjektet kan returnere følgende kolonner:

Kolonnenavn	Type	Beskrivelse
`PIPELINEID`	Varchar	Pipelineens ID.
`STAGEID`	Varchar	Stadiets ID.
`LABEL`	Varchar	Scenenes navn i HubSpot.
`DISPLAYORDER`	Nummer	Rekkefølgen som pipelinen vises i HubSpot.
`METADATA`	Variant	En JSON-formatert beskrivelse av fasen, inkludert om den er åpen eller lukket.
`ARKIVERT`	Boolsk	Om pipeline-stadiet er slettet.
`CREATEDAT`	Tidsstempel	Når rørledningsfasen ble opprettet.

Eksempel 1

Hent rørledningsstadier for en avtale-rørledning med navnetSalgsrørledning.

Spørring:

VELG pipelineid, stageId, label
FRA pipeline_stages
WHERE ikke arkivert
OG pipelineid = (
VELG pipelineid
FRA rørledninger
WHERE objektTypeId = '0-3'
OG ikke arkivert
OG label = 'Salgspipeline' BEGRENSE 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 pipeline-stadier.

Spørsmål:

VELG
avtaler.objektId avtale_id,
avtaler.egenskaper:avtalenavn::varchar avtalenavn,
pipelines.label pipeline_name,
pipeline_stages.label pipeline_stage_name
FROM objekt_med_objekt_egenskaper avtaler
INNER JOIN rørledninger
ON deals.objectTypeId = pipelines.objectTypeId
OG deals.egenskaper:rørledning::streng = rørledninger.rørlednings-id
INNER JOIN pipeline_stages
ON deals.objectTypeId = pipeline_stages.pipelineid
OG deals.properties:pipeline::string = pipeline_stages.pipelineid
OG deals.properties:dealstage::string = pipeline_stages.stageId
WHERE deals.objecttypeId = '0-3';

Returnerer:

DEAL_ID	DEAL_NAME	PIPELINE_NAME	RØRLEDNINGSFASENAVN
605140072	Meowmix Global Registrering	Salgspipeline	Kontrakt sendt
605457408	Friskies Rebrand	Salgspipeline	Avtale planlagt
604362473	Fresh Step App-utvikling	Salgspipeline	Kontrakt signert
...	...	...	...

Eiendomssøk

property_definitions

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

Du kan identifisere spesifikke egenskaper ved å kombinere objektets type-ID og navn. Du kan hente lignende informasjon ved hjelp av egenskaps-API-en.

Dette databaseobjektet kan returnere følgende kolonner:

Kolonnenavn	Type	Beskrivelse
`OBJECTYPEID`	Varchar	ID-en til objektet som hendelsen er knyttet til.
`NAME`	Varchar	Eiendommens interne navn.
`LABEL`	Varchar	Eiendommens etikett.
`DESCRIPTION`	Varchar	Eiendommens beskrivelse.
`TYPE`	Varchar	Egenskapens type (f.eks. streng, tall, dato og klokkeslett).
`FIELDTYPE`	Varchar	Egenskapens felttype. Definerer hvordan egenskapen vises i HubSpot og på skjemaer (f.eks. avkryssingsrute, valg).
`DISPLAYORDER`	Tall	Eiendommens visningsrekkefølge.
`GROUPNAME`	Varchar	Eiendommens gruppenavn.
`OPTIONS`	Variant	For oppregningsegenskaper, en matrise med egenskapens alternativer, inkludert hvert alternativs attributter (f.eks. visningsrekkefølge, etikett).
`CREATEDUSERID`	Tall	ID-en til brukeren som opprettet egenskapen.
`REFERENCEDOBJECTTYPE`	Varchar	Typen av objekt som egenskapen refererer til. Eieregenskapene vil returnere verdien OWNER.
`CALCULATED`	Boolean	Om egenskapen er en beregnet egenskap.
`EXTERNALOPTIONS`	Bool	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.
`VISVALUTASYMBOL`	Boolsk	Om en tallverdi er formatert som 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 av en bruker.
`ARKIVERT`	Boolsk	Om egenskapen er slettet.
`CREATEDAT`	Tidsstempel	Dato og klokkeslett da eiendommen ble opprettet i HubSpot.
`OPPDATERET`	Tidsstempel	Dato og klokkeslett for når dataene sist ble oppdatert i HubSpot. Les mer om kolonnedatatyper.
`INGESTEDAT`	Tidsstempel	Dato og klokkeslett for når dataene sist ble innhentet av Snowflake.

Eksempel 1

Hent navnene og beskrivelsene for alle kontaktegenskaper.

Spørring:

VELG navn, etikett, beskrivelse
FRA property_definitions
WHERE objektTypeId = '0-1'

Returnerer:

NAME	LABEL	BESKRIVELSE
entered_sql_stage	Innført SQL-trinn	Start telling av SQL-trinnsdager.
first_conversion_event_name	Første konvertering	Det første skjemaet denne kontakten sendte inn.
adresse	Gateadresse	Kontaktens adresse.

Hendelsessøk

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

Navn
EVENTS_AD_INTERACTION	Detaljer om en annonse og kontakter som har interagert med den ved å klikke på annonsen eller sende inn et skjema etter å ha engasjert seg i den.
EVENTS_AD_METRICS_IMPORTED_V0	Detaljer om en annonse og dens ytelsesmålinger.
EVENTS_CALL_MENTIONED_KEYWORD	Detaljer om nøkkelord som er nevnt av deltakere i samtaler.
EVENTS_CLICKED_LINK_IN_EMAIL_V2	Lenker som er klikket på i markedsførings-e-poster av kontakter.
EVENTS_CLICKED_LINK_IN_TRACKED_INBOX_EMAIL_V8	Lenker som kontakter har klikket på i e-poster i Conversations Inbox.
EVENTS_COOKIE_BANNER_CLICKED	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 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 HubSpot-e-postserverne for å bli sendt.
EVENTS_MTA_DELIVERED_EMAIL_V2	E-poster som er levert til mottakerne av HubSpot-e-postserverne.
EVENTS_MTA_BOUNCED_EMAIL_V2	E-postleveringsforsøk som ble avvist av mottakerens e-postserver.
EVENTS_OPENED_EMAIL_V2	E-poster åpnet av kontakter.
EVENTS_REPORTED_SPAM_EMAIL_V2	E-poster merket som spam av mottakere.
EVENTS_UPDATED_EMAIL_SUBSCRIPTION_STATUS_V2	Endringer i e-postabonnementer fra mottakere.
EVENTS_OPENED_TRACKED_INBOX_EMAIL_V8	Konserveringer Innboks e-post åpnet av kontakter.
EVENTS_MB_MEDIA_PLAYED	Videoavspillingsaktivitet av kontakter.
EVENTS_V2_CONTACT_BOOKED_MEETING_THROUGH_SEQUENCE	Kontaktperson har booket et møte gjennom sekvens.
EVENTS_V2_CONTACT_ENROLLED_IN_SEQUENCE	Kontaktmelding registrert fra sekvens.
EVENTS_V2_CONTACT_FINISHED_SEQUENCE	Sekvensen er fullført.
EVENTS_V2_CONTACT_REPLIED_SEQUENCE_EMAIL	Kontakt svarte på e-post (eller innkommende e-post som avmeldte sekvensen) sendt gjennom sekvensen.
EVENTS_V2_CONTACT_UNENROLLED_FROM_SEQUENCE	Kontakt meldte seg av sekvensen.
EVENTS_V2_CONTACT_MANUELL_AVMELDING_FRA_SEKVENS	Brukeren meldte kontakten manuelt av.
EVENTS_V2_CONTACT_UNSUBSCRIBED_SEQUENCE_EMAIL	Kontakt har meldt seg av, og sekvensen er avmeldt.
EVENTS_V2_SEQUENCE_EMAIL_BOUNCED	Sekvens-e-post ble returnert.
EVENTS_V2_SEQUENCE_ERRORED	Sekvensfeil som førte til avmelding.
EVENTS_V2_SEQUENCE_STEP_EXECUTED	Sekvenssteg utført.
EVENTS_VISITED_PAGE	Besøk på nettstedssider av kontakter.
EVENTS_<INTEGRATION_EVENT_NAME>_<UNIQUE_IDENTIFIER>	Integreringshendelser (Timeline V3 API)

Du kan identifisere hendelser ved å kombinere hendelsestype-ID og ID. Kolonnene 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:

skjedde
skjedde på dato int

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

Kolonnenavn	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	Dette er unikt for hver hendelsestype. Ingen to poster vil ha samme ID innenfor en gitt hendelsestype.
`OBJECTTYPEID`	Varchar	Typen objekt som fullførte hendelsen. For eksempel vil et klikk på en e-postlenke vise`0-1` i denne kolonnen, som representerer kontaktobjektet.
`OBJECTID`	Tall	ID-en til posten som fullførte hendelsen.
`OCCURREDAT`	Tidsstempel	Når hendelsen skjedde.
`OCCURREDATDATEINT`	Nummer	Et tall som representerer når hendelsen skjedde. Inneholder de samme dataene som kolonnen `OCCURREDAT`, men formatert som et tall og brukt som en del av klyngenøkkelen til tabellen. I de fleste tilfeller kan du bruke tidsstemplet `OCCURREDAT` i stedet for dette tallet.
`OCCUREDATDATEINT`	Nummer	Et tall som angir når hendelsen skjedde. Inneholder de samme dataene som kolonnen `OCCURREDAT`, men formatert som et tall og brukt som en del av klyngenøkkelen til tabellen. I de fleste tilfeller kan du bruke tidsstemplet `OCCURREDAT` i stedet for dette tallet. Merk: denne kolonnen vil bli avviklet 24. november 2022 og erstattet med `OCCURREDATDATEINT`.
`OCCUREDAT`	Tidsstempel	Når hendelsen skjedde. Merk: denne kolonnen vil bli avviklet 24. november 2022 og erstattet med `OCCURREDAT`.
`INGESTEDAT`	Tidsstempel	Dato og klokkeslett for når dataene sist ble importert av Snowflake. Lær mer om kolonnedatatyper.
`PROPERTY_*`	Varchar	Individuelle kolonner som inneholder hendelsesegenskapene.

Eksempel 1

Hent de 50 siste e-postklikkhendelsene.

Spørring:

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	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	30.11.2017 14:27:11.528	https://hubs.ly/H097a37a?utm_source=hs_email&utm_medium=email&utm_content=58251290
...	...	...	...	...

Eksempel 2

Hent alle e-postklikkhendelser fra kontaktene som klikket. Denne spørringen henter kontaktdata ved å koble til object_with_object_properties.

Spørring:

SELECT klikk.oppstått klikk_tidsstempel, klikk.egenskap_hs_klikk_rå_url klikk_url, kontakt.egenskaper:fornavn::varchar kontakt_fornavn, kontakt.egenskaper:etternavn::varchar kontakt_etternavn FROM events_clicked_link_in_email_V2 klikk LEFT JOIN objekt_med_objekt_egenskaper kontakt ON klikk.objektTypeId = kontakt.objektTypeId OG klikk.objektId = kontakt.objektId BEGRENSE 3;

Returnerer:

CLICK_TIMESTAMP	KLIKK_URL	KONTAKT_FORNAVN	CONTACT_LASTNAME
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
08.11.2018 09:37:41.400	https://www.website.net/webinar-case-study?utm_source=hs_automation&utm_medium=email&utm_content=55200164	Milo	Gold
08.11.2018 09:37:41.426	https://www.website.net/contact?utm_source=hs_automation&utm_medium=email&utm_content=55200164	Harlow	Villari
...	...	...	...

Object_and_event_type_queries

object_and_event_type_definitions

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

Dette databaseobjektet kan returnere følgende kolonner:

Kolonnenavn	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	Dato og klokkeslett for når dataene sist ble importert av Snowflake. Les mer om kolonnedatatyper.

Eksempel 1

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

Spørring:

VELG objectTypeId, fullstendigNavn
FRA objekt_og_hendelsestypedefinisjoner;

Returnerer:

OBJECTTYPEID	FULLYQUALIFIEDNAME
0	CONTACT
0-8	LINE_ITEM
0-11	CONVERSATION
...	...

Segmenter spørsmål

Nedenfor kan du lære hvordan du kan søke i segmentene dine, for eksempel tilgjengelige kontakt- og bedriftssegmenter og oppføringene som inngår i disse segmentene.

segmenter

Dette databaseobjektet inneholder informasjon om HubSpot-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	Typen av poster i segmentet (f.eks. kontakt eller selskap).
`SEGMENTID`	Nummer	ID-en til segmentet. Kobles tilSEGMENTID -kolonnen i tabellen for segmentmedlemskap.
`CLASSICSEGMENTID`	Tall	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.
`STØRRELSE`	Tall	Antall poster i segmentet.
`CREATEDBYUSERID`	Tall	ID-en til brukeren som opprettet segmentet.
`CREATEDAT`	Tidsstempel	Når segmentet ble opprettet i HubSpot.
`OPPDATERT AV BRUKER-ID`	Nummer	ID-en til brukeren som sist oppdaterte segmentet.
`OPPDATERT`	Tidsstempel	Dato og klokkeslett for når datoen sist ble oppdatert i HubSpot. Lær mer om kolonnedatatyper.
`INGESTEDAT`	Tidsstempel	Dato og klokkeslett for når dataene sist ble importert av Snowflake.

Eksempel 1

Hent alle kontaktsegmenter.

Spørring:

VELG segmentId, navn, størrelse
FRA segmenter
WHERE objektTypeId = '0-1';

Returnerer:

SEGMENTSID	NAME	SIZE
118131	Ukentlig rekkevidde	103
66156	Blogg-abonnenter	455
771852	Toppabonnenter 2021	37
...	...	...

Eksempel 2

Hent et bestemt kontaktsegment med navnet Top subscribers 2021.

Spørsmål:

VELG segmentId, navn, størrelse
FRA segmenter
WHERE objektTypeId = '0-1' OGsegmentName = 'Toppabonnenter 2021';

Returnerer:

SEGMENTID	NAVN	STØRRELSE
771852	Toppabonnenter 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 segment med bloggabonnenter med 500 kontakter, vil databaseobjektet returnere 500 rader.

Inneholder kun segment-ID-er og objekt-ID-er. For mer informasjon, koble til segmentdatabaseobjektet.

Dette databaseobjektet kan returnere følgende kolonner:

Kolonnenavn	Type	Beskrivelse
`SEGMENTID`	Varchar	ID-en til segmentet. Kobles til kolonnen HS_SEGMENT_ID i segment tabellen.
`OBJECTID`	Varchar	ID-en til posten i segmentet.
`UPDATEDAT`	Tidsstempel	Dato og klokkeslett for når dataene sist ble oppdatert i HubSpot. Lær mer om kolonnedatatyper.
`INGESTEDAT`	Tidsstempel	Dato og klokkeslett for når dataene sist ble innhentet av Snowflake.

Eksempel 1

Hent ID-ene til alle kontakter i segmentetToppabonnenter 2021.

Spørring:

VELG objektId
FRA segmentmedlemskap
INNER JOIN segmenter
ON segmentmedlemskap.segmentId = segmenter.segmentId
WHERE segmenter.objekttypeId = '0-1'
OG segments.name = 'Toppabonnenter 2021';

Returnerer:

OBJECTID

54325098

96805401

6922028

...

Eksempel 2

Hent for- og etternavnene til kontaktene i segmentet Toppabonnenter 2021.

Spørsmål:

SELECT

kontakt.objektId AS objektid, kontakt.egenskap_fornavn AS fornavn, kontakt.egenskap_etternavn AS etternavn FROM objekter_kontakter kontakt INNER JOIN segmentmedlemskap ON kontakt.objektId = segmentmedlemskap.objektId INNER JOIN segmenter PÅ segmentmedlemskap.segmentId = segmenter.segmentId WHERE segmenter.objektTypeId = '0-1' OG segments.name = 'Toppabonnenter 2021'

Returnerer:

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

Ofte stilte

Jeg vil generere data som ligner på en rapport fra Hubspot-appen. Hvordan gjør jeg det?

Generelt sett bør du se på kolonnene i rapporten du sammenligner med. Hvis rapportvisualiseringen ikke er tabellformet, vil konvertering til tabell 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. Du kan gjøre dette ved å spørre property_definitions:

VELG * FRA eiendomsdefinisjoner

WHERE label = [column_name]

Det er ikke alltid det finnes en eksakt match, fordi noen egenskapsnavn vanligvis blir omgjort til et mer beskrivende navn i appen. I slike tilfeller kan det være nyttig å gjøre et fuzzy-søk ved hjelp av LIKE-operatoren på kolonnen label (eller til og med beskrivelsen) i property_definitions.

Etter å ha bestemt hvilken objekttype kolonnen tilhører, er det enkelt å bestemme hva du skal spørre om. 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 forskjellige poster til hverandre, kan du ta en titt på assosiasjoner. Assosiasjoner representerer relasjonene mellom objekter i HubSpot CRM. Alle forskjellige assosiasjoner som er mulige mellom to typer, er oppført i association_definitions. I eksemplet ovenfor må du spørre ASSOCIATIONS_CAMPAIGNS_TO_FORMS for å finne ut hvilke skjemaer en kampanje er koblet til:

VELG kampanjer.eiendom_hs_navn kampanje_navn, skjemaer.eiendom_hs_skjema_id skjema_id FROM objekter_kampanjer kampanjer JOIN tilknytninger_kampanjer_til_skjemaer assoc ON assoc.kampanje_objektid=kampanjer.objektid JOIN objekter_skjemaer skjemaer ON skjemaer.objektid=assoc.skjema_objektid GROUP BY kampanjens_navn

Hvordan finner jeg ut statusen for HubSpot-Snowflake-integrasjonen?

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

SELECT * FROM hubspot.public.data_share_status LIMIT 1

Resultatene vises som:

STATUS	MELDING	OPPDATERINGS
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 spore integrasjonens ytelse og oppdage eventuelle driftsavbrudd eller feil.

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-kontoens region

Konfigurer Snowflake-miljøet

Dataoversikt

Begrense og sortere returnerte data

Kolonnedatatyper

Transformere datatyper

Objektforespørsler

objects_x-visninger

Eksempel 1

Eksempel 2

Eksempel 3

objekt_med_objektegenskaper

Eksempel 1

Eksempel 2

objekter

Eksempel 1

object_properties

Eksempel 1

Eksempel 2

object_properties_history

Eksempel 1

Eksempel 2

Assosiasjonsspørsmål

associations_x_to_y-visninger

Eksempel 1

Eksempel 2

Eksempel 3

association_definitions

Eksempel 1

Eksempel 2

tilknytninger

Eksempel 1

Eksempel 2

Eksempel 3

Eierforespørsler

eiere

Eksempel 1

Eksempel 2

Eksempel 3

Teamspørsmål

team

Eksempel 1

owner_team

Eksempel 1

Pipeline-spørsmål

rørledninger

Eksempel 1

Eksempel 2

Eksempel 3

pipeline_stages

Eksempel 1

Eksempel 2

Eiendomssøk

property_definitions

Eksempel 1

Hendelsessøk

Eksempel 1

Eksempel 2

Object_and_event_type_queries

object_and_event_type_definitions

Eksempel 1

Segmenter spørsmål

segmenter

Eksempel 1

Eksempel 2

segment_membership

Eksempel 1

Eksempel 2

Ofte stilte

Jeg vil 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 finner jeg ut statusen for HubSpot-Snowflake-integrasjonen?

Relatert innhold