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.

Forespørsler om HubSpot-data i Snowflake

Sist oppdatert: april 9, 2024

Gjelder for:

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

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

Konfigurer Snowflake-miljøet ditt

For å søke i HubSpot-dataene dine i Snowflake må du velge lageret, databasen og skjemaet du ønsker å søke fra. Du kan enten angi dem på regnearknivå for å inkludere dem automatisk i spørringene dine, eller du kan legge dem til manuelt.

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

I den øverste raden i regnearket klikker du på linjen for regnearkhandlinger.
I popup-vinduet:
- Klikk på rullegardinmenyen Lager, og velg deretter lageret ditt.
- Klikk på rullegardinmenyen Database, og velg deretter HubSpot-databasen.
- Klikk på rullegardinmenyen Skjema, og velg deretter skjemaet du vil bruke:

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

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

SELECT objectTypeId, property_createddate
FROM hubspot_share_name.V2_LIVE.objects_deals

LIMIT 1

Oversikt over data

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

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

Lesmer om HubSpots CRM-datamodell.

Merk: Etter hvert som vi utvikler datadelingen, vil vi gjøre endringer, og noen av dem kan være ødeleggende.Vi anbefaler på det sterkeste at du abonnerer på HubSpots endringslogg for utviklere. Disse endringene vil alltid bli lagt ut i endringsloggen i forkant av en oppdatering.

Begrense og sortere returnerte data

Når du konstruerer spørringer, kan du kontrollere hvor mye data som returneres, samt rekkefølgen de returneres i, ved å inkludere LIMIT og ORDER BY i spørringen. Hvis du for eksempel vil søke etter alle kontakter med tilhørende egenskaper, men bare få 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 dataene 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 det gjelder både tabeller og visninger.

snowflake-sidebar-view-column-details0

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

SELECTobjectId, updatedAt
FROM objects_contacts

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

OBJECTTYPEID: en VARCHAR-verdi som representerer et objekts type. For eksempel representerer 0-1 kontaktobjektet, 0-2 representerer firmaobjektet, og 2-1232 kan representere et egendefinert objekt i kontoen din. I lister refererer dette til listetypen (f.eks. kontakt eller selskap). Du kan søke etter alle objekt- og hendelses-ID-er i kontoen din ved hjelp av visningen object_and_event_type_definitions.
OBJECTID: et BIGINT-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-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 opprettelses- eller oppdateringsoperasjon i HubSpot.
- På grunn av HubSpots interne behandling kan tidsstempelet for en rad bli oppdatert selv om ingen andre kolonner på raden er endret.
- Når du bygger ETL-prosesser som kopierer data som nylig er endret, anbefales det å basere spørringene på tidsstempelet for ingestion. Hvis flyten kopierer data daglig, anbefales det i tillegg å 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 samsvarer med tidsstemplene i HubSpot. Klokkeslettet som vises i HubSpot for en posts opprettelsesdato, vil for eksempel være det samme som tidsstempelet i CREATEDAT-kolonnen i Snowflake. Disse er ikke direkte relatert til tidsstempelet for inntak, og det anbefales ikke å basere ETL-prosesser på disse egenskapene.
COMBINEDASSOCIATIONTYPE: en VARCHAR-verdi som unikt identifiserer en assosiasjonsdefinisjon.

Transformasjon av datatyper

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

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

Objektforespørsler

Nedenfor kan du se hvordan du spør etter data fra spesifikke HubSpot-objekter og -oppføringer, 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 et objecttypeid ved spørring. Disse visningene er enklere å spørre i siden du ikke trenger å vite 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 til å hente objektdata. Se mer i Objects_X-visninger nedenfor.
Kombinert: Alle poster for alle objekttyper kombineres til ett databaseobjekt. Når du spør, må du derfor angi et filter som "WHERE objectTypeId='0-1'". Du kan for eksempel bruke følgende objectTypeId når du spør:

Objektets navn	ObjectTypeId
Kontaktpersoner	0-1
Selskaper	0-2
Poster	0-8

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

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

objects_x visninger

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

Forespørsler til denne visningen returnerer én rad for hver post i et objekt, og hver egenskap i objektet er tilgjengelig som en egen kolonne.

Nedenfor finner du en omfattende liste over tilgjengelige HubSpot-objekttyper (som ikke er egendefinerte), en kort beskrivelse av dataene de representerer og tilhørende visninger:

HubSpot Objekttype	ObjectTypeId	Beskrivelse
KONTAKT	0-1	Informasjon om enkeltpersoner som samhandler med virksomheten din
SELSKAP	0-2	Informasjon om enkeltbedrifter eller organisasjoner
DEAL	0-3	Detaljer om inntektsmuligheter med en kontakt eller et selskap.
ENGASJEMENT	0-4	Lagrer data fra CRM-handlinger, inkludert notater, oppgaver, e-post, møter og samtaler.
BILLETT	0-5	Representere kundeforespørsler om hjelp eller 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 undergruppe av produkter som selges i en avtale. Når et produkt knyttes til en avtale, blir det en varelinje.
SAMTALE	0-11	Detaljer om innkommende meldinger fra flere kanaler.
LANDING_PAGE	0-25	Detaljer om destinasjonssidene dine
OPPGAVE	0-27	Lagrer informasjon om oppgavelister
FORM	0-28	Brukes til å samle inn leadinformasjon om besøkende og kontakter.
E-POST_MARKEDSFØRING	0-29	Detaljer om e-poster fra markedsføringsnav
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 de enkelte annonsene
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
OBJEKTLISTE	0-45	Informasjon om grupperinger av objektposter basert på egenskaper eller aktiviteter.
RING	0-48	Samtaler foretatt av andre CRM-poster, f.eks. kontakter
FAKTURA	0-53	Administrere og synkronisere fakturaer med eksterne regnskapssystemer
MEDIA_BRIDGE	0-57	Informasjon om medieressurser importert til Hubspot
SEKVENS	0-58	En sekvens er en serie målrettede, tidsbestemte e-postmaler for å pleie kontakter over tid.
DEAL_SPLIT	0-72	Deling av avtaler brukes til å dele avtalekreditten mellom flere brukere.
SALGS_DOKUMENT	0-83	Salgsdokumenter bygger opp et bibliotek med innhold som hele teamet kan laste opp og dele dokumenter med kontaktene.
TILBAKEMELDING_INNLEVERING	0-19	Lagrer informasjon som er sendt inn i en tilbakemeldingsundersøkelse.
ABONNEMENT	0-69	Abonnementer inneholder informasjon om gjentatte betalinger.
BETALING FOR HANDEL	0-101	Inneholder data om innsamlede midler fra kunder

Hvert databaseobjekt returnerer følgende kolonner:

Kolonnenavn	Type	Beskrivelse
OBJECTTYPEID	Varchar	ID-en til objekttypen (f.eks. kontakter er 0-1).
OBJECTID	Antall	ID-en til posten (f.eks. en kontaktpost med ID 123752).
OPPDATERTAT	Tidsstempel	Dato og klokkeslett da dette objektet sist ble oppdatert i HubSpot.
INGESTEDAT	Tidsstempel	Dato og klokkeslett 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.

Spørring:

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

Returnerer:

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

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	stengt	34199
321740651	Testavtale 123	14845019	8383663
98392101	Pop-up-baldakin	stengt	9309007

Eksempel 3

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

Spørring:

Siden data om avtalebeløp er tilgjengelig som en talldatatype, kan de brukes til å bestille uten at det er nødvendig med konvertering eller casting.

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

Returnerer:

OBJECTID	PROPERTY_DEALNAME	PROPERTY_DEALSTAGE	PROPERTY_DEALAMOUNT
98392101	Pop-up-baldakin	stengt	9309007
321740651	Testavtale 123	14845019	8383663
38960439	Navn på avtale 1	stengt	34199

object_with_object_properties (objekt_med_objektegenskaper)

Dette databaseobjektet inneholder data fra HubSpot-postene dine. Forespørsler til dette databaseobjektet returnerer én rad for hver post i en objekttype (f.eks. alle kontaktposter i objekttypen kontakter). Alle egenskaper lagres i Properties-kolonnen, 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`	Antall	ID-en til posten (f.eks. en kontaktpost med ID `123752`).
`PROPERTIES`	Variant	Postens eiendomsverdier.
`UPDATEDAT`	Tidsstempel	Dato og klokkeslett da posten sist ble oppdatert i HubSpot. Finn ut mer om kolonnedatatyper.
`INGESTEDAT`	Tidsstempel	Dato og klokkeslett for når dataene sist ble tatt inn av Snowflake.

Merk: 25. januar 2022 vil kol onnen timestamp i object_with_object_properties-tabellen og -visningen, som representerer dato og klokkeslett for når objektposten sist ble oppdatert i HubSpot , bli updatedat. Dette er for å harmonisere med hvordan datetime-data representeres i resten av datadelen.

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

Etter 90 dager, den 25. januar 2022, fjernes kolonnen timestamp fra tabellen og visningen. Etter denne datoen vil alle forsøk på å søke i tabellen eller visningen object_with_object_properties med tidsstempelkolonner 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	EIENDOMMER
0-1	38960439	{"createdate": "1504656970152"...}
0-1	321740651	{ "createdate": "1590183081949"...}
0-1	98392101	{ "createdate": "1533566477279"...}
...	...	...

Eksempel 2

Hent avtalens navn og stadium for opptil tre avtaler.

Spørring:

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	stengt/forsvunnet	7488939
321740651	Navn på avtale 1	stengt	9292029
98392101	Navn på avtale 1	stengt/forsvunnet	62626528

Gjenstander

Dette databaseobjektet er en delmengde av dataene i databaseobjektet object_with_object_properties. Hver rad som returneres, returnerer objekt-ID-en for hver post. Dette databaseobjektet returnerer kun eksisterende poster. Når en post slettes i HubSpot, fjernes den 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, fjernes den fra denne visningen.

Dette databaseobjektet kan være nyttig hvis kontoen din har en stor mengde data, noe som fører til at object_with_object_properties og objects_x-visningene fungerer sakte. Ved å bruke dette databaseobjektet sammen med databaseobjektet object_properties kan du 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`	Antall	ID-en til posten (f.eks. en kontaktpost med ID `123752`).
`INGESTEDAT`	Tidsstempel	Dato og klokkeslett da dataene sist ble lastet inn av Snowflake. Finn ut mer om kolonnedatatyper.

Eksempel 1

Hent alle kontaktoppføringer.

Spørring:

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 aktuelle egenskapsverdien som er angitt for en gitt post. En kontakt vil for eksempel ha én rad for egenskapen Fornavn og én rad for egenskapen Etternavn. Hvis en post ikke har noen verdi for en egenskap, vises raden enten med en tom streng eller ikke 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`	Antall	ID-en til posten (f.eks. en kontaktpost med ID `123752`).
`NAME`	Varchar	Navnet på eiendommen.
`VALUE`	Tidsstempel	Verdien av eiendommen.
`UPDATEDAT`	Tidsstempel	Dato og klokkeslett da posten sist ble oppdatert i HubSpot. Finn ut mer om kolonnedatatyper.
`INGESTEDAT`	Tidsstempel	Dato og klokkeslett for når dataene sist ble tatt inn av Snowflake.

Eksempel 1

Hent egenskapene fornavn, etternavn og by for alle kontakter.

Spørring:

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

Returnerer:

OBJECTTYPEID	OBJECTID	NAVN	VERDI
0-1	10401	fornavn	Brian
0-1	10401	by	Dublin
0-1	10401	etternavn	Gallagher
0-1	23451	fornavn	Fernando
0-1	23451	etternavn	Fierro
0-1	25751	fornavn	Charles
...	...	...	...

Eksempel 2

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

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

objekt_egenskaper_historikk

Dette databaseobjektet inneholder historiske egenskapsverdier. For kontakter inneholder det de 45 nyeste verdiene. For alle andre objekter inneholder det de 20 nyeste verdiene. Viser en rad for hver historiske egenskapsverdi. Den gjeldende verdien for en egenskap bestemmes av det nyeste 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`	Antall	ID-en til posten (f.eks. en kontaktpost med ID `123752`).
`NAME`	Varchar	Navnet på eiendommen.
`VALUE`	Tidsstempel	Verdien av eiendommen.
`UPDATEDAT`	Tidsstempel	Dato og klokkeslett da dataene sist ble oppdatert i HubSpot. Finn ut mer om kolonnedatatyper.
`INGESTEDAT`	Tidsstempel	Dato og klokkeslett da dataene sist ble tatt inn av Snowflake.

Eksempel 1

Hent historikken for en enkelt egenskap for en enkelt kontakt.

Spørring:

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

Returnerer:

OBJECTID	NAVN	VERDI	OPPDATERTAT
136493192	hs_predictivescoringnivå	nivå_1	2022-06-22 22:45:05.931
136493192	hs_predictivescoringnivå	nivå_2	2021-09-18 08:20:56.622
136493192	hs_predictivescoringnivå	nivå_3	2019-11-31 18:20:22.851
...	...	...	...

Eksempel 2

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

Forespørsler om assosiasjoner

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

Individuell: Hver assosiasjonstype lagres i sin egen visning og inneholder bare poster av denne typen. For eksempel inneholder associations_contacts_to_deals bare assosiasjonsposter mellom kontakt- og avtaleobjekter. Dette eliminerer behovet for å spesifisere et assosiasjonstypeid ved spørring. Disse visningene er ganske enkle å bruke, 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 assosiasjonsdata. Se mer i associations_x_to_y-visningene nedenfor.
Kombinert: Alle poster for alle assosiasjonstyper kombineres til ett databaseobjekt. Når du spør, må du derfor spesifisere et filter som "WHERE combinedassociationtypeid='0-32'". Se mer i assosiasjoner og association_definitions nedenfor.

assosiasjoner_x_til_y visninger

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

Hvert databaseobjekt returnerer følgende kolonner:

Kolonnenavn	Type	Beskrivelse
KOMBINERT FORENINGSTYPEID	Varchar	Den unike identifikatoren for assosiasjonsdefinisjonen.
ASSOSIASJONSKATEGORI	Varchar	Kilden til assosiasjonstypen. En av følgende: HUBSPOT_DEFINERT, BRUKER_DEFINERT, INTEGRATOR_DEFINERT
ASSOCIATIONTYPEID	Varchar	En unik identifikator for en assosiasjonsdefinisjon innenfor en bestemt assosiasjonskategori, dvs. at ingen to definisjoner i en assosiasjonskategori har samme associationtypeid.
FRAOBJEKTTYPEID	Varchar	Objekttypeid som er kilden til assosiasjonsdefinisjonen.
FROMOBJECTTYPE	Varchar	Navnet på objekttypen som er kilden til assosiasjonsdefinisjonen.
TOOBJECTTYPEID	Varchar	Objekttypeid som er målet for assosiasjonsdefinisjonen.
TOOBJECTTYPE	Varchar	Navnet på objekttypen som er målet for assosiasjonsdefinisjonen.
NAVN	Varchar	Navnet på assosiasjonsdefinisjonen.
ETIKETT	Varchar	Beskrivelsen av assosiasjonsdefinisjonen.
DEFINISJON AV HOVEDFORENING	Boolsk	Om assosiasjonsdefinisjonen er hovedtypen. Hvis true, er det definisjonen som HubSpot viser på tilknyttede oppføringer.
[FROMOBJECTTYPE_OBJECTID], f.eks. for visningen ASSOCIATIONS_CONTACTS_TO_DEALS vil dette være CONTACT_OBJECTID.	Antall	Objekt-ID-en til kildeobjektet.
[TOOBJECTTYPE_OBJECTID], f.eks. for visningen ASSOCIATIONS_CONTACTS_TO_DEALS vil dette være DEAL_OBJECTID.	Antall	Objekt-ID-en til destinasjonsobjektet.
INGESTEDAT	Tidsstempel	Dato og klokkeslett da dataene sist ble tatt inn av Snowflake.

Eksempel 1

Hent alle avtaler som er knyttet til en bestemt kontakt.

Spørring:

SELECT
kontakt_objektId, avtale_objektId

FROM foreninger_kontakter_til_avtaler

WHERE contactId = 6626541373

Returnerer:

CONTACT_OBJECTID	DEAL_OBJECTID
6626541373	233620335
6626541373	90253678

Eksempel 2

Hent alle kontakter 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'

KONTAKT_FORNAVN	ETTERNAVN_KONTAKT	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_LUKKET_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 til assosiasjonsdatabaseobjektet for å få postspesifikk assosiasjonsinformasjon.

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

Dette databaseobjektet kan returnere følgende kolonner:

Kolonnenavn	Type	Beskrivelse
`COMBINEDASSOCIATIONTYPEID`	Varchar	Den unike identifikatoren for assosiasjonsdefinisjonen.
`CATEGORY`	Varchar	Kilden til assosiasjonstypen. En av følgende: `HUBSPOT_DEFINED`, `USER_DEFINED`, `INTEGRATOR_DEFINED`
`ID`	Antall	Identifikatoren til assosiasjonsdefinisjonen innenfor sin kategori.
`FROMOBJECTTYPEID`	Varchar	ID-en til objektet som er kilden til assosiasjonsdefinisjonen.
`TOOBJECTTYPEID`	Varchar	ID-en til objektet som er målet for assosiasjonsdefinisjonen.
`NAME`	Varchar	Navnet på assosiasjonsdefinisjonen.
`LABEL`	Varchar	Etiketten til assosiasjonsdefinisjonen.
`ISMAINASSOCIATIONDEFINITION`	Boolsk	Om assosiasjonsdefinisjonen er hovedtypen. Hvis true, er det definisjonen som HubSpot viser på tilknyttede oppføringer.
`INGESTEDAT`	Tidsstempel	Dato og klokkeslett da dataene sist ble lastet inn av Snowflake. Finn ut mer om kolonnedatatyper.

Eksempel 1

Hent hvilke typer assosiasjoner som er tilgjengelige i kontoen din.

Spørring:

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

Returnerer:

KOMBINERT FORENINGSTYPE	FRAOBJEKTTYPEID	TOOBJECTTYPEID	NAVN
0-1	0-1	0-2	KONTAKT_TIL_SELSKAP
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	AVTALE_TIL_SELSKAP
...	...	...	...

Eksempel 2

Hent de tilgjengelige assosiasjonstypene mellom avtaler og selskaper.

Spørring:

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

Returnerer:

KOMBINERT FORENINGSTYPE	FRAOBJEKTTYPEID	TOOBJECTTYPEID	NAVN
0-5	0-3	0-2	AVTALE_TIL_SELSKAP
0-271	0-3	0-2	DEAL_TO_PRIMARY_COMPANY (AVTALE_TIL_PRIMÆRT_SELSKAP)
0-341	0-3	0-2	DEAL_TO_COMAPNY_UNLABELED

assosiasjoner

Dette databaseobjektet inneholder informasjon om assosiasjoner mellom spesifikke poster. Hver rad representerer en assosiasjon fra ett objekt til et annet. Det kan finnes rader i dette databaseobjektet selv om de refererte postene er slettet. Du kan sjekke om det finnes poster ved å koble 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:

Kolonnenavn	Type	Beskrivelse
`COMBINEDASSOCIATIONTYPEID`	Varchar	Den unike identifikatoren for assosiasjonsdefinisjonen.
`FROMOBJECTID`	Antall	ID-en til kildeobjektet.
`TOOBJECTID`	Antall	ID-en til destinasjonsobjektet.
`INGESTEDAT`	Tidsstempel	Dato og klokkeslett da dataene sist ble lastet inn av Snowflake. Finn ut mer om kolonnedatatyper.

Eksempel 1

Hent alle tilknyttede avtaler og kontakter.

Spørring:

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

Returnerer:

KOMBINERT FORENINGSTYPEID	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).

Spørring:

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

Returnerer:

KOMBINERT FORENINGSTYPE	FROMOBJECTID	TOOBJECTID
0-5	6626541373	233620335

Eksempel 3

Henter alle avtaler som er knyttet til en bestemt kontakt (kontakt-ID: 4464). I stedet for å skrive combinedAssociationTypeId, kobles 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:

KOMBINERT FORENINGSTYPEID	FROMOBJECTID	TOOBJECTID
0-5	6626541373	233620335

Forespørsler fra eieren

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:

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

Eksempel 1

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

Spørring:

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

Returnerer:

EIERID	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ørring:

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

Returnerer:

EIERID	USERID	EMAIL	FORNAVN	ETTERNAVN
29584574	4621126	233620335	Hobbes	Baron

Eksempel 3

Henter alle kontakter og deres eiere. Denne spørringen knytter 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	ETTERNAVN_KONTAKT	KONTAKT_HUBSPOT_EIER_ID	EIER_FORNAVN	EIER_NAKNAVN	EIER_EMAIL
113834202	Richard	Greenfield	29584574	Hobbes	Baron	hobbes.b@business.com
53540801	Ford	Karl	30241125	Milo	Gull	milo.g@business.com
...	...	...	...	...	...	...

Team-spørsmål

lag

Med Teams 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:

Kolonnenavn	Type	Beskrivelse
TEAMID	Antall	Teamets ID.
TEAMNAME	Varchar	Lagets navn.
PARENTTEAMID	Antall	Lag-ID-en til det overordnede laget.
BARNEAMIDLER	Matrise	Team-ID-ene til barnelagene.
PRIMÆREIERMEDLEMMER	Varchar	Eier-ID-ene til de primære teammedlemmene.
SEKUNDÆRE EIERMEDLEMMER	Boolsk	Eier-ID-ene til de sekundære teammedlemmene.
INGESTEDAT	Tidsstempel	Dato og klokkeslett da dataene sist ble tatt inn av Snowflake.

Eksempel 1

Hent alle lagene.

Spørring:

SELECT teamId,teamName, primaryOwnerMembers

FRA team

Returnerer:

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

eier_team

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

Dette databaseobjektet kan returnere følgende kolonner:

Kolonnenavn	Type	Beskrivelse
TEAMID	Antall	Teamets ID.
EIERID	Antall	Brukerens eier-ID.
ISTEAMPRIMARY	Boolsk	Om dette laget er det primære laget for denne eieren.
INGESTEDAT	Tidsstempel	Dato og klokkeslett da dataene sist ble tatt inn av Snowflake.

Eksempel 1

Hent alle eiere for et gitt lag.

Spørring:

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

Avkastning

TEAMID	TEAMNAME	ISTEAMPRIMARY
29584574	233620335	SANN
29584574	1234553	SANN

Pipeline-spørringer

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

Du kan slå sammen disse dataene med objektdata for å få en fullstendig oversikt over pipelines. Du kan for eksempel søke etter avtaler og tilhørende pipelines ved å koble objects_deals_view eller object_with_object_properties-data med pipelines-data.

rørledninger

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

Denne tabellen kan returnere følgende kolonner:

Kolonnenavn	Type	Beskrivelse
`PIPELINEID`	Varchar	Rørledningens ID.
`OBJECTTYPEID`	Varchar	ID-en til objektet som pipelinen kan inneholde (f.eks. avtaler eller billetter).
`LABEL`	Varchar	Navnet på pipelinen i HubSpot.
`DISPLAYORDER`	Antall	Rekkefølgen pipelinen vises i i HubSpot.
`ARCHIVED`	Boolsk	Om rørledningen er slettet.
`CREATEDAT`	Tidsstempel	Når rørledningen ble opprettet.
`UPDATEDAT`	Tidsstempel	Dato og klokkeslett da dataene sist ble oppdatert i HubSpot. Finn ut mer om kolonnedatatyper.
`INGESTEDAT`	Tidsstempel	Dato og klokkeslett da dataene sist ble tatt inn av Snowflake.

Eksempel 1

Hent alle tilgjengelige deal pipelines, sortert etter rekkefølge i HubSpot.

Spørring:

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

Returnerer:

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

Eksempel 2

Henter avtaler innenfor en bestemt pipeline. Kobler sammen object_with_object_properties og pipelines.

Spørring:

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 nytt varemerke	Salgspipeline
604362473	Fresh Step App Build	Salgspipeline

Eksempel 3

Samme som i eksempel 2 ovenfor, men hent avtaler innenfor en bestemt pipeline. Men i stedet for å bruke objects_deals i joins, 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 nytt varemerke	Salgspipeline
604362473	Fresh Step App Build	Salgspipeline

pipeline_stadier

Denne visningen inneholder informasjon om individuelle trinn i en pipeline. Identifiser trinn ved å kombinere objekttype-ID, pipeline-ID og trinn-ID. Bruk objekttype-ID og rørlednings-ID ved sammenføyning med rørledninger.

Dette databaseobjektet kan returnere følgende kolonner:

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

Eksempel 1

Hent pipeline-stadier for en avtalepipeline med navnet Sales pipeline.

Spørring:

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	ETIKETT
941650	941651	Kontaktet
941650	941652	Avtalt tid
941650	941653	Faktura sendt
...	...	...

Eksempel 2

Hent alle avtaler og deres respektive pipeline-stadier.

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 nytt varemerke	Salgspipeline	Avtalt tid
604362473	Fresh Step App Build	Salgspipeline	Kontrakt signert
...	...	...	...

Forespørsler om eiendom

property_definitions

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

Du kan identifisere bestemte 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:

Kolonnenavn	Type	Beskrivelse
`OBJECTYPEID`	Varchar	ID-en til objektet som hendelsen er relatert til.
`NAME`	Varchar	Egenskapens interne navn.
`LABEL`	Varchar	Eiendommens etikett.
`DESCRIPTION`	Varchar	Beskrivelse av eiendommen.
`TYPE`	Varchar	Egenskapens type (f.eks. streng, tall, datetime).
`FIELDTYPE`	Varchar	Egenskapens felttype. Definerer hvordan egenskapen vises i HubSpot og på skjemaer (f.eks. avkrysningsrute, valg).
`DISPLAYORDER`	Antall	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`	Antall	ID-en til brukeren som opprettet egenskapen.
`REFERENCEDOBJECTTYPE`	Varchar	Objekttypen som egenskapen refererer til. Eieregenskaper returnerer verdien OWNER.
`CALCULATED`	Boolsk	Om egenskapen er en beregnet egenskap.
`EXTERNALOPTIONS`	Boolsk	Om egenskapens alternativer er definert i et eksternt system.
`HASUNIQUEVALUE`	Boolsk	Om egenskapens verdier er unike. Kan bare angis når du oppretter en egenskap via API-et.
`HIDDEN`	Boolsk	Om egenskapen er skjult i HubSpot.
`SHOWCURRENCYSYMBOL`	Boolsk	Om en tallverdi skal formateres 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 av en bruker.
`ARCHIVED`	Boolsk	Om egenskapen er slettet.
`CREATEDAT`	Tidsstempel	Dato og klokkeslett da egenskapen ble opprettet i HubSpot.
`UPDATEDAT`	Tidsstempel	Dato og klokkeslett da dataene sist ble oppdatert i HubSpot. Finn ut mer om kolonnedatatyper.
`INGESTEDAT`	Tidsstempel	Dato og klokkeslett da dataene sist ble tatt inn av Snowflake.

Eksempel 1

Hent navn og beskrivelser for alle kontaktegenskaper.

Spørring:

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

Returnerer:

NAVN	ETIKETT	BESKRIVELSE
entered_sql_stage	Gikk inn i SQL-stadiet	Start telling av SQL-etappedager.
first_conversion_event_name	Første konvertering	Det første skjemaet denne kontakten sendte inn.
adresse	Adresse	Kontaktens adresse.

Forespørsler om hendelser

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

Navn
EVENTS_AD_INTERACTION	Detaljer om en annonse og kontakter som interagerte med den ved å klikke på annonsen eller sende inn et skjema etter å ha sett 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.
HENDELSER_KLIKKET_LENKE_I_E-POST_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 e-poster i innboksen for samtaler.
EVENTS_COOKIE_BANNER_CLICKED	Kontakter som har klikket på informasjonskapsler.
EVENTS_COOKIE_BANNER_VIEWED (HENDELSER_COOKIE_BANNER_VIST)	Kontakter som har sett informasjonskapsler.
HENDELSER_DOKUMENT_DELT_V2	Salgsdokumenter som deles med kontakter via en ekstern lenke.
HENDELSER_DOKUMENT_VIST_V2	Salgsdokumenter og kontakter som de har sett ved å åpne den eksterne lenken.
HENDELSER_DOKUMENT_FULLFØRT_V2	Salgsdokumenter og kontakter som har avsluttet dem.
HENDELSER_HS_PLANLAGT_E-POST_V2	E-poster som sendes til HubSpots e-postservere for å bli sendt.
HENDELSER_MTA_LEVERT_E-POST_V2	E-poster som er levert til mottakerne av HubSpots e-postservere.
HENDELSER_MTA_BOUNCED_EMAIL_V2	E-postleveringsforsøk som ble avvist av mottakerens e-postserver.
HENDELSER_ÅPNET_E-POST_V2	E-post åpnes av kontakter.
HENDELSER_RAPPORTERT_SPAM_EPOST_V2	E-poster merket som søppelpost av mottakere.
HENDELSER_OPPDATERT_E-POST_ABONNEMENT_STATUS_V2	Endringer i mottakernes e-postabonnementer.
HENDELSER_ÅPNET_SPORET_INNBOKS_E-POST_V8	Konserveringsinnboksens e-post åpnes av kontakter.
EVENTS_MB_MEDIA_PLAYED	Videoavspillingsaktivitet etter kontakter.
EVENTS_V2_CONTACT_BOOKED_MEETING_THROUGH_SEQUENCE (HENDELSER_V2_KONTAKT_BOOKET_MØTE_GJENNOM_SEKVENS)	Kontakten booket et møte gjennom sekvensen.
EVENTS_V2_CONTACT_ENROLLED_IN_SEQUENCE (HENDELSER_V2_KONTAKT_REGISTRERT_I_SEKVENS)	Kontakt registrert fra sekvensen.
EVENTS_V2_CONTACT_FINISHED_SEQUENCE (HENDELSER_V2_CONTACT_FINISHED_SEQUENCE)	Sekvensen er ferdig.
EVENTS_V2_CONTACT_REPLIED_SEQUENCE_EMAIL	Kontakten svarte på e-post (eller innkommende e-post som avregistrerte sekvensen) sendt gjennom sekvensen.
EVENTS_V2_CONTACT_UNENROLLED_FROM_SEQUENCE (HENDELSER_V2_CONTACT_UNROLLED_FROM_SEQUENCE)	Kontakt avmeldt fra sekvensen.
EVENTS_V2_CONTACT_UNENROLLED_MANUALLY_FROM_SEQUENCE (HENDELSER_V2_CONTACT_UNROLLED_MANUALLY_FROM_SEQUENCE)	Brukeren avregistrerte kontakten manuelt.
EVENTS_V2_CONTACT_UNSUBSCRISCRIBED_SEQUENCE_EMAIL	Kontakten meldte seg av, og avmeldte sekvensen.
EVENTS_V2_SEQUENCE_EMAIL_BOUNCED	Sekvens-e-posten ble avvist.
EVENTS_V2_SEQUENCE_ERRORED (HENDELSER_V2_SEKVENS_FORKASTET)	Feil i sekvensen førte til avregistrering.
EVENTS_V2_SEQUENCE_STEP_EXECUTED (HENDELSER_V2_SEKVENSSTEG_UTFØRT)	Sekvenstrinn utført.
HENDELSER_BESØKT_SIDE	Besøk på nettsidene fordelt på kontakter.
EVENTS_<INTEGRATION_EVENT_NAME>_<UNIQUE_IDENTIFIER>	Integrasjonshendelser(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:

occurredat
occurredatdateint

Disse kolonnene erstatter kolonnene occuredat og occuredatdateint den 24. november 2022. På den datoen vil de gamle kolonnene ikke lenger være tilgjengelige, og forsøk på å søke i et databaseobjekt eller en visning som inneholder hendelser ved hjelp av disse kolonnene, vil mislykkes. Finn ut mer om endringer for Snowflake-datadeling.

Kolonnenavn	Type	Beskrivelse
`EVENTTYPEID`	Varchar	ID-en til hendelsestypen, i likhet med 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. Hvis du for eksempel klikker på en e-postlenke, vises `0-1` i denne kolonnen, som representerer kontaktobjektet.
`OBJECTID`	Antall	ID-en til posten som fullførte hendelsen.
`OCCURREDAT`	Tidsstempel	Når hendelsen inntraff.
`OCCURREDATDATEINT`	Antall	Et tall som angir når hendelsen inntraff. Inneholder de samme dataene som `OCCURREDAT` -kolonnen, men formatert som et tall og brukes som en del av tabellens klyngenøkkel. I de fleste tilfeller kan du bruke `OCCURREDAT` tidsstempel i stedet for dette tallet.
`OCCUREDATDATEINT`	Antall	Et tall som angir når hendelsen inntraff. Inneholder de samme dataene som `OCCURREDAT` -kolonnen, men 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. Væroppmerksom på at denne kolonnen utdateres 24. november 2022 og erstattes med `OCCURREDATDATEINT`.
`OCCUREDAT`	Tidsstempel	Når hendelsen inntraff. Væroppmerksom på at denne kolonnen utdateres 24. november 2022 og erstattes med `OCCURREDAT`.
`INGESTEDAT`	Tidsstempel	Dato og klokkeslett da dataene sist ble lastet inn av Snowflake. Finn ut mer om kolonnedatatyper.
`PROPERTY_*`	Varchar	Individuelle kolonner som inneholder hendelsesegenskapene.

Eksempel 1

Hent de 50 siste klikkhendelsene for e-post.

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-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	ETTERNAVN_KONTAKT
2019-01-04 22:35:41.264	https://help.website.com/articles/tutorial/how-to-use-email-tool?utm_source=hs_automation&utm_medium=email&utm_content=68042217	Hobbes	Baron
2018-11-08 09:37:41.400	https://www.website.net/webinar-case-study?utm_source=hs_automation&utm_medium=email&utm_content=55200164	Milo	Gull
2018-11-08 09:37:41.426	https://www.website.net/contact?utm_source=hs_automation&utm_medium=email&utm_content=55200164	Harlow	Villari
...	...	...	...

Object_and_event_type_queries (spørsmål om objekt- og hendelsestype)

definisjoner av objekt- og hendelsestyper

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 pipelinen kan inneholde (f.eks. avtaler eller billetter).
`FULLYQUALIFIEDNAME`	Varchar	Navnet på objektet eller hendelsen.
`INGESTEDAT`	Tidsstempel	Dato og klokkeslett da dataene sist ble lastet inn av Snowflake. Finn ut mer om kolonnedatatyper.

Eksempel 1

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

Spørring:

SELECT objectTypeId, fullyQualifiedName
FROM object_and_event_type_definitions;

Returnerer:

OBJECTTYPEID	FULLT KVALIFISERT NAVN
0-1	KONTAKT
0-8	LINE_ITEM
0-11	SAMTALE
...	...

Lister med spørsmål

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

lister

Dette databaseobjektet inneholder informasjon om HubSpots kontakt- og bedriftslister. Returnerer én rad per liste, og kolonnene inneholder listedetaljer som listenavn, størrelse og objekttype for postene den inneholder. Inneholder ikke informasjon om de enkelte postene i hver liste (se list_membership).

Dette databaseobjektet kan returnere følgende kolonner:

Kolonnenavn	Type	Beskrivelse
`OBJECTTYPEID`	Varchar	Type poster i listen (f.eks. kontakt eller selskap).
`LISTID`	Antall	ID-en til listen. Kobles til LISTID-kolonnen i tabellen list-memberships.
`CLASSICLISTID`	Antall	En ID som er spesifikk for kontaktlister og som samsvarer med ID-en i URL-adressen til listen i HubSpot.
`NAME`	Varchar	Navnet på listen.
`SIZE`	Antall	Antall poster i listen.
`CREATEDBYUSERID`	Antall	ID-en til brukeren som opprettet listen.
`CREATEDAT`	Tidsstempel	Når listen ble opprettet i HubSpot.
`UPDATEDBYUSERID`	Antall	ID-en til brukeren som sist oppdaterte listen.
`UPDATEDAT`	Tidsstempel	Dato og klokkeslett da datoen sist ble oppdatert i HubSpot. Finn ut mer om kolonnedatatyper.
`INGESTEDAT`	Tidsstempel	Dato og klokkeslett da dataene sist ble tatt inn av Snowflake.

Eksempel 1

Hent alle kontaktlister.

Spørring:

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

Returnerer:

LISTID	NAVN	STØRRELSE
118131	Ukentlig oppsøkende virksomhet	103
66156	Abonnenter på bloggen	455
771852	Topp abonnenter 2021	37
...	...	...

Eksempel 2

Hent en spesifikk kontaktliste med navnet Toppabonnenter 2021.

Spørring:

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

Returnerer:

LISTID	NAVN	STØRRELSE
771852	Topp abonnenter 2021	37

list_membership

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

Inneholder bare liste-ID-er og objekt-ID-er. Hvis du vil ha mer informasjon, kan du slå deg sammen med databaseobjektet for lister.

Dette databaseobjektet kan returnere følgende kolonner:

Kolonnenavn	Type	Beskrivelse
`LISTID`	Varchar	ID-en til listen. Kobles til kolonnen HS_LIST_ID i listetabellen.
`OBJECTID`	Varchar	ID-en til posten i listen.
`UPDATEDAT`	Tidsstempel	Dato og klokkeslett da dataene sist ble oppdatert i HubSpot. Finn ut mer om kolonnedatatyper.
`INGESTEDAT`	Tidsstempel	Dato og klokkeslett da dataene sist ble tatt inn av Snowflake.

Eksempel 1

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

Spørring:

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

Returnerer:

OBJECTID

54325098

96805401

6922028

...

Eksempel 2

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

Spørring:

SELECT

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

Returnerer:

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

Ofte stilte spørsmål

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

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

SELECT * FROM property_definitions

WHERE label = [column_name]

Det kan hende at det ikke alltid er en eksakt match, fordi noen egenskapsnavn vanligvis løses til et mer beskrivende navn i appen. I slike tilfeller kan det være nyttig å gjøre et uklart søk ved hjelp av LIKE-operatoren i 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 søke 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 har behov for å 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. Hvis du vil vite hvilke skjemaer en kampanje er knyttet til i eksemplet ovenfor, må du søke i ASSOCIATIONS_CAMPAIGNS_TO_FORMS:

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

Hvordan vet jeg status for HubSpot-Snowflake-integrasjonen?

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

SELECT * FROM hubspot.public.data_share_status LIMIT 1

Resultatene vises som følger:

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

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

Var denne artikkelen nyttig? Ja Nei

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

Forespørsler om HubSpot-data i Snowflake

Gjelder for:

Dataforsinkelse og Snowflake-kontoregionen din

Konfigurer Snowflake-miljøet ditt

Oversikt over data

Begrense og sortere returnerte data

Datatyper for kolonner

Transformasjon av datatyper

Objektforespørsler

objects_x visninger

Eksempel 1

Eksempel 2

Eksempel 3

object_with_object_properties (objekt_med_objektegenskaper)

Eksempel 1

Eksempel 2

Gjenstander

Eksempel 1

object_properties

Eksempel 1

Eksempel 2

objekt_egenskaper_historikk

Eksempel 1

Eksempel 2

Forespørsler om assosiasjoner

assosiasjoner_x_til_y visninger

Eksempel 1

Eksempel 2

Eksempel 3

association_definitions

Eksempel 1

Eksempel 2

assosiasjoner

Eksempel 1

Eksempel 2

Eksempel 3

Forespørsler fra eieren

eiere

Eksempel 1

Eksempel 2

Eksempel 3

Team-spørsmål

lag

Eksempel 1

eier_team

Eksempel 1

Pipeline-spørringer

rørledninger

Eksempel 1

Eksempel 2

Eksempel 3

pipeline_stadier

Eksempel 1

Eksempel 2

Forespørsler om eiendom

property_definitions

Eksempel 1

Forespørsler om hendelser

Eksempel 1

Eksempel 2

Object_and_event_type_queries (spørsmål om objekt- og hendelsestype)

definisjoner av objekt- og hendelsestyper

Eksempel 1

Lister med spørsmål

lister

Eksempel 1

Eksempel 2

list_membership

Eksempel 1

Eksempel 2

Ofte stilte 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 status for HubSpot-Snowflake-integrasjonen?

Relatert innhold