Forespørg på HubSpot-data i Snowflake

Skrevet af HubSpot Support | Jun 28, 2023 1:53:46 PM

Når du har forbundet Snowflake med din HubSpot-konto, kan du bruge Snowflakes Data Share til at forespørge på 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.

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

Sæt dit Snowflake-miljø op

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 fra. Du kan enten indstille dem på regnearkniveau, så de automatisk inkluderes i dine forespørgsler, eller du kan tilføje dem manuelt.

For at vælge dit lager, din database og dit skema på regnearkniveau:

I den øverste række i regnearket skal du klikke på linjen Arbejdsarkhandlinger.
I pop op-vinduet:
- Klik på rullemenuen Warehouse, og vælg derefter dit lager.
- Klik på rullemenuen Database, og vælg derefter din HubSpot-database.
- Klik på rullemenuen Schema, og vælg derefter 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.

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

SELECT objectTypeId, property_createddate
FROM hubspot_share_name.V2_LIVE.objects_deals

LIMIT 1

Oversigt over data

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

Objekter: standard- og brugerdefinerede objekter, f.eks. kontakter, virksomheder og produkter.
Records: individuelle records, som f.eks. en individuel kontakt eller virksomhed.
Associations: alle tilgængelige associationstyper og aktuelt tilknyttede poster.
Begivenheder: Begivenhedsdata for både standard HubSpot-begivenheder, som f.eks. e-mailåbninger, og brugerdefinerede adfærdsbegivenheder.
Lister: HubSpot-kontakt- og virksomhedslister.
Ejere: brugere på din HubSpot-konto i forhold til de poster, de er angivet som ejer af.
Pipelines: aftale- og billetpipelines, herunder pipelinefaser.
Egenskaber: Egenskaber og deres værdier i CRM-poster, herunder ejendomshistorik.

Få mere at vide omHubSpots CRM-datamodel.

Bemærk: Itakt med at vi udvikler datadelingen, vil vi indføre ændringer, hvoraf nogle er afgørende.Det anbefales på det kraftigste at abonnere på HubSpots ændringslog for udviklere. Disse ændringer vil altid blive slået op i ændringsloggen forud for enhver opdatering.

Begrænsning og sortering 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;

Datatyper for kolonner

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: Iresten af dette dokument bruger vi udtrykket databaseobjekt, når sammenhængen gælder både tabeller og visninger.

For at returnere en bestemt kolonne skal du inkludere den pågældende kolonne 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 der generelle definitioner af kolonner, som en forespørgsel kan returnere. For andre definitioner, der ikke er medtaget 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 virksomhedsobjektet, 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-nummer, der repræsenterer en enkelt post af en given type objekt på 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 tidsstempel for indlæsning blive opdateret, selvom ingen andre kolonner i rækken er blevet ændret.
- Når du opbygger ETL-processer, der kopierer nyligt ændrede data, anbefales det at basere dine forespørgsler på indlæsningstemplet. 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 oprettelsesdatoen for en post, være det samme som tidsstemplet i CREATEDAT-kolonnen i Snowflake. Disse er ikke direkte relateret til tidsstemplet for indlæsning, og det anbefales ikke at basere ETL-processer på disse egenskaber.
COMBINEDASSOCIATIONTYPE: en VARCHAR-værdi, der entydigt identificerer en associationsdefinition.

Omdannelse 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 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 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 henholdsvis 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

Forespørgsler på objekter

Nedenfor kan du se, hvordan du forespørger på data fra specifikke HubSpot-objekter og -poster, samt hvilke data der bliver returneret.

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 samme objekttype, f.eks. indeholder objects_contacts kun kontaktposter. Dette eliminerer behovet for at angive et objekttype-id under forespørgsler. Disse visninger er nemmere at forespørge i, da man 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-visningerne 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 objekttypeid'er, når du forespørger:

Objektets navn	ObjectTypeId
Kontaktpersoner	0-1
Virksomheder	0-2
Linjeposter	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 man ønsker en bedre forespørgselsydelse end den, der kan opnås med objects_x views. Se flere detaljer i object_with_object_properties, object_properties, objects og object_properties_history nedenfor.

objekter_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_<objekttypenavn>, hvor <objekttypenavn> er flertalsformen for objekttypen (bemærk, at hvis objekttypen ikke har nogen flertalsform, vil <objekttypenavn> blot være entalsformen for objekttypenavnet sammenkædet med "S").

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

Se nedenfor den omfattende liste over tilgængelige HubSpot-objekttyper (dvs. ikke-brugerdefinerede), 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	Information om individuelle virksomheder eller organisationer
DEAL	0-3	Detaljer om indtjeningsmuligheder 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.
QUOTE	0-14	Bruges til at dele prisoplysninger med potentielle købere.
FORM_INDSENDELSE	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 knyttes til en aftale, bliver det til 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 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	Oplysninger 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 websites
BLOG_POST	0-39	Data om blogindlæg
OBJEKTSLISTE	0-45	Oplysninger 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	Oplysninger om medieaktiver, der er importeret til Hubspot
SEQUENCE	0-58	En sekvens er en række målrettede, tidsbestemte e-mailskabeloner til at pleje kontakter over tid.
DEAL_SPLIT	0-72	Deal splits bruges til at dele deal credit mellem flere brugere
SALES_DOKUMENT	0-83	Salgsdokumenter opbygger et bibliotek med indhold, så hele dit team kan uploade og dele dokumenter med dine kontakter.
FEEDBACK_INDSENDELSE	0-19	Gemmer oplysninger, der er indsendt til 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 vil returnere følgende kolonner:

Kolonnens navn	Type	Beskrivelse
OBJECTTYPEID	Varchar	Objekttypens ID (f.eks. kontakter er 0-1).
OBJECTID	Antal	Postens ID (f.eks. en kontaktpost med et ID på 123752).
OPDATERET	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 taltype (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-objektets egenskab deal_amount have kolonnen property_unparsed_deal_amount. En kolonne, der indeholder værdien konverteret til den oprindelige type. Kolonnen får navnet property_[name], f.eks. vil DEAL-objektegenskaben 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	LIVSFASE
54325098	Hobbes	Baron	føre
96805401	Milo	Guld	føre
6922028	Henry	Riley	føre

Eksempel 2

Hent aftalens navn og fase for op til tre aftaler.

Forespørgsel:

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

Returnerer:

OBJECTID	EJENDOMS_HANDELSNAVN	PROPERTY_DEALSTAGE	PROPERTY_DEALAMOUNT
38960439	Navn på aftale 1	Lukket vinder	34199
321740651	Testaftale 123	14845019	8383663
98392101	Pop-up baldakin	Lukket vinder	9309007

Eksempel 3

Hent aftalens navn og fase for de tre bedste aftaler efter beløb.

Forespørgsel:

Da data om deal-beløb er tilgængelige som en tal-datatype, kan de bruges til at bestille uden behov for konvertering eller casting.

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

Returnerer:

OBJECTID	EJENDOMS_HANDELSNAVN	PROPERTY_DEALSTAGE	PROPERTY_DEALAMOUNT
98392101	Pop-up baldakin	Lukket vinder	9309007
321740651	Testaftale 123	14845019	8383663
38960439	Navn på aftale 1	Lukket vinder	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 kontaktobjekttypen). 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. Få mere at vide om kolonnedatatyper.
`INGESTEDAT`	Tidsstempel	Den dato og det klokkeslæt, hvor dataene sidst blev indlæst af Snowflake.

Bemærk: Den25. januar 2022 vil kolonnen timestamp i tabellen og visningen object_with_object_properties, som repræsenterer den dato og det klokkeslæt, hvor objektposten sidst blev opdateret i HubSpot , være updatedat. Dette er for at tilpasse sig, hvordan datetime-data repræsenteres iresten 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. Det giver dig mulighed for at skifte til 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 i tabellen eller visningen object_with_object_properties 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 fase 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	closedlost	7488939
321740651	Navn på aftale 1	Lukket vinder	9292029
98392101	Navn på aftale 1	closedlost	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, som gør, at object_with_object_properties og objects_x views fungerer langsomt. Ved at bruge dette databaseobjekt sammen med databaseobjektet object_properties er 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. Få mere at vide 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
...	...

objekt_egenskaber

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. En kontakt vil f.eks. have en række for egenskaben First name og en række for egenskaben Last name. 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. Få mere at vide 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	LIVSFASE
0-1	54325098	Hobbes	Baron	føre
0-1	96805401	Milo	Guld	føre
0-1	6922028	Henry	Riley	føre
...	...	...	...	...

objekt_egenskaber_historie

Dette databaseobjekt indeholder historiske ejendomsvæ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 klokkeslæt, hvor dataene sidst blev opdateret i HubSpot. Få mere at vide 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	OPDATERET
136493192	hs_prediktivescoringtier	niveau_1	2022-06-22 22:45:05.931
136493192	hs_prediktivescoringtier	niveau_2	2021-09-18 08:20:56.622
136493192	hs_prediktivescoringtier	niveau_3	2019-11-31 18:20:22.851
...	...	...	...

Eksempel 2

Hent det aktuelle navn på alle kontakter, der nogensinde har haft livscyklusstadiet Subscriber.

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
...	...	...

Foreningens forespørgsler

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 associationsposter mellem kontakt- og aftaleobjekter. Dette eliminerer behovet for at angive et associationstype-id under forespørgsler. 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 associationsposten mellem to objekter, som nemt kan bruges i joins med objects_x-visninger. Så længe du ikke oplever langsomme forespørgsler, er det tilrådeligt at bruge disse visninger til at hente associationsdata. Se mere i associations_x_to_y-visningerne 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_<association type name>, 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 vil returnere følgende kolonner:

Kolonnens navn	Type	Beskrivelse
COMBINEDASSOCIATIONTYPEID	Varchar	Den unikke identifikator for associationsdefinitionen.
FORENINGSKATEGORI	Varchar	Kilden til foreningstypen. En af: HUBSPOT_DEFINED, USER_DEFINED, INTEGRATOR_DEFINED
ASSOCIATIONSTYPEID	Varchar	En unik identifikator for en associationsdefinition inden for en specifik associationskategori, dvs. at ikke to definitioner i en associationskategori vil have samme associationstypeid.
FROMOBJECTTYPEID	Varchar	Det objekttypeid, der er kilden til associationsdefinitionen.
FROMOBJECTTYPE	Varchar	Navnet på den objekttype, der er kilden til associationsdefinitionen.
TOOBJECTTYPEID	Varchar	Det objekttypeid, der er destinationen for associationsdefinitionen.
TOOBJECTTYPE	Varchar	Navnet på den objekttype, der er destinationen for associationsdefinitionen.
NAVN	Varchar	Foreningsdefinitionens navn.
ETIKET	Varchar	Foreningsdefinitionens beskrivelse.
ISMAINASSOCIATIONDEFINITION	Boolsk	Om tilknytningsdefinitionen er hovedtypen. Når det er sandt, 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	Objekt-ID for kildeobjektet.
[TOOBJECTTYPE_OBJECTID] f.eks. for ASSOCIATIONS_CONTACTS_TO_DEALS view 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
contact_objectId, deal_objectId

FROM foreninger_kontakter_til_handler

WHERE contactId = 6626541373

Returnerer:

KONTAKT_OBJEKTID	DEAL_OBJECTID
6626541373	233620335
6626541373	90253678

Eksempel 2

Hent alle kontakter, der er baseret i tidszonen Bogota, og deres aftaler.

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 indgåede 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_definitioner

Dette databaseobjekt indeholder oplysninger om alle de tilgængelige tilknytningstyper mellem HubSpot-objekter, med en række pr. tilknytningstype. Du kan forbinde dette databaseobjekt med associations-databaseobjektet for at få postspecifikke associationsoplysninger.

Der kan være flere typer associationer mellem de samme objekter. Hovedassociationstypen, som er den type, der vises i HubSpot, når poster er associeret, 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 foreningstypen. En af: `HUBSPOT_DEFINED`, `USER_DEFINED`, `INTEGRATOR_DEFINED`
`ID`	Antal	Identifikatoren for foreningsdefinitionen 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	Foreningsdefinitionens navn.
`LABEL`	Varchar	Associationsdefinitionens etiket.
`ISMAINASSOCIATIONDEFINITION`	Boolsk	Om tilknytningsdefinitionen er hovedtypen. Når det er sandt, 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. Få mere at vide 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:

KOMBINERET FORENINGSTYPE	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_HANDEL
0-5	0-3	0-2	DEAL_TO_COMPANY
...	...	...	...

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

Returnerer:

KOMBINERET FORENINGSTYPE	FROMOBJECTTYPEID	TOOBJECTTYPEID	NAVN
0-5	0-3	0-2	DEAL_TO_COMPANY
0-271	0-3	0-2	DEAL_TO_PRIMARY_COMPANY
0-341	0-3	0-2	DEAL_TO_COMAPNY_UNLABELED

foreninger

Dette databaseobjekt indeholder oplysninger om forbindelserne mellem specifikke poster. Hver række repræsenterer en tilknytning fra et objekt til et andet objekt. Rækker kan være til stede i dette databaseobjekt, selv om de poster, der henvises til, 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, som gør, at associations_x_to_y-visningerne 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. 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;

Returnerer:

KOMBINERET FORENINGSTYPE	FROMOBJECTID	TOOBJECTID
0-5	6626541373	233620335

Eksempel 3

Hent alle aftaler, der er knyttet til en bestemt kontakt (kontakt-ID: 4464). I stedet for hårdkodning af combinedAssociationTypeId forbinder 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:

COMBINEDASSOCIATIONTYPEID	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 ejere af poster 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 klokkeslæt, 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

Hent en bestemt ejer via dennes 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 forbinder poster med 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:

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

Forespørgsler fra teamet

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 i din HubSpot-konto.

Dette databaseobjekt kan returnere følgende kolonner:

Kolonnens navn	Type	Beskrivelse
TEAMID	Antal	Holdets ID.
TEAMNAME	Varchar	Holdets navn.
PARENTTEAMID	Antal	Forældreteamets team-ID.
BØRNTEAMIDS	Array	Team-id'erne for de underordnede teams.
PRIMÆRE EJERMEDLEMMER	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 hold

Returnerer:

TEAMID	TEAMNAME	PRIMÆRE EJERMEDLEMMER
29584574	Underteam	[233620335, 1234553]
30532717	Super Team	[3866015468, 126221873]
3058032	Et hold	[7132752747]

ejer_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

Returnerer

TEAMID	TEAMNAME	ISTEAMPRIMARY
29584574	233620335	SAND
29584574	1234553	SAND

Rørledningsforespørgsler

Nedenfor kan du se, hvordan du forespørger påpipelinedata for aftaler og billetter, f.eks. de tilgængelige pipelines på din konto og deres stadier.

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

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'et 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	Da pipelinen blev oprettet.
`UPDATEDAT`	Tidsstempel	Den dato og det klokkeslæt, hvor dataene sidst blev opdateret i HubSpot. Få mere at vide 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	ETIKET
0-3	1bed503c-37f7-4f51-9d40-7598902673f4	Salgspipeline
0-3	12659678	Licenser Pipeline
0-3	75e28846-ad0d-4be2-a027-5e1da6590b98	Nye forretninger
...	...	...

Eksempel 2

Hent aftaler inden for en bestemt pipeline. Sammenføjer 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 Rebranding	Salgspipeline
604362473	Fresh Step App Build	Salgspipeline

Eksempel 3

Samme som eksempel 2 ovenfor, hent aftaler 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 Rebranding	Salgspipeline
604362473	Fresh Step App Build	Salgspipeline

pipeline_stages

Denne visning indeholder oplysninger om de enkelte faser i en pipeline. Identificer etaper ved at kombinere objekttype-id, pipeline-id og etape-id. Brug objekttype-ID og pipeline-ID, 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 pipelinetrinnet er blevet slettet.
`CREATEDAT`	Tidsstempel	Da pipelinetrinnet blev oprettet.

Eksempel 1

Hent pipelinetrin for en aftalepipeline med navnet Salgspipeline.

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	ETIKET
941650	941651	Kontaktet
941650	941652	Aftale planlagt
941650	941653	Faktura sendt
...	...	...

Eksempel 2

Hent alle aftaler 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 Rebranding	Salgspipeline	Aftale planlagt
604362473	Fresh Step App Build	Salgspipeline	Kontrakt underskrevet
...	...	...	...

Forespørgsler om ejendom

egenskaber_definitioner

Dette databaseobjekt indeholder oplysninger om objektegenskaber og hændelsesegenskaber i din HubSpot-konto. Hændelsesegenskaber omfatter standardhændelser, som f.eks. e-mailåbninger og -klik, og brugerdefinerede adfærdsrelaterede 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 properties-API'en.

Dette databaseobjekt kan returnere følgende kolonner:

Kolonnens navn	Type	Beskrivelse
`OBJECTYPEID`	Varchar	ID'et for det objekt, som hændelsen vedrører.
`NAME`	Varchar	Egenskabens interne navn.
`LABEL`	Varchar	Ejendommens etiket.
`DESCRIPTION`	Varchar	Ejendommens beskrivelse.
`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 indstillinger, inklusive hver indstillings attributter (f.eks. visningsrækkefølge, etiket).
`CREATEDUSERID`	Antal	ID for den bruger, der har oprettet ejendommen.
`REFERENCEDOBJECTTYPE`	Varchar	Den type objekt, som egenskaben refererer til. Ejeregenskaber vil returnere værdien OWNER.
`CALCULATED`	Boolsk	Om egenskaben er en beregnet egenskab.
`EXTERNALOPTIONS`	Boolsk	Om egenskabens muligheder er defineret i et eksternt system.
`HASUNIQUEVALUE`	Boolsk	Om egenskabens værdier er unikke. Kan kun indstilles, når man opretter en egenskab via API'en.
`HIDDEN`	Boolsk	Om egenskaben er skjult i HubSpot.
`SHOWCURRENCYSYMBOL`	Boolsk	Om en talegenskabs værdi er formateret 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 om den blev oprettet af en bruger.
`ARCHIVED`	Boolsk	Om ejendommen er blevet slettet.
`CREATEDAT`	Tidsstempel	Den dato og det klokkeslæt, hvor ejendommen blev oprettet i HubSpot.
`UPDATEDAT`	Tidsstempel	Den dato og det klokkeslæt, hvor dataene sidst blev opdateret i HubSpot. Få mere at vide 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	ETIKET	BESKRIVELSE
entered_sql_stage	Gik ind i SQL-stadiet	Starttælling af SQL-etapedage.
første_konvertering_begivenhed_navn	Første konvertering	Den første formular, som denne kontaktperson indsendte.
adresse	Gadeadresse	Kontaktens adresse.

Forespørgsler om begivenheder

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

Navn
BEGIVENHEDER_AD_INTERAKTION	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.
BEGIVENHEDER_OPKALD_NÆVNT_NØGLEORD	Detaljer om nøgleord nævnt af alle 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 delt 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, der er blevet leveret til modtagerne af HubSpots e-mailservere.
EVENTS_MTA_BOUNCED_EMAIL_V2	Forsøg på levering af e-mail, som blev afvist af modtagerens e-mailserver.
EVENTS_OPENED_EMAIL_V2	Åbninger af e-mails efter kontakter.
BEGIVENHEDER_RAPPORTERET_SPAM_EMAIL_V2	E-mails markeret som spam af modtagere.
EVENTS_UPDATED_EMAIL_SUBSCRIPTION_STATUS_V2	Ændringer i modtagernes e-mail-abonnementer.
EVENTS_OPENED_TRACKED_INBOX_EMAIL_V8	Conservations Inbox e-mail åbnes af kontakter.
EVENTS_MB_MEDIA_PLAYED	Videoafspilningsaktivitet efter kontakter.
EVENTS_V2_CONTACT_BOOKED_MEETING_THROUGH_SEQUENCE	Kontakt bookede et møde gennem sequence.
EVENTS_V2_CONTACT_ENROLLED_IN_SEQUENCE	Kontakt indskrevet fra sekvens.
EVENTS_V2_CONTACT_FINISHED_SEQUENCE	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	Kontakt afmeldt fra sekvens.
EVENTS_V2_CONTACT_UNENROLLED_MANUALLY_FROM_SEQUENCE	Brugeren afmeldte kontakten manuelt.
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	Fejl i sekvensen forårsager afmelding.
EVENTS_V2_SEQUENCE_STEP_EXECUTED	Sekvenstrin udført.
BEGIVENHEDER_BESØGT_SIDE	Besøg på websider af kontakter.
EVENTS_<INTEGRATION_EVENT_NAME>_<UNIQUE_IDENTIFIER>	Integrationshændelser(Timeline V3 API)

Du kan identificere begivenheder ved at kombinere deres begivenhedstype-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: HubSpot har tilføjet to nye kolonner til alle event-tabeller 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, der bruger disse kolonner, vil mislykkes. Få mere at vide om ændringer for Snowflake-datadele.

Kolonnens navn	Type	Beskrivelse
`EVENTTYPEID`	Varchar	ID for hændelsestypen, 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 er ikke to poster, der har samme ID inden for en given eventtype.
`OBJECTTYPEID`	Varchar	Den type objekt, der gennemførte begivenheden. For eksempel vil et klik på et e-mail-link vise `0-1` i denne kolonne, som repræsenterer kontaktobjektet.
`OBJECTID`	Antal	ID'et for den post, der afsluttede begivenheden.
`OCCURREDAT`	Tidsstempel	Når begivenheden fandt sted.
`OCCURREDATDATEINT`	Antal	Et tal, der repræsenterer, hvornår begivenheden fandt sted. Indeholder de samme data som kolonnen `OCCURREDAT`, men er formateret som et tal og bruges som en del af klyngenøglen i tabellen. I de fleste tilfælde kan du bruge `OCCURREDAT` -tidsstemplet i stedet for dette tal.
`OCCUREDATDATEINT`	Antal	Et tal, der repræsenterer, hvornår begivenheden fandt sted. Indeholder de samme data som kolonnen `OCCURREDAT`, men er formateret som et tal og bruges som en del af klyngenøglen i tabellen. I de fleste tilfælde kan du bruge `OCCURREDAT` -tidsstemplet i stedet for dette tal. Bemærk: Denne kolonne udgår den 24. november 2022 og erstattes med `OCCURREDATDATEINT`.
`OCCUREDAT`	Tidsstempel	Når begivenheden fandt sted. Bemærk: Denne kolonne udgår den 24. november 2022 og erstattes med `OCCURREDAT`.
`INGESTEDAT`	Tidsstempel	Den dato og det klokkeslæt, hvor dataene sidst blev indlæst af Snowflake. Få mere at vide om kolonnedatatyper.
`PROPERTY_*`	Varchar	Individuelle kolonner, der indeholder begivenhedens 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 har klikket. Denne forespørgsel henter kontaktdata ved at sammenføje 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
...	...	...	...

Object_and_event_type_queries

objekt_og_hændelsestype_definitioner

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

Dette databaseobjekt kan returnere følgende kolonner:

Kolonnens navn	Type	Beskrivelse
`OBJECTTYPEID`	Varchar	ID'et 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. Få mere at vide 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 listens navn, 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 på listen (f.eks. kontakt eller virksomhed).
`LISTID`	Antal	Listens ID. Forbindes med 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 på listen.
`CREATEDBYUSERID`	Antal	ID for den bruger, der har oprettet listen.
`CREATEDAT`	Tidsstempel	Da 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. Få mere at vide 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 indsats	103
66156	Abonnenter på bloggen	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 liste over blogabonnenter med 500 kontakter, vil databaseobjektet returnere 500 rækker.

Indeholder kun liste-id'er og objekt-id'er. Du kan få flere oplysninger ved at joine med databaseobjektet lists.

Dette databaseobjekt kan returnere følgende kolonner:

Kolonnens navn	Type	Beskrivelse
`LISTID`	Varchar	Listens ID. Forbindes med kolonnen HS_LIST_ID i tabellen lists.
`OBJECTID`	Varchar	ID'et for posten på listen.
`UPDATEDAT`	Tidsstempel	Den dato og det klokkeslæt, hvor dataene sidst blev opdateret i HubSpot. Få mere at vide om kolonnedatatyper.
`INGESTEDAT`	Tidsstempel	Den dato og det klokkeslæt, hvor dataene sidst blev indlæst af Snowflake.

Eksempel 1

Hent ID'erne for 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å detaljer om kontakter 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 du gerne se på de kolonner, der findes i den rapport, du sammenligner med. Hvis rapportens visualisering ikke er i tabelform, vil konvertering til en tabel vise de kolonner, rapporten indeholder. Disse kolonner er normalt 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 på property_definitions:

SELECT * FROM property_definitions

WHERE label = [column_name]

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

Når man har fundet ud af, hvilken objekttype kolonnen tilhører, er det nemt at finde ud af, hvad man skal spørge om. 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, skal du kigge på associationer. Associationer repræsenterer relationerne mellem objekter i HubSpot CRM. Alle de forskellige associationer, der er mulige mellem to typer, er anført 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 på HubSpot-Snowflake-integrationen?

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

SELECT * FROM hubspot.public.data_share_status LIMIT 1

Resultaterne vil blive vist som:

STATUS	BESKED	OPDATERET
OK	INGEN KENDT HÆNDELSE I ØJEBLIKKET	2023-04-10 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 spore integrationens ydeevne og opdage eventuel nedetid eller udfald.

Se hele indlægget