HubSpotin tietojen kysely Snowflakessa

Kun olet yhdistänyt Snowflake-palvelun HubSpot-tiliisi, voit käyttää Snowflake-palvelun Data Share -ominaisuutta HubSpot-tietojen hakua varten Snowflake-tililtäsi.

Tietojen viive ja Snowflake-tilisi alue

Käytössäsi on V2_LIVE-skeema, joka päivitetään 15 minuutin välein, sekä V2_DAILY-skeema, joka päivitetään päivittäin.

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

Määritä Snowflake-ympäristösi

Jos haluat kysellä HubSpot-tietojasi Snowflakessa, sinun on valittava varasto, tietokanta ja skeema, joista haluat kysellä. Voit joko asettaa ne työkirjan tasolla, jolloin ne lisätään automaattisesti kyselyihisi, tai lisätä ne manuaalisesti.

Varaston, tietokannan ja skeeman valitseminen laskentataulukon tasolla:

1. Napsauta työkirjan yläreunassa olevaaTyökirjan toiminnot -palkkia.
   
   
2. Ponnahdusikkunassa:
   • NapsautaVarasto -pudotusvalikkoa ja valitsevarastosi.
   • NapsautaDatabase -pudotusvalikkoa ja valitse HubSpot-tietokanta.
   • NapsautaSchema -pudotusvalikkoa ja valitse sitten haluamasi skeema:
     • V2_DAILY: päivittäinenskeema tietojen hakua varten taulukoiden perusteella. Tämän skeeman tiedot päivitetään kerran päivässä. Tämän skeeman käyttö nopeuttaa hakua, ja sitä suositellaan käytettäväksi suoraan Snowflakessa.
     • V2_LIVE: live-skeema, joka perustuu HubSpot-tietojen suojattuihin näkymiin. Tämän skeeman tiedot päivitetään jopa 15 minuutin välein. Jos haet suurta tietojoukkoa, kyselyt voivat olla hitaita. Tässä tapauksessa on suositeltavaa kopioida tiedot ensin omaan taulukkoon ETL-prosessilla ja hakea sitten kyseisestä taulukosta.
     
     
     

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

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

Tietojen yleiskatsaus

Kyselyt rakennetaan SQL:n avulla, ja niitä voidaan käyttää HubSpot-tietojen hakemiseen, kuten:

• Objektit: vakio- ja mukautetut objektit, kuten yhteystiedot, yritykset, tuotteet. 
• Tietueet: yksittäiset tietueet, kuten yksittäinen yhteyshenkilö tai yritys. 
• Yhdistykset: kaikki käytettävissä olevat yhdistystyypit ja tällä hetkellä yhdistetyt tietueet.
• Tapahtumat: tapahtumatietoja sekä HubSpotin vakiotapahtumista, kuten sähköpostin avaamisista, että mukautetuista käyttäytymistapahtumista.
• Segmentit: HubSpot -yhteyshenkilö- ja yrityssegmentit.
• Omistajat: HubSpot-tilisi käyttäjät suhteessa tietoihin, joiden omistajiksi heidät on asetettu.
• Pipeline: kauppa-ja tikettipipeline, mukaan lukien pipeline-vaiheet.
• Ominaisuudet: CRM-tietueiden ominaisuudet ja niiden arvot, mukaan lukien ominaisuuksien historia.

Lisätietoja HubSpotin CRM-tietomallista. 

Huomaa Kehittäessämme tietojen jakamista tulemme tekemään muutoksia, joista osa on merkittäviä muutoksia. Suosittelemme tilaamaan HubSpotin kehittäjien muutospäiväkirjan. Nämä muutokset julkaistaan aina muutospäiväkirjassa ennen päivitystä.

Palautettujen tietojen rajoittaminen ja järjestäminen

Kyselyjä luodessasi voit hallita palautettavien tietojen määrää ja järjestystä lisäämällä kyselyynLIMIT- ja ORDER BY -komennot. Jos haluat esimerkiksi hakea kaikki yhteystiedot ja niiden ominaisuudet, mutta palauttaa vain kolme tulosta ja järjestää ne yhteystunnuksen mukaan, voit luoda kyselyn seuraavasti:

Sarakkeen tietotyypit

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

Huomaa:tässä asiakirjassa käytämme termiä tietokantaobjekti, kun konteksti koskee sekä taulukoita että näkymiä.

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


SELECTobjectId, updatedAt
FROM objects_contacts



Alla on yleisiä määritelmiä sarakkeille, jotka kysely voi palauttaa. Muita määritelmiä, joita ei ole mainittu alla, on esitetty yksittäisten näkymien määritelmissä yllä olevassa artikkelissa.

• OBJECTTYPEID: VARCHAR-arvo, joka edustaa objektin tyyppiä. Esimerkiksi 0-1 edustaa yhteystietoja, 0-2 edustaa yrityksiä ja 2-1232 voi edustaa tilisi mukautettua objektia. Segmentissä tämä viittaa segmentin tyyppiin (esim. yhteystieto tai yritys). Voit hakea kaikki tilisi objektien ja tapahtumien tunnukset käyttämällä object_and_event_type_definitions -näkymää.
• OBJECTID: BIGINT-luku, joka edustaa yksittäistä tietuetta tietyn tyyppisestä objektista HubSpot-tililläsi. Tietueen tunnistamiseksi sinun on käytettävä sekä objektityypin tunnusta että objektin tunnusta.
• INGESTEDAT: aikaleima, joka kertoo, milloin tietorivi on lisätty Snowflakeen, ilmaistuna TIMESTAMP_NTZ- arvona. Ei liity HubSpotin luomis- tai päivitystoimenpiteen loogiseen aikaleimaan.
  • HubSpotin sisäisen käsittelyn vuoksi rivin syöttöajankohdan aikaleima voi päivittyä, vaikka muut rivin sarakkeet eivät olisi muuttuneet.
  • Kun luot ETL-prosesseja, jotka kopioivat äskettäin muutettuja tietoja, on suositeltavaa perustaa kyselyt tallennuksen aikaleimaan. Lisäksi, jos virta kopioi tietoja päivittäin, on suositeltavaa kopioida kahden edellisen päivän tiedot viivästysten varalta.
• CREATEDAT ja UPDATEDAT: looginen aikaleima, joka kertoo, milloin tiedot on luotu tai päivitetty HubSpotissa, ilmaistuna TIMESTAMP_NTZ-arvona . Nämä aikaleimat vastaavat HubSpotin aikaleimoja. Esimerkiksi HubSpotissa näkyvä tietueen luontipäivämäärä on sama kuin Snowflaken CREATEDAT-sarakkeen aikaleima. Nämä eivät liity suoraan syöttöajankohtaan, eikä ETL-prosessien perustamista näihin ominaisuuksiin suositella.
• COMBINEDASSOCIATIONTYPE: VARCHAR -arvo, joka yksilöi assosiaatiomääritelmän.

Tietotyyppien muuntaminen

Joskus kysely palauttaa tietoja VARCHAR-sarakkeilla, vaikka olisi toivottavaa, että ne olisivat eri tyyppiä. Tällaisissa tapauksissa on suositeltavaa muuntaa VARCHAR-tietotyyppi halutuiksi tyypeiksi Snowflake-funktioiden avulla. Esimerkiksi objektitietueen ominaisuudet tallennetaan useimmissa tietokantaobjekteissa VARCHAR-tietotyyppeinä, mutta joskus ne sisältävät numero- ja päivämäärä- ja aikatietoja. Funktiot kuten
try_to_number, try_to_timestamp_ntz voidaan käyttää muuntamaan nämä VARCHAR-tiedot vastaavasti 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



Objektikyselyt

Alla on ohjeita tietojen hakemisesta tietyistä HubSpot-objekteista ja -tietueista sekä palautettavien tietojen esittely. 

Erilaiset objektitiedot on järjestetty ja saatavilla kahdella tavalla: 

• Yksittäinen:Jokainen objektityyppi tallennetaan omaan näkymäänsä ja sisältää vain saman objektityypin tietueita, esim. objects_contacts sisältää vain yhteystietotietueita. Tämä poistaa tarpeen määrittää objektityyppitunnusta kyselyn yhteydessä. Näitä näkymiä on helpompi kysellä, koska sinun ei tarvitse tietää objektityyppitunnuksia. Ne palauttavat myös tiedot käyttökelpoisemmassa muodossa, jossa jokainen rivi vastaa yhtä 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 kohdasta Objects_X-näkymät alla. 
• Yhdistetty: Kaikkien objektityyppien tietueet yhdistetään yhdeksi tietokantaobjektiksi. Siksi kyselyä tehdessäsi sinun on määritettävä suodatin, kuten ”WHERE objectTypeId=’0-1’”. Voit esimerkiksi käyttää seuraavia objecttypeid-tunnisteita kyselyä tehdessäsi:

Mukautetuille objekteille annetaan tunnus luomisen yhteydessä, ja ne tunnistetaan muodossa2-unique_ID. Esimerkiksi2-12345. Lisätietoja on kohdassa object_and_event_type_definitions.

Nämä tietokantaobjektit sopivat yleensä, jos haluat parempaa kyselytehoa kuin mitä object_x-näkymistä on saatavilla. Katso lisätietoja kohdista object_with_object_properties, object_properties, objects ja object_properties_history alla.

objects_x-näkymät

Tässä tietokantaobjektissa jokaisella käytettävissä olevalla objektityypillä, mukaan lukien mukautetut objektit, on oma näkymänsä, joka sisältää vain kyseisen objektityypin objektien tietueet. Nämä näkymät on nimetty muodossa OBJECTS_<objektityypin nimi>, jossa <objektityypin nimi> on objektityypin monikkomuotoinen nimi. (Huomaa, että jos objektityypillä ei ole monikkomuotoa, <objektityypin nimi> on yksinkertaisesti objektityypin yksikön nimi, johon on liitetty ”S”).

Tähän näkymään tehdyt kyselyt palauttavat yhden rivin jokaisesta objektin tietueesta, ja jokainen objektin ominaisuus on saatavilla erillisenä sarakkeena.

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

Jokainen tietokantaobjekti palauttaa seuraavat sarakkeet:

Esimerkki 1

Hae kaikkien yhteyshenkilöiden etunimi, sukunimi ja elinkaaren vaihe.

Kysely:


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



Tulokset:

Esimerkki 2

Hae enintään kolmen kaupan nimi ja vaihe.

Kysely:


SELECT objectId, property_dealName, property_dealStage,
property_amount AS dealAmount

FROM objects_deals

LIMIT 3

Palauttaa:

Esimerkki 3

Hae kolmen suurimman kaupan nimi ja vaihe.

Kysely:

Koska kaupan summa on saatavilla numerotyyppisenä, sitä voidaan käyttää järjestämiseen ilman muuntamista tai tyyppimuunnosta.


SELECT objectId, property_dealName, property_dealStage,
property_amount AS dealAmount

FROM objects_deals
ORDER BY property_amount DESC
LIMIT 3




Palauttaa:

object_with_object_properties

Tämä tietokantaobjekti sisältää tietoja HubSpot-tietueistasi. Kyselyt tähän tietokantaobjektiin palauttavat yhden rivin jokaisesta objektityypin tietueesta (esim. kaikki yhteystietojen objektityypin yhteystietotietueet). Kaikki ominaisuudet tallennetaan Ominaisuudet- sarakkeeseen, joka on Snowflake Variant / JSON -sarake. 

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

Huomaa 25. tammikuuta 2022 sarakkeessa timestamp taulukossa ja näkymässä object_with_object_properties, joka edustaa päivämäärää ja kellonaikaa, jolloin objektitietue päivitettiin viimeksi HubSpotissa, päivitetään. Tämä tehdään, jotta se vastaa tapaa, jolla päivämäärä- ja aikatiedot esitetään muissa tietojen jakamisissa.

Koska kyseessä on merkittävä muutos, uusi sarake updatedat on lisätty taulukkoon ja näkymään. Seuraavien 90 päivän ajan nämä kaksi uutta saraketta ovat rinnakkain timestamp-sarakkeen kanssa, jonka ne korvaavat. Tämä antaa sinulle mahdollisuuden siirtyä käyttämään uusia sarakkeita.

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

Esimerkki 1

Hae kaikki yhteystiedot ja niiden ominaisuudet.

Kysely:

Palauttaa:

Esimerkki 2

Hae enintään kolmen kaupan nimi ja vaihe.

Kysely:

Palautukset:

objektit

Tämä tietokantaobjekti on osajoukko object_with_object_properties-tietokantaobjektin tiedoista. Jokainen palautettu rivi palauttaa kunkin tietueen objektitunnuksen. Tämä tietokantaobjekti palauttaa vain olemassa olevat tietueet. Kun tietue poistetaan HubSpotista, se poistetaan myös tästä tietokantaobjektista. Tämä tietokantaobjekti on osajoukko object_with_object_properties-taulukon tiedoista. Jokainen palautettu rivi palauttaa objektin tunnuksen jokaiselle tietueelle. Tämä näkymä palauttaa vain olemassa olevat tietueet. Kun tietue poistetaan HubSpotista, se poistetaan myös tästä näkymästä. 

Tämä tietokantaobjekti voi olla hyödyllinen, jos tililläsi on paljon tietoja, mikä hidastaa object_with_object_properties- ja objects_x-näkymien toimintaa. Käyttämällä tätä tietokantaobjektia yhdessä object_properties-tietokantaobjektin kanssa on mahdollista replikoida object_with_object_properties-tietokannan tiedot ja samalla hallita, mitkä ominaisuudet palautetaan.

Tämä tietokantaobjekti voi palauttaa seuraavat sarakkeet:

Esimerkki 1

Hae kaikki yhteystietotietueet.

Kysely:

Palauttaa:

object_properties

Tämä tietokantaobjekti on osa object_with_object_properties-tietokantaobjektia. Jokainen rivi sisältää tietyn tietueen nykyisen ominaisuusarvon. Esimerkiksi yhteystiedolla on yksi rivi etunimen ominaisuudelle ja yksi rivisukunimen ominaisuudelle. Jos tietueella ei ole ominaisuuden arvoa, rivi näkyy joko tyhjänä merkkijonona tai ei näy lainkaan.

Tämä tietokantaobjekti voi palauttaa seuraavat sarakkeet:

Esimerkki 1

Hae kaikkien yhteystietojen etunimi-, sukunimi- ja kaupunkiominaisuudet.

Kysely:

Palauttaa:

Esimerkki 2

Hae kaikkien yhteystietojen etunimi, sukunimi ja elinkaaren vaihe ja yhdistä ne yhdeksi riviksi kutakin yhteystietoa kohti. Tässä esimerkissä käytetään SQL PIVOT -syntaksia.

Kysely:

Palauttaa:

object_properties_history

Tämä tietokantaobjekti sisältää historialliset ominaisuusarvot. Yhteystietojen osalta se sisältää 45 viimeisintä arvoa. Kaikkien muiden objektien osalta se sisältää 20 viimeisintä arvoa. Näyttää rivin jokaiselle historialliselle ominaisuusarvolle. Ominaisuuden nykyinen arvo määräytyy ominaisuuden historian viimeisimmän UPDATEDAT-aikaleimanperusteella.

Tämä tietokantaobjekti voi palauttaa seuraavat sarakkeet:

Esimerkki 1

Hae yhden kontaktin yhden ominaisuuden historia.

Kysely:

 
Palauttaa:

Esimerkki 2

Hae kaikkien kontaktien nykyinen nimi, joilla on joskus ollut tilaajan elinkaaren vaihe.

Kysely:

Palauttaa:

Yhdistelmäkyselyt

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

• Yksilöllinen: Jokainen assosiaatiotyyppi tallennetaan omaan näkymäänsä ja sisältää vain kyseisen tyyppisiä tietueita. Esimerkiksi associations_contacts_to_deals sisältää vain assosiaatiotietueita kontaktien ja kauppojen objektien välillä. Tämä poistaa tarpeen määrittää associationtypeid kyselyn yhteydessä. Näitä näkymiä on melko helppo kysellä, koska niiden käyttö ei vaadi CRM-tietomallin tuntemusta. Ne palauttavat myös rikastetun kuvauksen kahden objektin välisestä assosiaatiotietueesta, 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 alla olevista associations_x_to_y-näkymistä. 
• Yhdistetty: Kaikki kaikkien assosiaatiotyyppien tietueet yhdistetään yhdeksi tietokantaobjektiksi. Siksi kyselyä tehdessäsi sinun on määritettävä suodatin, kuten ”WHERE combinedassociationtypeid=’0-32’ ”. Katso lisätietoja kohdasta associations ja association_definitions alla.

associations_x_to_y-näkymät

Jokaisella assosiaatiotyypillä on oma näkymänsä, joka on nimetty associations_<assosiaatiotyypin nimi> esimerkiksi associations_contacts_to_deals. Jokainen näkymä on osajoukko assosiaatiotietokantaobjektin tiedoista ja sisältää vain tietyn combinedassociationtypeid-tunnuksen tietueet.

Jokainen tietokantaobjekti palauttaa seuraavat sarakkeet:

Esimerkki 1

Hae kaikki tiettyyn yhteyshenkilöön liittyvät kaupat.

Kysely:

Palauttaa:

Esimerkki 2

Hae kaikki Bogotan aikavyöhykkeellä olevat yhteyshenkilöt ja heidän kaupat.

Esimerkki 3

Hae kaikki yhteystiedot ja kunkin yhteystiedon kanssa tehtyjen kauppojen kokonaissumma.

Palauttaa:

association_definitions

Tämä tietokantaobjekti sisältää tietoja kaikista HubSpot-objektien välillä käytettävissä olevista assosiaatiotyypeistä, yksi rivi kutakin assosiaatiotyyppiä kohti. Voit yhdistää tämän tietokantaobjektin assosiaatiotietokantaobjektiin saadaksesi tietueiden assosiaatiotietoja.

Saman objektin välillä voi olla useita assosiaatiotyyppejä. Pääassosiaatiotyyppi, joka on HubSpotissa näkyvä tyyppi, kun tietueet on assosioitu, käyttää assosiaatiota, jossa ISMAINASSOCIATIONDEFINITION on totta.

Tämä tietokantaobjekti voi palauttaa seuraavat sarakkeet:

Esimerkki 1 

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

Kysely:

 
Palauttaa:

Esimerkki 2

Hae käytettävissä olevat assosiaatiotyypit kaupoista ja yrityksistä.

Kysely:

Tulokset:

assosiaatiot

Tämä tietokantaobjekti sisältää tietoja tiettyjen tietueiden välisistä assosiaatioista. Jokainen rivi edustaa assosiaatiota yhdestä objektista toiseen objektiin. Rivejä voi olla tässä tietokantaobjektissa, vaikka viitatut tietueet on poistettu. Voit tarkistaa, onko tietueita olemassa, yhdistämällä ne objektitaulukkoon.

Tämä tietokantaobjekti voi olla hyödyllinen, jos tililläsi on paljon tietoja, mikä hidastaa associations_x_to_y-näkymien suorittamista.

Tämä tietokantaobjekti voi palauttaa seuraavat sarakkeet:

Esimerkki 1

Hae kaikki liitännäiset kaupat ja yhteystiedot.

Kysely:

 
Palauttaa: 

Esimerkki 2 

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

Kysely:

Tulokset:

Esimerkki 3 

Hae kaikki tietyn kontaktin (kontakti-ID: 4464) liittyvät kaupat. Tämän esimerkin sijaan, jossa yhdistettyAssociationTypeId on koodattu kiinteästi, tässä esimerkissä käytetään association_definitions-liitosta.

Kysely:

Palauttaa:

Omistajan kyselyt

omistajat

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

Tämä tietokantaobjekti voi palauttaa seuraavat sarakkeet:

Esimerkki 

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

Kysely:

 
Palauttaa: 

Esimerkki 2

Hae tietty omistaja omistajan tunnuksen perusteella.

Kysely:

Palautukset: 

Esimerkki 3

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

Palauttaa: 

Tiimikyselyt

tiimit

HubSpotin tiimit mahdollistavat käyttäjien järjestämisen ryhmiin organisaatio- ja raportointitarkoituksia varten. Voit luoda päätiimin ja lisäjoukkueita.

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

Tämä tietokantaobjekti voi palauttaa seuraavat sarakkeet:

Esimerkki 1

Hae kaikki tiimit.

Kysely:

Palauttaa:

owner_team

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

Tämä tietokantaobjekti voi palauttaa seuraavat sarakkeet:

Esimerkki 1

Hae kaikki tietyn tiimin omistajat.

Kysely:

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

Palauttaa

Pipeline-kyselyt

Alla on ohjeet kauppa- ja lippuputken tietoja, kuten tililläsi olevat käytettävissä olevat putket ja niiden vaiheet.

Voit yhdistää nämä tiedot objektitietoihin saadaksesi kattavan kuvan putkistostasi. Voit esimerkiksi kysellä kauppoja ja niiden putkistoja yhdistämällä objects_deals_view- tai object_with_object_properties- tiedot putkistotietoihin.

putket

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

Tämä taulukko voi palauttaa seuraavat sarakkeet:

Esimerkki 1

Hae kaikki käytettävissä olevat kaupan putket järjestettynä niiden järjestyksen mukaan HubSpotissa.

Kysely:

 
Palauttaa: 

Esimerkki 2

Hae kaupat tietystä putkesta. Yhdistää object_with_object_properties ja pipelines.

Kysely:

Palauttaa: 

Esimerkki 3

Sama kuin esimerkissä 2 yllä, hae tietyn myyntiputken sisällä olevat kaupat. Käytä kuitenkin objektien yhdistämisessä object_deals-objektin sijaan object_with_object_properties-objektia.

Palauttaa: 

pipeline_stages

Tämä näkymä sisältää tietoja putkilinjan yksittäisistä vaiheista. Tunnista vaiheet yhdistämällä objektityypin tunnus, putkilinjan tunnus ja vaiheen tunnus. Kun yhdistät putkilinjoja, käytä objektityypin tunnusta ja putkilinjan tunnusta.

Tämä tietokantaobjekti voi palauttaa seuraavat sarakkeet:

Esimerkki 1 

Hae myyntiputken vaiheita nimeltäSales pipeline.

Kysely:

 
Palauttaa: 

Esimerkki 2

Hae kaikki kaupat ja niiden vastaavat myyntiputken vaiheet.

Kysely:

Palautukset: 

Ominaisuuskyselyt

property_definitions

Tämä tietokantaobjekti sisältää tietoja HubSpot-tilisi objektien ominaisuuksista ja tapahtumien ominaisuuksista. Tapahtumien ominaisuuksiin kuuluvat vakiotapahtumat, kuten sähköpostien avaamiset ja klikkaukset, sekä mukautetut käyttäytymistapahtumien ominaisuudet. Nämä tiedot voivat olla hyödyllisiä määritettäessä object_properties- ja events-tietojen arvoja.

Voit tunnistaa tietyt ominaisuudet yhdistämällä niiden objektityypin tunnuksen ja nimen. Voit hakea vastaavia tietoja käyttämällä ominaisuus-API:ta.

Tämä tietokantaobjekti voi palauttaa seuraavat sarakkeet:

Esimerkki 1

Hae kaikkien yhteystietojen ominaisuuksien nimet ja kuvaukset.

Kysely:

 
Palauttaa:

Tapahtumakyselyt

Tapahtumat sisältävät HubSpotin vakiotapahtumat ja mukautetut käyttäytymistapahtumat. Jokaisella tapahtumalla on oma tietokantaobjekti, joka on nimetty events_eventname.

Voit tunnistaa tapahtumat yhdistämällä niiden tapahtumatyypin tunnuksen ja tunnuksen. Palautettavat sarakkeet riippuvat tapahtumasta, ja jokaisella tapahtumaominaisuudella on yksi sarake. Kaikki tapahtumat palauttavat seuraavat sarakkeet:

Esimerkki 1

Hae 50 viimeisintä sähköpostin klikkaus tapahtumaa.

Kysely:

Palauttaa: 

Esimerkki 2

Hae kaikki sähköpostin klikkaus tapahtumat, jotka ovat peräisin klikanneilta yhteyshenkilöiltä. Tämä kysely hakee yhteystiedot yhdistämällä ne object_with_object_properties-objektin kanssa.

Kysely:

Palauttaa: 

Object_and_event_type_queries

object_and_event_type_definitions

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:

Esimerkki 1

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

Kysely:

 
Palauttaa: 

Segmenttikyselyt

Alla on ohjeet segmenttien, kuten käytettävissä olevien yhteyshenkilö- ja yrityssegmenttien sekä kyseisiin segmentteihin sisältyvien tietueiden, kyselyyn.

segmentit

Tämä tietokantaobjekti sisältää tietoja HubSpot-yhteyshenkilö- ja yrityssegmenteistä. Palauttaa yhden rivin segmenttiä kohti, ja sarakkeet sisältävät segmentin tiedot, kuten segmentin nimen, koon ja sen sisältämien tietueiden objektityypin. Ei sisällä tietoja kunkin segmentin yksittäisistä tietueista (katso segment_membership). 

Tämä tietokantaobjekti voi palauttaa seuraavat sarakkeet:

Esimerkki 1

Hae kaikki yhteystietosegmentit.

Kysely:

 
Palauttaa: 

Esimerkki 2

Hae tietty yhteystietosegmentti nimeltä Top subscribers 2021. 

Kysely:

Tulokset: 

segment_membership

Tämä tietokantaobjekti sisältää tietoja siitä, mitkä tietueet kuuluvat mihinkin segmentteihin, ja segmentissä on yksi rivi kutakin tietuetta kohti. Jos sinulla on esimerkiksi Blogin tilaajat -segmentti, jossa on 500 yhteystietoa, tietokantaobjekti palauttaa 500 riviä. 

Sisältää vain segmenttien tunnukset ja objektien tunnukset. Lisätietoja saat yhdistämällä segmenttien tietokantaobjektin.

Tämä tietokantaobjekti voi palauttaa seuraavat sarakkeet:

Esimerkki 1

Hae kaikkien yhteystietojen tunnukset segmentistäTop subscribers 2021.

Kysely:

 
Palauttaa: 

Esimerkki 2

Hae etu- ja sukunimet yhteystietojen tiedoista segmentissä Top subscribers 2021.

Kysely:

Tulokset: 

Usein kysytyt

Haluan luoda Hubspot-sovelluksen raportin kaltaisia tietoja. Miten teen sen?

Yleensä kannattaa tarkastella vertailukohteena olevan raportin 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ää, mihin objektityypin ominaisuuteen sarake vastaa. Voit tehdä tämän kyselemällä property_definitions:

Aina ei välttämättä löydy tarkkaa vastaavuutta, koska jotkin ominaisuusnimet muutetaan sovelluksessa yleensä kuvaavammiksi nimiksi. Tällaisissa tapauksissa voi olla apua tehdä epätarkka haku käyttämällä LIKE-operaattoria property_definitions-sarakkeen nimikkeessä (tai jopa kuvauksessa).

Kun olet määrittänyt, mihin objektityyppiin sarake kuuluu, on helppo määrittää, mitä kysyä. Voit yksinkertaisesti etsiä objektityyppiin vastaavan object_x-näkymän.

Kuinka linkitän tämän tietotyypin toiseen, esimerkiksi kuinka haen lomakkeita kampanjaa varten?

Jos haluat linkittää kaksi tai useampia eri tietueita toisiinsa, tutustu assosiaatioihin. Assosiaatiot edustavat HubSpot CRM:n objektien välisiä suhteita. Kaikki kahden tyypin välillä mahdolliset assosiaatiot on lueteltu association_definitions-taulukossa. Yllä olevassa esimerkissä, jotta saat selville kaikki lomakkeet, joihin kampanja on linkitetty, sinun on haettava ASSOCIATIONS_CAMPAIGNS_TO_FORMS:

Miten saan selville HubSpot-Snowflake-integraation tilan?

Saadaksesi reaaliaikaisia tilapäivityksiä HubSpot-Snowflake-integraation häiriöistä ja ongelmista, kysy data_share_status-näkymää:

SELECT * FROM hubspot.public.data_share_status
LIMIT 1

Tulokset näytetään seuraavasti:

Tämä näkymä tarjoaa päivityksiä integraation tilasta käänteisessä aikajärjestyksessä. Tämän kyselyn tulosten integroiminen kojelautaan auttaa sinua seuraamaan integraation suorituskykyä ja havaitsemaan mahdolliset käyttökatkokset tai häiriöt.