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.
- 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.
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ä.
Jos haluat palauttaa tietyn sarakkeen, sisällytä kyseinen sarake kyselysi SELECT
-kenttään. Esimerkiksi seuraava kysely palauttaa vain sarakkeet OBJECTID
ja UpdatedAt
:
SELECTobjectId, 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 amountFROM 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 |
0-1 |
Tietoja yrityksesi kanssa vuorovaikutuksessa olevista henkilöistä |
|
0-2 |
Tietoa yksittäisistä yrityksistä tai organisaatioista |
|
0-3 |
Yksityiskohtaiset tiedot yhteystiedon tai yrityksen tarjoamista tulonhankintamahdollisuuksista. |
|
0-4 |
Tallentaa tietoja CRM-toiminnoista, mukaan lukien muistiinpanot, tehtävät, sähköpostit, kokoukset ja puhelut. |
|
0-5 |
Edustaa asiakkaiden avun- ja tukipyyntöjä. |
|
0-14 |
Käytetään hintatietojen jakamiseen mahdollisten ostajien kanssa. |
|
0-15 |
HubSpot-lomakkeen yksittäisten lähetysten tiedot. |
|
0-8 |
Edustaa kaupassa myytävien tuotteiden osajoukkoa. Kun tuote liitetään kauppaan, siitä tulee rivikohta. |
|
0-11 |
Yksityiskohdat useista kanavista saapuvista viesteistä. |
|
0-25 |
Laskeutumissivujesi yksityiskohdat |
|
0-27 |
Tallentaa tietoja tehtävälistoista |
|
0-28 |
Käytetään keräämään tietoja kävijöistäsi ja yhteyshenkilöistäsi. |
|
0-29 |
Tiedot markkinointikeskuksesta tulevista sähköposteista |
|
AD_ACCOUNT |
0-30 |
Tallentaa tietoja Linkedinin, Facebookin ja Googlen mainostileistäsi. |
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 |
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 |
0-39 |
Tiedot blogikirjoituksista |
|
0-45 |
Tietoa objektitietueiden ryhmittelystä niiden ominaisuuksien tai toimintojen perusteella. |
|
0-48 |
Muiden CRM-tietueiden, esim. yhteystietojen, soittamat puhelut. |
|
LASKU |
0-53 |
Laskujen hallinta ja synkronointi ulkoisten kirjanpitojärjestelmien kanssa. |
0-57 |
Tiedot Hubspotiin tuoduista mediavaroista |
|
0-58 |
Sekvenssi on sarja kohdennettuja, ajoitettuja sähköpostipohjia, joiden avulla kontakteja hoidetaan ajan mittaan. |
|
0-72 |
Kaupan jakamista käytetään jakamaan kauppahyvityksiä useiden käyttäjien kesken. |
|
0-83 |
Myyntiasiakirjat rakentavat koko tiimillesi sisällön kirjaston, johon voit ladata ja jakaa asiakirjoja yhteystietojesi kanssa. |
|
0-19 |
Tallentaa palautekyselyyn lähetetyt tiedot. |
|
0-69 |
Tilaukset sisältävät tiedot toistuvista maksuista |
|
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:
|
Esimerkki 1
Hae kaikkien yhteystietojen etunimi, sukunimi ja elinkaaren vaihe.
Kysely:
SELECT objectId, property_firstname AS firstname, property_lastname AS lastname,property_lifecyclestage AS lifecyclestageFROM 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 dealAmountFROM 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 dealAmountFROM 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:
SELECTobjectId,
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
WHERE
object_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:
SELECT
combinedAssociationTypeId, fromObjectTypeId, toObjectTypeId, name
FROM association_definitions
WHERE fromObjectTypeId = '0-3' AND toObjectTypeId = '0-2'
AND isMainAssociationDefinition = trueORDER 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:
SELECTdeals.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. |
|
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. |
|
Numero | Numero, joka kuvaa tapahtuman ajankohtaa. Sisältää samat tiedot kuin Huomaa: tämä sarake poistetaan käytöstä 24. marraskuuta 2022 ja korvataan osoitteella |
OCCUREDAT |
Aikaleima | Milloin tapahtuma tapahtui. Huomaa: tämä sarake poistetaan käytöstä 24. marraskuuta 2022 ja korvataan osoitteella |
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'
ANDlistName = '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.