Gå til innhold
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: mai 31, 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.

Datalag og Snowflake-kontoregionen din

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

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

Konfigurer Snowflake-miljøet ditt

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

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

  • Klikk på Arbeidsarkhandlinger i øverste rad i regnearket.

    snowflake-worksheet-settings0
  • I popup-vinduet:
    • Klikk på rullegardinmenyen Lager, og velg deretter lageret ditt.
    • Klikk på rullegardinmenyen Database, og velg deretter HubSpot-databasen din.
    • Klikk på nedtrekksmenyen Schema, og velg deretter skjemaet du vil bruke:
        • V2_DAILY: det daglige skjemaet for å søke etter data basert på tabeller. Data i dette skjemaet oppdateres én gang per dag. Bruk av dette skjemaet gir raskere spørringer, og anbefales for spørringer direkte i Snowflake.
        • V2_LIVE: live-skjemaet basert på sikre visninger av HubSpot-data. Data i dette skjemaet oppdateres opptil hvert 15. minutt. Hvis du spør etter et stort sett med data, kan spørringene være trege. I dette tilfellet anbefales det å kopiere dataene til din egen tabell først ved hjelp av en ETL-prosess, og deretter søke i den tabellen.


      snowflake-worksheet-settings-window0

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

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


SELECT objectTypeId, property_createddate
FROM hubspot_share_name.V2_LIVE.objects_deals

LIMIT 1

Oversikt over data

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

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

Finn ut mer omHubSpots CRM-datamodell.

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

Begrensning og sortering av returnerte data

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


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

Datatyper for kolonner

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

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

snowflake-sidebar-view-column-details0


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


SELECT
objectId, updatedAt
FROM objects_contacts

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

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

Transformere datatyper

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


SELECT objectid, value AS amount_str, try_to_number(value) AS amount

FROM object_properties
WHERE objecttypeid='0-3' AND name='amount'
LIMIT 1

Objektforespørsler

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

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

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

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

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

objekter_x visninger

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

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

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

HubSpot Objekttype

ObjectTypeId

Beskrivelse

KONTAKT

0-1

Informasjon om enkeltpersoner som samhandler med virksomheten din

SELSKAP

0-2

Informasjon om enkeltbedrifter eller organisasjoner

DEAL

0-3

Detaljer om inntektsmuligheter med en kontakt eller et selskap.

ENGASJEMENT

0-4

Lagrer data fra CRM-handlinger, inkludert notater, oppgaver, e-post, møter og samtaler.

BILLETT

0-5

Representere kundeforespørsler om hjelp eller support.

SITAT

0-14

Brukes til å dele prisinformasjon med potensielle kjøpere.

FORM_SUBMISSION

0-15

Detaljer for individuelle innsendinger for et HubSpot-skjema.

LINE_ITEM

0-8

Representerer en delmengde av produkter som selges i en avtale. Når et produkt knyttes til en avtale, blir det en varelinje.

SAMTALE

0-11

Detaljer om innkommende meldinger fra flere kanaler.

LANDING_PAGE

0-25

Detaljer om landingssidene dine

OPPGAVE

0-27

Lagrer informasjon om gjøremålslister

FORM

0-28

Brukes til å samle inn informasjon om besøkende og kontakter

MARKETING_EMAIL

0-29

Detaljer om e-poster fra markedsføringshuben

AD_ACCOUNT

0-30

Lagrer informasjon om annonsekontoene dine på Linkedin, Facebook og Google

AD_CAMPAIGN

0-31

Detaljer om annonsekampanjene dine. En annonsekampanje kan inneholde én eller flere annonser

AD_GROUP

0-32

Logisk gruppering av annonser i en annonsekampanje

AD

0-33

Detaljer om individuelle annonser

KAMPANJE

0-35

Informasjon om relaterte markedsføringsressurser og -innhold, slik at du enkelt kan måle effektiviteten av den samlede markedsføringsinnsatsen.

SITE_PAGE

0-38

Data om individuelle sider på nettsidene dine

BLOGG_POST

0-39

Data om blogginnlegg

OBJECT LIST

0-45

Informasjon om grupperinger av objektposter basert på egenskaper eller aktiviteter

RING

0-48

Anrop foretatt av andre CRM-poster, f.eks. kontakter

FAKTURA

0-53

Administrer og synkroniser fakturaer med eksterne regnskapssystemer

MEDIA_BRIDGE

0-57

Informasjon om medieressurser som importeres til Hubspot

SEQUENCE

0-58

En sekvens er en serie målrettede, tidsbestemte e-postmaler for å pleie kontakter over tid

DEAL_SPLIT

0-72

Deling av avtaler brukes til å dele avtalekreditten mellom flere brukere

SALES_DOKUMENT

0-83

Salgsdokumenter bygger et bibliotek med innhold som hele teamet kan laste opp og dele dokumenter med kontaktene dine.

TILBAKEMELDING_INNSENDING

0-19

Lagrer informasjon som er sendt inn i en tilbakemeldingsundersøkelse.

ABONNEMENT

0-69

Abonnementer inneholder informasjon om tilbakevendende betalinger

HANDELSBETALING

0-101

Inneholder data om innsamlede midler fra kunder



Hvert databaseobjekt returnerer følgende kolonner:

Navn på kolonnen

Type

Beskrivelse

OBJECTTYPEID

Varchar

ID-en til objekttypen (f.eks. kontakter er 0-1).

OBJECTID

Antall

ID-en til posten (f.eks. en kontaktpost med ID 123752).

OPPDATERTAT

Tidsstempel

Datoen og klokkeslettet da dette objektet sist ble oppdatert i HubSpot.

INGESTEDAT

Tidsstempel

Datoen og klokkeslettet da dataene sist ble tatt inn av Snowflake.

PROPERTY_*

Varchar

Individuelle kolonner som inneholder den nyeste versjonen av objektets egenskaper For hver objektegenskap som har en dato- eller talltype (som spesifisert av property_definitions), vil det være to kolonner:

  1. En kolonne som inneholder egenskapsverdien som en streng. Kolonnenavnet vil være property_unparsed_[name] . For eksempel vil DEAL-objektegenskapen deal_amount ha kolonnen property_unparsed_deal_amount
  2. En kolonne som inneholder verdien konvertert til den opprinnelige typen. Kolonnen vil ha navnet property_[name], for eksempel vil DEAL-objektegenskapen deal_amount ha kolonnen property_deal_amount. Merk at denne kolonnen vil inneholde null hvis konverteringen til opprinnelig type mislykkes på grunn av ugyldige data.

Eksempel 1


Hent fornavn, etternavn og livssyklusstadium for alle kontakter.

Forespørsel:


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

FROM objects_contact

Returnerer:

OBJECTID

FORNAVN

ETTERNAVN

LIVSLØPSFASEN

54325098

Hobbes

Baron

bly

96805401

Milo

Gull

bly

6922028

Henry

Riley

bly

Eksempel 2

Hent avtalens navn og stadium for opptil tre avtaler.

Query:


SELECT objectId, property_dealName, property_dealStage,
property_amount AS dealAmount

FROM objects_deals

LIMIT 3

Returnerer:

OBJECTID

PROPERTY_DEALNAME

PROPERTY_DEALSTAGE

PROPERTY_DEALAMOUNT

38960439

Navn på avtale 1

closedwon

34199

321740651

Testavtale 123

14845019

8383663

98392101

Pop-up baldakin

closedwon

9309007

Eksempel 3

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

Forespørsel:

Siden data om avtalebeløp er tilgjengelig som en talldatatype, kan de brukes til bestilling uten konvertering eller casting.


SELECT objectId, property_dealName, property_dealStage,
property_amount AS dealAmount

FROM objects_deals
ORDER BY property_amount DESC
LIMIT 3


Returnerer:

OBJECTID

PROPERTY_DEALNAME

PROPERTY_DEALSTAGE

PROPERTY_DEALAMOUNT

98392101

Pop-up baldakin

closedwon

9309007

321740651

Testavtale 123

14845019

8383663

38960439

Navn på avtale 1

closedwon

34199

objekt_med_objektegenskaper

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

Denne visningen kan returnere følgende kolonner:

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

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

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

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

Eksempel 1

Hent alle kontakter og deres egenskaper.

Forespørsel:


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


Returnerer:

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

Eksempel 2

Hent avtalens navn og stadium for opptil tre avtaler.

Forespørsel:


SELECT

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


Returnerer:

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

gjenstander

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

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

Dette databaseobjektet kan returnere følgende kolonner:

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

Eksempel 1

Hent alle kontaktoppføringer.

Forespørsel:


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


Returnerer:

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

object_properties

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

Dette databaseobjektet kan returnere følgende kolonner:

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

Eksempel 1

Henter fornavn, etternavn og byegenskaper for alle kontakter.

Forespørsel:


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


Returnerer:

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

Eksempel 2

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

Forespørsel:


SELECT objectId, firstname, lastname, lifecyclestage
FROM
(
SELECT objectId, name, value
FROM object_properties
WHERE objectTypeId = '0-1'
AND name IN ('firstname', 'lastname', 'lifecyclestage')
)
PIVOT(MAX(value) FOR name IN ('firstname', 'lastname', 'lifecyclestage')) AS p(objectId, firstname, lastname, lifecyclestage);

Returnerer:

OBJECTTYPEID OBJECTID FORNAVN ETTERNAVN LIVSLØPSFASEN
0-1 54325098 Hobbes Baron bly
0-1 96805401 Milo Gull bly
0-1 6922028 Henry Riley bly
... ... ... ... ...

object_properties_history

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

Dette databaseobjektet kan returnere følgende kolonner:

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

Eksempel 1

Hent historikken til en enkelt eiendom for en enkelt kontakt.

Forespørsel:


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


Returnerer:

OBJECTID NAVN VERDI OPPDATERTAT

136493192

hs_prediktivecoringnivå

nivå_1

2022-06-22 22:45:05.931

136493192

hs_prediktivecoringnivå

nivå_2

2021-09-18 08:20:56.622

136493192

hs_prediktivecoringnivå

nivå_3

2019-11-31 18:20:22.851

...

...

...

...

Eksempel 2

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

Forespørsel:


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


Returnerer:

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

Forespørsler om assosiasjoner

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

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

assosiasjoner_x_to_y visninger

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

Hvert databaseobjekt returnerer følgende kolonner:

Navn på kolonnen

Type

Beskrivelse

COMBINEDASSOCIATIONTYPEID

Varchar

Den unike identifikatoren for tilknytningsdefinisjonen.

FORENINGSKATEGORI

Varchar

Kilden til tilknytningstypen. En av følgende: HUBSPOT_DEFINED, USER_DEFINED, INTEGRATOR_DEFINED

FORENINGSTYPEID

Varchar

En unik identifikator for en assosiasjonsdefinisjon innenfor en bestemt assosiasjonskategori, dvs. at ingen to definisjoner i en assosiasjonskategori vil ha samme associationtypeid.

FROMOBJECTTYPEID

Varchar

Objekttypeid som er kilden til assosiasjonsdefinisjonen.

FROMOBJECTTYPE

Varchar

Navnet på objekttypen som er kilden til assosiasjonsdefinisjonen.

TOOBJECTTYPEID

Varchar

Objekttypeid som er destinasjonen for assosiasjonsdefinisjonen.

TOOBJECTTYPE

Varchar

Navnet på objekttypen som er destinasjonen for assosiasjonsdefinisjonen.

NAVN

Varchar

Navnet på assosiasjonsdefinisjonen.

MERK

Varchar

Foreningsdefinisjonens beskrivelse.

ISMAINASSOCIATIONDEFINITION

Boolsk

Om tilknytningsdefinisjonen er hovedtypen. Når true, er definisjonen den som HubSpot viser på tilknyttede poster.

[FROMOBJECTTYPE_OBJECTID] f.eks. for ASSOCIATIONS_CONTACTS_TO_DEALS-visningen vil dette være CONTACT_OBJECTID

Antall

Objekt-ID-en til kildeobjektet.

[TOOBJECTTYPE_OBJECTID] f.eks. for visningen ASSOCIATIONS_CONTACTS_TO_DEALS vil dette være DEAL_OBJECTID

Antall

Objekt-ID-en til destinasjonsobjektet.

INGESTEDAT

Tidsstempel

Datoen og klokkeslettet da dataene sist ble tatt inn av Snowflake.

Eksempel 1

Hent alle avtaler som er knyttet til en bestemt kontakt.

Forespørsel:


SELECT
kontakt_objektId, avtale_objektId

FROM foreninger_kontakter_til_avtaler

WHERE contactId = 6626541373

Returnerer:

KONTAKT_OBJEKTID

DEAL_OBJECTID

6626541373

233620335

6626541373

90253678

Eksempel 2

Hent alle kontakter basert i tidssonen Bogota og tilbudene deres.


SELECT contacts.property_firstname contact_firstname,

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

KONTAKT_FORNAVN

KONTAKT_ETTERNAVN

KONTAKT_EMAIL

DEAL_TYPE

DEAL_AMOUNT

David

Magalhães

dmagalhaes@example.com

newbusiness

74848

Fernanda

Rodrigues

fmoreira@example.com

newbusiness

253530

Eksempel 3

Hent alle kontakter og den totale summen av inngåtte avtaler for hver kontakt.


SELECT SUM(deals.property_hs_closed_amount) AS
total_closed_amount, contacts.property_email contact_email
FROM objects_contacts contacts
JOIN associations_contacts_to_deals assoc on
assoc.contact_objectid=contacts.objectid
JOIN objects_deals deals on deals.objectid=assoc.deal_objectid
GROUP BY contact_email
ORDER BY total_closed_amount DESC

Returnerer:

TOTALT_AVSLUTTET_BELØP

KONTAKT_EMAIL

98474793

johndoe@riverview.com

849488

sallymae@longford.com

assosiasjon_definisjoner

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

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

Dette databaseobjektet kan returnere følgende kolonner:

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

Eksempel 1

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

Forespørsel:


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


Returnerer:

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

Eksempel 2

Hent de tilgjengelige assosiasjonstypene mellom avtaler og selskaper.

Forespørsel:


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

ORDER BY category, id


Returnerer:

KOMBINERTFORENINGSTYPE FROMOBJECTTYPEID TOOBJECTTYPEID NAVN
0-5 0-3 0-2 DEAL_TO_COMPANY
0-271 0-3 0-2 DEAL_TO_PRIMARY_COMPANY
0-341 0-3 0-2 AVTALE_TIL_SELSKAP_UMERKET

foreninger

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

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

Dette databaseobjektet kan returnere følgende kolonner:

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

Eksempel 1

Hent alle tilknyttede avtaler og kontakter.

Forespørsel:


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


Returnerer:

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

Eksempel 2

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

Forespørsel:


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


Returnerer:

KOMBINERTFORENINGSTYPE FROMOBJECTID TOOBJECTID
0-5 6626541373 233620335

Eksempel 3

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

Forespørsel:


SELECT combinedAssociationTypeId, fromObjectId toObjectId,
FROM associations
WHERE
combinedAssociationTypeId = (
SELECT combinedAssociationTypeId
FROM association_definitions
WHERE fromObjectTypeId = '0-1'
AND toObjectTypeId = '0-3'
AND isMainAssociationDefinition)
AND fromObjectId = 4464;


Returnerer:

COMBINEDASSOCIATIONTYPEID FROMOBJECTID TOOBJECTID
0-5 6626541373 233620335

Forespørsler fra eierne

eiere

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

Dette databaseobjektet kan returnere følgende kolonner:

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

Eksempel 1

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

Forespørsel:


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


Returnerer:

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

Eksempel 2

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

Forespørsel:


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


Returnerer:

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

Eksempel 3

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


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

JOIN owners owner ON contact.property_hubspot_owner_id = owner.ownerId


Returnerer:

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

Forespørsler fra teamet

lag

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

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

Dette databaseobjektet kan returnere følgende kolonner:

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

Eksempel 1

Hent alle lagene.

Forespørsel:

SELECT teamId,teamName, primaryOwnerMembers

FRA team

Returnerer:

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

eier_team

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

Dette databaseobjektet kan returnere følgende kolonner:

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

Eksempel 1

Hent alle eiere for et gitt lag.

Forespørsel:

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

Retur

TEAMID TEAMNAME ISTEAMPRIMARY
29584574 233620335 SANT
29584574 1234553 SANT

Rørledningsspørringer

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

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

rørledninger

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

Denne tabellen kan returnere følgende kolonner:

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

Eksempel 1

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

Forespørsel:


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


Returnerer:

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

Eksempel 2

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

Forespørsel:


SELECT

deals.objectId deal_id,
deals.property_dealname deal_name,
pipelines.label pipeline_name
FROM objects_deals deals
INNER JOIN pipelines
ON deals.objectTypeId = pipelines.objectTypeId
AND deals.property_pipeline = pipelines.pipelineid
WHERE pipelines.objectTypeId = '0-3';


Returnerer:

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

Eksempel 3

Samme som i eksempel 2 ovenfor, hent avtaler i en bestemt pipeline. Men i stedet for å bruke objects_deals i sammenføyninger, bruker du object_with_object_properties.


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

Returnerer:

DEAL_ID

DEAL_NAME

PIPELINE_NAME

605140072

Meowmix Global Registrering

Salgspipeline

605457408

Friskies Rebrand

Salgspipeline

604362473

Fresh Step App Build

Salgspipeline

pipeline_stadier

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

Dette databaseobjektet kan returnere følgende kolonner:

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

Eksempel 1

Hent pipelinefaser for en avtalepipeline med navnet Salgspipeline.

Forespørsel:


SELECT pipelineid, stageId, label
FROM pipeline_stages
WHERE not archived
AND pipelineid = (
SELECT pipelineid
FROM pipelines
WHERE objectTypeId = '0-3'
AND not archived
AND label = 'Sales Pipeline' LIMIT 1)
ORDER BY displayorder;


Returnerer:

PIPELINEID STAGEID MERK
941650 941651 Kontaktet
941650 941652 Avtale planlagt
941650 941653 Faktura sendt
... ... ...

Eksempel 2

Hent alle avtaler og deres respektive pipeline-stadier.

Forespørsel:


SELECT

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


Returnerer:

DEAL_ID DEAL_NAME PIPELINE_NAME PIPELINE_STAGE_NAME
605140072 Meowmix Global Registrering Salgspipeline Kontrakt sendt
605457408 Friskies Rebrand Salgspipeline Avtale planlagt
604362473 Fresh Step App Build Salgspipeline Kontrakt signert
... ... ... ...

Forespørsler om eiendom

property_definitions

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

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

Dette databaseobjektet kan returnere følgende kolonner:

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

Eksempel 1

Henter navn og beskrivelser for alle kontaktegenskaper.

Forespørsel:


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


Returnerer:

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

Spørsmål om hendelser

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

Navn
HENDELSER_ANNONSE_INTERAKSJON Detaljer om en annonse og kontakter som interagerte med den ved å klikke på annonsen eller sende inn et skjema etter å ha interagert med den.
EVENTS_AD_METRICS_IMPORTED_V0

Detaljer om en annonse og dens ytelsesberegninger.
HENDELSER_ANROP_NEVNT_NØKKELORD Detaljer om nøkkelord som nevnes av deltakere i samtaler.
HENDELSER_KLIKKET_PÅ_LENKE_I_EPOST_V2

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

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

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

  • occurredat
  • occurredatdateint

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



Navn på kolonnen Type Beskrivelse
EVENTTYPEID Varchar ID-en til hendelsestypen, på samme måte som OBJECTTYPEID
Du kan søke etter alle hendelsestype-ID-er i kontoen din ved hjelp av visningen object_and_event_type_definitions.
ID Varchar Denne er unik for hver hendelsestype. Ingen to poster vil ha samme ID innenfor en gitt hendelsestype.
OBJECTTYPEID Varchar Objekttypen som fullførte hendelsen. For eksempel vil et klikk på en e-postlenke vise 0-1 i denne kolonnen, som representerer kontaktobjektet.
OBJECTID Antall ID-en til posten som fullførte hendelsen.
OCCURREDAT Tidsstempel Når hendelsen inntraff.

OCCURREDATDATEINT

Antall Et tall som representerer når hendelsen inntraff. Inneholder de samme dataene som kolonnen OCCURREDAT, men er formatert som et tall og brukes som en del av tabellens klyngenøkkel. I de fleste tilfeller kan du bruke OCCURREDAT tidsstempel i stedet for dette tallet.

OCCUREDATDATEINT

Antall

Et tall som representerer når hendelsen inntraff. Inneholder de samme dataene som kolonnen OCCURREDAT, men er formatert som et tall og brukes som en del av tabellens klyngenøkkel. I de fleste tilfeller kan du bruke OCCURREDAT tidsstempel i stedet for dette tallet.

Merk: Denne kolonnen vil bli utfaset 24. november 2022 og erstattet med OCCURREDATDATEINT.

OCCUREDAT Tidsstempel

Når hendelsen inntraff.

Merk: Denne kolonnen vil bli utfaset 24. november 2022 og erstattet med OCCURREDAT.

INGESTEDAT Tidsstempel Datoen og klokkeslettet da dataene sist ble tatt inn av Snowflake. Finn ut mer om kolonnedatatatyper.
PROPERTY_* Varchar Individuelle kolonner som inneholder hendelsesegenskapene.

Eksempel 1

Hent de 50 siste klikkhendelsene på e-post.

Forespørsel:


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

LIMIT 50;


Returnerer:

EVENTTYPEID OBJECTTYPEID OBJECTID OCCUREDAT HS_CLICK_RAW_URL
4-666288 0-1 45318579 2016-08-04 21:06:43.245 http://website.com?utm_campaign=Launch&utm_source=hs_email&utm_medium=email&utm_content=32520579
4-666288 0-1 80701 2016-08-29 13:31:28.622 https://cta-image-cms2.hubspot.com/ctas/v2/public/cs/ci/?pg=f0f6585a-08fc-4273-8422-49cfaddcf8d8&pid=1976760&ecid=ACsprvtkRbakerw4BiWlaDL7xFAqau1aW9m1_PAqSfQiWarY69X7Ds42zHGYTCfhHJLrXUP86Nxu
4-666288 0-1 26146013 2017-11-30 14:27:11.528 https://hubs.ly/H097a37a?utm_source=hs_email&utm_medium=email&utm_content=58251290
... ... ... ... ...

Eksempel 2

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

Forespørsel:


SELECT
click.occuredat click_timestamp,
click.property_hs_click_raw_url click_url,
contact.properties:firstname::varchar contact_firstname,
contact.properties:lastname::varchar contact_lastname
FROM events_clicked_link_in_email_V2 click
LEFT JOIN object_with_object_properties contact
ON click.objectTypeId = contact.objectTypeId
AND click.objectId = contact.objectId
LIMIT 3;


Returnerer:

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

Object_and_event_type_queries

objekt_og_hendelse_typedefinisjoner

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

Dette databaseobjektet kan returnere følgende kolonner:

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

Eksempel 1

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

Forespørsel:


SELECT objectTypeId, fullyQualifiedName
FROM object_and_event_type_definitions;


Returnerer:

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

Lister over forespørsler

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

lister

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

Dette databaseobjektet kan returnere følgende kolonner:

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

Eksempel 1

Hent alle kontaktlister.

Forespørsel:


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


Returnerer:

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

Eksempel 2

Hent en spesifikk kontaktliste med navnet Toppabonnenter 2021.

Forespørsel:


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


Returnerer:

LISTID NAVN STØRRELSE
771852 Topp abonnenter 2021 37

list_membership

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

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

Dette databaseobjektet kan returnere følgende kolonner:

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

Eksempel 1

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

Forespørsel:


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


Returnerer:

OBJECTID
54325098
96805401
6922028
...

Eksempel 2

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

Forespørsel:


SELECT

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


Returnerer:

OBJECTID

FORNAVN

ETTERNAVN

54325098

Hobbes

Baron

96805401

Milo

Gull

6922028

Henry

Riley

...

...

...

Vanlige spørsmål

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


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


SELECT * FROM property_definitions

WHERE label = [column_name]

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

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

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


Hvis du trenger å koble to eller flere forskjellige poster til hverandre, kan du ta en titt på assosiasjoner. Assosiasjoner representerer relasjonene mellom objekter i HubSpot CRM. Alle mulige assosiasjoner mellom to typer er oppført i association_definitions. I eksempelet ovenfor må du spørre ASSOCIATIONS_CAMPAIGNS_TO_FORMS for å finne ut alle skjemaene en kampanje er knyttet til:


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

Hvordan vet jeg status for HubSpot-Snowflake-integrasjonen?

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

SELECT * FROM hubspot.public.data_share_status
LIMIT 1

Resultatene vises som følger:

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

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

Var denne artikkelen nyttig?
Dette skjemaet brukes kun for tilbakemeldinger om dokumentasjon. Se hvordan du kan få hjelp med HubSpot.