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.

Hente HubSpot-data i Snowflake

Sist oppdatert: 24 september 2026

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

Data Hub Enterprise

Når du har koblet Snowflake til HubSpot-kontoen din, kan du bruke Snowflakes Data Share til å hente ut HubSpot-data fra Snowflake-kontoen din.

Dataforsinkelse og regionen for Snowflake-kontoen din

Du vil ha tilgang til V2_LIVE-skjemaet, som oppdateres hvert 15. minutt, og V2_DAILY-skjemaet, som oppdateres hver dag.

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

Konfigurer Snowflake-miljøet ditt

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

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

Klikk påhandlingslinjen forregnearket i den øverste raden av regnearket.
I popup-vinduet:
- Klikk på rullegardinmenyen«Lager», og velg deretterlageret ditt.
- Klikk på rullegardinmenyen«Database», og velg deretter HubSpot-databasen din.
- Klikk på rullegardinmenyen«Skjema», og velg deretter skjemaet du vil bruke:

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

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

SELECT objectTypeId, objectId, updatedAt

FRA hubspot_share_name.V2_LIVE.objects

WHERE objectTypeId = '0-3'

BEGRENS 1;

Dataoversikt

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

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

Lær mer om HubSpots CRM-datamodell.

Merk: Etter hvert som vi videreutvikler datadelingen, vil vi innføre endringer, hvorav noen vil være brytende endringer. Det anbefales på det sterkeste å abonnere på HubSpots endringslogg for utviklere. Disse endringene vil alltid bli publisert i endringsloggen før en oppdatering gjennomføres.

Begrensning og sortering av returnerte data

Når du utformer spørsmål, kan du kontrollere hvor mye data som returneres, samt rekkefølgen de returneres i, ved å inkludereLIMIT og ORDER BY i spørsmålet ditt. For eksempel, for å søke etter alle kontakter med deres egenskaper, men bare returnere tre resultater og sortere dem etter kontakt-ID, kan du utforme spørsmålet ditt som følger:

SELECT objectTypeId, updatedAt, ingestedAt

FROM objekter

WHERE objectTypeId = '0-1'

SORTER ETTER objekt-ID

BEGRENS 10;

Datatyper for kolonner

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

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

snowflake-sidebar-view-column-details0

For å returnere en bestemt kolonne, må du inkludere den kolonnen i SELECT i spørringen din. For eksempel vil følgende spørring kun returnere kolonnene OBJECTID og UpdatedAt

SELECT objectTypeId, updatedAt, ingestedAt

FROM objekter

WHERE objectTypeId = '0-1'

SORTER ETTER objekt-ID

BEGRENS 10;

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 kontakter-objektet, 0-2 representerer selskaper-objektet, og 2-1232 kan representere et tilpasset objekt i kontoen din. I segmenter refererer dette til segmenttypen (f.eks. kontakt eller selskap). Du kan søke etter alle objekt- og hendelses-ID-er i kontoen din ved hjelp av visningen object_and_event_type_definitions.
OBJECTID: et BIGINT- tall som representerer en enkelt post av en gitt objekttype i HubSpot-kontoen din. For å identifisere en post må du bruke både objekttype-ID-en og objekt-ID-en.
INGESTEDAT: tidsstemplet for når en datarad ble lagt til i Snowflake, representert av en TIMESTAMP_NTZ- verdi. Har ikke noe å gjøre med det logiske tidsstemplet for en opprettelses- eller oppdateringsoperasjon i HubSpot.
- På grunn av HubSpots interne behandling kan tidsstemplet for innlasting av en rad bli oppdatert selv om ingen andre kolonner i raden har endret seg.
- Når du bygger ETL-prosesser som kopierer nylig endrede data, anbefales det å basere spørringene dine på innlesningstidsstemplet. I tillegg, hvis flyten din kopierer data daglig, anbefales det å kopiere data fra de to foregående dagene for å ta høyde for forsinkelser.
CREATEDAT og UPDATEDAT: den logiske tidsstemplingen for når dataene ble opprettet eller oppdatert i HubSpot, representert av en TIMESTAMP_NTZ-verdi . Disse tidsstemplingene vil samsvare med tidsstemplingene i HubSpot. For eksempel vil klokkeslettet som vises i HubSpot for opprettelsesdatoen til en post, være det samme som tidsstemplet i CREATEDAT-kol onnen i Snowflake. Disse er ikke direkte knyttet til innlesningstidsstemplet, og det anbefales ikke å basere ETL-prosesser på disse egenskapene.
COMBINEDASSOCIATIONTYPE: en VARCHAR -verdi som entydig identifiserer en assosiasjonsdefinisjon.

Konvertering av datatyper

Noen ganger returneres data fra en spørring med VARCHAR-kolonner, mens det ville vært ønskelig å ha dem i en annen type. I slike tilfeller anbefales det å konvertere VARCHAR-datatypen til de ønskede typene ved hjelp av Snowflake-funksjoner. For eksempel lagres egenskaper for en objektpost som VARCHAR-datatyper i de fleste databaseobjekter, men inneholder noen ganger tall- og dato-/tidsverdier. Funksjoner som:
try_to_number, try_to_timestamp_ntz kan brukes til å konvertere disse VARCHAR-dataene til henholdsvis NUMBER - og DATETIME -typer:

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

Objektsøk

Nedenfor kan du lære hvordan du henter data fra bestemte HubSpot-objekter og -poster, samt hvilke data som returneres.

Objektdata er tilgjengelig i delte databaseobjekter. Filtrer etter objectTypeId for å hente en bestemt objekttype. Bruk OBJECT_WITH_OBJECT_PROPERTIES når du trenger de gjeldende egenskapene for hver post. Egenskapsverdiene lagres i properties JSON-kolonnen. Bruk OBJECTS for kjerneattributter i postene og OBJECT_PROPERTIES eller OBJECT_PROPERTIES_HISTORY for data per egenskap.

Objektnavn	ObjectTypeId
Kontakter	0-1
Bedrifter	0–2
Linjeposter	0-8

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

Se flere detaljer i «object_with_object_properties», «object_properties», «objects» og «object_properties_history» nedenfor.

object_with_object_properties

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

Denne visningen kan returnere følgende kolonner:

Kolonnenavn	Type	Beskrivelse
`OBJECTTYPEID`	Varchar	ID-en til objekttypen (f.eks. er kontakter `0-1`).
`OBJECTID`	Tall	ID-en til posten (f.eks. en kontaktpost med ID `123752`).
`PROPERTIES`	Variant	Postens egenskapsverdier.
`UPDATEDAT`	Tidsstempel	Dato og klokkeslett for når posten sist ble oppdatert i HubSpot. Les mer om datatyper for kolonner.
`INGESTEDAT`	Tidsstempel	Dato og klokkeslett for når dataene sist ble importert av Snowflake.

Merk: 25. januar 2022 vil kolonnen «timestamp » i tabellen og visningen «object_with_object_properties», som representerer datoen og klokkeslettet da objektposten sist ble oppdatert i HubSpot, bli endret til «updatedat». Dette gjøres for å samsvare med hvordan dato- og klokkeslettdata representeres i resten av datadelingen.

Siden dette er en endring som medfører kompatibilitetsproblemer, er den nye kolonnen «updatedat» lagt til i tabellen og visningen. I løpet av de neste 90 dagene vil disse to nye kolonnene eksistere side om side med «timestamp», kolonnene de skal erstatte. Dette gir deg muligheten til å 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å å foreta en forespørsel til tabellen «object_with_object_properties» eller visningen ved hjelp av «timestamp»-kolonner mislykkes.

Eksempel 1

Hent alle kontakter og deres egenskaper.

Spørring:

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

Returnerer:

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

Eksempel 2

Hent avtalenavn og fase for opptil tre avtaler.

Spørring:

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

Returnerer:

OBJECTID	DEALNAME	AVTALEFASE	AVTALEBELØP
38960439	Avtalenavn 1	avsluttet-tapt	7488939
321740651	Avtalenavn 1	avsluttet vunnet	9292029
98392101	Avtalenavn 1	avsluttet tapt	62626528

objekter

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

Dette databaseobjektet inneholder gjeldende objektdata uten egenskapsverdier. Bruk det når du kun trenger kjerneattributter for postene, eller koble det sammen med OBJECT_PROPERTIES når du trenger utvalgte egenskaper. Ved å bruke dette databaseobjektet sammen med databaseobjektet object_properties blir det mulig å replikere dataene i object_with_object_properties, samtidig som du beholder kontrollen over hvilke egenskaper som returneres.

Dette databaseobjektet kan returnere følgende kolonner:

Kolonnenavn	Type	Beskrivelse
`OBJECTTYPEID`	Varchar	ID-en til objekttypen (f.eks. er kontakter `0-1`).
`OBJECTID`	Tall	ID-en til posten (f.eks. en kontaktpost med ID `123752`).
`INGESTEDAT`	Tidsstempel	Dato og klokkeslett for når dataene sist ble importert av Snowflake. Les mer om datatyper for kolonner.

Eksempel 1

Hent alle kontaktposter.

Spørring:

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

Returnerer:

OBJECTTYPEID	OBJEKTID
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 for en gitt post. For eksempel vil en kontakt ha én rad for egenskapen «Fornavn» og én rad for egenskapen«Etternavn ». Hvis en post ikke har en verdi for en egenskap, vil raden enten vises med en tom streng eller ikke vises i det hele tatt.

Dette databaseobjektet kan returnere følgende kolonner:

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

Eksempel 1

Hent egenskapene «Fornavn», «Etternavn» og «By» for alle kontakter.

Spørring:

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

Returnerer:

OBJECTTYPEID	OBJECTID	NAVN	VALUE
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 livssyklusstadiet for alle kontakter, og kombiner dem til én rad per kontakt. Dette eksemplet bruker SQL PIVOT-syntaksen.

Spørring:

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

Returnerer:

OBJEKTTYPE-ID	OBJEKTID	FORNAVN	ETTERNAVN	LIVSSYKLUSFASE
0-1	54325098	Hobbes	Baron	ledelse
0-1	96805401	Milo	Gull	ledelse
0-1	6922028	Henry	Riley	ledelse
...	...	...	...	...

object_properties_history

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

Dette databaseobjektet kan returnere følgende kolonner:

Kolonnenavn	Type	Beskrivelse
`OBJECTTYPEID`	Varchar	ID-en til objekttypen (f.eks. er «kontakter» `0-1`).
`OBJECTID`	Tall	ID-en til posten (f.eks. en kontaktpost med ID `123752`).
`NAME`	Varchar	Navnet på egenskapen.
`VALUE`	Tidsstempel	Verdien av egenskapen.
`UPDATEDAT`	Tidsstempel	Dato og klokkeslett for når dataene sist ble oppdatert i HubSpot. Les mer om datatyper for kolonner.
`INGESTEDAT`	Tidsstempel	Dato og klokkeslett for når dataene sist ble importert av Snowflake.

Eksempel 1

Hent historikken til en enkelt egenskap for en enkelt kontakt.

Spørring:

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

Returnerer:

OBJECTID	NAVN	VALUE	OPPDATERINGSDATO
136493192	hs_predictivescoringtier	tier_1	22.06.2022 22:45:05,931
136493192	hs_prediktiv_poengnivå	tier_2	18.09.2021 08:20:56.622
136493192	hs_prediktiv_poengnivå	tier_3	31.11.2019 18:20:22,851
...	...	...	...

Eksempel 2

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

Spørring:

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

Returnerer:

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

Assosiasjonsspørsmål

Assosiasjonsdata er tilgjengelig i ASSOCIATIONS. Filtrer etter combinedAssociationTypeId for å hente en bestemt assosiasjonstype. Koble ASSOCIATIONS med ASSOCIATION_DEFINITIONS for å identifisere de relaterte objekttypene og assosiasjonsdefinisjonen.

association_definitions

Dette databaseobjektet inneholder informasjon om alle tilgjengelige assosiasjonstyper mellom HubSpot-objekter, med én rad per assosiasjonstype. Du kan koble dette databaseobjektet med databaseobjektet for assosiasjoner for å få oppføringsspesifikk informasjon om assosiasjoner.

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:

Kolonnenavn	Type	Beskrivelse
`COMBINEDASSOCIATIONTYPEID`	Varchar	Den unike identifikatoren for assosiasjonsdefinisjonen.
`CATEGORY`	Varchar	Kilden til assosiasjonstypen. En av følgende: `HUBSPOT_DEFINED`, `USER_DEFINED`, `INTEGRATOR_DEFINED`
`ID`	Tall	Identifikatoren for assosiasjonsdefinisjonen innenfor sin kategori.
`FROMOBJECTTYPEID`	Varchar	ID-en til objektet som er kilden til assosiasjonsdefinisjonen.
`TOOBJECTTYPEID`	Varchar	ID-en til objektet som er målet for assosiasjonsdefinisjonen.
`NAME`	Varchar	Navnet på assosiasjonsdefinisjonen.
`LABEL`	Varchar	Etiketten til assosiasjonsdefinisjonen.
`ISMAINASSOCIATIONDEFINITION`	Boolsk	Angir om assosiasjonsdefinisjonen er hovedtypen. Når verdien er «true», er dette definisjonen som HubSpot viser på tilknyttede poster.
`INGESTEDAT`	Tidsstempel	Dato og klokkeslett for når dataene sist ble importert av Snowflake. Les mer om datatyper for kolonner.

Eksempel 1

Hent de tilknytningstypene som er tilgjengelige i kontoen din.

Spørring:

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

Returnerer:

KOMBINERT ASSOSIASJONSTYPE	FROMOBJECTTYPEID	TOOBJECTTYPEID	NAME
0-1	0-1	0-2	KONTAKT_TIL_SELSKAP
0-2	0-2	0-1	SELSKAP_Å_KONTAKTE
0–3	0–3	0-1	DEAL_TO_CONTACT
0-4	0-1	0-3	KONTAKT_TIL_AVTALE
0-5	0-3	0-2	AVTALE_MED_SELSKAP
...	...	...	...

Eksempel 2

Hent de tilgjengelige assosiasjonstypene mellom avtaler og selskaper.

Spørring:

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

Returnerer:

KOMBINERT FORENINGSTYPE	FRA OBJEKTTYPE-ID	TIL OBJEKTTYPE-ID	NAVN
0–5	0-3	0-2	DEAL_TO_COMPANY
0-271	0-3	0-2	AVTALE_MED_HOVEDSELSKAP
0-341	0-3	0-2	AVTALE_MED_SELSKAP_UTEN_MERKNAD

associations

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

Dette databaseobjektet inneholder tilknytningsposter for alle tilknytningstyper. Filtrer etter combinedAssociationTypeId og koble sammen med ASSOCIATION_DEFINITIONS når du trenger metadata om tilknytninger.

Dette databaseobjektet kan returnere følgende kolonner:

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

Eksempel 1

Hent alle tilknyttede avtaler og kontakter.

Spørring:

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 saker knyttet til en bestemt kontakt (kontakt-ID: 3005).

Spørring:

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

Resultat:

KOMBINERT ASSOSIASJONSTYPE	FRA OBJEKT-ID	TIL OBJEKT-ID
0–5	6626541373	233620335

Eksempel 3

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

Spørring:

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

Resultat:

KOMBINERT ASSOSIASJONSTYPE-ID	FRAOBJEKTID	TILOBJEKTID
0–5	6626541373	233620335

Eierforespørsler

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 den samme brukeren.

Dette databaseobjektet kan returnere følgende kolonner:

Kolonnenavn	Type	Beskrivelse
`OWNERID`	Tall	Brukerens eier-ID.
`USERID`	Tall	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 er slettet.
`CREATEDAT`	Tidsstempel	Dato og klokkeslett da brukeren ble opprettet i HubSpot. Se kolonnedatatyper for mer informasjon.
`UPDATEDAT`	Tidsstempel	Dato og klokkeslett da brukeren sist ble oppdatert i HubSpot. Se kolonnedatatyper for mer informasjon.
`INGESTEDAT`	Tidsstempel	Dato og klokkeslett da dataene sist ble importert av Snowflake.

Eksempel 1

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

Spørring:

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

Returnerer:

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

Eksempel 2

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

Spørring:

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

Resultat:

EIER-ID	BRUKER-ID	E-POST	FORNAVN	ETTERNAVN
29584574	4621126	233620335	Hobbes	Baron

Eksempel 3

Hent alle kontakter og deres eiere. Denne spørringen kobler poster til eiere ved hjelp av object_with_object_properties og kontaktattributtet hubspot_owner_id.

SELECT

contact.objectId AS contact_id,

contact.properties:firstname::string AS contact_firstname,

contact.properties:lastname::string AS contact_lastname,

contact.properties:hubspot_owner_id::number AS contact_hubspot_owner_id,

eier.fornavn AS eier_fornavn,

owner.lastname AS eier_etternavn,

eier.e-post AS eier_e-post

FRA objekt_med_objekt_egenskaper AS kontakt

SLÅ SAMMEN eiere AS eier

PÅ contact.properties:hubspot_owner_id::number = owner.ownerId

WHERE contact.objectTypeId = '0-1';

Returnerer:

KONTAKTID	CONTACT_FIRSTNAME	CONTACT_ETTERNAVN	CONTACT_HUBSPOT_EIER_ID	EIER_FORNAVN	EIER_ETTERNAVN	EIER_E-POST
113834202	Richard	Greenfield	29584574	Hobbes	Baron	hobbes.b@business.com
53540801	Ford	Karl	30241125	Milo	Gold	milo.g@business.com
...	...	...	...	...	...	...

Teamspørsmål

team

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

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

Dette databaseobjektet kan returnere følgende kolonner:

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

Eksempel 1

Hent alle team.

Spørring:

SELECT teamId,teamName, primaryOwnerMembers

FROM teams

Returnerer:

TEAMID	TEAMNAVN	PRIMÆRE EIERMEDLEMMER
29584574	Underlag	[233620335, 1234553]
30532717	Superlag	[3866015468, 126221873]
3058032	A-laget	[7132752747]

owner_team

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

Dette databaseobjektet kan returnere følgende kolonner:

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

Eksempel 1

Hent alle eiere for et gitt team.

Spørring:

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

Returnerer

TEAMID	TEAMNAME	ISTEAMPRIMARY
29584574	233620335	SANT
29584574	1234553	SANT

Pipeline-spørsmål

Nedenfor kan du lære hvordan du spør data om avtale- og ticket-pipelines, for eksempel de tilgjengelige pipeline-ene i kontoen din og trinnene i disse.

Du kan koble disse dataene sammen med objektdata for å få et fullstendig overblikk over pipelinene dine. Du kan for eksempel søke etter avtaler og tilhørende pipeliner ved å koble object_with_object_properties sammen med pipelines».

pipelines

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

Denne tabellen kan returnere følgende kolonner:

Kolonnenavn	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	Navnet på pipelinen i HubSpot.
`DISPLAYORDER`	Tall	Rekkefølgen som pipelinen vises i i HubSpot.
`ARCHIVED`	Boolsk	Om pipelinen er slettet.
`CREATEDAT`	Tidsstempel	Når rørledningen ble opprettet.
`UPDATEDAT`	Tidsstempel	Dato og klokkeslett for når dataene sist ble oppdatert i HubSpot. Les mer om datatyper for kolonner.
`INGESTEDAT`	Tidsstempel	Dato og klokkeslett for når dataene sist ble importert av Snowflake.

Eksempel 1

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

Spørring:

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

Returnerer:

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

Eksempel 2

Hent avtaler innenfor en bestemt pipeline ved å brukeobject_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 omprofilering	Salgspipeline
604362473	Utvikling av Fresh Step-appen	Salgspipeline

pipeline_stages

Denne visningen inneholder informasjon om individuelle trinn i en pipeline. Identifiser trinn ved å kombinere objekttype-ID, pipeline-ID og trinn-ID. Når du kobler sammen med pipelines, bruker du objekttype-ID og pipeline-ID.

Dette databaseobjektet kan returnere følgende kolonner:

Kolonnenavn	Type	Beskrivelse
`PIPELINEID`	Varchar	Rørledningens ID.
`STAGEID`	Varchar	Trinnets ID.
`LABEL`	Varchar	Navnet på scenen i HubSpot.
`DISPLAYORDER`	Tall	Rekkefølgen som pipelinen vises i i HubSpot.
`METADATA`	Variant	En beskrivelse av fasen i JSON-format, 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 rørledningstrinn for en avtalepipeline med navnetSalgspipeline.

Spørring:

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

Returnerer:

PIPELINEID	STAGEID	LABEL
941650	941651	Kontaktet
941650	941652	Avtale avtalt
941650	941653	Faktura sendt
...	...	...

Eksempel 2

Hent alle avtaler og deres respektive faser i salgsrørledningen.

Spørring:

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

Resultat:

DEAL_ID	DEAL_NAME	PIPELINE_NAME	PIPELINE_STAGE_NAME
605140072	Meowmix Global Registrering	Salgspipeline	Kontrakt sendt
605457408	Friskies omprofilering	Salgspipeline	Avtale avtalt
604362473	Utvikling av Fresh Step-app	Salgspipeline	Kontrakt inngått
...	...	...	...

Eiendomssøk

property_definitions

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

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

Dette databaseobjektet kan returnere følgende kolonner:

Kolonnenavn	Type	Beskrivelse
`OBJECTYPEID`	Varchar	ID-en til objektet som hendelsen er knyttet til.
`NAME`	Varchar	Egenskapens interne navn.
`LABEL`	Varchar	Egenskapens etikett.
`DESCRIPTION`	Varchar	Beskrivelsen av egenskapen.
`TYPE`	Varchar	Eiendommens type (f.eks. streng, tall, dato og klokkeslett).
`FIELDTYPE`	Varchar	Egenskapens felttype. Definerer hvordan egenskapen vises i HubSpot og på skjemaer (f.eks. avkryssingsrute, nedtrekksmeny).
`DISPLAYORDER`	Tall	Egenskapens visningsrekkefølge.
`GROUPNAME`	Varchar	Eiendommens gruppenavn.
`OPTIONS`	Variant	For oppregningsegenskaper, en matrise med egenskapens alternativer, inkludert hvert alternativs attributter (f.eks. visningsrekkefølge, etikett).
`CREATEDUSERID`	Tall	ID-en til brukeren som opprettet egenskapen.
`REFERENCEDOBJECTTYPE`	Varchar	Typen av objekt som egenskapen refererer til. Eieregenskaper vil returnere verdien OWNER.
`CALCULATED`	Boolean	Om egenskapen er en beregnet egenskap.
`EXTERNALOPTIONS`	Boolsk	Angir om egenskapens alternativer er definert i et eksternt system.
`HASUNIQUEVALUE`	Boolsk	Angir om egenskapens verdier er unike. Kan kun angis når en egenskap opprettes via API-et.
`HIDDEN`	Boolsk	Angir om egenskapen er skjult i HubSpot.
`SHOWCURRENCYSYMBOL`	Boolsk	Om verdien til en tall-egenskap 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	Angir om egenskapen ble opprettet av HubSpot, i motsetning til av en bruker.
`ARCHIVED`	Boolsk	Om egenskapen er slettet.
`CREATEDAT`	Tidsstempel	Dato og klokkeslett da egenskapen ble opprettet i HubSpot.
`UPDATEDAT`	Tidsstempel	Dato og klokkeslett da dataene sist ble oppdatert i HubSpot. Les mer om datatyper for kolonner.
`INGESTEDAT`	Tidsstempel	Dato og klokkeslett for når dataene sist ble importert av Snowflake.

Eksempel 1

Hent navnene og beskrivelsene for alle kontaktegenskaper.

Spørring:

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

Returnerer:

NAME	ETIKETT	BESKRIVELSE
entered_sql_stage	Innført i SQL-trinn	Start telling av SQL-trinnsdager.
navn_på_første_konverteringshendelse	Første konvertering	Det første skjemaet denne kontakten sendte inn.
adresse	Gateadresse	Kontaktens adresse.

Hendelsesspørsmål

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

Navn
EVENTS_AD_INTERACTION	Detaljer om en annonse og kontakter som har interagert med den ved å klikke på annonsen eller sende inn et skjema etter å ha engasjert seg med den.
EVENTS_AD_METRICS_IMPORTED_V0	Detaljer om en annonse og dens ytelsesmålinger.
EVENTS_CALL_MENTIONED_KEYWORD	Detaljer om søkeord som er nevnt av deltakere i samtaler.
EVENTS_CLICKED_LINK_IN_EMAIL_V2	Lenker som kontakter har klikket på i markedsførings-e-poster.
EVENTS_CLICKED_LINK_IN_TRACKED_INBOX_EMAIL_V8	Lenker som kontakter har klikket på i e-poster i Conversations-innboksen.
EVENTS_COOKIE_BANNER_CLICKED	Kontakter som har klikket på informasjonskapsler.
EVENTS_COOKIE_BANNER_VIEWED	Kontakter som har sett på informasjonskapsler.
EVENTS_DOCUMENT_SHARED_V2	Salgsdokumenter som er delt med kontakter via en ekstern lenke.
EVENTS_DOCUMENT_VIEWED_V2	Salgsdokumenter og kontakter som har sett dem ved å åpne den eksterne lenken.
EVENTS_DOCUMENT_COMPLETED_V2	Salgsdokumenter og kontakter som har avsluttet dem.
EVENTS_HS_SCHEDULED_EMAIL_V2	E-poster som er sendt til HubSpots e-postservere for utsendelse.
EVENTS_MTA_DELIVERED_EMAIL_V2	E-poster som er levert til mottakerne av HubSpots e-postservere.
EVENTS_MTA_BOUNCED_EMAIL_V2	Forsøk på levering av e-post som ble avvist av mottakerens e-postserver.
EVENTS_OPENED_EMAIL_V2	E-poster åpnet av kontakter.
EVENTS_REPORTED_SPAM_EMAIL_V2	E-poster som er merket som spam av mottakere.
EVENTS_UPDATED_EMAIL_SUBSCRIPTION_STATUS_V2	Endringer i e-postabonnementer foretatt av mottakere.
EVENTS_OPENED_TRACKED_INBOX_EMAIL_V8	Åpninger av e-post i innboksen som spores av kontakter.
EVENTS_MB_MEDIA_PLAYED	Aktivitet knyttet til avspilling av videoer av kontakter.
EVENTS_V2_CONTACT_BOOKED_MEETING_THROUGH_SEQUENCE	Kontakten har booket et møte via sekvensen.
EVENTS_V2_CONTACT_ENROLLED_IN_SEQUENCE	Kontakten har meldt seg på fra sekvensen.
EVENTS_V2_CONTACT_FINISHED_SEQUENCE	Sekvensen er fullført.
EVENTS_V2_CONTACT_REPLIED_SEQUENCE_EMAIL	Kontakten har svart på e-post (eller innkommende e-post som avmeldte sekvensen) sendt gjennom sekvensen.
EVENTS_V2_CONTACT_UNENROLLED_FROM_SEQUENCE	Kontakten har meldt seg ut av sekvensen.
EVENTS_V2_CONTACT_UNENROLLED_MANUALLY_FROM_SEQUENCE	Brukeren har manuelt meldt kontakten ut av sekvensen.
EVENTS_V2_CONTACT_UNSUBSCRIBED_SEQUENCE_EMAIL	Kontakten har meldt seg av, og er dermed fjernet fra sekvensen.
EVENTS_V2_SEQUENCE_EMAIL_BOUNCED	Sekvens-e-posten ble returnert.
EVENTS_V2_SEQUENCE_ERRORED	Feil i sekvensen førte til at mottakeren ble fjernet fra sekvensen.
EVENTS_V2_SEQUENCE_STEP_EXECUTED	Sekvensstrinn utført.
EVENTS_VISITED_PAGE	Besøk på nettsider av kontakter.
EVENTS_<INTEGRATION_EVENT_NAME>_<UNIQUE_IDENTIFIER>	Integrasjonshendelser (Timeline V3 API)

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

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

occurredat
occurredatdateint

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

Kolonnenavn	Type	Beskrivelse
`EVENTTYPEID`	Varchar	ID-en til hendelsestypen, tilsvarende OBJECTTYPEID Du kan hente alle hendelsestype-ID-er i kontoen din ved hjelp av visningen object_and_event_type_definitions.
`ID`	Varchar	Denne er unik for hver hendelsestype. Det finnes ikke to poster med samme ID innenfor en gitt hendelsestype.
`OBJECTTYPEID`	Varchar	Typen av objekt som fullførte hendelsen. For eksempel vil et klikk på en e-postlenke vise`0-1` i denne kolonnen, som representerer kontaktobjektet.
`OBJECTID`	Tall	ID-en til posten som fullførte hendelsen.
`OCCURREDAT`	Tidsstempel	Når hendelsen fant sted.
`OCCURREDATDATEINT`	Tall	Et tall som angir når hendelsen fant sted. Inneholder de samme dataene som `OCCURREDAT` kolonnen, men er formatert som et tall og brukes som en del av tabellens klyngenøkkel. I de fleste tilfeller kan du bruke `OCCURREDAT` tidsstemplet i stedet for dette tallet.
`OCCUREDATDATEINT`	Tall	Et tall som angir når hendelsen fant sted. 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 tidsstempelet `OCCURREDAT` i stedet for dette tallet. Merk: Denne kolonnen vil bli utfaset 24. november 2022 og erstattet med `OCCURREDATDATEINT`.
`OCCUREDAT`	Tidsstempel	Når hendelsen fant sted. Merk: Denne kolonnen vil bli utfaset 24. november 2022 og erstattet med `OCCURREDAT`.
`INGESTEDAT`	Tidsstempel	Dato og klokkeslett for når dataene sist ble importert av Snowflake. Les mer om kolonnedatatypene.
`PROPERTY_*`	Varchar	Enkeltkolonner som inneholder hendelsesegenskapene.

Eksempel 1

Hent de 50 nyeste e-postklikkhendelsene.

Spørring:

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

Returnerer:

EVENTTYPEID	OBJECTTYPEID	OBJECTID	OCCUREDAT	HS_CLICK_RAW_URL
4-666288	0-1	45318579	04.08.2016 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	29.08.2016 13:31:28.622	https://cta-image-cms2.hubspot.com/ctas/v2/public/cs/ci/?pg=f0f6585a-08fc-4273-8422-49cfaddcf8d8&pid=1976760&ecid=ACsprvtkRbakerw4BiWlaDL7xFAqau1aW9m1_PAqSfQiWarY69X7Ds42zHGYTCfhHJLrXUP86Nxu
4-666288	0-1	26146013	30.11.2017 14:27:11,528	https://hubs.ly/H097a37a?utm_source=hs_email&utm_medium=email&utm_content=58251290
...	...	...	...	...

Eksempel 2

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

Spørring:

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

Resultat:

KLIKK_TIDSPUNKT	KLIKK_URL	CONTACT_FIRSTNAME	CONTACT_ETTERNAVN
4. januar 2019 kl. 22:35:41,264	https://help.website.com/articles/tutorial/how-to-use-email-tool?utm_source=hs_automation&utm_medium=email&utm_content=68042217	Hobbes	Baron
08.11.2018 09:37:41.400	https://www.website.net/webinar-case-study?utm_source=hs_automation&utm_medium=email&utm_content=55200164	Milo	Gull
08.11.2018 09:37:41.426	https://www.website.net/contact?utm_source=hs_automation&utm_medium=email&utm_content=55200164	Harlow	Villari
...	...	...	...

Object_and_event_type_queries

object_and_event_type_definitions

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

Dette databaseobjektet kan returnere følgende kolonner:

Kolonnenavn	Type	Beskrivelse
`OBJECTTYPEID`	Varchar	ID-en til objektet som rørledningen kan inneholde (f.eks. avtaler eller billetter).
`FULLYQUALIFIEDNAME`	Varchar	Navnet på objektet eller hendelsen.
`INGESTEDAT`	Tidsstempel	Dato og klokkeslett for når dataene sist ble importert av Snowflake. Les mer om kolonnedatatypene.

Eksempel 1

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

Spørring:

SELECT objectTypeId, fullyQualifiedName
FROM object_and_event_type_definitions;

Returnerer:

OBJECTTYPEID	FULLYQUALIFIEDNAME
0–1	CONTACT
0-8	LINE_ITEM
0-11	SAMTALE
...	...

Segmentforespørsler

Nedenfor kan du lære hvordan du søker i segmentene dine, for eksempel de tilgjengelige kontakt- og bedriftssegmentene og postene som inngår i disse segmentene.

segmenter

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

Dette databaseobjektet kan returnere følgende kolonner:

Kolonnenavn	Type	Beskrivelse
`OBJECTTYPEID`	Varchar	Typen av poster i segmentet (f.eks. kontakt eller selskap).
`SEGMENTID`	Tall	ID-en til segmentet. Kobles tilSEGMENTID -kolonnen i tabellen for segmentmedlemskap.
`CLASSICSEGMENTID`	Tall	En ID som er spesifikk for kontaktsegmenter og som samsvarer med ID-en i URL-en til segmentet i HubSpot.
`NAME`	Varchar	Navnet på segmentet.
`SIZE`	Tall	Antall poster i segmentet.
`CREATEDBYUSERID`	Tall	ID-en til brukeren som opprettet segmentet.
`CREATEDAT`	Tidsstempel	Når segmentet ble opprettet i HubSpot.
`UPDATEDBYUSERID`	Tall	ID-en til brukeren som sist oppdaterte segmentet.
`UPDATEDAT`	Tidsstempel	Dato og klokkeslett for når dataene sist ble oppdatert i HubSpot. Les mer om datatyper for kolonner.
`INGESTEDAT`	Tidsstempel	Dato og klokkeslett for når dataene sist ble importert av Snowflake.

Eksempel 1

Hent alle kontaktsegmenter.

Spørring:

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

Returnerer:

SEGMENTSID	NAVN	STØRRELSE
118131	Ukentlig utrekning	103
66156	Bloggabonnenter	455
771 852	Toppabonnenter 2021	37
...	...	...

Eksempel 2

Hent et bestemt kontaktsegment med navnet «Toppabonnenter 2021».

Spørring:

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

Returnerer:

SEGMENTID	NAVN	STØRRELSE
771 852	Toppabonnenter 2021	37

segment_membership

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

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

Dette databaseobjektet kan returnere følgende kolonner:

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

Eksempel 1

Hent ID-ene til alle kontakter i segmentet«Toppabonnenter 2021 ».

Spørring:

SELECT objectId
FROM segment_memberships
INNER JOIN segments
ON segment_memberships.segmentId = segments.segmentId
WHERE segments.objectTypeId = '0-1'
AND segments.name = 'Top Subscribers 2021';

Returnerer:

OBJECTID

54325098

96805401

6922028

...

Eksempel 2

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

Spørring:

SELECT

contact.objectId AS object_id,

contact.properties:firstname::string AS fornavn,

contact.properties:lastname::string AS etternavn

FRA objekt_med_objekt_egenskaper AS kontakt

INNER JOIN segment_medlemskap AS medlemskap

ON kontakt.objekt-ID = medlemskap.objekt-ID

INNER JOIN segmenter

ON medlemskap.segmentId = segmenter.segmentId

WHERE kontakt.objekttype-ID = '0-1'

OG segments.objectTypeId = '0-1'

OG segments.name = 'Toppabonnenter 2021';

Resultat:

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

Ofte stilte spørsmål

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

Vanligvis bør du se på kolonnene i rapporten du sammenligner med. Hvis rapporten ikke er presentert i tabellform, kan du konvertere den til en tabell for å se hvilke kolonner rapporten inneholder. Disse kolonnene er vanligvis egenskaper til en objekttype eller en hendelsestype. Neste trinn er å finne ut hvilken objekttypeegenskap en kolonne tilsvarer. Du kan gjøre dette ved å søke i property_definitions:

SELECT * FROM property_definitions

WHERE label = [column_name]

Det er ikke alltid det finnes en eksakt samsvar, fordi noen egenskapsnavn vanligvis omdøpes til et mer beskrivende navn i appen. I slike tilfeller kan det være nyttig å foreta et fuzzy-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 søke etter. Søk i object_with_object_properties og filtrer etter ` objectTypeId ` for den aktuelle typen. Les de nødvendige egenskapsverdiene fra JSON-kolonnen `properties`.

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

For å hente skjemaer knyttet til hver kampanje, må du koble sammen OBJECT_WITH_OBJECT_PROPERTIES, ASSOCIATIONS og ASSOCIATION_DEFINITIONS.

SELECT DISTINCT

campaigns.properties:hs_name::string AS kampanjenavn,

skjemaer.egenskaper:hs_skjema_id::streng AS form_id

FRA objekt_med_objekt_egenskaper AS kampanjer

SLÅ SAMMEN tilknytninger AS forening

PÅ forening.fraObjekt-ID = kampanjer.objekt-ID

JOIN association_definitions AS definition

ON definisjon.kombinertForeningsTypeId =

association.combinedAssociationTypeId

JOIN objekt_med_objekt_egenskaper AS forms

ON forms.objectId = association.toObjectId

WHERE kampanjer.objekttype-ID = '0-35'

OG forms.objectTypeId = '0-28'

OG definisjon.fraObjektTypeId = '0-35'

OG definisjon.tilObjekttypeID = '0-28';

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

For å motta statusoppdateringer i sanntid om driftsavbrudd og problemer med HubSpot-Snowflake-integrasjonen, kan du foreta en forespørsel på data_share_status-visningen:

SELECT * FROM hubspot.public.data_share_status LIMIT 1

Resultatene vises som følger:

STATUS	MELDING	OPPDATERINGSDATO
OK	INGEN KJENTE HENDELSER FOR ØYEBLIKKET	10.04.2023 09:21:20.123

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

Var denne artikkelen nyttig?

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

Hente HubSpot-data i Snowflake

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

Dataforsinkelse og regionen for Snowflake-kontoen din

Konfigurer Snowflake-miljøet ditt

Dataoversikt

Begrensning og sortering av returnerte data

Datatyper for kolonner

Konvertering av datatyper

Objektsøk

object_with_object_properties

Eksempel 1

Eksempel 2

objekter

Eksempel 1

object_properties

Eksempel 1

Eksempel 2

object_properties_history

Eksempel 1

Eksempel 2

Assosiasjonsspørsmål

association_definitions

Eksempel 1

Eksempel 2

associations

Eksempel 1

Eksempel 2

Eksempel 3

Eierforespørsler

eiere

Eksempel 1

Eksempel 2

Eksempel 3

Teamspørsmål

team

Eksempel 1

owner_team

Eksempel 1

Pipeline-spørsmål

pipelines

Eksempel 1

Eksempel 2

pipeline_stages

Eksempel 1

Eksempel 2

Eiendomssøk

property_definitions

Eksempel 1

Hendelsesspørsmål

Eksempel 1

Eksempel 2

Object_and_event_type_queries

object_and_event_type_definitions

Eksempel 1

Segmentforespørsler

segmenter

Eksempel 1

Eksempel 2

segment_membership

Eksempel 1

Eksempel 2

Ofte stilte spørsmål

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

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

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

Relatert innhold