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ørgsel på HubSpot-data i Snowflake

Sidst opdateret: september 27, 2023

Gælder for:

Operations Hub Enterprise

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

Dataforsinkelse og din Snowflake-kontoregion

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

Opsæt dit Snowflake-miljø

For at forespørge på dine HubSpot-data i Snowflake skal du vælge det lager, den database og det skema, du vil forespørge på. Du kan enten indstille dem på regnearkniveau for automatisk at inkludere dem i dine forespørgsler, eller du kan tilføje dem manuelt.

Vælg dit lager, din database og dit skema på regnearksniveau:

I øverste række af regnearket skal du klikke på regnearkets handlingslinje.
I pop op-vinduet:
- Klik på rullemenuen Lager, og vælg derefter dit lager.
- Klik på rullemenuen Database, og vælg din HubSpot-database.
- Klik på rullemenuen Schema, og vælg det skema, du vil bruge:

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

For manuelt at tilføje din database og skematype til forespørgsler skal du tilføje databasenavnet efterfulgt af skemaet i begyndelsen af FROM -feltet. For eksempel:

SELECT objectTypeId, property_createddate
FROM hubspot_share_name.V2_LIVE.objects_deals

LIMIT 1

Oversigt over data

Forespørgsler er konstrueret ved hjælp af SQL og kan bruges til at hente HubSpot-data som f.eks:

Objekter: standard- og brugerdefinerede objekter, såsom kontakter, virksomheder, produkter.
Records: individuelle records, som f.eks. en individuel kontakt eller virksomhed.
Associationer: alle tilgængelige associationstyper og aktuelt associerede poster.
Begivenheder: begivenhedsdata for både standard HubSpot-begivenheder, såsom åbning af e-mails, og brugerdefinerede adfærdsbegivenheder.
Lister: HubSpot kontakt- og virksomhedslister.
Ejere: brugere på din HubSpot-konto i forhold til de poster, de er sat som ejere af.
Pipelines: aftale- og billetpipelines, herunder pipelinefaser.
Egenskaber: egenskaber og deres værdier på CRM-poster, herunder ejendomshistorik.

Få mere at vide om HubSpots CRM-datamodel.

Bemærk: Efterhånden som vi udvikler datadelingen, vil vi introducere ændringer, nogle af dem er banebrydende. Det anbefales på det kraftigste at abonnere på HubSpots ændringslog for udviklere. Disse ændringer vil altid blive offentliggjort i ændringsloggen forud for enhver opdatering.

Begrænsning og bestilling af returnerede data

Når du konstruerer forespørgsler, kan du styre, hvor mange data der returneres, og i hvilken rækkefølge de returneres, ved at inkludere LIMIT 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 ordne dem efter kontakt-ID, kan du konstruere din forespørgsel på følgende måde:

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

Kolonne-datatyper

Når du forespørger på data i Snowflake, afhænger de kolonner, der returneres, af de data, du forespørger på. 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

Hvis du vil returnere en bestemt kolonne, skal du inkludere kolonnen i SELECT -feltet i din forespørgsel. For eksempel vil følgende forespørgsel kun returnere kolonnerne OBJECTID og UpdatedAt:

SELECTobjectId, updatedAt
FROM objects_contacts

Nedenfor er generelle definitioner for kolonner, som en forespørgsel kan returnere. For andre definitioner, der ikke er inkluderet nedenfor, se de individuelle visningsdefinitioner i artiklen ovenfor.

OBJECTTYPEID: en VARCHAR-værdi, der repræsenterer et objekts type. For eksempel repræsenterer 0-1 kontaktobjektet, 0-2 repræsenterer firmaobjektet, og 2-1232 kan repræsentere et brugerdefineret objekt i din konto. I lister henviser dette til listetypen (f.eks. kontakt eller virksomhed). Du kan forespørge på alle objekt- og hændelses-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 type objekt 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 række data blev tilføjet til Snowflake, repræsenteret ved en TIMESTAMP_NTZ-værdi. Ikke relateret til det logiske tidsstempel for en oprettelses- eller opdateringsoperation i HubSpot.
- På grund af HubSpots interne behandling kan en rækkes ingestion-tidsstempel blive opdateret, selvom ingen andre kolonner i rækken har ændret sig.
- Når du bygger ETL-processer, der kopierer nyligt ændrede data, anbefales det at basere dine forespørgsler på ingestion-tidsstemplet. Hvis dit flow kopierer data dagligt, anbefales det desuden at kopiere data fra de foregående to 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 ved en TIMESTAMP_NTZ-værdi . Disse tidsstempler vil matche tidsstemplerne i HubSpot. For eksempel vil det tidspunkt, der vises i HubSpot for en posts oprettelsesdato, være det samme som tidsstemplet i CREATEDAT-kolonnen i Snowflake. Disse er ikke direkte relateret til ingestion-tidsstemplet, og det anbefales ikke at basere ETL-processer på disse egenskaber.
COMBINEDASSOCIATIONTYPE: en VARCHAR-værdi, der entydigt identificerer en associationsdefinition.

Transformering af datatyper

Nogle gange returneres data fra en forespørgsel med VARCHAR-kolonner, når det ville være ønskeligt at have dem som en anden type. I tilfælde som dette 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 nogle gange tal- og datetime-værdier. Funktioner som f.eks:
try_to_number, try_to_timestamp_ntz kan bruges til at konvertere disse VARCHAR-data til deres 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 se, hvordan du forespørger data fra specifikke HubSpot-objekter og -poster, samt hvilke data der returneres.

Objektdata af forskellige typer er organiseret og tilgængelige på to måder:

Individuel: Hver objekttype gemmes i sin egen visning og indeholder kun poster af den samme objekttype, f.eks. indeholder objects_contacts kun kontaktposter. Dette eliminerer behovet for at angive et objecttypeid under forespørgslen. Disse visninger er nemmere at forespørge på, da du ikke behøver at kende ObjectTypeIds. De returnerer også data i et mere brugbart format, hvor hver række svarer til et objekt og den aktuelle version af dets egenskaber. Så længe du ikke oplever langsomme forespørgsler, er det tilrådeligt at bruge disse visninger til at hente objektdata. Se mere i Objects_X-visninger nedenfor.
Kombineret: Alle poster for alle objekttyper kombineres til ét databaseobjekt. Når du forespørger, skal du derfor angive et filter som "WHERE objectTypeId='0-1'. Du kan f.eks. bruge følgende objekttype-id'er, når du forespørger:

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

Brugerdefinerede objekter får tildelt et ID på oprettelsestidspunktet og identificeres som 2-unique_ID. For eksempel 2-12345. Læs mere om object_and_event_type_definitions.

Disse databaseobjekter er generelt velegnede, hvis du ønsker bedre forespørgselsperformance, end hvad der kan opnås med objects_x views. Se flere detaljer i object_with_object_properties, object_properties, objects og object_properties_history nedenfor.

objects_x visninger

I dette databaseobjekt har hver tilgængelig objekttype, inklusive brugerdefinerede objekter, sin egen specifikke visning, hvor hver visning kun indeholder poster for objekter af den specifikke objekttype. Disse visninger navngives i formatet OBJECTS_<object type name>, hvor <object type name> er objekttypens flertalsform(bemærk, at hvis objekttypen ikke har nogen flertalsform, vil <object type name> blot være entalsformen af objekttypens navn sammenkædet med "S").

Forespørgsler til denne visning returnerer en række for hver post i et objekt med hver egenskab i objektet tilgængelig som en separat kolonne.

Se nedenfor den omfattende liste over tilgængelige HubSpot-objekttyper (dvs. ikke-tilpassede), en kort beskrivelse af de data, de repræsenterer, og deres tilsvarende visninger:

HubSpot Objekttype	ObjectTypeId	Beskrivelse
KONTAKT	0-1	Oplysninger om personer, der interagerer med din virksomhed
VIRKSOMHED	0-2	Oplysninger om individuelle virksomheder eller organisationer
AFTALE	0-3	Detaljer om indtægtsmuligheder med en kontakt eller virksomhed.
ENGAGEMENT	0-4	Gemmer data fra CRM-handlinger, herunder noter, opgaver, e-mails, møder og opkald.
BILLET	0-5	Repræsentere kundeanmodninger om hjælp eller support.
CITAT	0-14	Bruges til at dele prisoplysninger med potentielle købere.
FORM_SUBMISSION	0-15	Detaljer for individuelle indsendelser til en HubSpot-formular.
LINE_ITEM	0-8	Repræsenterer en delmængde af de produkter, der sælges i en aftale. Når et produkt er knyttet til en aftale, bliver det en varelinje.
SAMTALE	0-11	Detaljer om indgående beskeder fra flere kanaler.
LANDING_PAGE	0-25	Detaljer om dine landingssider
OPGAVE	0-27	Gemmer oplysninger om to-do-lister
FORM	0-28	Bruges til at indsamle lead-oplysninger om dine besøgende og kontakter.
MARKETING_EMAIL	0-29	Detaljer om e-mails fra marketing hub
AD_ACCOUNT	0-30	Gemmer oplysninger om dine annoncekonti på Linkedin, Facebook og Google.
AD_CAMPAIGN	0-31	Detaljer om dine annoncekampagner. En annoncekampagne kan indeholde en eller flere annoncer
AD_GROUP	0-32	Logisk gruppering af annoncer i en annoncekampagne
AD	0-33	Detaljer om individuelle annoncer
KAMPAGNE	0-35	Information om relaterede marketingaktiver og indhold, så du nemt kan måle effektiviteten af din samlede marketingindsats.
SITE_PAGE	0-38	Data om individuelle sider på dine hjemmesider
BLOG_POST	0-39	Data om blogindlæg
OBJECT LIST	0-45	Information om grupperinger af objektposter baseret på deres egenskaber eller aktiviteter
RING	0-48	Opkald foretaget af andre CRM-poster, f.eks. kontakter
FAKTURA	0-53	Administrer og synkroniser fakturaer med eksterne regnskabssystemer
MEDIA_BRIDGE	0-57	Information om medieaktiver importeret til Hubspot
SEQUENCE	0-58	En sekvens er en række målrettede, timede e-mailskabeloner til at pleje kontakter over tid.
DEAL_SPLIT	0-72	Deal splits bruges til at dele deal credit mellem flere brugere
SALES_DOCUMENT	0-83	Salgsdokumenter opbygger et bibliotek med indhold, så hele dit team kan uploade og dele dokumenter med dine kontakter.
FEEDBACK_SUBMISSION	0-19	Gemmer oplysninger, der er indsendt i en feedback-undersøgelse.
ABONNEMENT	0-69	Abonnementer indeholder oplysninger om tilbagevendende betalinger
BETALING FOR HANDEL	0-101	Indeholder data om midler indsamlet fra kunder

Hvert databaseobjekt returnerer følgende kolonner:

Kolonnens navn	Type	Beskrivelse
OBJECTTYPEID	Varchar	Objekttypens ID (f.eks. er kontakter 0-1).
OBJECTID	Antal	Postens ID (f.eks. en kontaktpost med et ID på 123752).
OPDATERETAT	Tidsstempel	Den dato og det klokkeslæt, hvor dette objekt sidst blev opdateret i HubSpot.
INGESTEDAT	Tidsstempel	Den dato og det klokkeslæt, hvor dataene sidst blev indlæst af Snowflake.
PROPERTY_*	Varchar	Individuelle kolonner, der indeholder den seneste version af objektets egenskaber. For hver objektegenskab, der har en dato eller tal-type (som specificeret af property_definitions), vil der være to kolonner: En kolonne, der indeholder egenskabsværdien som streng. Kolonnenavnet vil være property_unparsed_[name] . For eksempel vil DEAL-objektegenskaben deal_amount have kolonnen property_unparsed_deal_amount. En kolonne, der indeholder værdien konverteret til den oprindelige type. Kolonnen vil have navnet property_[name], f.eks. vil DEAL object property, deal_amount have kolonnen property_deal_amount. Bemærk, at denne kolonne vil indeholde null, hvis konverteringen til den oprindelige type mislykkes på grund af ugyldige data.

Eksempel 1

Hent fornavn, efternavn og livscyklusstadie for alle kontakter.

Forespørgsel:

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

Returnerer:

OBJECTID	FORNAVN	EFTERNAVN	LIVSSTIL
54325098	Hobbes	Baron	bly
96805401	Milo	Guld	bly
6922028	Henry	Riley	bly

Eksempel 2

Hent aftalens navn og stadie for op til tre aftaler.

Forespørgsel:

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

Returnerer:

OBJECTID	PROPERTY_DEALNAME	PROPERTY_DEALSTAGE	PROPERTY_DEALAMOUNT
38960439	Navn på aftale 1	vundet	34199
321740651	Test Deal 123	14845019	8383663
98392101	Pop-up baldakin	vundet	9309007

Eksempel 3

Hent aftalens navn og stadie for de tre største aftaler efter beløb.

Forespørgsel:

Da deal amount-data er tilgængelige som en tal-datatype, kan de bruges til bestilling uden at skulle konverteres eller castes.

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

Returnerer:

OBJECTID	PROPERTY_DEALNAME	PROPERTY_DEALSTAGE	PROPERTY_DEALAMOUNT
98392101	Pop-up baldakin	vundet	9309007
321740651	Test Deal 123	14845019	8383663
38960439	Navn på aftale 1	vundet	34199

objekt_med_objekt_egenskaber

Dette databaseobjekt indeholder data fra dine HubSpot-poster. Forespørgsler til dette databaseobjekt returnerer en 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:

Kolonnens navn	Type	Beskrivelse
`OBJECTTYPEID`	Varchar	Objekttypens ID (f.eks. er kontakter `0-1`).
`OBJECTID`	Antal	Postens ID (f.eks. en kontaktpost med et ID på `123752`).
`PROPERTIES`	Variant	Postens ejendomsværdier.
`UPDATEDAT`	Tidsstempel	Den dato og det klokkeslæt, hvor posten sidst blev opdateret i HubSpot. Læs mere om kolonnedatatyper.
`INGESTEDAT`	Tidsstempel	Den dato og det klokkeslæt, hvor dataene sidst blev indlæst af Snowflake.

Bemærk: Den 25. januar 2022 bliver kolonnen timestamp i object_with_object_properties-tabellen og -visningen, som repræsenterer dato og klokkeslæt for, hvornår objektposten sidst blev opdateret i HubSpot , til updatedat. Dette er for at tilpasse sig, hvordan datetime-data repræsenteres i resten af datadelen.

Da dette er en gennemgribende ændring, er den nye kolonne, updatedat, blevet tilføjet til tabellen og visningen. I de næste 90 dage vil disse to nye kolonner eksistere side om side med timestamp, som er de kolonner, de skal erstatte. Dette giver dig en mulighed for at skifte til at bruge de nye kolonner.

Efter 90 dage, den 25. januar 2022, vil kolonnen timestamp blive fjernet fra tabellen og visningen. Efter denne dato vil ethvert forsøg på at forespørge object_with_object_properties-tabellen 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'

Returnerer:

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

Eksempel 2

Hent aftalens navn og stadie 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	DEALSTAGE	DEALAMOUNT
38960439	Navn på aftale 1	lukket tabt	7488939
321740651	Navn på aftale 1	vundet	9292029
98392101	Navn på aftale 1	lukket 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, vil den blive fjernet fra dette databaseobjekt. Dette databaseobjekt er en delmængde af dataene i tabellen object_with_object_properties. Hver returneret række returnerer objekt-ID'et for hver post. Denne visning returnerer kun eksisterende poster. Når en post slettes i HubSpot, vil den blive fjernet fra denne visning.

Dette databaseobjekt kan være nyttigt, hvis din konto har en stor mængde data, hvilket fører til, at object_with_object_properties og objects_x views fungerer langsomt. Brug af dette databaseobjekt sammen med databaseobjektet object_properties gør det muligt at replikere dataene i object_with_object_properties, samtidig med at man bevarer kontrollen over, hvilke egenskaber der returneres.

Dette databaseobjekt kan returnere følgende kolonner:

Kolonnens navn	Type	Beskrivelse
`OBJECTTYPEID`	Varchar	Objekttypens ID (f.eks. er kontakter `0-1`).
`OBJECTID`	Antal	Postens ID (f.eks. en kontaktpost med et ID på `123752`).
`INGESTEDAT`	Tidsstempel	Den dato og det klokkeslæt, hvor dataene sidst blev indlæst af Snowflake. Læs mere om kolonnedatatyper.

Eksempel 1

Hent alle kontaktoptegnelser.

Forespørgsel:

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

Returnerer:

OBJECTTYPEID	OBJECTID
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 indstillet på en given post. For eksempel vil en kontakt 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, vil rækken enten blive vist med en tom streng eller slet ikke blive vist.

Dette databaseobjekt kan returnere følgende kolonner:

Kolonnens navn	Type	Beskrivelse
`OBJECTTYPEID`	Varchar	Objekttypens ID (f.eks. er kontakter `0-1`).
`OBJECTID`	Antal	Postens ID (f.eks. en kontaktpost med et ID på `123752`).
`NAME`	Varchar	Navnet på ejendommen.
`VALUE`	Tidsstempel	Værdien af ejendommen.
`UPDATEDAT`	Tidsstempel	Den dato og det klokkeslæt, hvor posten sidst blev opdateret i HubSpot. Læs mere om kolonnedatatyper.
`INGESTEDAT`	Tidsstempel	Den dato og det klokkeslæt, hvor dataene sidst blev indlæst af Snowflake.

Eksempel 1

Hent fornavn, efternavn og byegenskaber 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 livscyklusstadie for alle kontakter, og kombiner dem i é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);

Returnerer:

OBJECTTYPEID	OBJECTID	FORNAVN	EFTERNAVN	LIVSSTIL
0-1	54325098	Hobbes	Baron	bly
0-1	96805401	Milo	Guld	bly
0-1	6922028	Henry	Riley	bly
...	...	...	...	...

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 for en egenskab bestemmes af det seneste UPDATEDAT-tidsstempel i egenskabens historik.

Dette databaseobjekt kan returnere følgende kolonner:

Kolonnens navn	Type	Beskrivelse
`OBJECTTYPEID`	Varchar	Objekttypens ID (f.eks. er kontakter `0-1`).
`OBJECTID`	Antal	Postens ID (f.eks. en kontaktpost med et ID på `123752`).
`NAME`	Varchar	Navnet på ejendommen.
`VALUE`	Tidsstempel	Værdien af ejendommen.
`UPDATEDAT`	Tidsstempel	Den dato og det tidspunkt, hvor dataene sidst blev opdateret i HubSpot. Læs mere om kolonnedatatyper.
`INGESTEDAT`	Tidsstempel	Den dato og det klokkeslæt, hvor dataene sidst blev indlæst af Snowflake.

Eksempel 1

Hent historikken for en enkelt ejendom 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	OPDATERETAT
136493192	hs_predictivescoringtier	tier_1	2022-06-22 22:45:05.931
136493192	hs_predictivescoringtier	niveau_2	2021-09-18 08:20:56.622
136493192	hs_predictivescoringtier	niveau_3	2019-11-31 18:20:22.851
...	...	...	...

Eksempel 2

Hent det aktuelle navn på alle kontakter, der nogensinde har haft et livscyklusstadie som 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'
);

Returnerer:

OBJECTID	FORNAVN	EFTERNAVN
54325098	Hobbes	Baron
96805401	Milo	Guld
6922028	Henry	Riley
...	...	...

Forespørgsler om foreninger

Ligesom objektdata er associationsdata organiseret på to måder:

Individuel: Hver associationstype gemmes i sin egen visning og indeholder kun poster af den type. For eksempel indeholder associations_contacts_to_deals kun association records mellem kontakt- og deal-objekter. Dette eliminerer behovet for at angive et associationtypeid under forespørgslen. Disse visninger er ret nemme at forespørge på, da de ikke kræver kendskab til CRM-datamodellen for at kunne bruges. De returnerer også en beriget beskrivelse af association record mellem to objekter, som nemt kan bruges i joins med objects_x views. Så længe du ikke oplever langsomme forespørgsler, kan det anbefales at bruge disse views til at hente associationsdata. Se mere i associations_x_to_y views nedenfor.
Kombineret: Alle poster for alle associationstyper kombineres til ét databaseobjekt. Når du forespørger, skal du derfor angive et filter som "WHERE combinedassociationtypeid='0-32'". Se mere i associations og association_definitions nedenfor.

associationer_x_til_y visninger

Hver associationstype har sin egen visning, mærket som associations_<associationstypens navn>, f.eks. associations_contacts_to_deals. Hver visning er en delmængde af dataene i associations-databaseobjektet og indeholder kun poster med et specifikt combinedassociationtypeid.

Hvert databaseobjekt returnerer følgende kolonner:

Kolonnens navn	Type	Beskrivelse
KOMBINERETASSOCIATIONSTYPEID	Varchar	Den unikke identifikator for associationsdefinitionen.
FORENINGSKATEGORI	Varchar	Kilden til associationstypen. En af følgende: HUBSPOT_DEFINED, USER_DEFINED, INTEGRATOR_DEFINED
ASSOCIATIONTYPEID	Varchar	En unik identifikator for en associationsdefinition inden for en specifik associationskategori, dvs. at ikke to definitioner i en associationskategori vil have samme associationtypeid.
FROMOBJECTTYPEID	Varchar	Det objecttypeid, der er kilden til associationsdefinitionen.
FROMOBJECTTYPE	Varchar	Navnet på den objekttype, der er kilden til associationsdefinitionen.
TOOBJECTTYPEID	Varchar	Det objecttypeid, som er destinationen for associationsdefinitionen.
TOOBJECTTYPE	Varchar	Navnet på den objekttype, som er destinationen for associationsdefinitionen.
NAVN	Varchar	Navnet på associationsdefinitionen.
LABEL	Varchar	Beskrivelsen af foreningsdefinitionen.
ISMAINASSOCIATIONDEFINITION	Boolsk	Om associationsdefinitionen er hovedtypen. Hvis true, er definitionen den, som HubSpot viser på tilknyttede poster.
[FROMOBJECTTYPE_OBJECTID] f.eks. for visningen ASSOCIATIONS_CONTACTS_TO_DEALS vil dette være CONTACT_OBJECTID.	Antal	Kildeobjektets objekt-ID.
[TOOBJECTTYPE_OBJECTID] f.eks. for visningen ASSOCIATIONS_CONTACTS_TO_DEALS, vil dette være DEAL_OBJECTID.	Antal	Objekt-ID for destinationsobjektet.
INGESTEDAT	Tidsstempel	Den dato og det klokkeslæt, hvor dataene sidst blev indlæst af Snowflake.

Eksempel 1

Hent alle aftaler, der er knyttet til en bestemt kontakt.

Forespørgsel:

SELECT
kontakt_objektId, aftale_objektId

FROM associations_contacts_to_deals

HVOR kontaktId = 6626541373

Returnerer:

CONTACT_OBJECTID	DEAL_OBJECTID
6626541373	233620335
6626541373	90253678

Eksempel 2

Hent alle kontakter baseret i tidszonen Bogota og deres tilbud.

SELECT contacts.property_firstname contact_firstname,

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

KONTAKT_FORNAVN	KONTAKT_EFTERNAVN	KONTAKT_EMAIL	DEAL_TYPE	DEAL_AMOUNT
David	Magalhães	dmagalhaes@example.com	newbusiness	74848
Fernanda	Rodrigues	fmoreira@example.com	newbusiness	253530

Eksempel 3

Hent alle kontakter og den samlede sum af lukkede aftaler for hver kontakt.

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

Returnerer:

SAMLET_LUKKET_BELØB	KONTAKT_EMAIL
98474793	johndoe@riverview.com
849488	sallymae@longford.com

association_definitions

Dette databaseobjekt indeholder information om alle de tilgængelige associationstyper mellem HubSpot-objekter, med én række pr. associationstype. Du kan joine dette databaseobjekt med associations-databaseobjektet for at få postspecifik associationsinformation.

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

Dette databaseobjekt kan returnere følgende kolonner:

Kolonnens navn	Type	Beskrivelse
`COMBINEDASSOCIATIONTYPEID`	Varchar	Den unikke identifikator for associationsdefinitionen.
`CATEGORY`	Varchar	Kilden til associationstypen. En af følgende: `HUBSPOT_DEFINED`, `USER_DEFINED`, `INTEGRATOR_DEFINED`
`ID`	Antal	Identifikatoren for associationsdefinitionen inden for dens kategori.
`FROMOBJECTTYPEID`	Varchar	ID for det objekt, der er kilden til associationsdefinitionen.
`TOOBJECTTYPEID`	Varchar	ID for det objekt, der er destination for associationsdefinitionen.
`NAME`	Varchar	Navnet på associationsdefinitionen.
`LABEL`	Varchar	Etiketten på associationsdefinitionen.
`ISMAINASSOCIATIONDEFINITION`	Boolsk	Om associationsdefinitionen er hovedtypen. Hvis true, er definitionen den, som HubSpot viser på tilknyttede poster.
`INGESTEDAT`	Tidsstempel	Den dato og det klokkeslæt, hvor dataene sidst blev indlæst af Snowflake. Læs mere om kolonnedatatyper.

Eksempel 1

Hent de typer af foreninger, der er tilgængelige på din konto.

Forespørgsel:

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

Returnerer:

KOMBINERETFORENINGSTYPE	FROMOBJECTTYPEID	TOOBJECTTYPEID	NAVN
0-1	0-1	0-2	KONTAKT_TIL_VIRKSOMHED
0-2	0-2	0-1	FIRMA_TIL_KONTAKT
0-3	0-3	0-1	AFTALE_TIL_KONTAKT
0-4	0-1	0-3	KONTAKT_TIL_AFTALE
0-5	0-3	0-2	DEAL_TO_COMPANY
...	...	...	...

Eksempel 2

Hent de tilgængelige associationstyper mellem tilbud 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

Returnerer:

KOMBINERETFORENINGSTYPE	FROMOBJECTTYPEID	TOOBJECTTYPEID	NAVN
0-5	0-3	0-2	DEAL_TO_COMPANY
0-271	0-3	0-2	DEAL_TO_PRIMARY_COMPANY (AFTALE TIL PRIMÆR VIRKSOMHED)
0-341	0-3	0-2	DEAL_TO_COMAPNY_UNLABELED

foreninger

Dette databaseobjekt indeholder information om associationerne mellem specifikke poster. Hver række repræsenterer en association fra et objekt til et andet objekt. Rækker kan være til stede i dette databaseobjekt, selvom de refererede poster er blevet slettet. Du kan tjekke, om der findes poster ved at joine med objekttabellen.

Dette databaseobjekt kan være nyttigt, hvis din konto har en stor mængde data, hvilket fører til, at associations_x_to_y views fungerer langsomt.

Dette databaseobjekt kan returnere følgende kolonner:

Kolonnens navn	Type	Beskrivelse
`COMBINEDASSOCIATIONTYPEID`	Varchar	Den unikke identifikator for associationsdefinitionen.
`FROMOBJECTID`	Antal	ID for kildeobjektet.
`TOOBJECTID`	Antal	ID for destinationsobjektet.
`INGESTEDAT`	Tidsstempel	Den dato og det klokkeslæt, hvor dataene sidst blev indlæst af Snowflake. Læs mere om kolonnedatatyper.

Eksempel 1

Hent alle tilknyttede aftaler og kontakter.

Forespørgsel:

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

Returnerer:

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

Returnerer:

KOMBINERETFORENINGSTYPE	FROMOBJECTID	TOOBJECTID
0-5	6626541373	233620335

Eksempel 3

Hent alle aftaler, der er forbundet med en bestemt kontakt (kontakt-ID: 4464). I stedet for at hardcode combinedAssociationTypeId, joiner 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;

Returnerer:

KOMBINERETASSOCIATIONSTYPEID	FROMOBJECTID	TOOBJECTID
0-5	6626541373	233620335

Forespørgsler fra ejeren

ejere

Dette databaseobjekt indeholder oplysninger om brugerne på din HubSpot-konto. Brugere kan indstilles som record-ejere 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:

Kolonnens navn	Type	Beskrivelse
`OWNERID`	Antal	Brugerens ejer-ID.
`USERID`	Antal	Brugerens bruger-ID. Brugere med NULL i denne kolonne er blevet slettet.
`EMAIL`	Varchar	Brugerens e-mailadresse.
`FIRSTNAME`	Varchar	Brugerens fornavn.
`LASTNAME`	Varchar	Brugerens efternavn.
`ARCHIVED`	Boolsk	Om brugeren er blevet slettet.
`CREATEDAT`	Tidsstempel	Den dato og det klokkeslæt, hvor brugeren blev oprettet i HubSpot. Se kolonnedatatyper for mere information.
`UPDATEDAT`	Tidsstempel	Den dato og det tidspunkt, hvor brugeren sidst blev opdateret i HubSpot. Se kolonnedatatyper for mere information.
`INGESTEDAT`	Tidsstempel	Den dato og det klokkeslæt, hvor dataene sidst blev indlæst af Snowflake.

Eksempel 1

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

Forespørgsel:

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

Returnerer:

EJERID	USERID	EMAIL	FORNAVN	EFTERNAVN
29584574	4621126	233620335	Hobbes	Baron
30532717	4874784	3866015468	Pablo	Walters
30580321	925511	7132752747	Milo	Guld
...	...	...	...	...

Eksempel 2

Find en bestemt ejer ved hjælp af deres ejer-ID.

Forespørgsel:

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

Returnerer:

EJERID	USERID	EMAIL	FORNAVN	EFTERNAVN
29584574	4621126	233620335	Hobbes	Baron

Eksempel 3

Hent alle kontakter og deres ejere. Denne forespørgsel knytter poster til ejere med object_with_object_properties og kontaktegenskaben hubspot_owner_id.

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

JOIN owners owner ON contact.property_hubspot_owner_id = owner.ownerId

Returnerer:

CONTACTID	KONTAKT_FORNAVN	KONTAKT_EFTERNAVN	KONTAKT_HUBSPOT_EJER_ID	EJER_FORNAVN	EJER_NÆSTNAVN	EJER_EMAIL
113834202	Richard	Greenfield	29584574	Hobbes	Baron	hobbes.b@business.com
53540801	Ford	Karl	30241125	Milo	Guld	milo.g@business.com
...	...	...	...	...	...	...

Team-forespørgsler

hold

Teams i HubSpot giver dig mulighed for at 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 på din HubSpot-konto.

Dette databaseobjekt kan returnere følgende kolonner:

Kolonnens navn	Type	Beskrivelse
TEAMID	Antal	Holdets ID.
TEAMNAME	Varchar	Holdets navn.
PARENTTEAMID	Antal	Team-ID for det overordnede team.
BØRNEAMIDLER	Array	Team-ID'erne for de underordnede teams.
PRIMÆREJERMEDLEMMER	Varchar	Ejer-ID'erne for teamets primære medlemmer.
SEKUNDÆRE EJERMEDLEMMER	Boolsk	Ejer-id'erne for teamets sekundære medlemmer.
INGESTEDAT	Tidsstempel	Den dato og det klokkeslæt, hvor dataene sidst blev indlæst af Snowflake.

Eksempel 1

Hent alle hold.

Forespørgsel:

SELECT teamId,teamName, primaryOwnerMembers

Fra teams

Returnerer:

TEAMID	TEAMNAME	PRIMÆREJERMEDLEMMER
29584574	Underteam	[233620335, 1234553]
30532717	Superholdet	[3866015468, 126221873]
3058032	Et hold	[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:

Kolonnens navn	Type	Beskrivelse
TEAMID	Antal	Holdets ID.
EJERID	Antal	Brugerens ejer-ID.
ISTEAMPRIMARY	Boolsk	Om dette hold er det primære hold for denne ejer.
INGESTEDAT	Tidsstempel	Den dato og det klokkeslæt, hvor dataene sidst blev indlæst af Snowflake.

Eksempel 1

Hent alle ejere for et givet hold.

Forespørgsel:

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

Afkast

TEAMID	TEAMNAME	ISTEAMPRIMARY
29584574	233620335	SAND
29584574	1234553	SAND

Pipeline-forespørgsler

Nedenfor kan du se, hvordan du forespørger pådeal- og ticket pipeline-data, såsom de tilgængelige pipelines på din konto og deres stadier.

Du kan joine disse data med objektdata for at få et fuldt overblik over dine pipelines. Du kan f.eks. forespørge på deals og deres pipelines ved at joine objects_deals_view eller object_with_object_properties-data med pipelines-data.

rørledninger

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

Denne tabel kan returnere følgende kolonner:

Kolonnens navn	Type	Beskrivelse
`PIPELINEID`	Varchar	Rørledningens ID.
`OBJECTTYPEID`	Varchar	ID for det objekt, som pipelinen kan indeholde (f.eks. tilbud eller billetter).
`LABEL`	Varchar	Pipelinens navn i HubSpot.
`DISPLAYORDER`	Antal	Den rækkefølge, som pipelinen vises i i HubSpot.
`ARCHIVED`	Boolsk	Om pipelinen er blevet slettet.
`CREATEDAT`	Tidsstempel	Hvornår pipelinen blev oprettet.
`UPDATEDAT`	Tidsstempel	Den dato og det tidspunkt, hvor dataene sidst blev opdateret i HubSpot. Læs mere om kolonnedatatyper.
`INGESTEDAT`	Tidsstempel	Den dato og det klokkeslæt, hvor dataene sidst blev indlæst af Snowflake.

Eksempel 1

Hent alle tilgængelige deal pipelines, 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	Licenser Pipeline
0-3	75e28846-ad0d-4be2-a027-5e1da6590b98	Ny virksomhed
...	...	...

Eksempel 2

Hent aftaler inden for en bestemt pipeline. Forbinder object_with_object_properties og pipelines.

Forespørgsel:

SELECT

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

Returnerer:

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

Eksempel 3

Samme som eksempel 2 ovenfor, hent deals inden for en bestemt pipeline. Men i stedet for at bruge objects_deals i joins, skal du bruge object_with_object_properties.

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

Returnerer:

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

pipeline_stadier

Denne visning indeholder oplysninger om individuelle faser i en pipeline. Identificer trin ved at kombinere objekttype-ID, pipeline-ID og trin-ID. Brug objekttype-id'et og pipeline-id'et, når du forbinder med pipelines.

Dette databaseobjekt kan returnere følgende kolonner:

Kolonnens navn	Type	Beskrivelse
`PIPELINEID`	Varchar	Rørledningens ID.
`STAGEID`	Varchar	Scenens ID.
`LABEL`	Varchar	Scenens navn i HubSpot.
`DISPLAYORDER`	Antal	Den rækkefølge, som pipelinen vises i i HubSpot.
`METADATA`	Variant	En JSON-formateret beskrivelse af scenen, herunder om den er åben eller lukket.
`ARCHIVED`	Boolsk	Om pipeline-stadiet er blevet slettet.
`CREATEDAT`	Tidsstempel	Da pipeline-stadiet blev oprettet.

Eksempel 1

Hent pipeline-stadier for en deal-pipeline med navnet Sales 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	Tidsbestilling
941650	941653	Faktura sendt
...	...	...

Eksempel 2

Hent alle tilbud og deres respektive pipeline-stadier.

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

Returnerer:

DEAL_ID	DEAL_NAME	PIPELINE_NAME	PIPELINE_STAGE_NAME
605140072	Meowmix Global tilmelding	Salgspipeline	Kontrakt sendt
605457408	Friskies Rebrand	Salgspipeline	Tidsbestilling
604362473	Fresh Step App Build	Salgspipeline	Kontrakt underskrevet
...	...	...	...

Forespørgsler om ejendom

property_definitions

Dette databaseobjekt indeholder oplysninger om objektegenskaber og hændelsesegenskaber i din HubSpot-konto. Hændelsesegenskaber omfatter standardhændelser, såsom e-mailåbninger og klik, og brugerdefinerede adfærdsmæssige h ændelsesegenskaber. Disse oplysninger kan være nyttige til at definere værdier, der findes i object_properties og hændelsesdata.

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:

Kolonnens navn	Type	Beskrivelse
`OBJECTYPEID`	Varchar	ID for det objekt, som hændelsen relaterer til.
`NAME`	Varchar	Egenskabens interne navn.
`LABEL`	Varchar	Ejendommens etiket.
`DESCRIPTION`	Varchar	Beskrivelse af ejendommen.
`TYPE`	Varchar	Egenskabens type (f.eks. streng, tal, datetime).
`FIELDTYPE`	Varchar	Egenskabens felttype. Definerer, hvordan egenskaben vises i HubSpot og på formularer (f.eks. afkrydsningsfelt, vælg).
`DISPLAYORDER`	Antal	Ejendommens visningsrækkefølge.
`GROUPNAME`	Varchar	Egenskabens gruppenavn.
`OPTIONS`	Variant	For opregningsegenskaber, et array af egenskabens muligheder, inklusive hver mulighedens attributter (f.eks. visningsrækkefølge, label).
`CREATEDUSERID`	Antal	ID for den bruger, der har oprettet ejendommen.
`REFERENCEDOBJECTTYPE`	Varchar	Typen af objekt, som egenskaben refererer til. Ejer-egenskaber returnerer en værdi på OWNER.
`CALCULATED`	Boolsk	Om egenskaben er en beregnet egenskab.
`EXTERNALOPTIONS`	Boolsk	Om egenskabens indstillinger er defineret i et eksternt system.
`HASUNIQUEVALUE`	Boolsk	Om egenskabens værdier er unikke. Kan kun indstilles, når du opretter en egenskab via API'en.
`HIDDEN`	Boolsk	Om egenskaben er skjult i HubSpot.
`SHOWCURRENCYSYMBOL`	Boolsk	Om en talegenskabsværdi skal formateres som en valuta.
`FORMFIELD`	Boolsk	Om denne egenskab kan bruges i formularer.
`READONLYDEFINITION`	Boolsk	Om egenskaben kan redigeres i HubSpot.
`READONLYVALUE`	Boolsk	Om egenskabens værdi kan redigeres i HubSpot.
`HUBSPOTDEFINED`	Boolsk	Om ejendommen blev oprettet af HubSpot eller af en bruger.
`ARCHIVED`	Boolsk	Om ejendommen er blevet slettet.
`CREATEDAT`	Tidsstempel	Den dato og det tidspunkt, hvor ejendommen blev oprettet i HubSpot.
`UPDATEDAT`	Tidsstempel	Den dato og det tidspunkt, hvor dataene sidst blev opdateret i HubSpot. Læs mere om kolonnedatatyper.
`INGESTEDAT`	Tidsstempel	Den dato og det klokkeslæt, hvor dataene sidst blev indlæst af Snowflake.

Eksempel 1

Hent navne og beskrivelser for alle kontaktegenskaber.

Forespørgsel:

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

Returnerer:

NAVN	LABEL	BESKRIVELSE
entered_sql_stage	Er gået ind i SQL-stadiet	Start optælling af SQL-etapedage.
første_konvertering_begivenhed_navn	Første konvertering	Den første formular, denne kontakt sendte.
adresse	Gadeadresse	Kontaktpersonens adresse.

Forespørgsler om begivenheder

Hændelser omfatter standard HubSpot-hændelser og brugerdefinerede adfærdshændelser. Hver begivenhed har sit eget databaseobjekt, mærket som events_eventname.

Navn
EVENTS_AD_INTERACTION	Detaljer om en annonce og 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	Detaljer om en annonce og dens præstationsmålinger.
EVENTS_CALL_MENTIONED_KEYWORD	Detaljer om nøgleord nævnt af deltagere i opkald.
EVENTS_CLICKED_LINK_IN_EMAIL_V2	Links, som kontakter har klikket på i marketingmails.
EVENTS_CLICKED_LINK_IN_TRACKED_INBOX_EMAIL_V8	Links, som kontakter har klikket på i e-mails i Conversations Inbox.
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 deles med kontakter via et eksternt link.
EVENTS_DOCUMENT_VIEWED_V2	Salgsdokumenter og kontakter, som de har set ved at åbne det eksterne link.
EVENTS_DOCUMENT_COMPLETED_V2	Salgsdokumenter og kontakter, der har lukket dem.
EVENTS_HS_SCHEDULED_EMAIL_V2	E-mails, der sendes til HubSpots e-mailservere for at blive sendt.
EVENTS_MTA_DELIVERED_EMAIL_V2	E-mails leveret til modtagerne af HubSpots e-mailservere.
EVENTS_MTA_BOUNCED_EMAIL_V2	Forsøg på levering af e-mail, der blev afvist af modtagerens e-mailserver.
EVENTS_OPENED_EMAIL_V2	E-mail åbnes af kontakter.
EVENTS_REPORTED_SPAM_EMAIL_V2	E-mails markeret som spam af modtagere.
EVENTS_UPDATED_EMAIL_SUBSCRIPTION_STATUS_V2	Modtagernes ændringer af e-mail-abonnementer.
EVENTS_OPENED_TRACKED_INBOX_EMAIL_V8	Konserveringsindbakke e-mail åbnes af kontakter.
EVENTS_MB_MEDIA_PLAYED	Videoafspilningsaktivitet efter kontakter.
EVENTS_V2_CONTACT_BOOKED_MEETING_THROUGH_SEQUENCE (KONTAKT_BOOKET_MØDE_GENNEM_SEKVENS)	Kontakt bookede et møde gennem sekvens.
EVENTS_V2_CONTACT_ENROLLED_IN_SEQUENCE (KONTAKT TILMELDT I RÆKKEFØLGE)	Kontakt indskrevet fra sekvens.
BEGIVENHEDER_V2_KONTAKT_AFSLUTTET_SEKVENS	Sekvensen er færdig.
EVENTS_V2_CONTACT_REPLIED_SEQUENCE_EMAIL	Kontakten svarede på e-mail (eller indgående e-mail, som afmeldte sekvensen) sendt gennem sekvensen.
EVENTS_V2_CONTACT_UNENROLLED_FROM_SEQUENCE (BEGIVENHEDER_V2_KONTAKT_AFMELDT_FRA_SEKVENS)	Kontakt afmeldt fra sekvens.
EVENTS_V2_CONTACT_UNENROLLED_MANUALLY_FROM_SEQUENCE	Brugeren har manuelt afmeldt kontakten.
EVENTS_V2_CONTACT_UNSUBSCRIBED_SEQUENCE_EMAIL	Kontakten afmeldte sig og afmeldte sekvensen.
EVENTS_V2_SEQUENCE_EMAIL_BOUNCED	Sekvens-e-mail blev afvist.
EVENTS_V2_SEQUENCE_ERRORED	Sekvensfejl, der forårsager afmelding.
EVENTS_V2_SEQUENCE_STEP_EXECUTED (BEGIVENHEDER_V2_SEKVENS_TRIN_UDFØRT)	Sekvenstrin udført.
EVENTS_VISITED_PAGE	Besøg på hjemmesiden fordelt på kontakter.

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

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

occurredat
occurredatdateint

Disse kolonner erstatter kolonnerne occuredat og occuredatdateint den 24. november 2022. På den 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 for Snowflake-datadele.

Kolonnens navn	Type	Beskrivelse
`EVENTTYPEID`	Varchar	Hændelsestypens ID, svarende til OBJECTTYPEID Du kan forespørge på alle eventtype-ID'er i 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 eventtype.
`OBJECTTYPEID`	Varchar	Den type objekt, der afsluttede hændelsen. For eksempel vil et klik på et e-mail-link vise `0-1` i denne kolonne, som repræsenterer kontaktobjektet.
`OBJECTID`	Antal	ID for den post, der afsluttede begivenheden.
`OCCURREDAT`	Tidsstempel	Hvornår hændelsen fandt sted.
`OCCURREDATDATEINT`	Antal	Et tal, der repræsenterer, hvornår hændelsen fandt sted. Indeholder de samme data som kolonnen `OCCURREDAT`, men formateret som et tal og brugt som en del af tabellens klyngenøgle. I de fleste tilfælde kan du bruge `OCCURREDAT` tidsstempel i stedet for dette tal.
`OCCUREDATDATEINT`	Antal	Et tal, der repræsenterer, hvornår hændelsen fandt sted. Indeholder de samme data som kolonnen `OCCURREDAT`, men formateret som et tal og brugt som en del af tabellens klyngenøgle. I de fleste tilfælde kan du bruge `OCCURREDAT` tidsstempel i stedet for dette tal. Bemærk: Denne kolonne vil blive forældet den 24. november 2022 og erstattet med `OCCURREDATDATEINT`.
`OCCUREDAT`	Tidsstempel	Hvornår hændelsen fandt sted. Bemærk: Denne kolonne vil blive forældet den 24. november 2022 og erstattet med `OCCURREDAT`.
`INGESTEDAT`	Tidsstempel	Den dato og det klokkeslæt, hvor dataene sidst blev indlæst af Snowflake. Læs mere om kolonnedatatyper.
`PROPERTY_*`	Varchar	Individuelle kolonner, der indeholder hændelsens egenskaber.

Eksempel 1

Hent de 50 seneste e-mail-klikhændelser.

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

Eksempel 2

Hent alle e-mail-klikhændelser efter de kontakter, der klikkede. Denne query henter kontaktdata ved at joine 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;

Returnerer:

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

Objekt_og_hændelsestype_forespørgsler

object_and_event_type_definitioner

Dette databaseobjekt indeholder definitioner for alle objekter og begivenheder, der er tilgængelige i din HubSpot-konto.

Dette databaseobjekt kan returnere følgende kolonner:

Kolonnens navn	Type	Beskrivelse
`OBJECTTYPEID`	Varchar	ID for det objekt, som pipelinen kan indeholde (f.eks. tilbud eller billetter).
`FULLYQUALIFIEDNAME`	Varchar	Navnet på objektet eller begivenheden.
`INGESTEDAT`	Tidsstempel	Den dato og det klokkeslæt, hvor dataene sidst blev indlæst af Snowflake. Læs mere om kolonnedatatyper.

Eksempel 1

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

Forespørgsel:

SELECT objectTypeId, fullyQualifiedName
FROM object_and_event_type_definitions;

Returnerer:

OBJECTTYPEID	FULDT KVALIFICERET NAVN
0-1	KONTAKT
0-8	LINE_ITEM
0-11	SAMTALE
...	...

Lister over forespørgsler

Nedenfor kan du se, hvordan du forespørger på dine lister, f.eks. de tilgængelige kontakt- og virksomhedslister og de poster, der er inkluderet i disse lister.

lister

Dette databaseobjekt indeholder oplysninger om HubSpots kontakt- og virksomhedslister. Returnerer én række pr. liste, og kolonnerne indeholder listeoplysninger som listenavn, størrelse og objekttypen for de poster, den indeholder. Indeholder ikke oplysninger om de enkelte poster på hver liste (se list_membership).

Dette databaseobjekt kan returnere følgende kolonner:

Kolonnens navn	Type	Beskrivelse
`OBJECTTYPEID`	Varchar	Typen af poster i listen (f.eks. kontakt eller virksomhed).
`LISTID`	Antal	ID'et for listen. Kobles til kolonnen LISTID i tabellen list-memberships.
`CLASSICLISTID`	Antal	Et ID, der er specifikt for kontaktlister, og som matcher ID'et i listens URL i HubSpot.
`NAME`	Varchar	Navnet på listen.
`SIZE`	Antal	Antallet af poster i listen.
`CREATEDBYUSERID`	Antal	ID for den bruger, der har oprettet listen.
`CREATEDAT`	Tidsstempel	Hvornår listen blev oprettet i HubSpot.
`UPDATEDBYUSERID`	Antal	ID for den bruger, der senest har opdateret listen.
`UPDATEDAT`	Tidsstempel	Den dato og det klokkeslæt, hvor datoen sidst blev opdateret i HubSpot. Læs mere om kolonnedatatyper.
`INGESTEDAT`	Tidsstempel	Den dato og det klokkeslæt, hvor dataene sidst blev indlæst af Snowflake.

Eksempel 1

Hent alle kontaktlister.

Forespørgsel:

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

Returnerer:

LISTID	NAVN	STØRRELSE
118131	Ugentlig opsøgende arbejde	103
66156	Blog-abonnenter	455
771852	De bedste abonnenter 2021	37
...	...	...

Eksempel 2

Hent en specifik kontaktliste med navnet Top subscribers 2021.

Forespørgsel:

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

Returnerer:

LISTID	NAVN	STØRRELSE
771852	De bedste abonnenter 2021	37

list_membership

Dette databaseobjekt indeholder oplysninger om, hvilke poster der er medlemmer af hvilke lister, med en række pr. post på listen. Hvis du f.eks. har en Blog subscribers-liste med 500 kontakter, vil databaseobjektet returnere 500 rækker.

Indeholder kun liste-ID'er og objekt-ID'er. For mere information, join med databaseobjektet lists.

Dette databaseobjekt kan returnere følgende kolonner:

Kolonnens navn	Type	Beskrivelse
`LISTID`	Varchar	ID for listen. Kobles til kolonnen HS_LIST_ID i listetabellen.
`OBJECTID`	Varchar	ID for posten i listen.
`UPDATEDAT`	Tidsstempel	Den dato og det tidspunkt, hvor dataene sidst blev opdateret i HubSpot. Læs mere om kolonnedatatyper.
`INGESTEDAT`	Tidsstempel	Den dato og det klokkeslæt, hvor dataene sidst blev indlæst af Snowflake.

Eksempel 1

Hent ID'erne på alle kontakter på listen Top subscribers 2021.

Forespørgsel:

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

Returnerer:

OBJECTID

54325098

96805401

6922028

...

Eksempel 2

Hent for- og efternavn på kontaktpersoner på listen Top subscribers 2021.

Forespørgsel:

SELECT

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

Returnerer:

OBJECTID	FORNAVN	EFTERNAVN
54325098	Hobbes	Baron
96805401	Milo	Guld
6922028	Henry	Riley
...	...	...

Ofte stillede spørgsmål

Jeg vil gerne generere data svarende til en rapport fra Hubspot-appen, hvordan gør jeg det?

Generelt vil man gerne se på de kolonner, der findes i den rapport, man sammenligner med. Hvis rapportvisualiseringen ikke er i tabelform, vil en konvertering til en tabel vise de kolonner, rapporten indeholder. Disse kolonner er som regel egenskaber for en objekttype eller en hændelsestype. Næste skridt er at finde ud af, hvilken objekttypeegenskab en kolonne svarer til. Det kan du gøre ved at forespørge property_definitions:

SELECT * FROM property_definitions

WHERE label = [column_name]

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

Når du har fundet ud af, hvilken objekttype kolonnen tilhører, er det nemt at finde ud af, hvad du skal søge efter. Du kan simpelthen søge efter den object_x-visning, der svarer til typen.

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

Hvis du har brug for at linke to eller flere forskellige poster til hinanden, så tag et kig på associationer. Associationer repræsenterer relationerne mellem objekter i HubSpot CRM. Alle de forskellige associationer, der er mulige mellem to typer, er listet i association_definitions. I eksemplet ovenfor skal du forespørge ASSOCIATIONS_CAMPAIGNS_TO_FORMS for at kende alle de formularer, som en kampagne er knyttet til:

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

Hvordan kender jeg status for HubSpot-Snowflake-integrationen?

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

SELECT * FROM hubspot.public.data_share_status LIMIT 1

Resultaterne vil blive vist som:

STATUS	BESKED	OPDATERETAT
OK	INGEN KENDTE HÆNDELSER I ØJEBLIKKET	2023-04-10 09:21:20.123

Denne visning giver opdateringer om integrationsstatus i omvendt kronologisk rækkefølge. Hvis du integrerer resultaterne af denne forespørgsel i et dashboard, kan du spore integrationens ydeevne og opdage nedetid eller udfald.

Var denne artikel nyttig? Ja Nej

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

Forespørgsel på HubSpot-data i Snowflake

Gælder for:

Dataforsinkelse og din Snowflake-kontoregion

Opsæt dit Snowflake-miljø

Oversigt over data

Begrænsning og bestilling af returnerede data

Kolonne-datatyper

Transformering af datatyper

Objektforespørgsler

objects_x visninger

Eksempel 1

Eksempel 2

Eksempel 3

objekt_med_objekt_egenskaber

Eksempel 1

Eksempel 2

objekter

Eksempel 1

object_properties

Eksempel 1

Eksempel 2

object_properties_history

Eksempel 1

Eksempel 2

Forespørgsler om foreninger

associationer_x_til_y visninger

Eksempel 1

Eksempel 2

Eksempel 3

association_definitions

Eksempel 1

Eksempel 2

foreninger

Eksempel 1

Eksempel 2

Eksempel 3

Forespørgsler fra ejeren

ejere

Eksempel 1

Eksempel 2

Eksempel 3

Team-forespørgsler

hold

Eksempel 1

owner_team

Eksempel 1

Pipeline-forespørgsler

rørledninger

Eksempel 1

Eksempel 2

Eksempel 3

pipeline_stadier

Eksempel 1

Eksempel 2

Forespørgsler om ejendom

property_definitions

Eksempel 1

Forespørgsler om begivenheder

Eksempel 1

Eksempel 2

Objekt_og_hændelsestype_forespørgsler

object_and_event_type_definitioner

Eksempel 1

Lister over forespørgsler

lister

Eksempel 1

Eksempel 2

list_membership

Eksempel 1

Eksempel 2

Ofte stillede spørgsmål

Jeg vil gerne generere data svarende til en rapport fra Hubspot-appen, hvordan gør jeg det?

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

Hvordan kender jeg status for HubSpot-Snowflake-integrationen?

Relateret indhold