Siirry sisältöön
Huomaa: Tämän artikkelin käännös on tarkoitettu vain tiedoksi. Käännös on luotu automaattisesti käännösohjelmiston avulla, eikä sitä ole välttämättä tarkistettu. Näin ollen tämän artikkelin englanninkielistä versiota on pidettävä hallitsevana versiona, joka sisältää uusimmat tiedot. Voit tutustua siihen täällä.

HubSpotin tietojen kysely Snowflakessa

Päivitetty viimeksi: toukokuuta 31, 2024

Saatavilla minkä tahansa seuraavan Tilauksen kanssa, paitsi jos toisin mainitaan:

Operations Hub   Enterprise

Kun olet yhdistänyt Snowflaken HubSpot-tiliisi, voit käyttää Snowflaken Data Share -palvelua HubSpotin tietojen kyselyyn Snowflake-tililtäsi.

Dataviive ja Snowflake-tilisi alue

Sinulla on pääsy V2_LIVE-skeemaan, joka päivitetään 15 minuutin välein, ja V2_DAILY-skeemaan, joka päivitetään päivittäin.

Huomaa: V2_LIVE-skeeman seuraavat näkymät päivitetään vain päivittäin: association_definitions, owners, pipelines ja pipeline_stages.

Snowflake-ympäristön määrittäminen

Jotta voit tehdä HubSpot-tietojen kyselyn Snowflakessa, sinun on valittava varasto, tietokanta ja skeema, josta haluat tehdä kyselyn. Voit joko asettaa ne työarkkitasolla, jolloin ne sisällytetään automaattisesti kyselyihin, tai lisätä ne manuaalisesti.

Voit valita varaston, tietokannan ja skeeman työarkkitasolla:

  • Napsauta laskentataulukon ylärivillä laskentataulukon toimintopalkkia.

    snowflake-worksheet-settings0
  • Ponnahdusikkunassa:
    • Napsauta Warehouse (Varasto ) -pudotusvalikkoa ja valitse sitten varastosi.
    • Napsauta avattavaa Tietokanta-valikkoa ja valitse sitten HubSpot-tietokantasi.
    • Napsauta Schema-pudotusvalikkoa ja valitse sitten haluamasi skeema:
        • V2_DAILY: Päivittäinen skeema, jolla voit kysyä tietoja taulukoiden perusteella. Tämän skeeman tiedot päivitetään kerran päivässä. Tämän skeeman käyttäminen nopeuttaa kyselyjä, ja sitä suositellaan suoraan Snowflakessa tehtäviin kyselyihin.
        • V2_LIVE: HubSpotin tietojen Secure Views -näkymiin perustuva live-skeema. Tämän skeeman tiedot päivitetään enintään 15 minuutin välein. Jos teet kyselyjä suuresta tietomäärästä, kyselyt voivat olla hitaita. Tällöin on suositeltavaa kopioida tiedot ensin ETL-prosessilla omaan taulukkoon ja tehdä sitten kysely kyseisestä taulukosta.


      snowflake-worksheet-settings-window0

Kun ympäristösi on määritetty, voit tehdä kyselyjä HubSpot-tietoihin ilman, että sinun tarvitsee lisätä tietokantaasi tai skeematyyppiäsi kyselyihin manuaalisesti.

Jos haluat lisätä tietokannan ja skeematyypin manuaalisesti kyselyihin, lisää tietokannan nimi ja skeema FROM -kentän alkuun. Esimerkiksi:


SELECT objectTypeId, property_createddate
FROM hubspot_share_name.V2_LIVE.objects_deals

LIMIT 1

Tietojen yleiskatsaus

Kyselyt muodostetaan SQL:n avulla, ja niiden avulla voidaan hakea HubSpotin tietoja, kuten:

  • Kohteet: vakio- ja mukautetut kohteet, kuten yhteystiedot, yritykset ja tuotteet.
  • Tietueet: yksittäiset tietueet, kuten yksittäinen yhteyshenkilö tai yritys.
  • Assosiaatiot: kaikki käytettävissä olevat assosiaatiotyypit ja tällä hetkellä niihin liittyvät tietueet.
  • Tapahtumat: tapahtumatiedot sekä HubSpotin vakiotapahtumista, kuten sähköpostin avauksista, että mukautetuista käyttäytymistapahtumista.
  • Luettelot: HubSpotin yhteyshenkilö- ja yritysluettelot.
  • Omistajat: HubSpot-tilisi käyttäjät suhteessa tietueisiin, joiden omistajiksi heidät on määritetty.
  • Putket: sopimusten ja lippujen putket, mukaan lukien putken vaiheet.
  • Ominaisuudet: CRM-tietueiden ominaisuudet ja niiden arvot, mukaan lukien ominaisuuksien historia.

Lisätietoja HubSpotin CRM-tietomallista.

Huomaa :Kun kehitämme tietojen yhteiskäyttöä, teemme muutoksia, joista osa on jopa mullistavia. On erittäin suositeltavaa tilata HubSpotin kehittäjien muutosloki. Nämä muutokset julkaistaan muutoslokissa aina ennen päivitystä.

Palautettujen tietojen rajaaminen ja järjestäminen

Kun muodostat kyselyjä, voit hallita palautettavien tietojen määrää ja palautusjärjestystä sisällyttämällä kyselyyn osoitteet LIMIT ja ORDER BY. Jos haluat esimerkiksi kysyä kaikkia yhteystietoja ja niiden ominaisuuksia, mutta palauttaa vain kolme tulosta ja järjestää ne yhteystiedon tunnuksen mukaan, voit rakentaa kyselyn seuraavasti:


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

Sarakkeen tietotyypit

Kun Snowflakessa kysytään tietoja, palautettavat sarakkeet riippuvat kysytyistä tiedoista. Voit tarkastella Snowflaken tietyn taulukon tai näkymän käytettävissä olevia sarakkeita valitsemalla näkymän vasemmasta sivupalkista.

Huomaa:Loppuosassa tätä dokumenttia käytämme termiä tietokantaobjekti, kun asiayhteys koskee sekä tauluja että näkymiä.

snowflake-sidebar-view-column-details0


Jos haluat palauttaa tietyn sarakkeen, sisällytä kyseinen sarake kyselysi SELECT -kenttään. Esimerkiksi seuraava kysely palauttaa vain sarakkeet OBJECTID ja UpdatedAt:


SELECT
objectId, updatedAt
FROM objects_contacts

Alla on yleisiä määritelmiä sarakkeille, jotka kysely voi palauttaa. Muut määritelmät, joita ei ole sisällytetty alla olevaan, löytyvät yksittäisten näkymien määritelmistä yllä olevassa artikkelissa.

  • OBJECTTYPEID: VARCHAR-arvo, joka edustaa objektin tyyppiä. Esimerkiksi 0-1 edustaa yhteystieto-objektia, 0-2 edustaa yritysobjektia ja 2-1232 voi edustaa tilisi mukautettua objektia. Luetteloissa tämä viittaa luettelon tyyppiin (esim. yhteystiedot tai yritys). Voit kysyä kaikkia tilisi objekti- ja tapahtumatunnuksia objektin_ja_tapahtumatyypin_määritykset -näkymällä.
  • OBJECTID: BIGINT-numero, joka edustaa HubSpot-tilisi tietyn tyyppisen objektin yksittäistä tietuetta. Tietueen tunnistamiseksi on käytettävä sekä objektityypin ID:tä että objektin ID:tä.
  • INGESTEDAT: TIMESTAMP_NTZ-arvona esitetty aikaleima siitä, milloin tietorivi lisättiin Snowflakeen. Ei liity HubSpotin luonti- tai päivitysoperaation loogiseen aikaleimaan.
    • HubSpotin sisäisestä käsittelystä johtuen rivin sisäänottoaikaleima saattaa päivittyä, vaikka rivin muut sarakkeet eivät olisi muuttuneet.
    • Kun rakennetaan ETL-prosesseja, jotka kopioivat äskettäin muuttuneita tietoja, on suositeltavaa perustaa kyselyt sisäänottoaikaleimakkeeseen. Lisäksi jos virtauksesi kopioi tietoja päivittäin, on suositeltavaa kopioida kahden edellisen päivän tiedot viiveiden huomioon ottamiseksi.
  • CREATEDAT ja UPDATEDAT: looginen aikaleima siitä, milloin tiedot on luotu tai päivitetty HubSpotissa, TIMESTAMP_NTZ-arvona . Nämä aikaleimat vastaavat HubSpotin aikaleimoja. Esimerkiksi HubSpotissa tietueen luontipäivämääränä näkyvä aika on sama kuin Snowflaken CREATEDAT-sarakkeen aikaleima. Nämä eivät liity suoraan sisäänsyöttöaikaleimaan, eikä ETL-prosessien perustaminen näihin ominaisuuksiin ole suositeltavaa.
  • COMBINEDASSOCIATIONTYPE: VARCHAR-arvo, joka yksilöi assosiaatiomääritelmän.

Tietotyyppien muuntaminen

Joskus kyselystä palautetaan tietoja VARCHAR-sarakkeilla, vaikka olisi toivottavaa, että ne olisivat eri tyyppisiä. Tällaisissa tapauksissa on suositeltavaa muuntaa VARCHAR-tietotyyppi halutuiksi Snowflake-funktioiden avulla. Esimerkiksi objektitietueen ominaisuudet tallennetaan VARCHAR-tietotyyppeinä useimmissa tietokantaobjekteissa, mutta joskus ne sisältävät numero- ja datetime-arvoja. Tällaisia funktioita ovat mm:
try_to_number, try_to_timestamp_ntz voidaan käyttää näiden VARCHAR-tietojen muuntamiseen NUMBER- ja DATETIME-tyypeiksi:


SELECT objectid, value AS amount_str, try_to_number(value) AS amount

FROM object_properties
WHERE objecttypeid='0-3' AND name='amount'
LIMIT 1

Kohdekyselyt

Seuraavassa kerrotaan, miten tiettyjä HubSpot-objekteja ja tietueita koskevia tietoja sekä palautettavia tietoja kysytään.

Erityyppiset objektitiedot on järjestetty ja saatavilla kahdella tavalla:

  • Yksilöllinen: Kukin objektityyppi tallennetaan omaan näkymäänsä, ja se sisältää vain saman objektityypin tietueita, esim. objects_contacts sisältää vain yhteystietoja. Tämä poistaa tarpeen määrittää objektityypin tunniste kyselyssä. Näitä näkymiä on helpompi kysyä, koska sinun ei tarvitse tietää ObjectTypeId:tä. Ne myös palauttavat tiedot käyttökelpoisemmassa muodossa, jossa jokainen rivi vastaa objektia ja sen ominaisuuksien nykyistä versiota. Niin kauan kuin kyselyt eivät ole hitaita, on suositeltavaa käyttää näitä näkymiä objektitietojen hakemiseen. Katso lisätietoja Objects_X-näkymistä jäljempänä.
  • Yhdistetty: Kaikkien objektityyppien kaikki tietueet yhdistetään yhdeksi tietokantaobjektiksi. Näin ollen kyselyä tehdessäsi sinun on määritettävä suodatin, kuten "WHERE objectTypeId='0-1'. Voit esimerkiksi käyttää seuraavia objektityyppitunnuksia kyselyssä:
Kohteen nimi ObjectTypeId
Yhteystiedot 0-1
Yritykset 0-2
Rivikohdat 0-8

Mukautetuille objekteille annetaan tunniste luontihetkellä, ja sen tunniste on 2-unique_ID. Esimerkiksi 2-12345. Lisätietoja objekti- ja tapahtumatyypin määritelmistä.

Nämä tietokantaobjektit sopivat yleensä, jos haluat paremman kyselyn suorituskyvyn kuin mitä saadaan objects_x-näkymillä. Katso lisätietoja jäljempänä kohdissa object_with_object_properties, object_properties, objects ja object_properties_history.

objects_x näkymät

Tässä tietokantakohteessa jokaisella käytettävissä olevalla kohdetyypillä, mukaan lukien mukautetut kohteet, on oma näkymänsä, ja kukin näkymä sisältää vain kyseisen kohdetyypin kohteiden tietueita. Nämä näkymät nimetään muodossa OBJECTS_<objektityypin nimi>, jossa <objektityypin nimi> on objektityypin monikkomuotoinen nimike(Huomaa, että jos objektityypillä ei ole monikkomuotoa, <objektityypin nimi> on yksinkertaisesti objektityypin nimen yksikkömuotoinen nimike, johon on liitetty "S").

Tämän näkymän kyselyt palauttavat yhden rivin jokaisesta objektin tietueesta, ja jokainen objektin ominaisuus on käytettävissä erillisenä sarakkeena.

Alla on kattava luettelo käytettävissä olevista HubSpot-objektityypeistä (eli muista kuin mukautetuista), lyhyt kuvaus niiden edustamista tiedoista ja niitä vastaavista näkymistä:

HubSpotin kohdetyyppi

ObjectTypeId

Kuvaus

YHTEYSTIEDOT

0-1

Tietoja yrityksesi kanssa vuorovaikutuksessa olevista henkilöistä

YRITYS

0-2

Tietoa yksittäisistä yrityksistä tai organisaatioista

DEAL

0-3

Yksityiskohtaiset tiedot yhteystiedon tai yrityksen tarjoamista tulonhankintamahdollisuuksista.

ENGAGEMENT

0-4

Tallentaa tietoja CRM-toiminnoista, mukaan lukien muistiinpanot, tehtävät, sähköpostit, kokoukset ja puhelut.

LIPPU

0-5

Edustaa asiakkaiden avun- ja tukipyyntöjä.

QUOTE

0-14

Käytetään hintatietojen jakamiseen mahdollisten ostajien kanssa.

FORM_SUBMISSION

0-15

HubSpot-lomakkeen yksittäisten lähetysten tiedot.

LINE_ITEM

0-8

Edustaa kaupassa myytävien tuotteiden osajoukkoa. Kun tuote liitetään kauppaan, siitä tulee rivikohta.

KESKUSTELU

0-11

Yksityiskohdat useista kanavista saapuvista viesteistä.

LANDING_PAGE

0-25

Laskeutumissivujesi yksityiskohdat

TASK

0-27

Tallentaa tietoja tehtävälistoista

LOMAKE

0-28

Käytetään keräämään tietoja kävijöistäsi ja yhteyshenkilöistäsi.

MARKKINOINTISÄHKÖPOSTI

0-29

Tiedot markkinointikeskuksesta tulevista sähköposteista

AD_ACCOUNT

0-30

Tallentaa tietoja Linkedinin, Facebookin ja Googlen mainostileistäsi.

AD_CAMPAIGN

0-31

Tiedot mainoskampanjoistasi. Mainoskampanja voi sisältää yhden tai useamman mainoksen

AD_GROUP

0-32

Mainosten looginen ryhmittely mainoskampanjan sisällä

AD

0-33

Yksityiskohtaiset tiedot yksittäisistä mainoksista

KAMPANJA

0-35

Tietoa markkinointiin liittyvistä markkinointivaroista ja -sisällöstä, jotta voit helposti mitata yhteisten markkinointitoimien tehokkuutta.

SIVUSTO_SIVU

0-38

Tiedot yksittäisistä sivuista verkkosivustoillasi

BLOG_POST

0-39

Tiedot blogikirjoituksista

OBJEKTILUETTELO

0-45

Tietoa objektitietueiden ryhmittelystä niiden ominaisuuksien tai toimintojen perusteella.

SOITA

0-48

Muiden CRM-tietueiden, esim. yhteystietojen, soittamat puhelut.

LASKU

0-53

Laskujen hallinta ja synkronointi ulkoisten kirjanpitojärjestelmien kanssa.

MEDIA_BRIDGE

0-57

Tiedot Hubspotiin tuoduista mediavaroista

SEQUENCE

0-58

Sekvenssi on sarja kohdennettuja, ajoitettuja sähköpostipohjia, joiden avulla kontakteja hoidetaan ajan mittaan.

DEAL_SPLIT

0-72

Kaupan jakamista käytetään jakamaan kauppahyvityksiä useiden käyttäjien kesken.

SALES_DOCUMENT

0-83

Myyntiasiakirjat rakentavat koko tiimillesi sisällön kirjaston, johon voit ladata ja jakaa asiakirjoja yhteystietojesi kanssa.

FEEDBACK_SUBMISSION

0-19

Tallentaa palautekyselyyn lähetetyt tiedot.

TILAUS

0-69

Tilaukset sisältävät tiedot toistuvista maksuista

KAUPALLINEN MAKSU

0-101

Sisältää tietoja asiakkailta kerätyistä varoista



Kukin tietokantaobjekti palauttaa seuraavat sarakkeet:

Sarakkeen nimi

Tyyppi

Kuvaus

OBJECTTYPEID

Varchar

Objektityypin tunnus (esim. yhteystiedot on 0-1).

OBJECTID

Numero

Tietueen tunnus (esim. yhteystietue, jonka tunnus on 123752).

UPDATEDAT

Aikaleima

Päivämäärä ja kellonaika, jolloin tämä objekti on viimeksi päivitetty HubSpotissa.

INGESTEDAT

Aikaleima

Päivämäärä ja kellonaika, jolloin Snowflake on viimeksi syöttänyt tiedot.

PROPERTY_*

Varchar

Yksittäiset sarakkeet, jotka sisältävät objektin ominaisuuksien viimeisimmän version.Jokaiselle objektin ominaisuudelle, jolla on päivämäärä- tai numerotyyppi (kuten property_definitions määrittää), on kaksi saraketta:

  1. Sarake, joka sisältää ominaisuuden arvon merkkijonona. Sarakkeen nimi on property_unparsed_[nimi] . Esimerkiksi DEAL-objektin ominaisuudelle deal_amount annetaan sarake property_unparsed_deal_amount.
  2. Sarake, joka sisältää natiivityypiksi muunnetun arvon. Sarakkeen nimi on property_[name].Esimerkiksi DEAL-objektiominaisuus deal_amount saa sarakkeen property_deal_amount. Huomaa, että tämä sarake sisältää nollan, jos muuntaminen natiivityyppiseksi epäonnistuu virheellisten tietojen vuoksi.

Esimerkki 1


Hae kaikkien yhteystietojen etunimi, sukunimi ja elinkaaren vaihe.

Kysely:


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

FROM objects_contact

Palaa:

OBJECTID

ESIMERKKI

LASTNAME

ELINKAARIVAIHE

54325098

Hobbes

Paroni

lyijy

96805401

Milo

Kulta

lyijy

6922028

Henry

Riley

lyijy

Esimerkki 2

Hae enintään kolmen kaupan nimi ja vaihe.

Query:


SELECT objectId, property_dealName, property_dealStage,
property_amount AS dealAmount

FROM objects_deals

LIMIT 3

Palaa:

OBJECTID

OMAISUUS_KAUPPANIMI

PROPERTY_DEALSTAGE

PROPERTY_DEALAMOUNT

38960439

Sopimuksen nimi 1

closedwon

34199

321740651

Testi Deal 123

14845019

8383663

98392101

Pop-Up katos

closedwon

9309007

Esimerkki 3

Hae kolmen suurimman sopimuksen nimi ja vaihe summan mukaan.

Kysely:

Koska kauppasummatiedot ovat saatavilla numerotietotyyppinä, niitä voidaan käyttää järjestykseen ilman muuntamista tai valintaa.


SELECT objectId, property_dealName, property_dealStage,
property_amount AS dealAmount

FROM objects_deals
ORDER BY property_amount DESC
LIMIT 3


Palaa:

OBJECTID

OMAISUUS_KAUPPANIMI

PROPERTY_DEALSTAGE

PROPERTY_DEALAMOUNT

98392101

Pop-Up katos

closedwon

9309007

321740651

Testi Deal 123

14845019

8383663

38960439

Sopimuksen nimi 1

closedwon

34199

object_with_object_properties (objekti_objektiominaisuuksilla)

Tämä tietokantaobjekti sisältää tietoja HubSpot-tietueistasi. Kyselyt tälle tietokantaobjektille palauttavat yhden rivin jokaisesta tietueesta objektityypin sisällä (esim. kaikki yhteystietueet kontaktit-objektityypissä). Kaikki ominaisuudet tallennetaan Properties-sarakkeeseen, joka on Snowflake Variant / JSON-sarake.

Tämä näkymä voi palauttaa seuraavat sarakkeet:

Sarakkeen nimi Tyyppi Kuvaus
OBJECTTYPEID Varchar Objektityypin tunnus (esim. yhteystiedot on 0-1).
OBJECTID Numero Tietueen tunnus (esim. yhteystietue, jonka tunnus on 123752).
PROPERTIES Vaihtoehto Tietueen omaisuusarvot.
UPDATEDAT Aikaleima Päivämäärä ja kellonaika, jolloin tietue on viimeksi päivitetty HubSpotissa. Lisätietoja sarakkeen tietotyypeistä.
INGESTEDAT Aikaleima Päivämäärä ja kellonaika, jolloin Snowflake on viimeksi syöttänyt tiedot.

Huomaa: Tammikuun 25. päivänä 2022 object_with_object_properties-taulukon ja -näkymän sarakkeesta timestamp, joka edustaa päivämäärää ja kellonaikaa, jolloin objektitietue on viimeksi päivitetty HubSpotissa, tulee updatedat. Tämä on tarkoitus yhdenmukaistaa sen kanssa, miten datetime-tiedot esitetään muualla datajaossa.

Koska kyseessä on rikkova muutos, taulukkoon ja näkymään on lisätty uusi sarake updatedat. Seuraavien 90 päivän ajan nämä kaksi uutta saraketta toimivat rinnakkain timestamp-sarakkeiden kanssa, jotka ne on tarkoitus korvata. Tämä antaa sinulle mahdollisuuden siirtyä käyttämään uusia sarakkeita.

90 päivän kuluttua, 25. tammikuuta 2022, sarake timestamp poistetaan taulukosta ja näkymästä. Tämän päivämäärän jälkeen kaikki yritykset kysyä object_with_object_properties-taulusta tai näkymästä timestamp-sarakkeilla epäonnistuvat.

Esimerkki 1

Hae kaikki yhteystiedot ja niiden ominaisuudet.

Kysely:


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


Palaa:

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

Esimerkki 2

Hae enintään kolmen kaupan nimi ja vaihe.

Kysely:


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;


Palaa:

OBJECTID DEALNAME DEALSTAGE DEALAMOUNT
38960439 Sopimuksen nimi 1 closedlost 7488939
321740651 Sopimuksen nimi 1 closedwon 9292029
98392101 Sopimuksen nimi 1 closedlost 62626528

esineet

Tämä tietokantaobjekti on osajoukko object_with_object_properties-tietokantaobjektin tiedoista. Jokainen palautettu rivi palauttaa kunkin tietueen objektin tunnuksen. Tämä tietokantaobjekti palauttaa vain olemassa olevat tietueet. Kun tietue poistetaan HubSpotissa, se poistetaan tästä tietokantaobjektista. Tämä tietokantaobjekti on osajoukko object_with_object_properties-taulun tiedoista. Jokainen palautettu rivi palauttaa kunkin tietueen objektin ID:n. Tämä näkymä palauttaa vain olemassa olevat tietueet. Kun tietue poistetaan HubSpotissa, se poistetaan tästä näkymästä.

Tämä tietokantaobjekti voi olla hyödyllinen, jos tililläsi on suuri määrä tietoja, jolloin object_with_object_properties- ja objects_x-näkymät toimivat hitaasti. Tämän tietokantaobjektin käyttäminen yhdessä object_properties-tietokantaobjektin kanssa mahdollistaa object_with_object_properties-tietokannan tietojen monistamisen, mutta samalla voidaan hallita, mitkä ominaisuudet palautetaan.

Tämä tietokantaobjekti voi palauttaa seuraavat sarakkeet:

Sarakkeen nimi Tyyppi Kuvaus
OBJECTTYPEID Varchar Objektityypin tunnus (esim. yhteystiedot on 0-1).
OBJECTID Numero Tietueen tunnus (esim. yhteystietue, jonka tunnus on 123752).
INGESTEDAT Aikaleima Päivämäärä ja kellonaika, jolloin Snowflake on viimeksi syöttänyt tiedot. Lisätietoja sarakkeen tietotyypeistä.

Esimerkki 1

Hae kaikki yhteystietueet.

Kysely:


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


Palaa:

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

object_properties

Tämä tietokantaobjekti on object_with_object_properties-tietokantaobjektin osajoukko. Jokainen rivi sisältää tietueelle asetetun ominaisuuden nykyisen arvon. Esimerkiksi yhteystiedolla on yksi rivi sen etunimiominaisuudelle ja yksi rivi sen sukunimiominaisuudelle. Jos tietueella ei ole arvoa jollekin ominaisuudelle, rivillä on joko tyhjä merkkijono tai sitä ei näy lainkaan.

Tämä tietokantaobjekti voi palauttaa seuraavat sarakkeet:

Sarakkeen nimi Tyyppi Kuvaus
OBJECTTYPEID Varchar Objektityypin tunnus (esim. yhteystiedot on 0-1).
OBJECTID Numero Tietueen tunnus (esim. yhteystietue, jonka tunnus on 123752).
NAME Varchar Kiinteistön nimi.
VALUE Aikaleima Kiinteistön arvo.
UPDATEDAT Aikaleima Päivämäärä ja kellonaika, jolloin tietue on viimeksi päivitetty HubSpotissa. Lisätietoja sarakkeen tietotyypeistä.
INGESTEDAT Aikaleima Päivämäärä ja kellonaika, jolloin Snowflake on viimeksi syöttänyt tiedot.

Esimerkki 1

Hae kaikkien yhteystietojen etunimi, sukunimi ja kaupunkiominaisuudet.

Kysely:


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


Palaa:

OBJECTTYPEID OBJECTID NIMI ARVO
0-1 10401 etunimi Brian
0-1 10401 kaupunki Dublin
0-1 10401 sukunimi Gallagher
0-1 23451 etunimi Fernando
0-1 23451 sukunimi Fierro
0-1 25751 etunimi Charles
... ... ... ...

Esimerkki 2

Hae etunimi, sukunimi ja elinkaaren vaihe kaikista yhteystiedoista ja yhdistä ne yhdeksi riviksi per yhteystieto. Tässä esimerkissä käytetään SQL:n PIVOT-syntaksia.

Kysely:


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

Palaa:

OBJECTTYPEID OBJECTID ESIMERKKI LASTNAME ELINKAARIVAIHE
0-1 54325098 Hobbes Paroni lyijy
0-1 96805401 Milo Kulta lyijy
0-1 6922028 Henry Riley lyijy
... ... ... ... ...

object_properties_history

Tämä tietokantaobjekti sisältää historialliset ominaisuuksien arvot. Yhteystietojen osalta se sisältää viimeisimmät 45 arvoa. Kaikkien muiden kohteiden osalta se sisältää viimeisimmät 20 arvoa. Näyttää rivin kullekin historiallisen ominaisuuden arvolle. Ominaisuuden tämänhetkinen arvo määräytyy ominaisuuden historian viimeisimmän UPDATEDAT-aikaleiman perusteella.

Tämä tietokantaobjekti voi palauttaa seuraavat sarakkeet:

Sarakkeen nimi Tyyppi Kuvaus
OBJECTTYPEID Varchar Objektityypin tunnus (esim. yhteystiedot on 0-1).
OBJECTID Numero Tietueen tunnus (esim. yhteystietue, jonka tunnus on 123752).
NAME Varchar Kiinteistön nimi.
VALUE Aikaleima Kiinteistön arvo.
UPDATEDAT Aikaleima Päivämäärä ja kellonaika, jolloin tiedot on viimeksi päivitetty HubSpotissa. Lisätietoja sarakkeen tietotyypeistä.
INGESTEDAT Aikaleima Päivämäärä ja kellonaika, jolloin Snowflake on viimeksi syöttänyt tiedot.

Esimerkki 1

Hae yksittäisen yhteystiedon yksittäisen ominaisuuden historia.

Kysely:


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


Palaa:

OBJECTID NIMI ARVO UPDATEDAT

136493192

hs_predictivescoringtier

taso_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

...

...

...

...

Esimerkki 2

Hae kaikkien niiden yhteystietojen nykyinen nimi, joiden elinkaaren vaihe on ollut Subscriber.

Kysely:


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


Palaa:

OBJECTID ESIMERKKI LASTNAME
54325098 Hobbes Paroni
96805401 Milo Kulta
6922028 Henry Riley
... ... ...

Yhdistyskyselyt

Kuten objektitiedot, myös assosiaatiotiedot on järjestetty kahdella tavalla:

  • Yksilö: Kukin assosiaatiotyyppi tallennetaan omaan näkymäänsä, ja se sisältää vain kyseisen tyypin tietueita. Esimerkiksi associations_contacts_to_deals sisältää vain yhteystietoja yhteystieto- ja sopimusobjektien välillä. Tämä poistaa tarpeen määrittää associationtypeid-tunnus kyselyssä. Näitä näkymiä on melko helppo kysyä, koska niiden käyttäminen ei edellytä CRM-tietomallin tuntemusta. Ne palauttavat myös kahden objektin välisen assosiaatiotietueen rikastetun kuvauksen, jota voidaan helposti käyttää yhdistämisessä objects_x-näkymien kanssa. Niin kauan kuin kyselyt eivät ole hitaita, on suositeltavaa käyttää näitä näkymiä assosiaatiotietojen hakemiseen. Katso lisätietoja associations_x_to_y-näkymistä jäljempänä.
  • Yhdistetty: Kaikkien assosiaatiotyyppien kaikki tietueet yhdistetään yhdeksi tietokantaobjektiksi. Näin ollen kyselyssä on määritettävä suodatin, kuten "WHERE combinedassociationtypeid='0-32' ". Katso lisätietoja assosiaatioista ja association_definitions-luokituksista jäljempänä.

associations_x_to_y näkymät

Jokaisella assosiaatiotyypillä on oma näkymä, joka on merkitty nimellä associations_<association type name>, esimerkiksi associations_contacts_to_deals. Kukin näkymä on osajoukko assosiaatioiden tietokantaobjektin tiedoista, ja se sisältää vain tietueet, jotka kuuluvat tiettyyn yhdistettyyn assosiaatioiden tyyppitunnukseen.

Kukin tietokantaobjekti palauttaa seuraavat sarakkeet:

Sarakkeen nimi

Tyyppi

Kuvaus

COMBINEDASSOCIATIONTYPEID

Varchar

Yhdistyksen määritelmän yksilöllinen tunniste.

ASSOCIATIONCATEGORY

Varchar

Assosiaatiotyypin lähde. Yksi seuraavista: HUBSPOT_DEFINED, USER_DEFINED, INTEGRATOR_DEFINED.

ASSOCIATIONTYPEID

Varchar

Yhdistelmämääritelmän yksilöllinen tunniste tietyssä yhdistelmäluokassa, eli kahdella yhdistelmäluokan määritelmällä ei ole samaa associationtypeid-tunnusta.

FROMOBJECTTYPEID

Varchar

Objektityyppitunnus, joka on assosiaatiomäärittelyn lähde.

FROMOBJECTTYPE

Varchar

Sen objektityypin nimi, joka on assosiaatiomäärityksen lähde.

TOOBJECTTYPEID

Varchar

Objektityyppitunnus, joka on assosiaatiomäärityksen kohde.

TOOBJECTTYPE

Varchar

Sen objektityypin nimi, joka on assosiaatiomäärityksen kohde.

NIMI

Varchar

Yhdistyksen määritelmän nimi.

LABEL

Varchar

Yhdistyksen määritelmän kuvaus.

ISMAINASSOCIATIONDEFINITION

Boolean

Onko assosiaatiomääritelmä päätyyppi. Kun määritelmä on true, HubSpot näyttää sen assosioituneissa tietueissa.

[FROMOBJECTTYPE_OBJECTID] esim. ASSOCIATIONS_CONTACTS_TO_DEALS-näkymässä tämä on CONTACT_OBJECTID.

Numero

Lähdeobjektin objektitunnus.

[TOOBJECTTYPE_OBJECTID] esim. ASSOCIATIONS_CONTACTS_TO_DEALS-näkymässä tämä on DEAL_OBJECTID.

Numero

Kohdeobjektin kohdetunnus.

INGESTEDAT

Aikaleima

Päivämäärä ja kellonaika, jolloin Snowflake on viimeksi syöttänyt tiedot.

Esimerkki 1

Hae kaikki tiettyyn yhteystietoon liittyvät sopimukset.

Kysely:


SELECT
contact_objectId, deal_objectId

FROM associations_contacts_to_deals (yhdistykset_yhteydenotot_kauppoihin)

WHERE contactId = 6626541373

Palaa:

CONTACT_OBJECTID

DEAL_OBJECTID

6626541373

233620335

6626541373

90253678

Esimerkki 2

Hae kaikki Bogotan aikavyöhykkeellä olevat kontaktit ja heidän tarjouksensa.


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

YHTEYSHENKILÖN_ETUNIMI

YHTEYSHENKILÖN_SUKUNIMI

YHTEYSTIEDOT_EMAIL

DEAL_TYPE

DEAL_AMOUNT

David

Magalhães

dmagalhaes@example.com

newbusiness

74848

Fernanda

Rodrigues

fmoreira@example.com

newbusiness

253530

Esimerkki 3

Hae kaikki yhteystiedot ja kunkin yhteystiedon suljettujen kauppojen kokonaissumma.


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

Palaa:

TOTAL_CLOSED_AMOUNT

YHTEYSTIEDOT_EMAIL

98474793

johndoe@riverview.com

849488

sallymae@longford.com

association_definitions

Tämä tietokantaobjekti sisältää tietoja kaikista HubSpot-objektien välisistä käytettävissä olevista assosiaatiotyypeistä, ja jokaisesta assosiaatiotyypistä on yksi rivi. Voit liittää tämän tietokantaobjektin associations-tietokantaobjektiin saadaksesi tietuekohtaisia assosiaatiotietoja.

Samojen objektien välillä voi olla useita erilaisia assosiaatioita. Tärkein assosiointityyppi, joka näkyy HubSpotissa, kun tietueet yhdistetään, on assosiaatio, jossa ISMAINASSOCIATIONDEFINITION on true.

Tämä tietokantaobjekti voi palauttaa seuraavat sarakkeet:

Sarakkeen nimi Tyyppi Kuvaus
COMBINEDASSOCIATIONTYPEID Varchar Yhdistyksen määritelmän yksilöllinen tunniste.
CATEGORY Varchar Assosiaatiotyypin lähde. Yksi seuraavista: HUBSPOT_DEFINED, USER_DEFINED, INTEGRATOR_DEFINED
ID Numero Luokkaan kuuluvan assosiaatiomääritelmän tunniste.
FROMOBJECTTYPEID Varchar Sen objektin ID, joka on assosiaatiomäärityksen lähde.
TOOBJECTTYPEID Varchar Sen kohteen ID, joka on assosiaatiomäärityksen kohde.
NAME Varchar Yhdistyksen määritelmän nimi.
LABEL Varchar Assosiointimääritelmän nimike.
ISMAINASSOCIATIONDEFINITION Boolean Onko assosiaatiomääritelmä päätyyppi. Kun määritelmä on true, HubSpot näyttää sen assosioituneissa tietueissa.
INGESTEDAT Aikaleima Päivämäärä ja kellonaika, jolloin Snowflake on viimeksi syöttänyt tiedot. Lisätietoja sarakkeiden tietotyypeistä.

Esimerkki 1

Hae tililläsi käytettävissä olevat yhdistystyypit.

Kysely:


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


Palaa:

YHDISTETTY YHDISTYSTYYPPI FROMOBJECTTYPEID TOOBJECTTYPEID NIMI
0-1 0-1 0-2 CONTACT_TO_COMPANY
0-2 0-2 0-1 COMPANY_TO_CONTACT
0-3 0-3 0-1 DEAL_TO_CONTACT
0-4 0-1 0-3 CONTACT_TO_DEAL
0-5 0-3 0-2 DEAL_TO_COMPANY
... ... ... ...

Esimerkki 2

Hae käytettävissä olevat kauppojen ja yritysten väliset assosiaatiotyypit.

Kysely:


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

ORDER BY category, id


Palaa:

YHDISTETTY YHDISTYSTYYPPI FROMOBJECTTYPEID TOOBJECTTYPEID NIMI
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

yhdistykset

Tämä tietokantaobjekti sisältää tietoja tiettyjen tietueiden välisistä yhteyksistä. Jokainen rivi edustaa yhden objektin ja toisen objektin välistä yhteyttä. Tässä tietokantaobjektissa voi olla rivejä, vaikka tietueet, joihin viitataan, on poistettu. Voit tarkistaa, onko tietueita olemassa liittymällä objektitauluun.

Tämä tietokantaobjekti voi olla hyödyllinen, jos tililläsi on suuri määrä tietoja, minkä vuoksi associations_x_to_y-näkymät toimivat hitaasti.

Tämä tietokantaobjekti voi palauttaa seuraavat sarakkeet:

Sarakkeen nimi Tyyppi Kuvaus
COMBINEDASSOCIATIONTYPEID Varchar Yhdistyksen määritelmän yksilöllinen tunniste.
FROMOBJECTID Numero Lähdeobjektin ID.
TOOBJECTID Numero Kohdeobjektin ID.
INGESTEDAT Aikaleima Päivämäärä ja kellonaika, jolloin Snowflake on viimeksi syöttänyt tiedot. Lisätietoja sarakkeiden tietotyypeistä.

Esimerkki 1

Hae kaikki niihin liittyvät sopimukset ja yhteystiedot.

Kysely:


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


Palaa:

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

Esimerkki 2

Hae kaikki tiettyyn yhteyshenkilöön (yhteyshenkilön tunnus: 3005) liittyvät liput.

Kysely:


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


Palaa:

YHDISTETTY YHDISTYSTYYPPI FROMOBJECTID TOOBJECTID
0-5 6626541373 233620335

Esimerkki 3

Hae kaikki tiettyyn yhteyshenkilöön (yhteyshenkilön tunnus: 4464) liittyvät sopimukset. Tässä esimerkissä yhdistetään combinedAssociationTypeId-koodin sijasta association_definitions.

Kysely:


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;


Palaa:

COMBINEDASSOCIATIONTYPEID FROMOBJECTID TOOBJECTID
0-5 6626541373 233620335

Omistajan kyselyt

omistajat

Tämä tietokantaobjekti sisältää tietoja HubSpot-tilisi käyttäjistä. Käyttäjät voidaan asettaa tietueen omistajiksi, ja ne sisältävät sekä käyttäjätunnuksen että omistajatunnuksen, riippuen niiden kontekstista. Molempia tunnuksia voidaan käyttää saman käyttäjän tunnistamiseen.

Tämä tietokantaobjekti voi palauttaa seuraavat sarakkeet:

Sarakkeen nimi Tyyppi Kuvaus
OWNERID Numero Käyttäjän omistajatunnus.
USERID Numero Käyttäjän käyttäjätunnus. Käyttäjät, joilla on NULL tässä sarakkeessa, on poistettu.
EMAIL Varchar Käyttäjän sähköpostiosoite.
FIRSTNAME Varchar Käyttäjän etunimi.
LASTNAME Varchar Käyttäjän sukunimi.
ARCHIVED Boolean Onko käyttäjä poistettu.
CREATEDAT Aikaleima Päivämäärä ja kellonaika, jolloin käyttäjä luotiin HubSpotissa. Katso lisätietoja sarakkeen tietotyypeistä.
UPDATEDAT Aikaleima Päivämäärä ja kellonaika, jolloin käyttäjä on viimeksi päivitetty HubSpotissa. Katso lisätietoja sarakkeen tietotyypeistä.
INGESTEDAT Aikaleima Päivämäärä ja kellonaika, jolloin Snowflake on viimeksi syöttänyt tiedot.

Esimerkki 1

Hae kaikki käyttäjät. WHERE archived = false -suodatin poistaa poistetut käyttäjät palautetuista tiedoista.

Kysely:


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


Palaa:

OWNERID USERID SÄHKÖPOSTI ESIMERKKI LASTNAME
29584574 4621126 233620335 Hobbes Paroni
30532717 4874784 3866015468 Pablo Walters
30580321 925511 7132752747 Milo Kulta
... ... ... ... ...

Esimerkki 2

Hae tietty omistaja hänen omistajatunnuksensa perusteella.

Kysely:


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


Palaa:

OWNERID USERID SÄHKÖPOSTI ESIMERKKI LASTNAME
29584574 4621126 233620335 Hobbes Paroni

Esimerkki 3

Hae kaikki yhteystiedot ja niiden omistajat. Tämä kysely yhdistää tietueet omistajiin object_with_object_properties- ja yhteystiedon hubspot_owner_id-ominaisuudella.


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


Palaa:

CONTACTID YHTEYSHENKILÖN_ETUNIMI YHTEYSHENKILÖN_SUKUNIMI CONTACT_HUBSPOT_OWNER_ID OMISTAJA_ETUNIMI OWNER_LASTNAME OWNER_EMAIL
113834202 Richard Greenfield 29584574 Hobbes Paroni hobbes.b@business.com
53540801 Ford Karl 30241125 Milo Kulta milo.g@business.com
... ... ... ... ... ... ...

Joukkueen kyselyt

joukkueet

HubSpotin tiimien avulla voit järjestää käyttäjät ryhmiin organisointi- ja raportointitarkoituksiin. Sinulla voi olla päätiimi ja ylimääräisiä tiimejä.

Tämä tietokantaobjekti sisältää tietoja HubSpot-tilisi tiimeistä.

Tämä tietokantaobjekti voi palauttaa seuraavat sarakkeet:

Sarakkeen nimi Tyyppi Kuvaus
TEAMID Numero Joukkueen tunnus.
TEAMNAME Varchar Joukkueen nimi.
PARENTTEAMID Numero Vanhempien joukkueiden joukkueen tunnus.
CHILDTEAMIDS Array Lapsijoukkueiden joukkueen tunnukset.
PRIMARYOWNERMEMBERS Varchar Tiimin ensisijaisten jäsenten omistajatunnukset.
TOISSIJAISET OMISTAJÄSENET Boolean Tiimin toissijaisten jäsenten omistajatunnukset.
INGESTEDAT Aikaleima Päivämäärä ja kellonaika, jolloin Snowflake on viimeksi syöttänyt tiedot.

Esimerkki 1

Hae kaikki joukkueet.

Kysely:

SELECT teamId,teamName, primaryOwnerMembers

FROM joukkueet

Palaa:

TEAMID TEAMNAME PRIMARYOWNERMEMBERS
29584574 Alaryhmä [233620335, 1234553]
30532717 Super Team [3866015468, 126221873]
3058032 Tiimi [7132752747]

omistaja_tiimi

Tämä tietokantaobjekti sisältää tietoa siitä, mitkä omistajat vastaavat mitäkin tiimiä HubSpot-tililläsi.

Tämä tietokantaobjekti voi palauttaa seuraavat sarakkeet:

Sarakkeen nimi Tyyppi Kuvaus
TEAMID Numero Joukkueen tunnus.
OWNERID Numero Käyttäjän omistajatunnus.
ISTEAMPRIMARY Boolean Onko tämä joukkue tämän omistajan ensisijainen joukkue.
INGESTEDAT Aikaleima Päivämäärä ja kellonaika, jolloin Snowflake on viimeksi syöttänyt tiedot.

Esimerkki 1

Hae kaikki tietyn joukkueen omistajat.

Kysely:

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

Palauttaa

TEAMID TEAMNAME ISTEAMPRIMARY
29584574 233620335 TRUE
29584574 1234553 TRU E

Putkiston kyselyt

Alla kerrotaan, miten voit kysyä kauppoja ja lippuja koskevia putkitietoja, kuten tililläsi käytettävissä olevia putkia ja niiden vaiheita.

Voit yhdistää nämä tiedot objektitietoihin, jotta saat kokonaiskuvan putkistoista. Voit esimerkiksi kysyä kauppoja ja niiden putkistoja yhdistämällä objects_deals_view- tai object_with_object_properties-tiedot putkistotietoihin.

putkistot

Tämä tietokantaobjekti sisältää tietoja tilisi sopimus- ja lippuputkista. Jokainen palautettu rivi edustaa yhtä putkea.

Tämä taulukko voi palauttaa seuraavat sarakkeet:

Sarakkeen nimi Tyyppi Kuvaus
PIPELINEID Varchar Putkilinjan tunnus.
OBJECTTYPEID Varchar Sen kohteen ID, jonka putki voi sisältää (esim. tarjoukset tai liput).
LABEL Varchar Putken nimi HubSpotissa.
DISPLAYORDER Numero Järjestys, jossa putki näytetään HubSpotissa.
ARCHIVED Boolean Onko putkisto poistettu.
CREATEDAT Aikaleima Kun putki luotiin.
UPDATEDAT Aikaleima Päivämäärä ja kellonaika, jolloin tiedot on viimeksi päivitetty HubSpotissa. Lisätietoja sarakkeen tietotyypeistä.
INGESTEDAT Aikaleima Päivämäärä ja kellonaika, jolloin Snowflake on viimeksi syöttänyt tiedot.

Esimerkki 1

Hae kaikki käytettävissä olevat kauppaputket järjestyksessä niiden järjestyksen mukaan HubSpotissa.

Kysely:


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


Palaa:

OBJECTTYPEID PIPELINEID LABEL
0-3 1bed503c-37f7-4f51-9d40-7598902673f4 Myyntiputki
0-3 12659678 Lisenssit Pipeline
0-3 75e28846-ad0d-4be2-a027-5e1da6590b98 Uudet asiat
... ... ...

Esimerkki 2

Hae tietyn putken sisällä olevat kaupat. Yhdistää object_with_object_properties ja putkistot.

Kysely:


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


Palaa:

DEAL_ID DEAL_NAME PIPELINE_NAME
605140072 Meowmix maailmanlaajuinen rekisteröityminen Myyntiputki
605457408 Friskies Rebrand Myyntiputki
604362473 Fresh Step -sovelluksen rakentaminen Myyntiputki

Esimerkki 3

Sama kuin esimerkki 2 edellä, hae tietyn putken sisällä olevat kaupat. Mutta sen sijaan, että käyttäisit objects_dealsia yhdistämisessä, käytä object_with_object_propertiesia.


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

Palaa:

DEAL_ID

DEAL_NAME

PIPELINE_NAME

605140072

Meowmix maailmanlaajuinen rekisteröityminen

Myyntiputki

605457408

Friskies Rebrand

Myyntiputki

604362473

Fresh Step App Build

Myyntiputki

pipeline_stages

Tämä näkymä sisältää tietoja yksittäisistä vaiheista putkiston sisällä. Tunnista vaiheet yhdistämällä objektityypin tunnus, putkiston tunnus ja vaiheen tunnus. Kun yhdistät putkistoja, käytä objektityypin ID:tä ja putkiston ID:tä.

Tämä tietokantaobjekti voi palauttaa seuraavat sarakkeet:

Sarakkeen nimi Tyyppi Kuvaus
PIPELINEID Varchar Putkilinjan tunnus.
STAGEID Varchar Näyttämön tunnus.
LABEL Varchar Vaiheen nimi HubSpotissa.
DISPLAYORDER Numero Järjestys, jossa putki näytetään HubSpotissa.
METADATA Vaihtoehto JSON-muotoinen kuvaus vaiheesta ja siitä, onko se avoinna vai suljettu.
ARCHIVED Boolean Onko putkiston vaihe poistettu.
CREATEDAT Aikaleima Kun putkistovaihe luotiin.

Esimerkki 1

Hae myyntiputken vaiheet myyntiputkelle nimeltä Myyntiputki.

Kysely:


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;


Palaa:

PIPELINEID STAGEID LABEL
941650 941651 Yhteydenotot
941650 941652 Sovittu tapaaminen
941650 941653 Laskun lähettäminen
... ... ...

Esimerkki 2

Hae kaikki kaupat ja niiden valmisteluvaiheet.

Kysely:


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


Palaa:

DEAL_ID DEAL_NAME PIPELINE_NAME PUTKISTON_VAIHEEN_NIMI
605140072 Meowmix maailmanlaajuinen rekisteröityminen Myyntiputki Lähetetty sopimus
605457408 Friskies Rebrand Myyntiputki Sovittu tapaaminen
604362473 Fresh Step -sovelluksen rakentaminen Myyntiputki Allekirjoitettu sopimus
... ... ... ...

Kiinteistökyselyt

property_definitions

Tämä tietokantaobjekti sisältää tietoja HubSpot-tilisi objekti- ja tapahtumaominaisuuksista. Tapahtumaominaisuuksiin kuuluvat vakiotapahtumat, kuten sähköpostin avaukset ja napsautukset, sekä mukautetut käyttäytymiseen liittyvät tapahtumaominaisuudet. Nämä tiedot voivat olla hyödyllisiä määriteltäessä arvoja, jotka löytyvät object_properties- ja events-tiedoista.

Voit tunnistaa tietyt ominaisuudet yhdistämällä niiden objektityypin tunnuksen ja nimen. Voit hakea samanlaisia tietoja Properties API:n avulla.

Tämä tietokantaobjekti voi palauttaa seuraavat sarakkeet:

Sarakkeen nimi Tyyppi Kuvaus
OBJECTYPEID Varchar Sen objektin ID, johon tapahtuma liittyy.
NAME Varchar Ominaisuuden sisäinen nimi.
LABEL Varchar Ominaisuuden etiketti.
DESCRIPTION Varchar Kiinteistön kuvaus.
TYPE Varchar Ominaisuuden tyyppi (esim. merkkijono, numero, datetime).
FIELDTYPE Varchar Ominaisuuden kenttätyyppi. Määrittää, miten ominaisuus näkyy HubSpotissa ja lomakkeissa (esim. valintaruutu, valinta).
DISPLAYORDER Numero Ominaisuuden näyttöjärjestys.
GROUPNAME Varchar Ominaisuuden ryhmän nimi.
OPTIONS Vaihtoehto Luettelo-ominaisuuksien osalta joukko ominaisuuden vaihtoehtoja, mukaan lukien kunkin vaihtoehdon attribuutit (esim. näyttöjärjestys, merkintä).
CREATEDUSERID Numero Ominaisuuden luoneen käyttäjän tunnus.
REFERENCEDOBJECTTYPE Varchar Sen objektin tyyppi, johon ominaisuus viittaa. Omistajan ominaisuudet palauttavat arvon OWNER.
CALCULATED Boolean Onko ominaisuus laskettu ominaisuus.
EXTERNALOPTIONS Boolean Onko ominaisuuden vaihtoehdot määritelty ulkoisessa järjestelmässä.
HASUNIQUEVALUE Boolean Ovatko ominaisuuden arvot ainutlaatuisia. Voidaan asettaa vain luotaessa ominaisuutta API:n kautta.
HIDDEN Boolean Onko ominaisuus piilotettu HubSpotissa.
SHOWCURRENCYSYMBOL Boolean Muotoillaanko lukuominaisuuden arvo valuuttana.
FORMFIELD Boolean Voidaanko tätä ominaisuutta käyttää lomakkeissa.
READONLYDEFINITION Boolean Voidaanko ominaisuutta muokata HubSpotissa.
READONLYVALUE Boolean Voidaanko ominaisuuden arvoa muokata HubSpotissa.
HUBSPOTDEFINED Boolean Onko ominaisuus luotu HubSpotin toimesta vai käyttäjän toimesta.
ARCHIVED Boolean Onko ominaisuus poistettu.
CREATEDAT Aikaleima Päivämäärä ja kellonaika, jolloin ominaisuus luotiin HubSpotissa.
UPDATEDAT Aikaleima Päivämäärä ja kellonaika, jolloin tiedot on viimeksi päivitetty HubSpotissa. Lisätietoja sarakkeen tietotyypeistä.
INGESTEDAT Aikaleima Päivämäärä ja kellonaika, jolloin Snowflake on viimeksi syöttänyt tiedot.

Esimerkki 1

Hae kaikkien yhteyshenkilöiden ominaisuuksien nimet ja kuvaukset.

Kysely:


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


Palaa:

NIMI LABEL KUVAUS
entered_sql_stage SQL-vaiheeseen siirtyminen Aloituslaskenta SQL-vaiheen päivät.
first_conversion_event_name
Ensimmäinen muuntaminen Ensimmäinen lomake, jonka tämä yhteyshenkilö lähetti.
osoite Katuosoite Yhteyshenkilön osoite.

Tapahtumakyselyt

Tapahtumat sisältävät HubSpotin vakiotapahtumia ja mukautettuja käyttäytymistapahtumia. Jokaisella tapahtumalla on oma tietokantaobjekti, joka on merkitty nimellä events_eventname.

Nimi
EVENTS_AD_INTERACTION Tiedot mainoksesta ja yhteystiedoista, jotka ovat olleet vuorovaikutuksessa sen kanssa klikkaamalla mainosta tai lähettämällä lomakkeen sen jälkeen, kun ne ovat olleet vuorovaikutuksessa sen kanssa.
EVENTS_AD_METRICS_IMPORTED_V0

Tiedot mainoksesta ja sen suorituskykymittareista.
EVENTS_CALL_MAINITTU_AVAINSANA Yksityiskohtaiset tiedot avainsanoista, jotka kaikki puheluihin osallistuneet ovat maininneet.
EVENTS_CLICKED_LINKKI_ SÄHKÖPOSTISSA_V2

Yhteyshenkilöiden markkinointisähköposteissa napsauttamat linkit.
EVENTS_CLICKED_LINKKI_JÄLJITELLYSSÄ_POSTILAATIKOSSA_V8 Yhteyshenkilöiden napsauttamat linkit Keskustelut Saapuneet sähköpostit -sähköpostiviesteissä.
EVENTS_COOKIE_BANNER_CLICKED Yhteystiedot, jotka napsauttivat evästeitä.
EVENTS_COOKIE_BANNER_VIEWED Yhteystiedot, jotka katsoivat evästeitä.
EVENTS_DOCUMENT_SHARED_V2 Myyntiasiakirjat, jotka jaetaan yhteystietojen kanssa ulkoisen linkin kautta.
EVENTS_DOCUMENT_VIEWED_V2 Myyntiasiakirjat ja yhteystiedot, joita he ovat katsoneet avaamalla ulkoisen linkin.
EVENTS_DOCUMENT_COMPLETED_V2 Myyntiasiakirjat ja kontaktit, jotka ovat sulkeneet ne.
EVENTS_HS_SCHEDULED_EMAIL_V2 HubSpotin sähköpostipalvelimille lähetettävät sähköpostit.
EVENTS_MTA_DELIVERED_EMAIL_V2 HubSpotin sähköpostipalvelimet toimittivat sähköpostit onnistuneesti vastaanottajille.
EVENTS_MTA_BOUNCED_EMAIL_V2 Sähköpostin toimitusyritykset, jotka vastaanottajan sähköpostipalvelin hylkäsi.
EVENTS_OPENED_EMAIL_V2 Sähköpostin avaaminen yhteystietojen mukaan.
EVENTS_REPORTED_SPAM_EMAIL_V2 Vastaanottajien roskapostiksi merkitsemät sähköpostit.
EVENTS_UPDATED_EMAIL_SUBSCRIPTION_STATUS_V2 Vastaanottajien tekemät muutokset sähköpostitilauksiin.
EVENTS_OPENED_TRACKED_INBOX_EMAIL_V8 Conservations Inbox -sähköpostilaatikon avaukset yhteystietojen mukaan.
EVENTS_MB_MEDIA_PLAYED Videon toistotoiminta yhteystietojen mukaan.
EVENTS_V2_CONTACT_BOOKED_MEETING_THROUGH_SEQUENCE (TAPAHTUMAT_V2_YHTEYDENOTTO_VARATTU_KOKOUS) Yhteyshenkilö varasi kokouksen sekvenssin kautta.
EVENTS_V2_CONTACT_ENROLLED_IN_SEQUENCE (TAPAHTUMAT_V2_YHTEYSTIEDOT_KIRJATTU_JÄRJESTYKSEEN) Yhteydenotto kirjattu sarjasta.
EVENTS_V2_CONTACT_FINISHED_SEQUENCE (TAPAHTUMAT_V2_YHTEYDENOTTO_VALMISTUNUT_JAKSO) Jakso päättyi.
EVENTS_V2_CONTACT_REPLIED_SEQUENCE_EMAIL Yhteyshenkilö vastasi sähköpostiin (tai saapuvaan sähköpostiin, joka poisti sarjan), joka lähetettiin sarjan kautta.
EVENTS_V2_CONTACT_UNENROLLED_FROM_SEQUENCE (TAPAHTUMAT_V2_YHTEYSTIEDOT_EI_KIRJAUTUNUT_JAKSOSTA) Yhteyshenkilö poistui sarjasta.
EVENTS_V2_CONTACT_UNENROLLED_MANUALLY_FROM_SEQUENCE (TAPAHTUMAT_V2_YHTEYSTIEDOT_EI_MANUAALISESTI_JAKSOSTA) Käyttäjä poisti yhteystiedon manuaalisesti.
EVENTS_V2_CONTACT_UNSUBSCRIBED_SEQUENCE_EMAIL Yhteyshenkilö peruutti tilauksen ja poisti sarjan rekisteröinnin.
EVENTS_V2_SEQUENCE_EMAIL_BOUNCED Sequence-sähköposti kimposi.
EVENTS_V2_SEQUENCE_ERRORED Sequence errored causing unrerollment.
EVENTS_V2_SEQUENCE_STEP_EXECUTED (TAPAHTUMAT_V2_JAKSO_ASKEL_SUORITETTU) Sequence step executed.
EVENTS_VISITED_PAGE Verkkosivuston sivukäynnit yhteystietojen mukaan.
EVENTS_<INTEGRAATION_TAPAHTUMAN_NIMI>_<YKSILÖLLINEN_TUNNISTE> Integrointitapahtumat(Timeline V3 API)

Voit tunnistaa tapahtumat yhdistämällä niiden tapahtumatyypin ID:n ja ID:n. Palautettavat sarakkeet riippuvat tapahtumasta, ja jokaiselle tapahtuman ominaisuudelle on yksi sarake. Kaikki tapahtumat palauttavat seuraavat sarakkeet:

Huomaa: HubSpot on lisännyt kaksi uutta saraketta kaikkiin tapahtumataulukoihin ja -näkymiin:

  • occurredat
  • occurredatdateint

Nämä sarakkeet korvaavat sarakkeet occuredat ja occuredatdateint 24. marraskuuta 2022. Kyseisenä päivänä vanhat sarakkeet eivät ole enää käytettävissä, ja yritykset kysyä tietokantaobjekteja tai näkymiä, jotka sisältävät tapahtumia näiden sarakkeiden avulla, epäonnistuvat. Lisätietoja Snowflake-tietojakojen rikkoutuvista muutoksista.



Sarakkeen nimi Tyyppi Kuvaus
EVENTTYPEID Varchar Tapahtumatyypin tunnus, samanlainen kuin OBJECTTYPEID.
Voit kysyä kaikkia tililläsi olevia tapahtumatyyppien tunnuksia käyttämällä object_and_event_type_definitions-näkymää.
ID Varchar Tämä on ainutkertainen tapahtumatyypeittäin. Kahdella tietueella ei ole samaa tunnusta tietyn tapahtumatyypin sisällä.
OBJECTTYPEID Varchar Tapahtuman päättäneen objektin tyyppi. Esimerkiksi sähköpostilinkin napsautus näyttää tässä sarakkeessa 0-1, joka edustaa yhteystieto-objektia.
OBJECTID Numero Tapahtuman päättäneen tietueen ID.
OCCURREDAT Aikaleima Milloin tapahtuma tapahtui.

OCCURREDATDATEINT

Numero Numero, joka kuvaa tapahtuman ajankohtaa. Sisältää samat tiedot kuin OCCURREDAT -sarake, mutta se on muotoiltu numeroksi ja sitä käytetään osana taulukon klusteriavainta. Useimmissa tapauksissa voit käyttää tämän numeron sijasta OCCURREDAT -aikaleimaa.

OCCUREDATDATEINT

Numero

Numero, joka kuvaa tapahtuman ajankohtaa. Sisältää samat tiedot kuin OCCURREDAT -sarake, mutta se on muotoiltu numeroksi ja sitä käytetään osana taulukon klusteriavainta. Useimmissa tapauksissa voit käyttää tämän numeron sijasta OCCURREDAT -aikaleimaa.

Huomaa: tämä sarake poistetaan käytöstä 24. marraskuuta 2022 ja korvataan osoitteella OCCURREDATDATEINT.

OCCUREDAT Aikaleima

Milloin tapahtuma tapahtui.

Huomaa: tämä sarake poistetaan käytöstä 24. marraskuuta 2022 ja korvataan osoitteella OCCURREDAT.

INGESTEDAT Aikaleima Päivämäärä ja kellonaika, jolloin Snowflake on viimeksi syöttänyt tiedot. Lisätietoja sarakkeen tietotyypeistä.
PROPERTY_* Varchar Yksittäiset sarakkeet, jotka sisältävät tapahtuman ominaisuudet.

Esimerkki 1

Hae 50 viimeisintä sähköpostin napsautustapahtumaa.

Kysely:


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;


Palaa:

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

Esimerkki 2

Hae kaikki sähköpostin napsautustapahtumat napsauttaneiden yhteyshenkilöiden mukaan. Tämä kysely saa yhteystietoja yhdistämällä ne object_with_object_properties-olion kanssa.

Kysely:


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;


Palaa:

CLICK_TIMESTAMP CLICK_URL YHTEYSHENKILÖN_ETUNIMI YHTEYSHENKILÖN_SUKUNIMI
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 Paroni
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 Kulta
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_quies (esine- ja tapahtumatyypin kyselyt)

objektin_ja_tapahtuman_tyypin_määrittelyt

Tämä tietokantaobjekti sisältää määritelmät kaikille HubSpot-tililläsi käytettävissä oleville objekteille ja tapahtumille.

Tämä tietokantaobjekti voi palauttaa seuraavat sarakkeet:

Sarakkeen nimi Tyyppi Kuvaus
OBJECTTYPEID Varchar Sen kohteen ID, jonka putki voi sisältää (esim. tarjoukset tai liput).
FULLYQUALIFIEDNAME Varchar Objektin tai tapahtuman nimi.
INGESTEDAT Aikaleima Päivämäärä ja kellonaika, jolloin Snowflake on viimeksi syöttänyt tiedot. Lisätietoja sarakkeiden tietotyypeistä.

Esimerkki 1

Hae kaikki HubSpot-tililläsi käytettävissä olevat kohteet ja tapahtumat.

Kysely:


SELECT objectTypeId, fullyQualifiedName
FROM object_and_event_type_definitions;


Palaa:

OBJECTTYPEID FULLYQUALIFIEDNAME
0-1 YHTEYSTIEDOT
0-8 LINE_ITEM
0-11 KESKUSTELU
... ...

Luettelee kyselyt

Seuraavassa kerrotaan, miten voit tehdä kyselyjä luetteloista, kuten käytettävissä olevista yhteyshenkilö- ja yritysluetteloista ja luetteloihin sisältyvistä tietueista.

luettelot

Tämä tietokantaobjekti sisältää tietoja HubSpotin yhteyshenkilö- ja yritysluetteloista. Palauttaa yhden rivin listaa kohti, ja sarakkeisiin sisältyvät listan tiedot, kuten listan nimi, koko ja sen sisältämien tietueiden objektityyppi. Ei sisällä tietoja kunkin luettelon yksittäisistä tietueista (katso list_membership).

Tämä tietokantaobjekti voi palauttaa seuraavat sarakkeet:

Sarakkeen nimi Tyyppi Kuvaus
OBJECTTYPEID Varchar Luettelon tietueiden tyyppi (esim. yhteyshenkilö tai yritys).
LISTID Numero Luettelon ID. Yhdistetään listan jäsenyys-taulukon LISTID-sarakkeeseen.
CLASSICLISTID Numero Yhteystietoluetteloille ominainen tunnus, joka vastaa HubSpotin luettelon URL-osoitteessa olevaa tunnusta.
NAME Varchar Luettelon nimi.
SIZE Numero Tietueiden määrä luettelossa.
CREATEDBYUSERID Numero Luettelon luoneen käyttäjän tunnus.
CREATEDAT Aikaleima Kun lista luotiin HubSpotissa.
UPDATEDBYUSERID Numero Sen käyttäjän tunnus, joka on viimeksi päivittänyt luettelon.
UPDATEDAT Aikaleima Päiväys ja kellonaika, jolloin päivämäärä on viimeksi päivitetty HubSpotissa. Lisätietoja sarakkeen tietotyypeistä.
INGESTEDAT Aikaleima Päivämäärä ja kellonaika, jolloin Snowflake on viimeksi syöttänyt tiedot.

Esimerkki 1

Hae kaikki yhteystietoluettelot.

Kysely:


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


Palaa:

LISTID NIMI KOKO
118131 Viikoittainen toiminta 103
66156 Blogin tilaajat 455
771852 Parhaat tilaajat 2021 37
... ... ...

Esimerkki 2

Hae tietty yhteystietoluettelo nimeltä Parhaat tilaajat 2021.

Kysely:


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


Palaa:

LISTID NIMI KOKO
771852 Parhaat tilaajat 2021 37

list_membership

Tämä tietokantaobjekti sisältää tietoa siitä, mitkä tietueet ovat minkäkin luettelon jäseniä, ja yksi rivi kutakin luettelon tietuetta kohden. Jos sinulla on esimerkiksi Blogin tilaajaluettelo, jossa on 500 yhteystietoa, tietokantaobjekti palauttaa 500 riviä.

Sisältää vain luettelon tunnukset ja kohteiden tunnukset. Lisätietoja saat liittymällä luettelot-tietokantaobjektiin.

Tämä tietokantaobjekti voi palauttaa seuraavat sarakkeet:

Sarakkeen nimi Tyyppi Kuvaus
LISTID Varchar Luettelon ID. Yhdistetään listataulukon HS_LIST_ID-sarakkeeseen.
OBJECTID Varchar Luettelossa olevan tietueen ID.
UPDATEDAT Aikaleima Päivämäärä ja kellonaika, jolloin tiedot on viimeksi päivitetty HubSpotissa. Lisätietoja sarakkeen tietotyypeistä.
INGESTEDAT Aikaleima Päivämäärä ja kellonaika, jolloin Snowflake on viimeksi syöttänyt tiedot.

Esimerkki 1

Hae kaikkien Top-tilaajat 2021 -luettelossa olevien yhteystietojen tunnukset.

Kysely:


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


Palaa:

OBJECTID
54325098
96805401
6922028
...

Esimerkki 2

Hae etu- ja sukunimet 2021-luettelossa olevien yhteystietojen etu- ja sukunimet.

Kysely:


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'


Palaa:

OBJECTID

ESIMERKKI

SUKUNIMI

54325098

Hobbes

Paroni

96805401

Milo

Kulta

6922028

Henry

Riley

...

...

...

UKK

Haluan luoda tietoja, jotka muistuttavat Hubspot-sovelluksen raporttia, miten teen sen?


Yleisesti ottaen haluat tarkastella vertailtavassa raportissa olevia sarakkeita. Jos raportin visualisointi ei ole taulukkomuotoinen, sen muuntaminen taulukoksi näyttää raportin sisältämät sarakkeet. Nämä sarakkeet ovat yleensä objektityypin tai tapahtumatyypin ominaisuuksia. Seuraava vaihe on selvittää, mitä objektityypin ominaisuutta sarake vastaa. Tämä onnistuu kyselyllä property_definitions:


SELECT * FROM property_definitions

WHERE label = [column_name]

Aina ei välttämättä ole tarkkaa vastaavuutta, koska jotkin ominaisuuksien nimet ratkaistaan yleensä sovelluksessa kuvaavammaksi nimeksi. Tällaisissa tapauksissa epätarkan haun tekeminen käyttämällä LIKE-operaattoria property_definitions-sarakkeen label- (tai jopa description-) sarakkeessa voi auttaa.

Kun on määritetty, mihin objektityyppiin sarake kuuluu, on helppoa määrittää, mitä kysytään. Voit yksinkertaisesti etsiä tyyppiä vastaavaa object_x-näkymää.

Miten linkitän tämän tietotyypin toiseen, esimerkiksi miten haen lomakkeita kampanjaa varten?


Jos haluat yhdistää kaksi tai useampia eri tietueita toisiinsa, tutustu assosiaatioihin. Assosiaatiot edustavat HubSpot CRM:n objektien välisiä suhteita. Kaikki kahden tyypin välillä mahdolliset erilaiset assosiaatiot on lueteltu association_definitions-kohdassa. Yllä olevassa esimerkissä, jos haluat tietää kaikki lomakkeet, joihin kampanja on linkitetty, sinun on kysyttävä ASSOCIATIONS_CAMPAIGNS_TO_FORMS:


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

Miten tiedän HubSpot-Snowflake-integraation tilan?

Jos haluat saada reaaliaikaisia tilapäivityksiä HubSpot-Snowflake-integraation käyttökatkoksista ja ongelmista, tee kysely data_share_status-näkymästä:

SELECT * FROM hubspot.public.data_share_status
LIMIT 1

Tulokset näytetään seuraavasti:

STATUS VIESTI UPDATEDAT
OK TÄLLÄ HETKELLÄ EI OLE TIEDOSSA TAPAHTUMIA 2023-04-10 09:21:20.123

Tässä näkymässä integraation tila päivitetään käänteisessä aikajärjestyksessä. Tämän kyselyn tulosten integroiminen kojelautaan auttaa sinua seuraamaan integraation suorituskykyä ja havaitsemaan mahdolliset käyttökatkokset.

Oliko tästä artikkelista apua?
Tätä lomaketta käytetään vain dokumentaation palautteeseen. Lue, miten saat apua HubSpotin kanssa.