HubSpotin tietojen kysely Snowflakessa

Kirjoittanut HubSpot Support | Nov 2, 2021 12:48:39 PM

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:

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

Näytä koko julkaisu