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

Forespørg på HubSpot-data i Snowflake

Sidst opdateret: 31 december 2025

Gælder for:

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

Dataforsinkelse og din Snowflake-kontos region

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

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

Opsæt dit Snowflake-miljø

For at forespørge 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å regnearksniveau for at inkludere dem automatisk i dine forespørgsler, eller du kan tilføje dem manuelt.

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

  1. Klik på værktøjslinjenWorksheet actions i den øverste række af regnearket.

  2. I pop op-vinduet:
    • Klik på rullemenuenLager, og vælg derefter ditlager.
    • Klik på rullemenuenDatabase, og vælg din HubSpot-database.
    • Klik på rullemenuenSkema, og vælg det skema, du vil bruge:
        • V2_DAILY: det daglige skema til at forespørge data baseret på tabeller. Data i dette skema opdateres en gang om dagen. Brug af dette skema resulterer i hurtigere forespørgsler og anbefales til forespørgsler direkte i Snowflake.
        • V2_LIVE: det live skema baseret på Secure Views af HubSpot-data. Data i dette skema opdateres op til hvert 15. minut. Hvis du forespørger på et stort datasæt, kan forespørgslerne være langsomme. I dette tilfælde anbefales det at kopiere dataene til din egen tabel først med en ETL-proces og derefter forespørge på den tabel.


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

For manuelt at tilføje din database og skema 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

Dataoversigt

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

  • Objekter: standard- og brugerdefinerede objekter, såsom kontakter, virksomheder, produkter. 
  • Poster: individuelle poster, såsom en individuel kontakt eller virksomhed. 
  • Tilknytninger: alle tilgængelige tilknytningstyper og aktuelt tilknyttede poster.
  • Begivenheder: begivenhedsdata for både standard HubSpot-begivenheder, såsom åbning af e-mails, og brugerdefinerede adfærdsbegivenheder.
  • Segmenter: HubSpot-kontakt- og virksomhedssegmenter.
  • Ejere: brugere i din HubSpot-konto i relation til de poster, de er angivet som ejere af.
  • Pipelines: deal-og ticket-pipelines, inklusive pipeline-faser.
  • Egenskaber: Egenskaber og deres værdier på CRM-poster, herunder egenskabshistorik.

Få mere at vide om HubSpots CRM-datamodel. 

Bemærk I takt med at vi udvikler datadeling, vil vi indføre ændringer, hvoraf nogle vil være gennemgribende. Det anbefales stærkt at abonnere på HubSpots udviklerændringslog. Disse ændringer vil altid blive offentliggjort i ændringsloggen inden enhver opdatering.

Begrænsning og sortering af returnerede data

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


VÆLG objectTypeId, updatedAt, ingestedAt
FROM objects_deals
ORDER BY objectId
LIMIT 10;

Kolonnedatatyper

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

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


For at returnere en bestemt kolonne skal du medtage den kolonne i SELECT-feltet i din forespørgsel. Følgende forespørgsel returnerer f.eks. kun kolonnerne OBJECTID og UpdatedAt:


SELECTobjectId, updatedAt
FROM objects_contacts

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

  • OBJECTTYPEID: en VARCHAR-værdi, der 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 segmenter henviser dette til segmenttypen (f.eks. kontakt eller virksomhed). Du kan søge 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 objekttype i din HubSpot-konto. For at identificere en post skal du bruge både objekttype-id'et og objekt-id'et.
  • INGESTEDAT: tidsstemplet for, hvornår en datarække blev tilføjet til Snowflake, repræsenteret 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 indlæsningstidsstempel blive opdateret, selvom ingen andre kolonner i rækken er ændret.
    • Når du opretter ETL-processer, der kopierer nyligt ændrede data, anbefales det at basere dine forespørgsler på indlæsningstidsstemplet. Derudover anbefales det, at du kopierer data fra de to foregående dage, hvis din flow kopierer data dagligt, for at tage højde for forsinkelser.
  • CREATEDAT og UPDATEDAT: den 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 den tid, der vises i HubSpot for en postens oprettelsesdato, være den samme som tidsstemplet i kolonnen CREATEDAT i Snowflake. Disse er ikke direkte relateret til indlæsningstidsstemplet, og det anbefales ikke at basere ETL-processer på disse egenskaber.
  • COMBINEDASSOCIATIONTYPE: en VARCHAR-værdi, der entydigt identificerer en associeringsdefinition.

Transformation af datatyper

Nogle gange returneres data fra en forespørgsel med VARCHAR-kolonner, selvom 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 undertiden tal- og datotidsværdier. Funktioner som:
try_to_number, try_to_timestamp_ntz kan bruges til at konvertere disse VARCHAR-data til henholdsvis NUMBER - og DATETIME -typer:


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

Objektforespørgsler

Nedenfor kan du lære, hvordan du forespørger data fra specifikke HubSpot-objekter og -poster, sammen med de 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 samme objekttype, f.eks. indeholder objects_contacts kun kontaktposter. Dette eliminerer behovet for at angive en objecttypeid under forespørgsler. Disse visninger er nemmere at forespørge, 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, anbefales det at bruge disse visninger til at hente objektdata. Se mere i Objects_X-visninger nedenfor. 
  • Kombineret: Alle poster for alle objekttyper kombineres i ét databaseobjekt. Når du foretager en forespørgsel, skal du derfor angive et filter som f.eks. "WHERE objectTypeId='0-1'". Du kan f.eks. bruge følgende objecttypeids, når du foretager en forespørgsel:
Objektnavn Objekttypeid
Kontakter 0-1
Virksomheder 0-2
Linjeposter 0-8

Brugerdefinerede objekter tildeles et ID på oprettelsestidspunktet og identificeres som2-unique_ID. For eksempel2-12345. Få mere at vide om object_and_event_type_definitions.

Disse databaseobjekter er generelt velegnede, hvis du ønsker en bedre forespørgselsydeevne end den, der kan opnås fra objects_x-visninger. 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 er navngivet efter formatet OBJECTS_<objekttypenavn>, hvor <objekttypenavn> er flertalsformen af objekttypen. (Bemærk, at hvis objekttypen ikke har en flertalsform, vil <objekttypenavn> blot være entalsformen af objekttypenavnet sammenkædet med "S").

Forespørgsler til denne visning returnerer en række for hver post i et objekt, hvor hver egenskab for objektet er 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 tilhørende visninger:

 

HubSpot Objekttype

ObjectTypeId

Beskrivelse

KONTAKT

0-1

Oplysninger om personer, der interagerer med din virksomhed

VIRKSOMHED

0

Oplysninger om individuelle virksomheder eller organisationer

AFTALE

0-3

Detaljer om indtægtsmuligheder med en kontaktperson eller virksomhed

ENGAGEMENT

0-4

Gemmer data fra CRM-handlinger, herunder noter, opgaver, e-mails, møder og opkald

TICKET

0-5

Repræsenterer kundernes anmodninger om hjælp eller support

TILBUD

0-14

Bruges til at dele prisoplysninger med potentielle købere

FORM_SUBMISSION

0-15

Detaljer for individuelle indsendelser til et HubSpot-formular

LINE_ITEM

0-8

Repræsenterer en undergruppe af produkter, der sælges i en aftale. Når et produkt knyttes til en aftale, bliver det en linjepost.

CONVERSATION

0-11

Detaljer om indgående beskeder fra flere kanaler.

LANDING_PAGE

0-25

Detaljer om dine landingssider

 TASK

0-27

Gemmer oplysninger om opgavelister

FORM

0-28

Bruges til at indsamle leadoplysninger om dine besøgende og kontakter

MARKETING_EMAIL

0-29

Detaljer om e-mails fra marketinghub

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 inden for 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 dine samlede marketingindsatser.

SITE_PAGE

0-38

Data om individuelle sider på dine websteder

BLOG_POST

0-39

Data om blogindlæg

OBJECT_SEGMENT

0-45

Oplysninger om grupperinger af objektposter baseret på deres egenskaber eller aktiviteter

CALL

0-48

Opkald foretaget af andre CRM-poster, f.eks. kontakter

INVOICE

0

Administrer og synkroniser fakturaer med eksterne regnskabssystemer

MEDIA_BRIDGE

0

Oplysninger om medieaktiver importeret til Hubspot

SEKVENS

0-58

En sekvens er en serie af målrettede, tidsbestemte e-mailskabeloner, der bruges til at pleje kontakter over tid.

SKABELON

0-62

Gemte e-mailindhold, der kan genbruges til at sende e-mails.

DEAL_SPLIT

0-72

Deal splits bruges til at dele deal-kredit mellem flere brugere

SALES_DOCUMENT

0-83

Salgsdokumenter opbygger et bibliotek med indhold, som hele dit team kan uploade og dele dokumenter med dine kontakter

FEEDBACK_SUBMISSION

0-19

Gemmer oplysninger, der er indsendt til en feedbackundersøgelse.

ABONNEMENT

0-69

Abonnementer indeholder oplysninger om tilbagevendende betalinger.

HANDELSBETALING

0

Indeholder data om midler indsamlet fra kunder



Hvert databaseobjekt returnerer følgende kolonner:

Kolonnenavn

Type

Beskrivelse

OBJECTTYPEID

Varchar

ID for objekttypen (f.eks. kontakter er 0-1).

OBJECTID

Tal

ID'et for posten (f.eks. en kontaktpost med ID 123752).

UPDATEDAT

Tid

Dato og klokkeslæt for, hvornår dette objekt sidst blev opdateret i HubSpot. 

INGESTEDAT

Tidsstempel

Dato og klokkeslæt for, hvornår 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 taletype (som angivet af property_definitions), vil der være to kolonner: 

  1. En kolonne, der indeholder ejendomsværdien som streng. Kolonnenavnet vil være property_unparsed_[navn] . For eksempel vil DEAL-objektets ejendom, deal_amount, have kolonnen property_unparsed_deal_amount
  2. En kolonne, der indeholder værdien konverteret til den oprindelige type. Kolonnen vil have navnet property_[name]. For eksempel vil DEAL-objektets egenskab, 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 livscyklusfase for alle kontakter.

Forespørgsel:


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

Returnerer:

OBJECTID

FIRSTNAME

LASTNAME

LIFECYCLESTAGE

54325098

Hobbes

Baron

bly

96805401

Milo

Guld

bly

6922028

Henry

Riley

bly

Eksempel 2

 

Henter navnet og fasen på op til tre aftaler.

Forespørgsel:


SELECT objectId, property_dealName, property_dealStage,
property_amount AS dealAmount

FROM objekter_aftaler

LIMIT 3

Returnerer:

OBJECTID

PROPERTY_DEALNAME

PROPERTY_DEALSTAGE

PROPERTY_DEALAMOUNT

38960439

Handelsnavn 1

afsluttetvundet

34199

321740651

Test-aftale 123

14845019

8383663

98392101

Pop-up-telt

closedwon

9309007

 

Eksempel 3

 

Hent navnet og fasen på de tre største aftaler efter beløb.

Forespørgsel:

Da data om aftalens beløb er tilgængelige som en taledatatype, kan de bruges til sortering 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

PROPERTY_DEALNAME

PROPERTY_DEALSTAGE

EJENDOMS_HANDELSBELØB

98392101

Pop-up-fortelt

lukketvundet

9309007

321740651

Testtilbud 123

14845019

8383663

38960439

Aftale navn 1

lukketvundet

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 Egenskaber, som er en Snowflake Variant/JSON-kolonne. 

Denne visning kan returnere følgende kolonner:

Kolonnenavn Type Beskrivelse
OBJECTTYPEID Varchar ID for objekttypen (f.eks. kontakter er 0-1).
OBJECTID Nummer ID'et for posten (f.eks. en kontaktpost med ID 123752).
EGENSKABER Variant Postens egenskabsværdier.
OPDATERET Tid Dato og klokkeslæt for, hvornår posten sidst blev opdateret i HubSpot. Få mere at vide om kolonnedatatyper.
INGESTEDAT Tid Dato og klokkeslæt for, hvornår dataene sidst blev indlæst af Snowflake. 

Bemærk Den 25. januar 2022 vil kolonnen timestamp i tabellen og visningen object_with_object_properties, som repræsenterer datoen og klokkeslættet for, hvornår objektposten sidst blev opdateret i HubSpot, blive opdateret. Dette er for at tilpasse sig den måde, datetime-data repræsenteres på i resten af datadelen.

Da dette er en væsentlig æ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 sideløbende med timestamp, de kolonner, de skal erstatte. Dette giver dig mulighed for at skifte til at bruge de nye kolonner.

Efter 90 dage, den 25. januar 2022, fjernes kolonnen timestamp fra tabellen og visningen. Efter denne dato vil ethvert forsøg på at forespørge tabellen 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 PROPERTIES
0 38960439 {"createdate": "1504656970152"...}
0-1 321740651 { "oprettelsesdato": "1590183081949"...} 
0-1 98392101 { "oprettelsesdato": "1533566477279"...}
... ... ...

Eksempel 2

Hent navnet og fasen på op til tre aftaler.

Forespørgsel:


SELECT
objectId,
egenskaber:dealname::string AS dealname,
egenskaber:aftalestadium::streng AS aftalestadium,
egenskaber:beløb::tal AS aftalebeløb
FROM objekt_med_objekt_egenskaber
WHERE objektTypeId = '0-3'
BEGRÆNS 3;


Returnerer:

OBJECTID DEALNAME DEALSTAGE DEALAMOUNT
38960439 Handelsnavn 1 lukket tabt 7488939
321740651 Handelsnavn 1 lukketvundet 9292029
98392101 Aftale navn 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, fjernes den 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, fjernes den fra denne visning. 

Dette databaseobjekt kan være nyttigt, hvis din konto har en stor mængde data, hvilket medfører, at visningerne object_with_object_properties og objects_x kører 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:

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

Eksempel 1

Hent alle kontaktposter.

Forespørgsel:


VÆLG objectTypeId, objectId
FRA objekter
Hvor objectTypeId = '0-1'


Returnerer:

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

object_properties

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

Dette databaseobjekt kan returnere følgende kolonner:

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

Eksempel 1

Hent egenskaberne fornavn, efternavn og by for alle kontakter.

Forespørgsel:


VÆLG objectTypeId, objectId, navn, værdi
FRA object_properties
Hvor objectTypeId = '0-1'
OG navn I ('fornavn', 'efternavn', 'by')
ORDER BY objectId;


Returnerer:

OBJECTTYPEID OBJECTID NAME VÆRDI
0 10401 fornavn Brian
0-1 10401 by Dublin
0-1 10401 efternavn Gallagher
0-1 23451 fornavn Fernando
0-1 23451 efternavn Fierro
0-1 25751 fornavn Charles
... ... ... ...

Eksempel 2

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

Forespørgsel:


VÆLG objectId, fornavn, efternavn, livscyklusfase
FROM
(
VÆLG objectId, navn, værdi
FROM object_properties
WHERE objectTypeId = '0-1'
OG navn I ('fornavn', 'efternavn', 'livscyklusfase')
)
PIVOT(MAX(værdi) FOR navn IN ('fornavn', 'efternavn', 'livscyklusfase')) AS p(objektId, fornavn, efternavn, livscyklusfase);

 

Returnerer:

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

object_properties_history

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

Dette databaseobjekt kan returnere følgende kolonner:

Kolonnenavn Type Beskrivelse
OBJECTTYPEID Varchar ID for objekttypen (f.eks. er kontakter 0-1).
OBJECTID Tal ID'et for posten (f.eks. en kontaktpost med ID 123752).
NAME Varchar Navnet på ejendommen.
VÆRDI Tidsstempel Værdien af egenskaben.
OPDATERET Tidstempel Dato og klokkeslæt for sidste opdatering af dataene i HubSpot. Få mere at vide om kolonnedatatyper.
INGESTEDAT Tidsstempel Dato og klokkeslæt for, hvornår dataene sidst blev indlæst af Snowflake. 

Eksempel 1

Hent historikken for en enkelt egenskab for en enkelt kontakt.

Forespørgsel:


VÆLG objectId, navn, værdi, opdateret
FROM objekt_egenskaber_historik
WHERE objektTypeId = '0-1'
OG objectId = 136493192
OG navn = 'hs_predictivescoringtier'
ORDER BY UPDATEDAT DESC;

 
Returnerer:

OBJECTID NAME VALUE OPDATERET

136493192

hs_predictivescoringtier

tier_1

2022-06-22 22:45:05.931

136493192

hs_predictivescoringtier

tier_2

2021-09-18 08:20:56.622

136493192

hs_predictivescoringtier

tier_3

2019-11-31 18:20:22.851

...

...

...

...

Eksempel 2

Hent det aktuelle navn på alle kontakter, der nogensinde har haft en livscyklusfase som abonnent.

Forespørgsel:


VÆLG
objectId,
egenskaber:fornavn::streng AS fornavn,
egenskaber:efternavn::streng AS efternavn
FROM objekt_med_objekt_egenskaber
WHERE objekt_med_objekt_egenskaber.objektTypeId = '0-1'
OG objectId I (
VÆLG objectId
FRA objekt_egenskaber_historik
WHEREobjekt_egenskaber_historik.objektTypeId = '0-1'
OG object_properties_history.name = 'livscyklusfase'
OG object_properties_history.værdi = 'abonnent'
);


Returnerer:

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

Associeringsforespørgsler

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

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

associations_x_to_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 en bestemt combinedassociationtypeid.

Hvert databaseobjekt returnerer følgende kolonner:

Kolonnenavn

Type

Beskrivelse

COMBINEDASSOCIATIONTYPEID

Varchar

Den unikke identifikator for associeringsdefinitionen.

ASSOCIATIONCATEGORY

Varchar

Kilden til associationstypen. En af følgende: HUBSPOT_DEFINED, USER_DEFINED, INTEGRATOR_DEFINED

ASSOCIATIONTYPEID

Varchar

En unik identifikator for en associeringsdefinition inden for en bestemt associeringskategori, dvs. at ingen to definitioner i en associeringskategori vil have samme associationtypeid. 

FROMOBJECTTYPEID

Varchar

Den objecttypeid, der er kilden til associeringsdefinitionen.

FROMOBJECTTYPE

Varchar

Navnet på den objekttype, der er kilden til associeringsdefinitionen.

TOOBJECTTYPEID

Varchar

Den objekttype-id, der er destinationen for associationsdefinitionen.

TOOBJECTTYPE

Varchar

Navnet på den objekttype, der er destinationen for associeringsdefinitionen.

NAME

Varchar

Navnet på tilknytningsdefinitionen.

LABEL

Varchar

Beskrivelsen af associeringsdefinitionen.

ISMAINASSOCIATIONDEFINITION

Boolean

Om associeringsdefinitionen er hovedtypen. Når værdien er sand, er definitionen den, som HubSpot viser på associerede poster.

[FROMOBJECTTYPE_OBJECTID] F.eks. for visningen ASSOCIATIONS_CONTACTS_TO_DEALS vil dette være CONTACT_OBJECTID

Tal

Kildeobjektets objekt-id.

[TOOBJECTTYPE_OBJECTID] F.eks. for visningen ASSOCIATIONS_CONTACTS_TO_DEALS vil dette være DEAL_OBJECTID.

Tal

Objekt-ID for destinationsobjektet.

INGESTEDAT

Tidstempel

Dato og klokkeslæt for, hvornår 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 associations_contacts_to_deals

WHERE contactId = 6626541373

 

Returnerer:

CONTACT_OBJECTID

DEAL_OBJECTID

6626541373

233620335

6626541373

90253678

Eksempel 2

 

Henter alle kontakter baseret i Bogota-tidszonen og deres aftaler.


SELECT contacts.property_firstname contact_firstname,

kontakter.ejendom_efternavn kontakt_efternavn,
kontakter.ejendom_e-mail kontakt_e-mail,
deals.property_dealtype deal_type, deals.property_amount deal_amount
FROM objekter_kontakter kontakter
JOIN associations_kontakter_til_aftaler assoc på
assoc.kontakt_objektid=kontakter.objektid
JOIN objekter_aftaler aftaler på aftaler.objektid=assoc.aftale_objektid
hvor contacts.property_hs_timezone='america_slash_bogota'

 

KONTAKT_FØRNavn

KONTAKT_EFTERNAVN

KONTAKT_EMAIL

DEAL_TYPE

HANDELSBELØB

David

Magalhães

dmagalhaes@example.com

nyforretning

74848

Fernanda

Rodrigues

fmoreira@example.com

nyforretning

253530

Eksempel 3

 

Hent alle kontakter og det samlede beløb for afsluttede aftaler for hver kontakt.


VÆLG SUM(aftaler.ejendom_hs_lukket_beløb) SOM
total_closed_amount, contacts.property_email contact_email
FROM objekter_kontakter kontakter
JOIN associations_kontakter_til_aftaler assoc på
assoc.kontakt_objektid=kontakter.objektid
JOIN objekter_handler handler på handler.objektid=assoc.handel_objektid
GROUP BY kontakt_e-mail
ORDER BY total_closed_amount DESC

 

Returnerer:

TOTAL_CLOSED_AMOUNT

KONTAKT_EMAIL

98474793

johndoe@riverview.com

849488

sallymae@longford.com

association_definitions

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

Der kan være flere typer tilknytninger mellem de samme objekter. Den primære tilknytningstype, som er den type, der vises i HubSpot, når poster er tilknyttet, bruger den tilknytning, hvor ISMAINASSOCIATIONDEFINITION er sand.

Dette databaseobjekt kan returnere følgende kolonner:

Kolonnenavn Type Beskrivelse
COMBINEDASSOCIATIONTYPEID Varchar Den unikke identifikator for associeringsdefinitionen.
KATEGORI Varchar Kilden til associeringstypen. En af følgende: HUBSPOT_DEFINED, USER_DEFINED, INTEGRATOR_DEFINED
ID Tal Identifikatoren for tilknytningsdefinitionen inden for dens kategori.
FROMOBJECTTYPEID Varchar ID'et for det objekt, der er kilden til associeringsdefinitionen.
TOOBJECTTYPEID Varchar ID'et for det objekt, der er destinationen for associationsdefinitionen.
NAME Varchar Navnet på tilknytningsdefinitionen.
LABEL Varchar Forbindelsesdefinitionens etiket.
ISMAINASSOCIATIONDEFINITION Boolean Om associeringsdefinitionen er hovedtypen. Når værdien er sand, er definitionen den, som HubSpot viser på associerede poster.
INGESTEDAT Tid Dato og klokkeslæt for, hvornår dataene sidst blev indlæst af Snowflake. Få mere at vide om kolonnedatatyper.

Eksempel 1 

Hent de typer af tilknytninger, der er tilgængelige i din konto.

Forespørgsel:


VÆLG combinedAssociationTypeId, fromObjectTypeId, toObjectTypeId, navn
FROM association_definitions
ORDER BY kategori, id

 
Returnerer:

COMBINEDASSOCIATIONTYPE FROMOBJECTTYPEID TOOBJECTTYPEID NAME
0-1 0-1 0-2 KONTAKT_TIL_VIRKSOMHED
0-2 0-2 0-1 VIRKSOMHED_TIL_KONTAKT
0-3 0-3 0-1 KONTAKT_TIL_AFTALE
0-4 0-1 0-3 KONTAKT_TIL_AFTALE
0-5 0-3 0-2 AFTALE_TIL_VIRKSOMHED
... ... ... ...

Eksempel 2

Hent de tilgængelige associationstyper mellem aftaler og virksomheder.

Forespørgsel:


VÆLGcombinedAssociationTypeId, fromObjectTypeId, toObjectTypeId, navn
FRA association_definitions
WHERE fraObjekttypeId = '0-3' OG tilObjekttypeId = '0-2'
OG isMainAssociationDefinition = sand
ORDER BY kategori, id


Returnerer:

KOMBINERET ASSOCIATIONTYPE FRAOBJEKTTYPEID TILOBJEKTTYPEID NAVN
0-5 0 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

tilknytninger

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

Dette databaseobjekt kan være nyttigt, hvis din konto har en stor mængde data, hvilket medfører, at associations_x_to_y-visninger kører langsomt.

Dette databaseobjekt kan returnere følgende kolonner:

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

Eksempel 1

Hent alle tilknyttede aftaler og kontakter.

Forespørgsel:


VÆLG combinedAssociationTypeId, fromObjectId, toObjectId
FRA associationer
Hvor combinedAssociationTypeId = '0-5'

 
Returnerer: 

COMBINEDASSOCIATIONTYPEID FROMOBJECTID TOOBJECTID
0 6626541373 233620335
0 6616436082 3866015468
0-5 6690805943 7132752747
... ... ...

Eksempel 2 

Hent alle billetter, der er tilknyttet en bestemt kontakt (kontakt-id: 3005).

Forespørgsel:


VÆLG combinedAssociationTypeId, fromObjectId, toObjectId
FRA associationer
WHERE associationCategory = 'HUBSPOT_DEFINED'
OG combinedAssociationTypeId = '0-15'
OG fraObjektId = 3005;


Returnerer:

KOMBINERET ASSOCIATIONTYPE FRAOBJEKTID TILOBJEKTID
0-5 6626541373 233620335

Eksempel 3 

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

Forespørgsel:


VÆLG combinedAssociationTypeId, fromObjectId toObjectId,
FRA tilknytninger
WHERE
kombineretAssociationTypeId = (
VÆLG combinedAssociationTypeId
FRA association_definitions
HvorfraObjekttypeId = '0-1'
OG tilObjekttypeId = '0-3'
OG isMainAssociationDefinition)
OG fraObjektId = 4464;


Returnerer:

KOMBINERET ASSOCIATIONTYPEID FROMOBJECTID TILOBJEKTID
0-5 6626541373 233620335

Ejersøgninger

ejere

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

Dette databaseobjekt kan returnere følgende kolonner:

Kolonnenavn Type Beskrivelse
OWNERID Nummer Brugerens ejer-id.
USERID Nummer Brugerens bruger-ID. Brugere med NULL i denne kolonne er blevet slettet.
EMAIL Varchar Brugerens e-mailadresse.
FØRNavn Varchar Brugerens fornavn.
LASTNAME Varchar Brugerens efternavn.
ARKIVERET Boolean Om brugeren er blevet slettet.
CREATEDAT Tid Dato og klokkeslæt for, hvornår brugeren blev oprettet i HubSpot. Se kolonnedatatyper for mere information.
OPDATERET Tid Dato og klokkeslæt for, hvornår brugeren sidst blev opdateret i HubSpot. Se kolonnedatatyper for mere information.
INGESTEDAT Tidsstempel Dato og klokkeslæt for, hvornår 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:


VÆLG ejerId, brugerId, e-mail, fornavn, efternavn
FRA ejere
WHERE arkiveret = falsk

 
Returnerer: 

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

Eksempel 2

Hent en bestemt ejer ved hjælp af deres ejer-id.

Forespørgsel:


VÆLG ejerId, brugerId, e-mail, fornavn, efternavn
FRA ejere
WHERE ejerId = 29584574;


Returnerer: 

EJERID BRUGERID EMAIL FØRSTENAVN EFTERNAVN
29584574 4621126 233620335 Hobbes Baron

Eksempel 3

Hent alle kontakter og deres ejere. Denne forespørgsel sammenkæder poster med ejere ved hjælp af object_with_object_properties og kontaktattributten hubspot_owner_id.


VÆLG
kontakt.objektid kontaktid,
kontakt.ejendom_fornavn kontakt_fornavn,
kontakt.ejendom_efternavn kontakt_efternavn,
kontakt.ejendom_hubspot_ejer_id kontakt_hubspot_ejer_id,
ejer.fornavn ejer_fornavn,
ejer.efternavn ejer_efternavn,
ejer.e-mail ejer_e-mail
FROM objekter_kontakter kontakt

JOIN ejere ejer PÅ kontakt.property_hubspot_ejer_id = ejer.ejerId


Returnerer: 

CONTACTID CONTACT_FIRSTNAME CONTACT_LASTNAME CONTACT_HUBSPOT_EJER_ID EJER_FØRNAME EJER_EFTERNAVN EJER_EMAIL
113834202 Richard Greenfield 29584574 Hobbes Baron hobbes.b@business.com
53540801 Ford Karl 30241125 Milo Guld milo.g@business.com
... ... ... ... ... ... ...

Teamforespørgsler

teams

Teams i HubSpot giver dig mulighed for at organisere dine brugere i grupper til organisatoriske og rapporteringsformål. Du kan have et hovedteam og ekstra teams.

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

Dette databaseobjekt kan returnere følgende kolonner:

Kolonnenavn Type Beskrivelse
TEAMID Nummer Holdets ID.
TEAMNAME Varchar Holdets navn.
PARENTTEAMID Tal Team-id'et for det overordnede team.
CHILDTEAMIDS Array Team-id'erne for underordnede teams.
PRIMARYOWNERMEMBERS Varchar Ejer-id'erne for teamets primære medlemmer.
SECONDARYOWNERMEMBERS Boolean Ejernumrene for teamets sekundære medlemmer.
INGESTEDAT Tid Dato og klokkeslæt for, hvornår dataene sidst blev indlæst af Snowflake. 

Eksempel 1

Hent alle teams.

Forespørgsel:

VÆLG teamId,teamName, primaryOwnerMembers

FRA teams

Returnerer:

TEAMID TEAMNAME PRIMÆRE EJERE
29584574 Underteam [233620335, 1234553]
30532717 Superteam [3866015468, 126221873]
3058032 A Team [7132752747]

owner_team

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

Dette databaseobjekt kan returnere følgende kolonner:

Kolonnenavn Type Beskrivelse
TEAMID Nummer Team-id.
OWNERID Nummer Brugerens ejer-ID. 
ISTEAMPRIMARY Boolean Om dette team er det primære team for denne ejer.
INGESTEDAT Tid Dato og klokkeslæt for, hvornår dataene sidst blev indlæst af Snowflake. 

Eksempel 1

Hent alle ejere for et givet team.

Forespørgsel:

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

Returnerer

TEAMID TEAMNAME ISTEAMPRIMARY
29584574 233620335 TRUE
29584574 1234553 TRUE 

Pipeline-forespørgsler

Nedenfor kan du lære, hvordan du forespørger deal- og ticket-pipeline-data, såsom de tilgængelige pipelines i din konto og deres faser.

Du kan sammenkæde 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 sammenkæde dataene objects_deals_view eller object_with_object_properties med pipeline-data.

pipelines

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

Denne tabel kan returnere følgende kolonner:

Kolonnenavn Type Beskrivelse
PIPELINEID Varchar Pipeline-id'et.
OBJECTTYPEID Varchar ID'et for det objekt, som pipelinen kan indeholde (f.eks. aftaler eller billetter).
LABEL Varchar Navnet på pipelinen i HubSpot.
DISPLAYORDER Tal Den rækkefølge, som pipelinen vises i i HubSpot.
ARKIVERET Boolsk Om pipelinen er blevet slettet.
CREATEDAT Tid Hvornår pipelinen blev oprettet.
UPDATEDAT Tid Dato og klokkeslæt for sidste opdatering af dataene i HubSpot. Få mere at vide om kolonnedatatyper.
INGESTEDAT Tid Dato og klokkeslæt for, hvornår dataene sidst blev indlæst af Snowflake. 

Eksempel 1

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

Forespørgsel:


VÆLG objectTypeId, pipelineId, label
FRA pipelines
WHERE objektTypeId = '0-3'
OG ikke arkiveret
ORDER BY displayorder;

 
Returnerer: 

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

Eksempel 2

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

Forespørgsel:


VÆLG

deals.objectId deal_id,
deals.property_dealname deal_name,
pipelines.label pipeline_name
FROM objekter_aftaler aftaler
INNER JOIN pipelines
ON deals.objectTypeId = pipelines.objectTypeId
OG deals.property_pipeline = pipelines.pipelineid
WHERE pipelines.objekttypeid = '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 sammenkoblinger, skal du bruge object_with_object_properties.


VÆLG
deals.objectId deal_id,
deals.properties:dealname::varchar deal_name,
pipelines.label pipeline_name
FROM objekt_med_objekt_egenskaber aftaler
INNER JOIN pipelines
ON deals.objectTypeId = pipelines.objectTypeId
OG deals.properties:pipeline::string = pipelines.pipelineid
WHERE aftaler.objekttypeId = '0-3'
OG pipelines.objekttypeid = '0-3';

 

Returnerer: 

DEAL_ID

DEAL_NAME

PIPELINE_NAME

605140072

Meowmix Global tilmelding

Salgspipeline

605457408

Friskies rebranding

Salgspipeline

604362473

Fresh Step-app-udvikling

Salgspipeline

pipeline_stages

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

Dette databaseobjekt kan returnere følgende kolonner:

Kolonnenavn Type Beskrivelse
PIPELINEID Varchar Pipeline-id.
STAGEID Varchar Fasens ID.
LABEL Varchar Fasens navn i HubSpot.
DISPLAYORDER Nummer Den rækkefølge, som pipelinen vises i HubSpot.
METADATA Variant En JSON-formateret beskrivelse af fasen, herunder om den er åben eller lukket.
ARKIVERET Boolsk Om pipeline-fasen er blevet slettet.
CREATEDAT Tid Hvornår pipeline-fasen blev oprettet.

Eksempel 1 

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

Forespørgsel:


VÆLG pipelineid, stageId, label
FRA pipeline_stages
Hvor ikke arkiveret
OG pipelineid = (
VÆLG pipelineid
FROM pipelines
Hvor objektTypeId = '0-3'
OG ikke arkiveret
OG label = 'Salgspipeline' BEGRÆNS 1)
ORDER BY displayorder;

 
Returnerer: 

PIPELINEID STAGEID LABEL
941650 941651 Kontaktet
941650 941652 Aftale planlagt
941650 941653 Faktura sendt
... ... ...

Eksempel 2

Hent alle aftaler og deres respektive pipeline-faser.

Forespørgsel:


VÆLG
deals.objectId deal_id,
deals.properties:dealname::varchar deal_name,
pipelines.label pipeline_name,
pipeline_stages.label pipeline_stage_name
FROM objekt_med_objekt_egenskaber aftaler
INNER JOIN pipelines
ON deals.objectTypeId = pipelines.objectTypeId
OG deals.egenskaber:pipeline::streng = pipelines.pipelineid
INNER JOIN pipeline_stages
ON deals.objectTypeId = pipeline_stages.pipelineid
OG deals.properties:pipeline::string = pipeline_stages.pipelineid
OG 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 udviklet Salgspipeline Kontrakt underskrevet
... ... ... ...

Ejendomssøgninger

property_definitions

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

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

Dette databaseobjekt kan returnere følgende kolonner:

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

Eksempel 1

Hent navnene og beskrivelserne for alle kontaktegenskaber.

Forespørgsel:


VÆLG navn, etiket, beskrivelse
FRA property_definitions
Hvor objektTypeId = '0-1'

 
Returnerer:

NAME LABEL BESKRIVELSE
entered_sql_stage Indtastet SQL-fase Start tælling af SQL-fase-dage.
first_conversion_event_name
Første konvertering Den første formular, denne kontakt indsendte.
adresse Gadeadresse Kontaktens adresse.

Begivenhedsforespørgsler

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

Navn  
EVENTS_AD_INTERACTION Detaljer om en annonce og kontakter, der har interageret 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 søgeord, der er nævnt af deltagere i opkald.
EVENTS_CLICKED_LINK_IN_EMAIL_V2

 Links, der er klikket på i marketing-e-mails af kontakter.
EVENTS_CLICKED_LINK_IN_TRACKED_INBOX_EMAIL_V8 Links, der er klikket på i e-mails i samtaleindbakken af kontakter.
EVENTS_COOKIE_BANNER_CLICKED Kontakter, der har klikket på cookies.
EVENTS_COOKIE_BANNER_VIEWED Kontakter, der har set cookies.
EVENTS_DOCUMENT_SHARED_V2 Salgsdokumenter, der er delt med kontakter via et eksternt link.
EVENTS_DOCUMENT_VIEWED_V2 Salgsdokumenter og kontakter, der har set dem ved at åbne det eksterne link.
EVENTS_DOCUMENT_COMPLETED_V2 Salgsdokumenter og kontakter, der har afsluttet dem.
EVENTS_HS_SCHEDULED_EMAIL_V2 E-mails, der er sendt til HubSpot-e-mailserverne for at blive afsendt.
EVENTS_MTA_DELIVERED_EMAIL_V2 E-mails, der er leveret til modtagerne af HubSpot-e-mailservere.
EVENTS_MTA_BOUNCED_EMAIL_V2 E-mail-leveringsforsøg, der blev afvist af modtagerens e-mail-server.
EVENTS_OPENED_EMAIL_V2 E-mails åbnet af kontakter.
EVENTS_REPORTED_SPAM_EMAIL_V2 E-mails, der er markeret som spam af modtagere.
EVENTS_UPDATED_EMAIL_SUBSCRIPTION_STATUS_V2 Ændringer i e-mail-abonnementer foretaget af modtagere.
EVENTS_OPENED_TRACKED_INBOX_EMAIL_V8 E-mails i indbakken "Konservationer" åbnet af kontakter.
EVENTS_MB_MEDIA_PLAYED Videoafspilningsaktivitet af kontakter.
EVENTS_V2_CONTACT_BOOKED_MEETING_THROUGH_SEQUENCE Kontakt har booket et møde gennem sekvens.
EVENTS_V2_CONTACT_ENROLLED_IN_SEQUENCE Kontakt tilmeldt fra sekvens.
EVENTS_V2_CONTACT_FINISHED_SEQUENCE Sekvens afsluttet.
EVENTS_V2_CONTACT_REPLIED_SEQUENCE_EMAIL Kontakt har svaret på e-mail (eller indgående e-mail, der har afmeldt sekvensen) sendt via sekvensen.
EVENTS_V2_CONTACT_UNENROLLED_FROM_SEQUENCE Kontakt afmeldt sekvens.
EVENTS_V2_CONTACT_MANUALLY_UNSUBSCRIBED_FROM_SEQUENCE Brugeren har manuelt afmeldt kontakten.
EVENTS_V2_CONTACT_UNSUBSCRIBED_SEQUENCE_EMAIL Kontakt afmeldt, afmeldt sekvensen.
EVENTS_V2_SEQUENCE_EMAIL_BOUNCED Sekvens-e-mail returneret.
EVENTS_V2_SEQUENCE_ERRORED Sekvensfejl, der forårsager afmelding.
EVENTS_V2_SEQUENCE_STEP_EXECUTED Sekvens-trin udført.
EVENTS_VISITED_PAGE Besøg på webside af kontakter.
EVENTS_<INTEGRATION_EVENT_NAME>_<UNIQUE_IDENTIFIER> Integrationsbegivenheder (Timeline V3 API)

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

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

  • forekom
  • forekomstdatoint

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



Kolonnenavn Type Beskrivelse
EVENTTYPEID Varchar ID'et for begivenhedstypen, svarende til OBJECTTYPEID
Du kan søge på alle begivenhedstype-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 med samme ID inden for en given begivenhedstype.
OBJECTTYPEID Varchar Den type objekt, der afsluttede begivenheden. For eksempel vil et klik på et e-mail-link vise0-1 i denne kolonne, hvilket repræsenterer kontaktobjektet.
OBJECTID Tal ID'et for den post, der afsluttede begivenheden.
OCCURREDAT Tid Hvornår begivenheden fandt sted.

OCCURREDATDATEINT

 

 Nummer Et nummer, der angiver, hvornår begivenheden 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 tidsstemplet OCCURREDAT i stedet for dette nummer.

OCCUREDATDATEINT

 Nummer

Et tal, der angiver, hvornår begivenheden 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 tidsstemplet OCCURREDAT i stedet for dette tal.

Bemærk: Denne kolonne udgår den 24. november 2022 og erstattes med OCCURREDATDATEINT.
OCCUREDAT Tidsstempel

Hvornår begivenheden fandt sted.

Bemærk: Denne kolonne udgår den 24. november 2022 og erstattes med OCCURREDAT.
INGESTEDAT Tidsstempel Dato og klokkeslæt for, hvornår dataene sidst blev indlæst af Snowflake. Få mere at vide om kolonnedatatyper.
PROPERTY_* Varchar Individuelle kolonner, der indeholder begivenhedsegenskaberne.

Eksempel 1

Hent de 50 seneste e-mail-klikbegivenheder.

Forespørgsel:


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


Returnerer: 

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

Eksempel 2

Hent alle e-mail-klikbegivenheder fra de kontakter, der har klikket. Denne forespørgsel henter kontaktdata ved at sammenkæde med object_with_object_properties.

Forespørgsel:


SELECT
klik.forekommetid klik_tidsstempel,
klik.egenskab_hs_klik_rå_url klik_url,
kontakt.egenskaber:fornavn::varchar kontakt_fornavn,
kontakt.egenskaber:efternavn::varchar kontakt_efternavn
FROM events_clicked_link_in_email_V2 klik
LEFT JOIN objekt_med_objekt_egenskaber kontakt
ON klik.objekttypeId = kontakt.objekttypeId
OG click.objectId = kontakt.objectId
BEGRÆNS 3;


Returnerer: 

CLICK_TIMESTAMP KLIK_URL KONTAKT_FØRNavn 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 Gold
08.11.2018 09:37:41.426 https://www.website.net/contact?utm_source=hs_automation&utm_medium=email&utm_content=55200164 Harlow Villari
... ... ... ...

Object_and_event_type_queries

object_and_event_type_definitions

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

Dette databaseobjekt kan returnere følgende kolonner:

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

Eksempel 1

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

Forespørgsel:


VÆLG objectTypeId, fuldt kvalificeret navn
FRA objekt_og_begivenhedstypedefinitioner;

 
Returnerer: 

OBJECTTYPEID FULLYQUALIFIEDNAME
0 CONTACT
0-8 LINJEPOST
0-11 CONVERSATION
... ...

Segmentforespørgsler

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

segmenter

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

Dette databaseobjekt kan returnere følgende kolonner:

Kolonnenavn Type Beskrivelse
OBJECTTYPEID Varchar Typen af poster i segmentet (f.eks. kontakt eller virksomhed).
SEGMENTID Tal ID'et for segmentet. Forbindes til kolonnenSEGMENTID i tabellen med segmentmedlemskaber.
CLASSICSEGMENTID Tal Et ID, der er specifikt for kontaktsegmenter, og som matcher ID'et i URL'en for segmentet i HubSpot.
NAME Varchar Navnet på segmentet.
STØRRELSE Tal Antallet af poster i segmentet.
CREATEDBYUSERID Tal ID'et for den bruger, der oprettede segmentet.
CREATEDAT Tid Hvornår segmentet blev oprettet i HubSpot.
OPDATERET AF BRUGER-ID Tal ID'et for den bruger, der senest har opdateret segmentet.
OPDATERET Tidstempel Dato og klokkeslæt for sidste opdatering i HubSpot. Få mere at vide om kolonnedatatyper. 
INGESTEDAT Tidsstempel Dato og klokkeslæt for, hvornår dataene sidst blev indlæst af Snowflake.

Eksempel 1

Hent alle kontaktsegmenter.

Forespørgsel:


VÆLG segmentId, navn, størrelse
FRA segmenter
WHERE objektTypeId = '0-1';

 
Returnerer: 

SEGMENTSID NAME SIZE
118131 Ugentlig rækkevidde 103
66156 Blogabonnenter 455
771852 Topabonnenter 2021 37
... ... ...

Eksempel 2

Hent et specifikt kontaktsegment med navnet Topabonnenter 2021. 

Forespørgsel:


VÆLG segmentId, navn, størrelse 
FRA segmenter
WHERE objectTypeId = '0-1'
OGsegmentName = 'Top abonnenter 2021';


Returnerer: 

SEGMENTID NAVN STØRRELSE
771852 Topabonnenter 2021 37

segment_membership

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

Indeholder kun segment-id'er og objekt-id'er. For mere information, sammenkæd med segmentdatabaseobjektet.

Dette databaseobjekt kan returnere følgende kolonner:

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

Eksempel 1

Hent ID'erne for alle kontakter i segmentetTopabonnenter 2021.

Forespørgsel:


VÆLG objectId
FRA segmentmedlemskaber
INNER JOIN segmenter
ON segmentmedlemskaber.segmentId = segmenter.segmentId
WHERE segments.objectTypeId = '0-1'
OG segments.name = 'Topabonnenter 2021';

 
Returnerer: 

OBJECTID
54325098
96805401
6922028
...

Eksempel 2

Hent fornavn og efternavn på kontaktoplysninger i segmentet Topabonnenter 2021.

Forespørgsel:


VÆLG

kontakt.objektId AS objektid,
kontakt.ejendom_fornavn AS fornavn,
kontakt.ejendom_efternavn AS efternavn
FROM objekter_kontakter kontakt
INNER JOIN segmentmedlemskaber ON kontakt.objektId = segmentmedlemskaber.objektId
INNER JOIN segmenter PÅ segmentmedlemskaber.segmentId = segmenter.segmentId
WHERE segmenter.objektTypeId = '0-1'
OG segments.name = 'Topabonnenter 2021'


Returnerer: 

OBJECTID

FØRNavn

EFTERNAVN

54325098

Hobbes

Baron

96805401

Milo

Gold

6922028

Henry

Riley

...

...

...

Ofte stillede spørgsmål

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


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


VÆLG * FRA ejendomsdefinitioner

WHERE label = [kolonne_navn]

 

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

Når du har fastslået, hvilken objekttype kolonnen tilhører, er det nemt at afgøre, hvad du skal søge efter. Du kan blot søge efter den object_x-visning, der svarer til typen.

Hvordan forbinder 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, kan du se på associationer. Associationer repræsenterer relationerne mellem objekter i HubSpot CRM. Alle forskellige associationer, der er mulige mellem to typer, er angivet i association_definitions. I eksemplet ovenfor skal du for at se alle de formularer, en kampagne er linket til, søge i ASSOCIATIONS_CAMPAIGNS_TO_FORMS:


VÆLG campaigns.property_hs_name campaign_name,
forms.property_hs_form_id form_id
FROM objekter_kampagner kampagner
JOIN associations_campaigns_to_forms assoc ON
assoc.kampagneobjektid=kampagner.objektid
JOIN objekter_formularer formularer ON formularer.objektid=assoc.formularobjektid
GROUP BY kampagnenavn

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

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

SELECT * FROM hubspot.public.data_share_status
LIMIT 1

Resultaterne vises som:

STATUS MEDDELELSE OPDATERET
OK INGEN KENDTE HÆNDELSER PÅ NUVÆRENDE TIDSPUNKT 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 eventuelle nedbrud eller afbrydelser. 
Var denne artikel nyttig?
Denne formular bruges kun til dokumentationsfeedback. Læs, hvordan du kan få hjælp hos HubSpot.

Relateret indhold

Relateret indhold

New call-to-action