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.
- 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.
Når miljøet er konfigurert, kan du gjøre spørringer til HubSpot-dataene dine uten å måtte legge til database- eller skjematypen din i spørringene manuelt.
Hvis du vil legge til databasen og skjematypen manuelt i spørringer, legger du til databasenavnet etterfulgt av skjemaet i begynnelsen av FROM
-feltet. For eksempel
SELECT objectTypeId, property_createddate
FROM hubspot_share_name.V2_LIVE.objects_deals
LIMIT 1
Oversikt over data
Spørringer er konstruert ved hjelp av SQL, og kan brukes til å hente HubSpot-data som f.eks:
- Objekter: standardobjekter og egendefinerte objekter, for eksempel kontakter, selskaper og produkter.
- Registreringer: individuelle registreringer, for eksempel en individuell kontakt eller et selskap.
- Assosiasjoner: alle tilgjengelige assosiasjonstyper og tilknyttede poster.
- Hendelser: Hendelsesdata for både standard HubSpot-hendelser, for eksempel e-poståpninger, og egendefinerte atferdshendelser.
- Lister: HubSpots kontakt- og selskapslister.
- Eiere: brukere i HubSpot-kontoen din, i forhold til postene de er angitt som eier av.
- Pipelines: avtale- og billettpipelines, inkludert pipelinefaser.
- Egenskaper: egenskaper og deres verdier i CRM-poster, inkludert eiendomshistorikk.
Finn ut mer omHubSpots CRM-datamodell.
Merk: Etter hvert som vi utvikler datadelingen, vil vi introdusere endringer, og noen av dem kan være brudd. Det anbefales på det sterkeste å abonnere på HubSpots endringslogg for utviklere. Disse endringene vil alltid bli lagt ut i endringsloggen i forkant av enhver oppdatering.
Begrensning og sortering av returnerte data
Når du konstruerer spørringer, kan du kontrollere hvor mye data som returneres, og i hvilken rekkefølge de returneres, ved å inkludere LIMIT
og ORDER BY
i spørringen. Hvis du for eksempel vil søke etter alle kontaktene med tilhørende egenskaper, men bare returnere tre resultater og sortere dem etter kontakt-ID, kan du konstruere spørringen på følgende måte:
SELECT objectTypeId, updatedAt, ingestedAt
FROM objects_deals
ORDER BY objectId
LIMIT 10;
Datatyper for kolonner
Når du spør etter data i Snowflake, avhenger kolonnene som returneres, av hvilke data du spør etter. Du kan se de tilgjengelige kolonnene for en gitt tabell eller visning i Snowflake ved å velge visningen i venstre sidefelt.
Merk: Iresten av dette dokumentet bruker vi begrepet databaseobjekt når konteksten gjelder både tabeller og visninger.
Hvis du vil returnere en bestemt kolonne, inkluderer du den kolonnen i SELECT
-feltet i spørringen. Følgende spørring returnerer for eksempel bare kolonnene OBJECTID
og UpdatedAt
:
SELECTobjectId, updatedAt
FROM objects_contacts
Nedenfor finner du generelle definisjoner for kolonner som en spørring kan returnere. For andre definisjoner som ikke er inkludert nedenfor, se de enkelte visningsdefinisjonene i artikkelen ovenfor.
- OBJECTTYPEID: en VARCHAR-verdi som representerer et objekts type. For eksempel representerer 0-1 kontaktobjektet, 0-2 representerer firmaobjektet, og 2-1232 kan representere et egendefinert objekt i kontoen din. I lister refererer dette til listetypen (f.eks. kontakt eller selskap). Du kan søke etter alle objekt- og hendelses-ID-er i kontoen din ved hjelp av visningen object_and_event_type_definitions.
- OBJECTID: et BIGINT-nummer som representerer en enkelt post av en gitt type objekt i HubSpot-kontoen din. For å identifisere en post må du bruke både objekttype-ID-en og objekt-ID-en.
- INGESTEDAT: tidsstempelet for når en datarad ble lagt til i Snowflake, representert ved en TIMESTAMP_NTZ-verdi. Ikke relatert til det logiske tidsstempelet for en opprettings- eller oppdateringsoperasjon i HubSpot.
- På grunn av HubSpots interne behandling kan tidsstempelet for inntak av en rad oppdateres selv om ingen andre kolonner på raden har endret seg.
- Når du bygger ETL-prosesser som kopierer nylig endrede data, anbefales det å basere spørringene på inntaksstempelet. Hvis flyten din kopierer data daglig, anbefales det dessuten å kopiere data fra de to foregående dagene for å ta høyde for forsinkelser.
- CREATEDAT og UPDATEDAT: det logiske tidsstempelet for når data ble opprettet eller oppdatert i HubSpot, representert ved en TIMESTAMP_NTZ-verdi . Disse tidsstemplene vil samsvare med tidsstemplene i HubSpot. For eksempel vil klokkeslettet som vises i HubSpot for opprettelsesdatoen for en post, være det samme som tidsstempelet i CREATEDAT-kolonnen i Snowflake. Disse er ikke direkte relatert til tidsstempelet for inntak, og det anbefales ikke å basere ETL-prosesser på disse egenskapene.
- COMBINEDASSOCIATIONTYPE: en VARCHAR-verdi som unikt identifiserer en assosiasjonsdefinisjon.
Transformere datatyper
Noen ganger returneres data fra en spørring med VARCHAR-kolonner når det ville være ønskelig å ha dem som en annen type. I slike tilfeller anbefales det å konvertere VARCHAR-datatypen til de ønskede typene ved hjelp av Snowflake-funksjoner. For eksempel lagres egenskapene til en objektpost som VARCHAR-datatyper i de fleste databaseobjekter, men noen ganger inneholder de tall- og datetime-verdier. Funksjoner som f.eks:
try_to_number, try_to_timestamp_ntz kan brukes til å konvertere disse VARCHAR-dataene til henholdsvis NUMBER- og DATETIME-typen:
SELECT objectid, value AS amount_str, try_to_number(value) AS amountFROM 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 |
0-1 |
Informasjon om enkeltpersoner som samhandler med virksomheten din |
|
0-2 |
Informasjon om enkeltbedrifter eller organisasjoner |
|
0-3 |
Detaljer om inntektsmuligheter med en kontakt eller et selskap. |
|
0-4 |
Lagrer data fra CRM-handlinger, inkludert notater, oppgaver, e-post, møter og samtaler. |
|
0-5 |
Representere kundeforespørsler om hjelp eller support. |
|
0-14 |
Brukes til å dele prisinformasjon med potensielle kjøpere. |
|
0-15 |
Detaljer for individuelle innsendinger for et HubSpot-skjema. |
|
0-8 |
Representerer en delmengde av produkter som selges i en avtale. Når et produkt knyttes til en avtale, blir det en varelinje. |
|
0-11 |
Detaljer om innkommende meldinger fra flere kanaler. |
|
0-25 |
Detaljer om landingssidene dine |
|
0-27 |
Lagrer informasjon om gjøremålslister |
|
0-28 |
Brukes til å samle inn informasjon om besøkende og kontakter |
|
0-29 |
Detaljer om e-poster fra markedsføringshuben |
|
AD_ACCOUNT |
0-30 |
Lagrer informasjon om annonsekontoene dine på Linkedin, Facebook og Google |
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 |
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 |
0-39 |
Data om blogginnlegg |
|
OBJECT LIST |
0-45 |
Informasjon om grupperinger av objektposter basert på egenskaper eller aktiviteter |
0-48 |
Anrop foretatt av andre CRM-poster, f.eks. kontakter |
|
FAKTURA |
0-53 |
Administrer og synkroniser fakturaer med eksterne regnskapssystemer |
0-57 |
Informasjon om medieressurser som importeres til Hubspot |
|
0-58 |
En sekvens er en serie målrettede, tidsbestemte e-postmaler for å pleie kontakter over tid |
|
0-72 |
Deling av avtaler brukes til å dele avtalekreditten mellom flere brukere |
|
0-83 |
Salgsdokumenter bygger et bibliotek med innhold som hele teamet kan laste opp og dele dokumenter med kontaktene dine. |
|
0-19 |
Lagrer informasjon som er sendt inn i en tilbakemeldingsundersøkelse. |
|
0-69 |
Abonnementer inneholder informasjon om tilbakevendende betalinger |
|
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:
|
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 lifecyclestageFROM 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 dealAmountFROM 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 dealAmountFROM 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:
SELECTobjectId,
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
WHERE
object_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:
SELECT
combinedAssociationTypeId, fromObjectTypeId, toObjectTypeId, name
FROM association_definitions
WHERE fromObjectTypeId = '0-3' AND toObjectTypeId = '0-2'
AND isMainAssociationDefinition = trueORDER 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:
SELECTdeals.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. |
|
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. |
|
Antall | Et tall som representerer når hendelsen inntraff. Inneholder de samme dataene som kolonnen Merk: Denne kolonnen vil bli utfaset 24. november 2022 og erstattet med |
OCCUREDAT |
Tidsstempel | Når hendelsen inntraff. Merk: Denne kolonnen vil bli utfaset 24. november 2022 og erstattet med |
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'
ANDlistName = 'Top subscribers 2021';
Returnerer:
LISTID | NAVN | STØRRELSE |
771852 | Topp abonnenter 2021 | 37 |
list_membership
Dette databaseobjektet inneholder informasjon om hvilke poster som er medlemmer av hvilke lister, med én rad per post i listen. Hvis du for eksempel har en bloggabonnentliste med 500 kontakter, vil databaseobjektet returnere 500 rader.
Inneholder bare liste-ID-er og objekt-ID-er. Du finner mer informasjon ved å koble deg til databaseobjektet lists.
Dette databaseobjektet kan returnere følgende kolonner:
Navn på kolonnen | Type | Beskrivelse |
LISTID |
Varchar | ID-en til listen. Linker til kolonnen HS_LIST_ID i tabellen lists. |
OBJECTID |
Varchar | ID-en til posten i listen. |
UPDATEDAT |
Tidsstempel | Datoen og klokkeslettet da dataene sist ble oppdatert i HubSpot. Lær mer om kolonnedatatatyper. |
INGESTEDAT |
Tidsstempel | Datoen og klokkeslettet da dataene sist ble tatt inn av Snowflake. |
Eksempel 1
Hent ID-ene til alle kontaktene i listen Toppabonnenter 2021.
Forespørsel:
SELECT objectId
FROM list_memberships
INNER JOIN lists
ON list_memberships.listId = lists.listId
WHERE lists.objectTypeId = '0-1'
AND lists.name = 'Top Subscribers 2021';
Returnerer:
OBJECTID |
54325098 |
96805401 |
6922028 |
... |
Eksempel 2
Hent for- og etternavn på kontaktopplysninger i listen Toppabonnenter 2021.
Forespørsel:
SELECT
contact.objectId AS objectid,
contact.property_firstname AS firstname,
contact.property_lastname AS lastname
FROM objects_contacts contact
INNER JOIN list_memberships ON contact.objectId = list_memberships.objectId
INNER JOIN lists ON list_memberships.listId = lists.listId
WHERE lists.objectTypeId = '0-1'
AND lists.name = 'Top Subscribers 2021'
Returnerer:
OBJECTID |
FORNAVN |
ETTERNAVN |
54325098 |
Hobbes |
Baron |
96805401 |
Milo |
Gull |
6922028 |
Henry |
Riley |
... |
... |
... |
Vanlige spørsmål
Jeg ønsker å generere data som ligner på en rapport fra Hubspot-appen, hvordan gjør jeg det?
Vanligvis vil du se på kolonnene i rapporten du sammenligner med. Hvis rapportvisualiseringen ikke er i tabellform, kan du konvertere den til en tabell for å vise kolonnene rapporten inneholder. Disse kolonnene er vanligvis egenskaper for en objekttype eller en hendelsestype. Neste trinn er å finne ut hvilken objekttypeegenskap en kolonne tilsvarer. Dette kan du gjøre ved å spørre property_definitions:
SELECT * FROM property_definitions
WHERE label = [column_name]
Det er ikke alltid det er en nøyaktig match, fordi noen egenskapsnavn vanligvis løses opp til et mer beskrivende navn i appen. I slike tilfeller kan det hjelpe å gjøre et uklart søk ved å bruke LIKE-operatoren på kolonnen label (eller til og med description) i property_definitions.
Når du har funnet ut hvilken objekttype kolonnen tilhører, er det enkelt å finne ut hva du skal spørre etter. Du kan ganske enkelt søke etter object_x-visningen som tilsvarer typen.
Hvordan kobler jeg denne datatypen til en annen, f.eks. hvordan henter jeg skjemaer til en kampanje?
Hvis du trenger å koble to eller flere forskjellige poster til hverandre, kan du ta en titt på assosiasjoner. Assosiasjoner representerer relasjonene mellom objekter i HubSpot CRM. Alle mulige assosiasjoner mellom to typer er oppført i association_definitions. I eksempelet ovenfor må du spørre ASSOCIATIONS_CAMPAIGNS_TO_FORMS for å finne ut alle skjemaene en kampanje er knyttet til:
SELECT campaigns.property_hs_name campaign_name,
forms.property_hs_form_id form_id
FROM objects_campaigns campaigns
JOIN associations_campaigns_to_forms assoc ON
assoc.campaign_objectid=campaigns.objectid
JOIN objects_forms forms ON forms.objectid=assoc.form_objectid
GROUP BY campaign_name
Hvordan vet jeg status for HubSpot-Snowflake-integrasjonen?
Hvis du vil motta statusoppdateringer i sanntid om avbrudd og problemer for HubSpot-Snowflake-integrasjonen, kan du søke i data_share_status-visningen:
SELECT * FROM hubspot.public.data_share_status
LIMIT 1
Resultatene vises som følger:
STATUS | MELDING | OPPDATERTAT |
OK | INGEN KJENTE HENDELSER FOR ØYEBLIKKET | 2023-04-10 09:21:20.123 |
Denne visningen gir oppdateringer om integrasjonsstatusen i omvendt kronologisk rekkefølge. Ved å integrere resultatene av denne spørringen i et dashbord kan du følge med på integrasjonens ytelse og oppdage eventuelle driftsstanser eller avbrudd.