Bemærk:Oversættelsen af denne artikel er kun til rådighed for nemheds skyld. Oversættelsen oprettes automatisk via en oversættelsessoftware og er muligvis ikke blevet korrekturlæst. Den engelske version af denne artikel bør således anses for at være den gældende version, der indeholder de seneste oplysninger. Du kan få adgang til den her.

Forespørg HubSpot-data i Snowflake

Sidst opdateret: 24 september 2026

Gælder for:

Data Hub Enterprise

Når du har forbundet Snowflake til din HubSpot-konto, kan du bruge Snowflakes Data Share til at hente HubSpot-data fra din Snowflake-konto.

Datalag og din Snowflake-kontos region

Du får adgang til V2_LIVE-skemaet, som opdateres hvert 15. minut, og V2_DAILY-skemaet, som opdateres hver dag.

Bemærk: Følgende visninger i V2_LIVE-skemaet opdateres kun dagligt: association_definitions, owners, pipelines og pipeline_stages.

Konfigurer dit Snowflake-miljø

For at forespørge dine HubSpot-data i Snowflake skal du vælge det warehouse, den database og det skema, du vil forespørge fra. Du kan enten indstille dem på regnearksniveau, så de automatisk inkluderes i dine forespørgsler, eller du kan tilføje dem manuelt.

Sådan vælger du dit warehouse, din database og dit skema på regnearksniveau:

Klik på værktøjslinjenfor regneark i den øverste række af regnearket.
I pop op-vinduet:
- Klik på rullemenuenLager, og vælg derefter ditlager.
- Klik på rullemenuen"Database ", og vælg derefter din HubSpot-database.
- Klik på rullemenuen "Skema ", og vælg derefter det skema, du vil bruge:

Når dit miljø er konfigureret, kan du foretage forespørgsler på dine HubSpot-data uden at skulle tilføje din database eller skema-type manuelt til forespørgslerne.

Sådan tilføjer du manuelt din database og skema-type til forespørgslerne: Tilføj databasenavnet efterfulgt af skemaet i begyndelsen af FROM. For eksempel:

SELECT objectTypeId, objectId, updatedAt

FROM hubspot_share_name.V2_LIVE.objects

WHERE objectTypeId = '0-3'

BEGRÆNS 1;

Dataoversigt

Forespørgsler opbygges ved hjælp af SQL og kan bruges til at hente HubSpot-data såsom:

Objekter: standard- og brugerdefinerede objekter, f.eks. kontakter, virksomheder og produkter.
Poster: individuelle poster, f.eks. en enkelt kontakt eller virksomhed.
Forbindelser: alle tilgængelige forbindelsestyper og aktuelt forbundne poster.
Begivenheder: begivenhedsdata for både standard HubSpot-begivenheder, såsom åbning af e-mails, og brugerdefinerede adfærdsbegivenheder.
Segmenter: HubSpot-kontakt- og virksomhedssegmenter.
Ejere: brugere i din HubSpot-konto i forhold til de poster, de er angivet som ejere af.
Pipelines: deal-og ticket-pipelines, herunder pipelinefaser.
Egenskaber: egenskaber og deres værdier på CRM-poster, herunder egenskabshistorik.

Læs mere om HubSpots CRM-datamodel.

Bemærk: I takt med at vi videreudvikler datadeling, vil vi indføre ændringer, hvoraf nogle vil være ændringer, der medfører kompatibilitetsproblemer. Det anbefales på det kraftigste at abonnere på HubSpots ændringslog for udviklere. Disse ændringer vil altid blive offentliggjort i ændringsloggen inden enhver opdatering.

Begrænsning og sortering af returnerede data

Når du opretter forespørgsler, kan du styre, hvor mange data der returneres, samt den rækkefølge, de returneres i, ved at inkludereLIMIT og ORDER BY i din forespørgsel. Hvis du f.eks. vil forespørge på alle kontakter med deres egenskaber, men kun returnere tre resultater og sortere dem efter kontakt-ID, kan du oprette din forespørgsel som følger:

SELECT objectTypeId, updatedAt, ingestedAt

FROM objekter

WHERE objectTypeId = '0-1'

SORTERET EFTER objekt-id

BEGRÆNS 10;

Datatyper for kolonner

Når du forespørger data i Snowflake, afhænger de kolonner, der returneres, af de data, du forespørger. Du kan se de tilgængelige kolonner for en given tabel eller visning i Snowflake ved at vælge visningen i venstre sidepanel.

Bemærk:I resten af dette dokument bruger vi udtrykket databaseobjekt, når sammenhængen gælder både tabeller og visninger.

snowflake-sidebar-view-column-details0

For at returnere en bestemt kolonne skal du medtage den pågældende kolonne i SELECT i din forespørgsel. F.eks. returnerer følgende forespørgsel kun kolonnerne OBJECTID og UpdatedAt

SELECT objectTypeId, updatedAt, ingestedAt

FROM objekter

WHERE objectTypeId = '0-1'

SORTERET EFTER objekt-id

BEGRÆNS 10;

Nedenfor findes generelle definitioner af kolonner, som en forespørgsel kan returnere. For andre definitioner, der ikke er medtaget nedenfor, se de enkelte visningsdefinitioner i artiklen ovenfor.

OBJECTTYPEID: en VARCHAR-værdi, der angiver et objekts type. For eksempel repræsenterer 0-1 kontakter-objektet, 0-2 repræsenterer virksomheder-objektet, og 2-1232 kan repræsentere et brugerdefineret objekt i din konto. I segmenter henviser dette til segmenttypen (f.eks. kontakt eller virksomhed). Du kan søge på alle objekt- og begivenheds-ID'er i din konto ved hjælp af visningen object_and_event_type_definitions.
OBJECTID: et BIGINT-tal, der repræsenterer en enkelt post af en given objekttype i din HubSpot-konto. For at identificere en post skal du bruge både objekttype-ID'et og objekt-ID'et.
INGESTEDAT: tidsstemplet for, hvornår en datarække blev tilføjet til Snowflake, repræsenteret af en TIMESTAMP_NTZ-værdi. Har ingen relation til det logiske tidsstempel for en oprettelses- eller opdateringsoperation i HubSpot.
- På grund af HubSpots interne behandling kan en rækkes indlæsningstidsstempel blive opdateret, selvom ingen andre kolonner i rækken er ændret.
- Når du opretter ETL-processer, der kopierer nyligt ændrede data, anbefales det at basere dine forespørgsler på indlæsningstidsstemplet. Derudover anbefales det, hvis dit flow kopierer data dagligt, at kopiere data fra de to foregående dage for at tage højde for forsinkelser.
CREATEDAT og UPDATEDAT: det logiske tidsstempel for, hvornår data blev oprettet eller opdateret i HubSpot, repræsenteret af en TIMESTAMP_NTZ-værdi . Disse tidsstempler vil stemme overens med tidsstemplerne i HubSpot. For eksempel vil den tid, der vises i HubSpot for en postens oprettelsesdato, være den samme som tidsstemplet i CREATEDAT- kolonnen i Snowflake. Disse er ikke direkte relateret til indlæsningstidsstemplet, og det anbefales ikke at basere ETL-processer på disse egenskaber.
COMBINEDASSOCIATIONTYPE: en VARCHAR-værdi, der entydigt identificerer en associeringsdefinition.

Konvertering af datatyper

Nogle gange returneres data fra en forespørgsel med VARCHAR-kolonner, selvom det ville være ønskeligt at have dem i en anden type. I sådanne tilfælde anbefales det at konvertere VARCHAR-datatypen til de ønskede typer ved hjælp af Snowflake-funktioner. For eksempel gemmes egenskaber for en objektpost som VARCHAR-datatyper i de fleste databaseobjekter, men indeholder undertiden tal- og datetime-værdier. Funktioner som:
try_to_number, try_to_timestamp_ntz kan bruges til at konvertere disse VARCHAR-data til henholdsvis NUMBER - og DATETIME -typer:

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

Objektforespørgsler

Nedenfor kan du lære, hvordan du forespørger data fra specifikke HubSpot-objekter og -poster, samt hvilke data der returneres.

Objektdata er tilgængelige i delte databaseobjekter. Filtrer efter objectTypeId for at hente en bestemt objekttype. Brug OBJECT_WITH_OBJECT_PROPERTIES , når du har brug for de aktuelle egenskaber for hver post. Egenskabsværdier gemmes i properties JSON-kolonnen. Brug OBJECTS til centrale postattributter og OBJECT_PROPERTIES eller OBJECT_PROPERTIES_HISTORY for data pr. egenskab.

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

Brugerdefinerede objekter tildeles et ID ved oprettelsen og identificeres som2-unik_ID. For eksempel2-12345. Læs mere om object_and_event_type_definitions.

Se flere detaljer under object_with_object_properties, object_properties, objects og object_properties_history nedenfor.

object_with_object_properties

Dette databaseobjekt indeholder data fra dine HubSpot-poster. Forespørgsler til dette databaseobjekt returnerer én række for hver post inden for en objekttype (f.eks. alle kontaktposter i objekttypen kontakter). Alle egenskaber gemmes i kolonnen Properties, som er en Snowflake Variant / JSON-kolonne.

Denne visning kan returnere følgende kolonner:

Kolonnenavn	Type	Beskrivelse
`OBJECTTYPEID`	Varchar	ID'et for objekttypen (f.eks. er kontakter `0-1`).
`OBJECTID`	Tal	ID'et for posten (f.eks. en kontaktpost med ID'et `123752`).
`PROPERTIES`	Variant	Postens egenskabsværdier.
`UPDATEDAT`	Tidsstempel	Dato og klokkeslæt for, hvornår posten sidst blev opdateret i HubSpot. Læs mere om datatyper i kolonner.
`INGESTEDAT`	Tidsstempel	Dato og klokkeslæt for, hvornår dataene sidst blev indlæst af Snowflake.

Bemærk: Den 25. januar 2022 vil kolonnen " timestamp " i tabellen og visningen "object_with_object_properties", som angiver dato og klokkeslæt for den seneste opdatering af objektposten i HubSpot, blive ændret til "updatedat". Dette sker for at tilpasse sig den måde, hvorpå datetime-data vises i resten af datadelingen.

Da dette er en ændring, der medfører kompatibilitetsproblemer, er den nye kolonne " updatedat" blevet tilføjet til tabellen og visningen. I de næste 90 dage vil disse to nye kolonner eksistere sideløbende med "timestamp", de kolonner, de skal erstatte. Dette giver dig mulighed for at skifte til at bruge de nye kolonner.

Efter 90 dage, den 25. januar 2022, fjernes kolonnen "timestamp" fra tabellen og visningen. Efter denne dato vil ethvert forsøg på at forespørge tabellen "object_with_object_properties" eller visningen ved hjælp af "timestamp"-kolonner mislykkes.

Eksempel 1

Hent alle kontakter og deres egenskaber.

Forespørgsel:

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

Resultat:

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

Eksempel 2

Hent navnet og fasen for op til tre aftaler.

Forespørgsel:

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	AFTALEFASE	AFTALEBELØB
38960439	Aftalenavn 1	afsluttet-tabt	7488939
321740651	Handelsnavn 1	afsluttet vundet	9292029
98392101	Handelsnavn 1	afsluttet tabt	62626528

objekter

Dette databaseobjekt er en delmængde af dataene i databaseobjektet object_with_object_properties. Hver returneret række returnerer objekt-ID'et for hver post. Dette databaseobjekt returnerer kun eksisterende poster. Når en post slettes i HubSpot, fjernes den fra dette databaseobjekt. Dette databaseobjekt er en delmængde af dataene i tabellen object_with_object_properties. Hver returneret række angiver objekt-ID'et for hver post. Denne visning returnerer kun eksisterende poster. Når en post slettes i HubSpot, fjernes den fra denne visning.

Dette databaseobjekt indeholder aktuelle objektdata uden egenskabsværdier. Brug det, når du kun har brug for kerneattributter for poster, eller sammenkobl det med OBJECT_PROPERTIES, når du har brug for udvalgte egenskaber. Ved at bruge dette databaseobjekt sammen med databaseobjektet object_properties er det muligt at replikere dataene i object_with_object_properties, samtidig med at du bevarer kontrollen over, hvilke egenskaber der returneres.

Dette databaseobjekt kan returnere følgende kolonner:

Kolonnenavn	Type	Beskrivelse
`OBJECTTYPEID`	Varchar	ID'et for objekttypen (f.eks. er kontakter `0-1`).
`OBJECTID`	Tal	ID'et for posten (f.eks. en kontaktpost med ID'et `123752`).
`INGESTEDAT`	Tidsstempel	Dato og klokkeslæt for, hvornår dataene sidst blev indlæst af Snowflake. Få mere at vide om kolonnedatatyper.

Eksempel 1

Hent alle kontaktposter.

Forespørgsel:

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

Returnerer:

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

object_properties

Dette databaseobjekt er en delmængde af databaseobjektet »object_with_object_properties «. Hver række indeholder den aktuelle egenskabsværdi, der er angivet for en given post. For eksempel vil en kontaktperson have én række for egenskaben »Fornavn« og én række for egenskaben»Efternavn «. Hvis en post ikke har en værdi for en egenskab, vises rækken enten med en tom streng eller vises slet ikke.

Dette databaseobjekt kan returnere følgende kolonner:

Kolonnenavn	Type	Beskrivelse
`OBJECTTYPEID`	Varchar	ID'et for objekttypen (f.eks. er kontakter `0-1`).
`OBJECTID`	Tal	ID'et for posten (f.eks. en kontaktpost med ID'et `123752`).
`NAME`	Varchar	Navnet på egenskaben.
`VALUE`	Tidsstempel	Egenskabens værdi.
`UPDATEDAT`	Tidsstempel	Dato og klokkeslæt for, hvornår posten sidst blev opdateret i HubSpot. Få mere at vide om kolonnedatatyper.
`INGESTEDAT`	Tidsstempel	Dato og klokkeslæt for, hvornår dataene sidst blev indlæst af Snowflake.

Eksempel 1

Hent egenskaberne fornavn, efternavn og by for alle kontakter.

Forespørgsel:

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	VÆRDI
0-1	10401	fornavn	Brian
0-1	10401	by	Dublin
0-1	10401	efternavn	Gallagher
0-1	23451	fornavn	Fernando
0-1	23451	efternavn	Fierro
0-1	25751	fornavn	Charles
...	...	...	...

Eksempel 2

Hent fornavn, efternavn og livscyklusfase for alle kontakter, og kombiner dem til én række pr. kontakt. Dette eksempel bruger SQL PIVOT-syntaksen.

Forespørgsel:

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);

Resultat:

OBJECTTYPEID	OBJEKTID	FØRNAME	EFTERNAVN	LIVSCYKLUSFASE
0-1	54325098	Hobbes	Baron	bly
0-1	96805401	Milo	Guld	føring
0-1	6922028	Henry	Riley	føring
...	...	...	...	...

object_properties_history

Dette databaseobjekt indeholder historiske egenskabsværdier. For kontakter indeholder det de seneste 45 værdier. For alle andre objekter indeholder det de seneste 20 værdier. Viser en række for hver historisk egenskabsværdi. Den aktuelle værdi af en egenskab bestemmes af det seneste UPDATEDAT-tidsstempeli egenskabens historik.

Dette databaseobjekt kan returnere følgende kolonner:

Kolonnenavn	Type	Beskrivelse
`OBJECTTYPEID`	Varchar	Objekttypens ID (f.eks. er »kontakter« `0-1`).
`OBJECTID`	Tal	ID'et for posten (f.eks. en kontaktpost med ID'et `123752`).
`NAME`	Varchar	Navnet på egenskaben.
`VALUE`	Tidsstempel	Egenskabens værdi.
`UPDATEDAT`	Tidsstempel	Dato og klokkeslæt for, hvornår dataene sidst blev opdateret i HubSpot. Få mere at vide om kolonnedatatyper.
`INGESTEDAT`	Tidsstempel	Dato og klokkeslæt for, hvornår dataene sidst blev indlæst af Snowflake.

Eksempel 1

Hent historikken for en enkelt egenskab for en enkelt kontakt.

Forespørgsel:

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	VÆRDI	OPDATERINGSDATO
136493192	hs_predictivescoringtier	tier_1	22. juni 2022 kl. 22:45:05,931
136493192	hs_forudsigelsesscoringsniveau	tier_2	18.09.2021 08:20:56.622
136493192	hs_forudsigelsesscoringsniveau	tier_3	31.11.2019 18:20:22.851
...	...	...	...

Eksempel 2

Hent det aktuelle navn på alle kontakter, der nogensinde har haft livscyklusfasen " Abonnent".

Forespørgsel:

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'
);

Resultat:

OBJECTID	FØRNAME	EFTERNAVN
54325098	Hobbes	Baron
96805401	Milo	Gold
6922028	Henry	Riley
...	...	...

Associationsforespørgsler

Associationsdata er tilgængelige i ASSOCIATIONS. Filtrer efter combinedAssociationTypeId for at hente en bestemt associationstype. Forbind ASSOCIATIONS med ASSOCIATION_DEFINITIONS for at identificere de relaterede objekttyper og associationsdefinitionen.

association_definitions

Dette databaseobjekt indeholder oplysninger om alle tilgængelige associationstyper mellem HubSpot-objekter, med én række pr. associationstype. Du kan sammenkæde dette databaseobjekt med associationsdatabaseobjektet for at få rekordspecifikke associationsoplysninger.

Der kan være flere typer associationer mellem de samme objekter. Den primære associationstype, som er den type, der vises i HubSpot, når poster er associeret, bruger den association, hvor ISMAINASSOCIATIONDEFINITION er true.

Dette databaseobjekt kan returnere følgende kolonner:

Kolonnenavn	Type	Beskrivelse
`COMBINEDASSOCIATIONTYPEID`	Varchar	Den unikke identifikator for tilknytningsdefinitionen.
`CATEGORY`	Varchar	Kilden til associationstypen. En af følgende: `HUBSPOT_DEFINED`, `USER_DEFINED`, `INTEGRATOR_DEFINED`
`ID`	Tal	Identifikatoren for associeringsdefinitionen inden for dens kategori.
`FROMOBJECTTYPEID`	Varchar	ID'et for det objekt, der er kilden til associationsdefinitionen.
`TOOBJECTTYPEID`	Varchar	ID'et for det objekt, der er destinationen for associationsdefinitionen.
`NAME`	Varchar	Navnet på associeringsdefinitionen.
`LABEL`	Varchar	Etiketten for associeringsdefinitionen.
`ISMAINASSOCIATIONDEFINITION`	Boolean	Angiver, om associeringsdefinitionen er hovedtypen. Når værdien er true, er det denne definition, HubSpot viser på de associerede poster.
`INGESTEDAT`	Tidsstempel	Dato og klokkeslæt for, hvornår dataene sidst blev indlæst af Snowflake. Få mere at vide om kolonnedatatyper.

Eksempel 1

Hent de associationstyper, der er tilgængelige i din konto.

Forespørgsel:

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

Returnerer:

COMBINEDASSOCIATIONTYPE	FROMOBJECTTYPEID	TOOBJECTTYPEID	NAVN
0-1	0-1	0-2	KONTAKT_TIL_VIRKSOMHED
0-2	0-2	0-1	VIRKSOMHED_TIL_KONTAKT
0-3	0-3	0-1	DEAL_TO_CONTACT
0-4	0-1	0-3	KONTAKT_TIL_AFTALE
0-5	0-3	0-2	AFTALE_MED_VIRKSOMHED
...	...	...	...

Eksempel 2

Hent de tilgængelige associationstyper mellem aftaler og virksomheder.

Forespørgsel:

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

Resultat:

KOMBINERETFORENINGSTYPE	FRA OBJEKTTYPE-ID	TIL OBJEKTTYPE-ID	NAVN
0-5	0-3	0-2	DEAL_TO_COMPANY
0-271	0-3	0-2	AFTALE_MED_PRIMÆR_VIRKSOMHED
0-341	0-3	0-2	DEAL_TO_COMAPNY_UNLABELED

associations

Dette databaseobjekt indeholder oplysninger om tilknytningerne mellem specifikke poster. Hver række repræsenterer en tilknytning fra et objekt til et andet objekt. Der kan forekomme rækker i dette databaseobjekt, selvom de refererede poster er blevet slettet. Du kan kontrollere, om der findes poster, ved at sammenkæde med objekttabellen.

Dette databaseobjekt indeholder tilknytningsposter for alle tilknytningstyper. Filtrer efter combinedAssociationTypeId og sammenkobl med ASSOCIATION_DEFINITIONS, når du har brug for metadata om tilknytninger.

Dette databaseobjekt kan returnere følgende kolonner:

Kolonnenavn	Type	Beskrivelse
`COMBINEDASSOCIATIONTYPEID`	Varchar	Den unikke identifikator for associeringsdefinitionen.
`FROMOBJECTID`	Tal	ID'et for kildeobjektet.
`TOOBJECTID`	Tal	ID'et for destinationsobjektet.
`INGESTEDAT`	Tidsstempel	Dato og klokkeslæt for, hvornår dataene sidst blev indlæst af Snowflake. Få mere at vide om kolonnedatatyper.

Eksempel 1

Hent alle tilknyttede aftaler og kontakter.

Forespørgsel:

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

Forespørgsel:

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

Resultat:

KOMBINERET ASSOCIERINGSTYPE	FRA OBJEKT-ID	TIL OBJEKT-ID
0-5	6626541373	233620335

Eksempel 3

Hent alle aftaler, der er knyttet til en bestemt kontakt (kontakt-ID: 4464). I stedet for at hardkode combinedAssociationTypeId, sammenkæder dette eksempel med association_definitions.

Forespørgsel:

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:

KOMBINERET ASSOCIERINGSTYPE-ID	FRAOBJEKTID	TIL OBJEKT-ID
0-5	6626541373	233620335

Ejersøgninger

ejere

Dette databaseobjekt indeholder oplysninger om brugerne i din HubSpot-konto. Brugere kan angives som rekordejere og vil indeholde både et bruger-ID og et ejer-ID, afhængigt af deres kontekst. Begge ID'er kan bruges til at identificere den samme bruger.

Dette databaseobjekt kan returnere følgende kolonner:

Kolonnenavn	Type	Beskrivelse
`OWNERID`	Tal	Brugerens ejer-ID.
`USERID`	Tal	Brugerens bruger-ID. Brugere med NULL i denne kolonne er blevet slettet.
`EMAIL`	Varchar	Brugerens e-mail-adresse.
`FIRSTNAME`	Varchar	Brugerens fornavn.
`LASTNAME`	Varchar	Brugerens efternavn.
`ARCHIVED`	Boolean	Om brugeren er blevet slettet.
`CREATEDAT`	Tidsstempel	Dato og klokkeslæt for, hvornår brugeren blev oprettet i HubSpot. Se kolonnedatatyper for yderligere oplysninger.
`UPDATEDAT`	Tidsstempel	Dato og klokkeslæt for, hvornår brugeren sidst blev opdateret i HubSpot. Se kolonnedatatyper for yderligere oplysninger.
`INGESTEDAT`	Tidsstempel	Dato og klokkeslæt for, hvornår dataene sidst blev indlæst af Snowflake.

Eksempel 1

Hent alle brugere. Filtret WHERE archived = false fjerner slettede brugere fra de returnerede data.

Forespørgsel:

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

Returnerer:

OWNERID	USERID	EMAIL	FØRNAME	EFTERNAVN
29584574	4621126	233620335	Hobbes	Baron
30532717	4874784	3866015468	Pablo	Walters
30580321	925511	7132752747	Milo	Guld
...	...	...	...	...

Eksempel 2

Hent en bestemt ejer ved hjælp af vedkommendes ejer-ID.

Forespørgsel:

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

Resultat:

EJER-ID	BRUGER-ID	EMAIL	FØRNAME	EFTERNAVN
29584574	4621126	233620335	Hobbes	Baron

Eksempel 3

Hent alle kontakter og deres ejere. Denne forespørgsel sammenkæder poster med ejere ved hjælp af object_with_object_properties og kontaktattributten 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,

owner.firstname AS owner_firstname,

owner.lastname AS ejer_efternavn,

ejer.e-mail AS ejer_e-mail

FRA objekt_med_objekt_egenskaber AS kontakt

JOIN ejere AS ejer

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

WHERE contact.objectTypeId = '0-1';

Resultat:

KONTAKTID	CONTACT_FIRSTNAME	CONTACT_EFTERNAVN	KONTAKT_HUBSPOT_EJER_ID	EJER_FORNAME	EJER_EFTERNAVN	EJER_E-MAIL
113834202	Richard	Greenfield	29584574	Hobbes	Baron	hobbes.b@business.com
53540801	Ford	Karl	30241125	Milo	Gold	milo.g@business.com
...	...	...	...	...	...	...

Teamforespørgsler

teams

Med teams i HubSpot kan du organisere dine brugere i grupper til organisatoriske og rapporteringsmæssige formål. Du kan have et hovedteam og ekstra teams.

Dette databaseobjekt indeholder oplysninger om holdene i din HubSpot-konto.

Dette databaseobjekt kan returnere følgende kolonner:

Kolonnenavn	Type	Beskrivelse
TEAMID	Tal	Hold-ID'et.
TEAMNAME	Varchar	Holdnavnet.
PARENTTEAMID	Tal	ID'et for det overordnede hold.
CHILDTEAMIDS	Array	Team-ID'erne for underordnede teams.
PRIMARYOWNERMEMBERS	Varchar	ID'erne for de primære medlemmer af holdet.
SECONDARYOWNERMEMBERS	Boolean	Ejer-ID'erne for teamets sekundære medlemmer.
INGESTEDAT	Tidsstempel	Dato og klokkeslæt for, hvornår dataene sidst blev indlæst af Snowflake.

Eksempel 1

Hent alle teams.

Forespørgsel:

SELECT teamId,teamName, primaryOwnerMembers

FROM teams

Returnerer:

TEAMID	TEAMNAVN	PRIMÆRE EJERMEDLEMMER
29584574	Underhold	[233620335, 1234553]
30532717	Superhold	[3866015468, 126221873]
3058032	A-holdet	[7132752747]

owner_team

Dette databaseobjekt indeholder oplysninger om, hvilke ejere der svarer til hvilke teams i din HubSpot-konto.

Dette databaseobjekt kan returnere følgende kolonner:

Kolonnenavn	Type	Beskrivelse
TEAMID	Nummer	Team-ID'et.
OWNERID	Nummer	Brugerens ejer-ID.
ISTEAMPRIMARY	Boolsk	Angiver, om dette team er det primære team for denne ejer.
INGESTEDAT	Tidsstempel	Dato og klokkeslæt for, hvornår dataene sidst blev indlæst af Snowflake.

Eksempel 1

Hent alle ejere for et givet team.

Forespørgsel:

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

Returnerer

TEAMID	TEAMNAME	ISTEAMPRIMARY
29584574	233620335	SAND
29584574	1234553	SAND

Pipeline-forespørgsler

Nedenfor kan du lære, hvordan du forespørger data fra deal- og ticket-pipelines, f.eks. de tilgængelige pipelines på din konto og deres faser.

Du kan sammenkæde disse data med objektdata for at få et fuldstændigt overblik over dine pipelines. Du kan f.eks. søge på aftaler og deres pipelines ved at sammenkæde object_with_object_properties med pipelines«.

pipelines

Dette databaseobjekt indeholder oplysninger om aftale- og ticket-pipelines i din konto. Hver returneret række repræsenterer en enkelt pipeline.

Denne tabel kan returnere følgende kolonner:

Kolonnenavn	Type	Beskrivelse
`PIPELINEID`	Varchar	Pipelinens ID.
`OBJECTTYPEID`	Varchar	ID'et for det objekt, som pipelinen kan indeholde (f.eks. aftaler eller tickets).
`LABEL`	Varchar	Pipelinens navn i HubSpot.
`DISPLAYORDER`	Tal	Den rækkefølge, som pipelinen vises i i HubSpot.
`ARCHIVED`	Boolsk	Om pipelinen er blevet slettet.
`CREATEDAT`	Tidsstempel	Hvornår rørledningen blev oprettet.
`UPDATEDAT`	Tidsstempel	Dato og klokkeslæt for, hvornår dataene sidst blev opdateret i HubSpot. Få mere at vide om datatyper i kolonner.
`INGESTEDAT`	Tidsstempel	Dato og klokkeslæt for, hvornår dataene sidst blev indlæst af Snowflake.

Eksempel 1

Hent alle tilgængelige aftalepipelines, sorteret efter deres rækkefølge i HubSpot.

Forespørgsel:

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	Licenspipeline
0-3	75e28846-ad0d-4be2-a027-5e1da6590b98	Nye forretninger
...	...	...

Eksempel 2

Hent aftaler inden for en bestemt pipeline ved hjælp afobject_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 tilmelding	Salgspipeline
605457408	Friskies rebranding	Salgspipeline
604362473	Udvikling af Fresh Step-appen	Salgspipeline

pipeline_stages

Denne visning indeholder oplysninger om de enkelte faser i en pipeline. Identificer faser ved at kombinere objekttype-ID, pipeline-ID og fase-ID. Når du sammenkæder med pipelines, skal du bruge objekttype-ID og pipeline-ID.

Dette databaseobjekt kan returnere følgende kolonner:

Kolonnenavn	Type	Beskrivelse
`PIPELINEID`	Varchar	Pipelinens ID.
`STAGEID`	Varchar	Trinets ID.
`LABEL`	Varchar	Navnet på scenen i HubSpot.
`DISPLAYORDER`	Nummer	Den rækkefølge, som pipelinen vises i i HubSpot.
`METADATA`	Variant	En beskrivelse af fasen i JSON-format, herunder om den er åben eller lukket
`ARCHIVED`	Boolsk	Om pipeline-trinnet er blevet slettet.
`CREATEDAT`	Tidsstempel	Hvornår pipeline-trinnet blev oprettet.

Eksempel 1

Hent pipeline-faser for en deal-pipeline ved navnSales pipeline.

Forespørgsel:

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	Aftale planlagt
941650	941653	Faktura sendt
...	...	...

Eksempel 2

Hent alle aftaler og deres respektive pipelinefaser.

Forespørgsel:

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_FASE_NAVN
605140072	Meowmix Global tilmelding	Salgspipeline	Kontrakt sendt
605457408	Friskies rebranding	Salgspipeline	Aftale planlagt
604362473	Udvikling af Fresh Step-app	Salgspipeline	Kontrakt underskrevet
...	...	...	...

Ejendomsforespørgsler

property_definitions

Dette databaseobjekt indeholder oplysninger om objektegenskaber og begivenhedsegenskaber i din HubSpot-konto. Begivenhedsegenskaber omfatter standardbegivenheder, såsom åbning af e-mails og klik, samt brugerdefinerede adfærdsbegivenhedsegenskaber. Disse oplysninger kan være nyttige til at definere værdier, der findes i object_properties- og events-data.

Du kan identificere specifikke egenskaber ved at kombinere deres objekttype-ID og navn. Du kan hente lignende oplysninger ved hjælp af egenskabs-API'en.

Dette databaseobjekt kan returnere følgende kolonner:

Kolonnenavn	Type	Beskrivelse
`OBJECTYPEID`	Varchar	ID'et for det objekt, som begivenheden vedrører.
`NAME`	Varchar	Egenskabens interne navn.
`LABEL`	Varchar	Egenskabens etiket.
`DESCRIPTION`	Varchar	Ejendommens beskrivelse.
`TYPE`	Varchar	Ejendommens type (f.eks. streng, tal, dato/tid).
`FIELDTYPE`	Varchar	Egenskabens felttype. Definerer, hvordan egenskaben vises i HubSpot og på formularer (f.eks. afkrydsningsfelt, rullemenu).
`DISPLAYORDER`	Tal	Egenskabens visningsrækkefølge.
`GROUPNAME`	Varchar	Ejendommens gruppenavn.
`OPTIONS`	Variant	For opregningsegenskaber: en matrix med egenskabens indstillinger, herunder hver indstillings attributter (f.eks. visningsrækkefølge, etiket).
`CREATEDUSERID`	Tal	ID'et for den bruger, der oprettede egenskaben.
`REFERENCEDOBJECTTYPE`	Varchar	Den type objekt, som egenskaben henviser til. Ejeregenskaber returnerer værdien OWNER.
`CALCULATED`	Boolean	Angiver, om egenskaben er en beregnet egenskab.
`EXTERNALOPTIONS`	Boolean	Angiver, om egenskabens indstillinger er defineret i et eksternt system.
`HASUNIQUEVALUE`	Boolean	Angiver, om egenskabens værdier er unikke. Kan kun angives, når en egenskab oprettes via API'et.
`HIDDEN`	Boolsk	Angiver, om egenskaben er skjult i HubSpot.
`SHOWCURRENCYSYMBOL`	Boolsk	Om en talegenskabsværdi er formateret som en valuta.
`FORMFIELD`	Boolsk	Om denne egenskab kan bruges i formularer.
`READONLYDEFINITION`	Boolsk	Om egenskaben kan redigeres i HubSpot.
`READONLYVALUE`	Boolean	Om egenskabens værdi kan redigeres i HubSpot.
`HUBSPOTDEFINED`	Boolsk	Om egenskaben er oprettet af HubSpot eller af en bruger.
`ARCHIVED`	Boolsk	Om ejendommen er blevet slettet.
`CREATEDAT`	Tidsstempel	Dato og klokkeslæt for, hvornår ejendommen blev oprettet i HubSpot.
`UPDATEDAT`	Tidsstempel	Dato og klokkeslæt for, hvornår dataene sidst blev opdateret i HubSpot. Få mere at vide om kolonnedatatyper.
`INGESTEDAT`	Tidsstempel	Dato og klokkeslæt for, hvornår dataene sidst blev indlæst af Snowflake.

Eksempel 1

Hent navnene og beskrivelserne for alle kontaktegenskaber.

Forespørgsel:

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

Returnerer:

NAME	LABEL	BESKRIVELSE
entered_sql_stage	Indtastet SQL-fase	Starttælling af SQL-fase-dage.
navn_på_første_konverteringsbegivenhed	Første konvertering	Den første formular, som denne kontakt har indsendt.
adresse	Gadeadresse	Kontaktens adresse.

Begivenhedsforespørgsler

Begivenheder omfatter standard HubSpot-begivenheder og brugerdefinerede adfærdsbegivenheder. Hver begivenhed har sit eget databaseobjekt, mærket som events_eventname.

Navn
EVENTS_AD_INTERACTION	Detaljer om en annonce og de kontakter, der interagerede med den ved at klikke på annoncen eller indsende en formular efter at have interageret med den.
EVENTS_AD_METRICS_IMPORTED_V0	Oplysninger om en annonce og dens præstationsmålinger.
EVENTS_CALL_MENTIONED_KEYWORD	Oplysninger om søgeord, der er nævnt af deltagere i opkald.
EVENTS_CLICKED_LINK_IN_EMAIL_V2	Links, som kontakter har klikket på i marketing-e-mails.
EVENTS_CLICKED_LINK_IN_TRACKED_INBOX_EMAIL_V8	Links, som kontakter har klikket på i e-mails i Conversations-indbakken.
EVENTS_COOKIE_BANNER_CLICKED	Kontakter, der har klikket på cookies.
EVENTS_COOKIE_BANNER_VIEWED	Kontakter, der har set cookies.
EVENTS_DOCUMENT_SHARED_V2	Salgsdokumenter, der er delt med kontakter via et eksternt link.
EVENTS_DOCUMENT_VIEWED_V2	Salgsdokumenter og kontakter, der har set dem ved at åbne det eksterne link.
EVENTS_DOCUMENT_COMPLETED_V2	Salgsdokumenter og kontakter, der har afsluttet dem.
EVENTS_HS_SCHEDULED_EMAIL_V2	E-mails, der er sendt til HubSpots e-mailservere med henblik på afsendelse.
EVENTS_MTA_DELIVERED_EMAIL_V2	E-mails, der er leveret til modtagerne via HubSpots e-mailservere.
EVENTS_MTA_BOUNCED_EMAIL_V2	Forsøg på at levere e-mails, der blev afvist af modtagerens e-mail-server.
EVENTS_OPENED_EMAIL_V2	E-mails, der er åbnet af kontakter.
EVENTS_REPORTED_SPAM_EMAIL_V2	E-mails, der er markeret som spam af modtagerne.
EVENTS_UPDATED_EMAIL_SUBSCRIPTION_STATUS_V2	Ændringer i e-mail-abonnementer foretaget af modtagere.
EVENTS_OPENED_TRACKED_INBOX_EMAIL_V8	Åbninger af e-mails i indbakken, der spores af kontakter.
EVENTS_MB_MEDIA_PLAYED	Aktiviteter vedrørende afspilning af videoer blandt kontakter.
EVENTS_V2_CONTACT_BOOKED_MEETING_THROUGH_SEQUENCE	Kontakten har booket et møde via en sekvens.
EVENTS_V2_KONTAKT_TILMELDET_TIL_SEKVENS	Kontaktperson tilmeldt fra sekvens.
EVENTS_V2_CONTACT_FINISHED_SEQUENCE	Sekvensen er afsluttet.
EVENTS_V2_KONTAKT_SVARET_PÅ_SEKVENS_EMAIL	Kontakten har svaret på en e-mail (eller en indgående e-mail, der afmeldte sekvensen), der blev sendt via sekvensen.
EVENTS_V2_KONTAKT_AFMELDET_FRA_SEKVENS	Kontakten har afmeldt sig sekvensen.
EVENTS_V2_CONTACT_UNENROLLED_MANUALLY_FROM_SEQUENCE	Brugeren har manuelt afmeldt kontakten.
EVENTS_V2_KONTAKT_AFMELDTE_SEKVENS_E-MAIL	Kontakten har afmeldt sig, hvilket medfører afmelding fra sekvensen.
EVENTS_V2_SEQUENCE_EMAIL_BOUNCED	Sekvens-e-mailen blev returneret.
EVENTS_V2_SEQUENCE_ERRORED	Der opstod en fejl i sekvensen, hvilket medførte afmelding.
EVENTS_V2_SEQUENCE_STEP_EXECUTED	Sekvenstrin udført.
EVENTS_VISITED_PAGE	Besøg på websiden af kontakter.
EVENTS_<INTEGRATION_EVENT_NAME>_<UNIQUE_IDENTIFIER>	Integrationsbegivenheder (Timeline V3 API)

Du kan identificere begivenheder ved at kombinere deres begivenhedstype-ID og ID. De kolonner, der returneres, afhænger af begivenheden, med én kolonne for hver begivenhedsegenskab. Alle begivenheder returnerer følgende kolonner:

Bemærk: HubSpot har tilføjet to nye kolonner til alle begivenhedstabeller og -visninger:

occurredat
occurredatdateint

Disse kolonner erstatter kolonnerne occuredat og occuredatdateint den 24. november 2022. Fra denne dato vil de gamle kolonner ikke længere være tilgængelige, og forsøg på at forespørge et databaseobjekt eller en visning, der indeholder begivenheder ved hjælp af disse kolonner, vil mislykkes. Få mere at vide om ændringer, der medfører kompatibilitetsproblemer, for Snowflake-datadeling.

Kolonnenavn	Type	Beskrivelse
`EVENTTYPEID`	Varchar	ID'et for begivenhedstypen, svarende til OBJECTTYPEID Du kan hente alle begivenhedstype-ID'er på din konto ved hjælp af visningen object_and_event_type_definitions.
`ID`	Varchar	Dette er unikt for hver begivenhedstype. Der vil ikke være to poster med samme ID inden for en given begivenhedstype.
`OBJECTTYPEID`	Varchar	Den type objekt, der udløste begivenheden. For eksempel vil et klik på et link i en e-mail vise`0-1` i denne kolonne, hvilket repræsenterer kontaktobjektet.
`OBJECTID`	Tal	ID'et for den post, der udløste begivenheden.
`OCCURREDAT`	Tidsstempel	Hvornår begivenheden fandt sted.
`OCCURREDATDATEINT`	Tal	Et tal, der angiver, hvornår begivenheden fandt sted. Indeholder de samme data som kolonnen `OCCURREDAT`, men er formateret som et tal og bruges som en del af tabellens klyngenøgle. I de fleste tilfælde kan du bruge tidsstemplet `OCCURREDAT` i stedet for dette tal.
`OCCUREDATDATEINT`	Tal	Et tal, der angiver, hvornår begivenheden fandt sted. Indeholder de samme data som kolonnen `OCCURREDAT`, men er formateret som et tal og bruges som en del af tabellens klyngenøgle. I de fleste tilfælde kan du bruge tidsstemplet `OCCURREDAT` i stedet for dette tal. Bemærk: Denne kolonne udgår den 24. november 2022 og erstattes af `OCCURREDATDATEINT`.
`OCCUREDAT`	Tidsstempel	Hvornår begivenheden fandt sted. Bemærk: Denne kolonne vil blive udfaset den 24. november 2022 og erstattet med `OCCURREDAT`.
`INGESTEDAT`	Tidsstempel	Dato og klokkeslæt for, hvornår dataene sidst blev indlæst af Snowflake. Få mere at vide om kolonnedatatyper.
`PROPERTY_*`	Varchar	Individuelle kolonner, der indeholder begivenhedsegenskaberne.

Eksempel 1

Hent de 50 seneste e-mail-klikbegivenheder.

Forespørgsel:

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. august 2016 kl. 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-mail-klikbegivenheder fra de kontakter, der har klikket. Denne forespørgsel henter kontaktdata ved at sammenkæde med object_with_object_properties.

Forespørgsel:

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:

KLIK_TIDSPUNKT	KLIK_URL	CONTACT_FIRSTNAME	CONTACT_EFTERNAVN
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	Guld
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 databaseobjekt indeholder definitioner for alle objekter og begivenheder, der er tilgængelige i din HubSpot-konto.

Dette databaseobjekt kan returnere følgende kolonner:

Kolonnenavn	Type	Beskrivelse
`OBJECTTYPEID`	Varchar	ID'et for det objekt, som pipelinen kan indeholde (f.eks. aftaler eller tickets).
`FULLYQUALIFIEDNAME`	Varchar	Navnet på objektet eller begivenheden.
`INGESTEDAT`	Tidsstempel	Dato og klokkeslæt for, hvornår dataene sidst blev indlæst af Snowflake. Få mere at vide om kolonnedatatyper.

Eksempel 1

Hent alle objekter og begivenheder, der er tilgængelige i din HubSpot-konto.

Forespørgsel:

SELECT objectTypeId, fullyQualifiedName
FROM object_and_event_type_definitions;

Returnerer:

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

Segmentforespørgsler

Nedenfor kan du lære, hvordan du søger i dine segmenter, f.eks. de tilgængelige kontakt- og virksomhedssegmenter samt de poster, der er inkluderet i disse segmenter.

segmenter

Dette databaseobjekt indeholder oplysninger om HubSpot-kontakt- og virksomhedssegmenter. Returnerer én række pr. segment, og kolonnerne indeholder segmentoplysninger såsom segmentnavn, størrelse og objekttypen for de poster, det indeholder. Indeholder ikke oplysninger om de enkelte poster inden for hvert segment (se segment_membership).

Dette databaseobjekt kan returnere følgende kolonner:

Kolonnenavn	Type	Beskrivelse
`OBJECTTYPEID`	Varchar	Typen af poster i segmentet (f.eks. kontaktperson eller virksomhed).
`SEGMENTID`	Tal	Segmentets ID. Kobles til kolonnenSEGMENTID i tabellen segment-medlemskaber.
`CLASSICSEGMENTID`	Tal	Et ID, der er specifikt for kontaktsegmenter, og som svarer til ID’et i segmentets URL i HubSpot.
`NAME`	Varchar	Segmentets navn.
`SIZE`	Tal	Antallet af poster i segmentet.
`CREATEDBYUSERID`	Tal	ID'et for den bruger, der oprettede segmentet.
`CREATEDAT`	Tidsstempel	Hvornår segmentet blev oprettet i HubSpot.
`UPDATEDBYUSERID`	Tal	ID'et for den bruger, der senest har opdateret segmentet.
`UPDATEDAT`	Tidsstempel	Dato og klokkeslæt for den seneste opdatering af dataene i HubSpot. Få mere at vide om datatyper i kolonner.
`INGESTEDAT`	Tidsstempel	Dato og klokkeslæt for, hvornår dataene sidst blev indlæst af Snowflake.

Eksempel 1

Hent alle kontaktsegmenter.

Forespørgsel:

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

Returnerer:

SEGMENTSID	NAVN	STØRRELSE
118131	Ugentlig opsøgende indsats	103
66156	Blogabonnenter	455
771.852	Topfølgere 2021	37
...	...	...

Eksempel 2

Hent et specifikt kontaktsegment med navnet Topabonnenter 2021.

Forespørgsel:

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

Resultat:

SEGMENTID	NAVN	STØRRELSE
771.852	Topforskrivere 2021	37

segment_membership

Dette databaseobjekt indeholder oplysninger om, hvilke poster der er medlemmer af hvilke segmenter, med én række pr. post i segmentet. Hvis du f.eks. har et segment ved navn "Blogabonnenter" med 500 kontakter, returnerer databaseobjektet 500 rækker.

Indeholder kun segment-ID'er og objekt-ID'er. For yderligere oplysninger skal du sammenkøre med databaseobjektet " segmenter ".

Dette databaseobjekt kan returnere følgende kolonner:

Kolonnenavn	Type	Beskrivelse
`SEGMENTID`	Varchar	Segmentets ID. Kobles til kolonnen HS_SEGMENT_ID i segment tabellen.
`OBJECTID`	Varchar	ID'et for posten i segmentet.
`UPDATEDAT`	Tidsstempel	Dato og klokkeslæt for, hvornår dataene sidst blev opdateret i HubSpot. Få mere at vide om kolonnedatatyper.
`INGESTEDAT`	Tidsstempel	Dato og klokkeslæt for, hvornår dataene sidst blev indlæst af Snowflake.

Eksempel 1

Hent ID'erne for alle kontakter i segmentet "Topabonnenter 2021 ".

Forespørgsel:

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 fornavn og efternavn samt yderligere oplysninger om kontakterne i segmentet " Topabonnenter 2021 ".

Forespørgsel:

SELECT

contact.objectId AS object_id,

contact.properties:firstname::string AS fornavn,

contact.properties:lastname::string AS efternavn

FRA objekt_med_objekt_egenskaber AS kontakt

INNER JOIN segment_medlemskaber AS medlemskab

ON contact.objectId = membership.objectId

INNER JOIN segmenter

ON membership.segmentId = segments.segmentId

WHERE contact.objectTypeId = '0-1'

OG segments.objectTypeId = '0-1'

OG segments.name = 'Topabonnenter 2021';

Resultat:

OBJECTID	FØRNAME	EFTERNAVN
54325098	Hobbes	Baron
96805401	Milo	Gold
6922028	Henry	Riley
...	...	...

Ofte stillede spørgsmål

Jeg vil gerne generere data, der ligner en rapport fra Hubspot-appen. Hvordan gør jeg det?

Generelt bør du se på de kolonner, der findes i den rapport, du sammenligner med. Hvis rapportens visualisering ikke er tabelformet, vil en konvertering til en tabel vise de kolonner, rapporten indeholder. Disse kolonner er normalt egenskaber for en objekttype eller en begivenhedstype. Det næste trin er at finde ud af, hvilken objekttypeegenskab en kolonne svarer til. Du kan gøre dette ved at forespørge på property_definitions:

SELECT * FROM property_definitions

WHERE label = [column_name]

Der er ikke altid et nøjagtigt match, da nogle egenskabsnavne normalt omdannes til et mere beskrivende navn i appen. I sådanne tilfælde kan det hjælpe at foretage en fuzzy-søgning ved hjælp af LIKE-operatoren på kolonnen label (eller endda description) i property_definitions.

Når du har fastslået, hvilken objekttype kolonnen tilhører, er det nemt at afgøre, hvad der skal forespørges. Foretag en forespørgsel på object_with_object_properties og filtrer efter ` objectTypeId ` for den pågældende type. Læs de nødvendige egenskabsværdier fra JSON-kolonnen `properties`.

Hvordan knytter jeg denne datatype til en anden, f.eks. hvordan henter jeg formularer til en kampagne?

For at hente formularer, der er knyttet til hver kampagne, skal du sammenkæde OBJECT_WITH_OBJECT_PROPERTIES, ASSOCIATIONS og ASSOCIATION_DEFINITIONS.

SELECT DISTINCT

campaigns.properties:hs_name::string AS kampagnenavn,

forms.properties:hs_form_id::string AS form_id

FRA objekt_med_objekt_egenskaber AS kampagner

JOIN associationer AS forening

PÅ forening.fraObjektId = kampagner.objektId

JOIN association_definitions AS definition

ON definition.combinedAssociationTypeId =

association.combinedAssociationTypeId

JOIN objekt_med_objekt_egenskaber AS forms

ON forms.objectId = association.toObjectId

WHERE kampagner.objekttype-id = '0-35'

OG forms.objectTypeId = '0-28'

OG definition.fromObjectTypeId = '0-35'

OG definition.toObjectTypeId = '0-28';

Hvordan kan jeg se status for HubSpot-Snowflake-integrationen?

For at modtage statusopdateringer i realtid om nedbrud og problemer med HubSpot-Snowflake-integrationen skal du forespørge data_share_status-visningen:

SELECT * FROM hubspot.public.data_share_status LIMIT 1

Resultaterne vises som følger:

STATUS	MEDDELELSE	OPDATERET
OK	INGEN KENDTE HÆNDELSER P.T.	10. april 2023 kl. 09:21:20.123

Denne visning giver opdateringer om integrationsstatus i omvendt kronologisk rækkefølge. Ved at integrere resultaterne af denne forespørgsel i et dashboard kan du nemmere følge med i integrationens ydeevne og opdage eventuelle nedbrud eller afbrydelser.

Var denne artikel nyttig?

Denne formular bruges kun til dokumentationsfeedback. Læs, hvordan du kan få hjælp hos HubSpot.

Forespørg HubSpot-data i Snowflake

Gælder for:

Datalag og din Snowflake-kontos region

Konfigurer dit Snowflake-miljø

Dataoversigt

Begrænsning og sortering af returnerede data

Datatyper for kolonner

Konvertering af datatyper

Objektforespørgsler

object_with_object_properties

Eksempel 1

Eksempel 2

objekter

Eksempel 1

object_properties

Eksempel 1

Eksempel 2

object_properties_history

Eksempel 1

Eksempel 2

Associationsforespørgsler

association_definitions

Eksempel 1

Eksempel 2

associations

Eksempel 1

Eksempel 2

Eksempel 3

Ejersøgninger

ejere

Eksempel 1

Eksempel 2

Eksempel 3

Teamforespørgsler

teams

Eksempel 1

owner_team

Eksempel 1

Pipeline-forespørgsler

pipelines

Eksempel 1

Eksempel 2

pipeline_stages

Eksempel 1

Eksempel 2

Ejendomsforespørgsler

property_definitions

Eksempel 1

Begivenhedsforespørgsler

Eksempel 1

Eksempel 2

Object_and_event_type_queries

object_and_event_type_definitions

Eksempel 1

Segmentforespørgsler

segmenter

Eksempel 1

Eksempel 2

segment_membership

Eksempel 1

Eksempel 2

Ofte stillede spørgsmål

Jeg vil gerne generere data, der ligner en rapport fra Hubspot-appen. Hvordan gør jeg det?

Hvordan knytter jeg denne datatype til en anden, f.eks. hvordan henter jeg formularer til en kampagne?

Hvordan kan jeg se status for HubSpot-Snowflake-integrationen?

Relateret indhold