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

HubSpotin tietojen kysely Snowflakessa

Päivitetty viimeksi: 3 syyskuuta 2025

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

Data Hub Enterprise

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

Data lag 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 joka päivä.

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-tietojasi koskevia kyselyjä 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 voit lisätä ne manuaalisesti.

Varaston, tietokannan ja skeeman valitseminen työarkkitasolla:

Napsauta työarkin ylimmällä rivillä Työarkin toimet -palkkia.
Avautuvassa ikkunassa:
- Napsauta Warehouse (Varasto ) -pudotusvalikkoa ja valitse sitten varasto.
- Napsauta Database (Tietokanta ) -pudotusvalikkoa ja valitse sitten HubSpot-tietokantasi.
- Napsauta Schema (Skeema ) -pudotusvalikkoa ja valitse sitten haluamasi skeema:

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

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

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 esim. seuraavia:

Objektit: vakio- ja mukautetut objektit, 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.
Segmentit: HubSpotin kontakti- ja yrityssegmentit.
Omistajat: HubSpot-tilisi käyttäjät suhteessa tietueisiin, joiden omistajiksi heidät on asetettu.
Putket: Kauppa- ja lippuputket, mukaan lukien putkivaiheet.
Ominaisuudet: CRM-tietueiden ominaisuudet ja niiden arvot, mukaan lukien ominaisuuksien historia.

Lisätietoja HubSpotin CRM-tietomallista.

Huomaa : Kun kehitämme datajakoa, otamme käyttöön muutoksia, joista osa on rikkovia muutoksia. On erittäin suositeltavaa tilata HubSpotin kehittäjien muutosloki. Nämä muutokset julkaistaan muutoslokissa aina ennen päivitystä.

Palautettujen tietojen rajoittaminen ja järjestäminen

Kun muodostat kyselyjä, voit hallita palautettavien tietojen määrää ja palautusjärjestystä sisällyttämällä kyselyyn 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ä asiakirjaa käytämme termiä tietokantaobjekti, kun asiayhteys koskee sekä taulukoita että näkymiä.

snowflake-sidebar-view-column-details0

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

SELECTobjectId, updatedAt
FROM objects_contacts

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

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. Segmenttien kohdalla tämä viittaa segmentin 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, joka kertoo, 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 haluttuihin tyyppeihin 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

Objektikyselyt

Seuraavassa kerrotaan, miten tiettyjä HubSpot-objekteja ja tietueita sekä palautettavia tietoja voidaan kysyä.

Eri tyyppiset objektitiedot on järjestetty ja saatavilla kahdella tavalla:

Yksilö: Jokainen 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
Rivitiedot	0-8

Mukautetuille objekteille annetaan tunniste luontihetkellä, ja ne tunnistetaan 2-unique_ID:nä. Esimerkiksi 2-12345. Lisätietoja objektin_ja_tapahtuman_tyypin_määrittelyistä.

Nämä tietokantaobjektit soveltuvat yleensä, jos haluat paremman kyselysuorituskyvyn kuin mitä saadaan objects_x-näkymillä. Katso lisätietoja jäljempänä kohdista object_with_object_properties, object_properties, objects ja object_properties_history.

objects_x-näkymät

Tässä tietokantakohteessa jokaisella käytettävissä olevalla objektityypillä, mukaan lukien mukautetut objektit, on oma näkymänsä, ja kukin näkymä sisältää vain kyseisen objektityypin objektien 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").

Kyselyt tälle näkymälle palauttavat yhden rivin jokaiselle objektin tietueelle, 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ä:

HubSpot Object type	ObjectTypeId	Kuvaus
YHTEYSTIEDOT	0-1	Tietoja henkilöistä, jotka ovat vuorovaikutuksessa yrityksesi kanssa
COMPANY	0-2	Tietoja yksittäisistä yrityksistä tai organisaatioista
DEAL	0-3	Yksityiskohtaisia tietoja tulonhankintamahdollisuuksista kontaktin tai yrityksen kanssa
ENGAGEMENT	0-4	Tallentaa tietoja CRM-toiminnoista, mukaan lukien muistiinpanot, tehtävät, sähköpostit, kokoukset ja puhelut.
TICKET	0-5	Edustaa asiakkaan avun- tai tukipyyntöjä
QUOTE	0-14	Käytetään hintatietojen jakamiseen potentiaalisille ostajille
FORM_SUBMISSION	0-15	HubSpot-lomakkeen yksittäisten lähetysten tiedot.
LINE_ITEM	0-8	Edustaa sopimuksessa myytävien tuotteiden osajoukkoa. Kun tuote liitetään kauppaan, siitä tulee rivikohde.
CONVERSATION	0-11	Tiedot useista kanavista saapuvista viesteistä.
LANDING_PAGE	0-25	Laskeutumissivujesi tiedot
TASK	0-27	Tallentaa tietoja tehtävälistoista
FORM	0-28	Käytetään keräämään tietoja vierailijoista ja yhteystiedoista.
MARKETING_EMAIL	0-29	Tiedot markkinointikeskuksesta lähetetyistä sähköposteista
AD_ACCOUNT	0-30	Tallentaa tiedot mainostileistäsi Linkedinissä, Facebookissa ja Googlessa.
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	Yksittäisten mainosten tiedot
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
OBJECT_SEGMENT	0-45	Tietoa objektitietueiden ryhmittelystä niiden ominaisuuksien tai toimintojen perusteella.
CALL	0-48	Muiden CRM-tietueiden, esim. yhteystietojen, tekemät puhelut.
INVOICE	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öpostimalleja, joiden avulla kontakteja voidaan hoitaa ajan mittaan.
TEMPLATE	0-62	Tallennettu sähköpostisisältö, jota voidaan käyttää uudelleen sähköpostien lähettämiseen.
DEAL_SPLIT	0-72	Diiliosuuksia käytetään jakamaan kauppahyvityksiä useiden käyttäjien kesken.
SALES_DOCUMENT	0-83	Myyntidokumentit rakentavat koko tiimillesi sisältökirjaston, johon voit ladata ja jakaa dokumentteja yhteystietojesi kanssa.
FEEDBACK_SUBMISSION	0-19	Tallentaa palautekyselyyn lähetetyt tiedot
SUBSCRIPTION	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	Number	Tietueen ID (esim. yhteystietue, jonka ID 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.Kullekin 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

Palauttaa:

OBJECTID	FIRSTNAME	LASTNAME	LIFECYCLESTAGE
54325098	Hobbes	Paroni	lyijy
96805401	Milo	Gold	lyijy
6922028	Henry	Riley	lyijy

Esimerkki 2

Hae enintään kolmen sopimuksen nimi ja vaihe.

Query:

SELECT objectId, property_dealName, property_dealStage, property_amount AS dealAmount
FROM objects_deals LIMIT 3

Palauttaa:

OBJECTID	PROPERTY_DEALNAME	PROPERTY_DEALSTAGE	PROPERTY_DEALAMOUNT
38960439	Sopimuksen nimi 1	closedwon	34199
321740651	Testisopimus 123	14845019	8383663
98392101	Pop-Up-katos	closedwon	9309007

Esimerkki 3

Hae kolmen suurimman sopimuksen nimi ja vaihe summan mukaan.

Kysely:

Koska kauppojen summatiedot 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

Palauttaa:

OBJECTID	PROPERTY_DEALNAME	PROPERTY_DEALSTAGE	PROPERTY_DEALAMOUNT
98392101	Pop-Up-katos	closedwon	9309007
321740651	Testaa Deal 123	14845019	8383663
38960439	Sopimuksen nimi 1	closedwon	34199

object_with_object_properties (objekti_objekti_ominaisuuksilla)

Tämä tietokantaobjekti sisältää tietoja HubSpot-tietueistasi. Kyselyt tälle tietokantaobjektille palauttavat yhden rivin jokaiselle tietueelle 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 ominaisuuksien arvot.
`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 tiedot Kun Snowflake on viimeksi syöttänyt tiedot.

Huomaa: Tammikuun 25. päivänä 2022 object_with_object_properties-taulussa ja -näkymässä oleva sarake, timestamp, joka edustaa päivämäärää ja kellonaikaa, jolloin objektitietue viimeksi päivitettiin HubSpotissa, muuttuu 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

Haetaan kaikki yhteystiedot ja niiden ominaisuudet.

Kysely:

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

Palauttaa:

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;

Returns:

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

Objektit

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 tietojen kopioimisen object_with_object_properties-tietokantaobjektissa, mutta samalla säilytetään kontrolli siitä, mitkä ominaisuudet palautetaan.

Tämä tietokantaobjekti voi palauttaa seuraavat sarakkeet:

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

Esimerkki 1

Hae kaikki yhteystietueet.

Kysely:

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

Palauttaa:

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

object_properties

Tämä tietokantaobjekti on osa object_with_object_properties-tietokantaobjektista. 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`	Number	Tietueen tunnus (esim. yhteystietue, jonka tunnus on `123752`).
`NAME`	Varchar	Ominaisuuden nimi.
`VALUE`	Timestamp	Ominaisuuden arvo.
`UPDATEDAT`	Timestamp	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 tiedot Kun Snowflake on viimeksi syöttänyt tiedot.

Esimerkki 1

Hae kaikkien yhteystietojen etunimi, sukunimi ja kaupunki -ominaisuudet.

Kysely:

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

Palauttaa:

OBJECTTYPEID	OBJECTID	NAME	VALUE
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);

Palauttaa:

OBJECTTYPEID	OBJECTID	FIRSTNAME	LASTNAME	LIFECYCLESTAGE
0-1	54325098	Hobbes	Paroni	lead
0-1	96805401	Milo	Gold	lead
0-1	6922028	Henry	Riley	lead
...	...	...	...	...

object_properties_history

Tämä tietokantaobjekti sisältää historialliset ominaisuusarvot. Yhteystietojen osalta se sisältää viimeisimmät 45 arvoa. Kaikkien muiden objektien osalta se sisältää viimeisimmät 20 arvoa. Näyttää rivin kullekin historialliselle ominaisuusarvolle. 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`	Number	Tietueen tunnus (esim. yhteystietue, jonka tunnus on `123752`).
`NAME`	Varchar	Ominaisuuden nimi.
`VALUE`	Timestamp	Ominaisuuden 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

Haetaan yhden ominaisuuden historiaa yhdelle yhteystiedolle.

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;

Palauttaa:

OBJECTID	NAME	VALUE	UPDATEDAT
136493192	hs_predictivescoringtier	tier_1	2022-06-22 22:45:05.931
136493192	hs_predictivescoringtier	tier_2	2021-09-18 08:20:56.622
136493192	hs_predictivescoringtier	tier_3	2019-11-31 18:20:22.851
...	...	...	...

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

Palauttaa:

OBJECTID	FIRSTNAME	LASTNAME
54325098	Hobbes	Paroni
96805401	Milo	Gold
6922028	Henry	Riley
...	...	...

Yhdistelmäkyselyt

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

Individual: Kukin assosiaatiotyyppi tallennetaan omaan näkymäänsä ja se sisältää vain kyseisen tyypin tietueita. Esimerkiksi associations_contacts_to_deals sisältää vain yhteyshenkilö- ja sopimusobjektien välisiä assosiaatiotietueita. Näin ollen ei ole tarpeen määrittää associationtypeid-tunnusta 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 kyselyä tehdessäsi sinun on määritettävä suodatin, kuten "WHERE combinedassociationtypeid='0-32' ". Katso lisätietoja assosiaatioista ja assosiaatio_määrittelyistä jäljempänä.

associations_x_to_y-näkymät

Jokaisella assosiaatiotyypillä on oma näkymä, joka on merkitty nimellä associations_<association type name> esim. 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	Yhdistelmämäärityksen yksilöllinen tunniste.
ASSOCIATIONCATEGORY	Varchar	Assosiaatiotyypin lähde. Yksi seuraavista: HUBSPOT_DEFINED, USER_DEFINED, INTEGRATOR_DEFINED.
ASSOCIATIONTYPEID	Varchar	Yhdistelmämäärityksen yksilöllinen tunniste tietyssä yhdistysluokassa, eli kahdella yhdistysluokan määritelmällä ei ole samaa associationtypeid-tunnusta.
FROMOBJECTTYPEID	Varchar	Yhdistelmämäärittelyn lähteenä oleva objektityyppitunnus.
FROMOBJECTTYPE	Varchar	Assosiaatiomäärityksen lähteenä olevan objektityypin nimi.
TOOBJECTTYPEID	Varchar	Objektityypin tunniste, joka on assosiaatiomäärittelyn kohde.
TOOBJECTTYPE	Varchar	Sen objektityypin nimi, joka on assosiaatiomäärityksen kohde.
NAME	Varchar	Yhdistelmämäärityksen nimi.
LABEL	Varchar	Yhdistelmämäärityksen kuvaus.
ISMAINASSOCIATIONDEFINITION	Boolean	Onko assosiaatiomääritelmä päätyyppi. Kun vastaus on true, HubSpot näyttää määritelmän 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.	Number	Kohdeobjektin objektitunnus.
INGESTEDAT	Aikaleima	Päivämäärä ja kellonaika, jolloin Snowflake on viimeksi syöttänyt tiedot.

Esimerkki 1

Haetaan kaikki tiettyyn yhteystietoon liittyvät sopimukset.

Kysely:

SELECT
contact_objectId, deal_objectId

FROM associations_contacts_to_deals

WHERE contactId = 6626541373

Palauttaa:

CONTACT_OBJECTID	DEAL_OBJECTID
6626541373	233620335
6626541373	90253678

Esimerkki 2

Hae kaikki Bogotan aikavyöhykkeellä olevat kontaktit ja niiden tarjoukset.

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

CONTACT_FIRSTNAME	YHTEYSHENKILÖN_SUKUNIMI	YHTEYSTIETO_POSTI	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 osalta tehtyjen 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

Palauttaa:

TOTAL_CLOSED_AMOUNT	YHTEYSTIETOPOSTI
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 siinä on yksi rivi kutakin assosiaatiotyyppiä kohti. Voit yhdistää tämän tietokantaobjektin associations-tietokantaobjektin kanssa saadaksesi tietuekohtaisia assosiaatiotietoja.

Samojen objektien välillä voi olla useita assosiaatiotyyppejä. Tärkein assosiaatiotyyppi, joka näkyy HubSpotissa, kun tietueet on yhdistetty, käyttää assosiaatiota, 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`	Number	Yhdistyksen määritelmän tunniste luokassaan.
`FROMOBJECTTYPEID`	Varchar	Assosiointimääritelmän lähteenä olevan objektin tunniste.
`TOOBJECTTYPEID`	Varchar	Sen objektin tunnus, joka on assosiaatiomääritelmän kohde.
`NAME`	Varchar	Yhdistelmämäärityksen nimi.
`LABEL`	Varchar	Yhdistelmämäärityksen nimi.
`ISMAINASSOCIATIONDEFINITION`	Boolean	Onko assosiaatiomääritelmä päätyyppi. Kun vastaus on true, HubSpot näyttää määritelmän assosioituneissa tietueissa.
`INGESTEDAT`	Timestamp	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 assosiaatiotyypit.

Kysely:

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

Palauttaa:

COMBINEDASSOCIATIONTYPE	FROMOBJECTTYPEID	TOOBJECTTYPEID	NAME
0-1	0-1	0-2	YHTEYSHENKILÖ_YRITYKSEEN
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

Palauttaa:

COMBINEDASSOCIATIONTYPE	FROMOBJECTTYPEID	TOOBJECTTYPEID	NAME
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

.

Tämä tietokantaobjekti sisältää tietoja tiettyjen tietueiden välisistä assosiaatioista. Jokainen rivi edustaa assosiaatiota yhdestä objektista toiseen objektiin. Tässä tietokantaobjektissa voi olla rivejä, vaikka viitatut tietueet 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, jolloin associations_x_to_y-näkymät toimivat hitaasti.

Tämä tietokantaobjekti voi palauttaa seuraavat sarakkeet:

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

Esimerkki 1

Hae kaikki liitetyt sopimukset ja yhteystiedot.

Kysely:

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

Palauttaa:

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

Esimerkki 2

Hae kaikki tiettyyn yhteystietoon (yhteystiedon tunnus: 3005) liittyvät liput.

Kysely:

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

Palauttaa:

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;

Palauttaa:

COMBINEDASSOCIATIONTYPEID	FROMOBJECTID	TOOBJECTID
0-5	6626541373	233620335

Omistajakyselyt

owners

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

Palauttaa:

OWNERID	USERID	EMAIL	FIRSTNAME	LASTNAME
29584574	4621126	233620335	Hobbes	Paroni
30532717	4874784	3866015468	Pablo	Walters
30580321	925511	7132752747	Milo	Gold
...	...	...	...	...

Esimerkki 2

Hae tietty omistaja omistajatunnuksen perusteella.

Kysely:

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

Palauttaa:

OWNERID	USERID	EMAIL	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 kontaktin 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

Palauttaa:

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

Tiimikyselyt

teams

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	Emojoukkueen joukkueen tunnus.
CHILDTEAMIDS	Array	Lapsijoukkueiden joukkueen tunnukset.
PRIMARYOWNERMEMBERS	Varchar	Joukkueen ensisijaisten jäsenten omistajatunnukset.
SECONDARYOWNERMEMBERS	Boolean	Joukkueen toissijaisten jäsenten omistajatunnukset.
INGESTEDAT	Aikaleima	Päivämäärä ja kellonaika, jolloin Snowflake on viimeksi syöttänyt tiedot.

Esimerkki 1

Hae kaikki tiimit.

Kysely:

SELECT teamId,teamName, primaryOwnerMembers

FROM joukkueet

Palauttaa:

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

omistaja_joukkue

Tämä tietokantaobjekti sisältää tietoa siitä, mitkä omistajat vastaavat mitäkin tiimejä 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ä tiimi tämän omistajan ensisijainen tiimi.
INGESTEDAT	Aikaleima	Päivämäärä ja kellonaika, jolloin Snowflake on viimeksi syöttänyt tiedot.

Esimerkki 1

Hae kaikki tietyn tiimin omistajat.

Kysely:

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

Palauttaa

TEAMID	TEAMNAME	ISTEAMPRIMARY
29584574	233620335	TRUE
29584574	1234553	TRUE

Putkiston kyselyt

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

Voit yhdistää nämä tiedot kohdetietoihin saadaksesi täydellisen näkymän 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 tililläsi olevista diili- ja lippuputkistoista. 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. sopimukset tai liput).
`LABEL`	Varchar	Putkilinjan nimi HubSpotissa.
`DISPLAYORDER`	Number	Järjestys, jossa putki näytetään HubSpotissa.
`ARCHIVED`	Boolean	Onko putkisto poistettu.
`CREATEDAT`	Aikaleima	Milloin putkisto 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 diiliputket järjestettynä niiden järjestyksen mukaan HubSpotissa.

Kysely:

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

Palauttaa:

OBJECTTYPEID	PIPELINEID	LABEL
0-3	1bed503c-37f7-4f51-9d40-7598902673f4	Myyntiputki
0-3	12659678	Lisenssiputki
0-3	75e28846-ad0d-4be2-a027-5e1da6590b98	Uusi liiketoiminta
...	...	...

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

Palauttaa:

DEAL_ID	DEAL_NAME	PIPELINE_NAME
605140072	Meowmix maailmanlaajuinen rekisteröityminen	Myyntiputki
605457408	Friskies Rebrand	Myyntiputki
604362473	Fresh Step App Build	Myyntiputki

Esimerkki 3

Sama kuin esimerkki 2, mutta hakee tietyn putken sisällä olevat kaupat. Mutta sen sijaan, että käytät yhdistämisessä objects_deals, käytä object_with_object_properties.

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

Palauttaa:

DEAL_ID	DEAL_NAME	PIPELINE_NAME
605140072	Meowmix Global Signup	Myyntiputki
605457408	Friskies Rebrand	Myyntiputki
604362473	Fresh Step App Build	Myyntiputki

pipeline_stages

Tämä näkymä sisältää tietoja yksittäisistä vaiheista putken 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	Myyntiputken tunnus.
`STAGEID`	Varchar	Vaiheen tunnus.
`LABEL`	Varchar	Vaiheen nimi HubSpotissa.
`DISPLAYORDER`	Number	Järjestys, jossa putki näytetään HubSpotissa.
`METADATA`	Vaihtoehto	Vaiheen JSON-muotoinen kuvaus, mukaan lukien tieto siitä, onko vaihe avoinna vai suljettu.
`ARCHIVED`	Boolean	Onko putkistovaihe poistettu.
`CREATEDAT`	Aikaleima	Milloin putkistovaihe luotiin.

Esimerkki 1

Hae myyntiputkeksi nimetyn myyntiputken putkivaiheet.

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;

Palauttaa:

PIPELINEID	STAGEID	LABEL
941650	941651	Yhteydenotot
941650	941652	Sovittu tapaaminen
941650	941653	Lasku lähetetty
...	...	...

Esimerkki 2

Hae kaikki kaupat ja niiden putkivaiheet.

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

Palauttaa:

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 App Build	Myyntiputki	Sopimus allekirjoitettu
...	...	...	...

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 ID:n ja nimen. Voit hakea vastaavia 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 nimi.
`DESCRIPTION`	Varchar	Ominaisuuden 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`	Number	Ominaisuuden näyttöjärjestys.
`GROUPNAME`	Varchar	Ominaisuuden ryhmän nimi.
`OPTIONS`	Variantti	Luettelo-ominaisuuksien osalta joukko ominaisuuden vaihtoehtoja, mukaan lukien kunkin vaihtoehdon ominaisuudet (esim. näyttöjärjestys, merkintä).
`CREATEDUSERID`	Number	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 yksilöllisiä. Voidaan asettaa vain luotaessa ominaisuutta API:n kautta.
`HIDDEN`	Boolean	Onko ominaisuus piilotettu HubSpotissa.
`SHOWCURRENCYSYMBOL`	Boolean	Muodostetaanko 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äys ja kellonaika, jolloin ominaisuus luotiin HubSpotissa.
`UPDATEDAT`	Timestamp	Päiväys ja kellonaika, jolloin tieto viimeksi päivitettiin 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 ominaisuuksien nimet ja kuvaukset.

Kysely:

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

Palauttaa:

NAME	LABEL	KUVAUS
entered_sql_stage	Syötetty SQL-vaihe	Aloitetaan SQL-vaiheen päivien laskeminen.
first_conversion_event_name	Ensimmäinen muunnos	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 olivat vuorovaikutuksessa sen kanssa klikkaamalla mainosta tai lähettämällä lomakkeen sen jälkeen, kun ne olivat vuorovaikutuksessa sen kanssa.
EVENTS_AD_METRICS_IMPORTED_V0	Tiedot mainoksesta ja sen suorituskykymittareista.
EVENTS_CALL_MAINITTU_AVAINSANA	Tiedot avainsanoista, jotka kaikki puheluihin osallistujat ovat maininneet.
EVENTS_CLICKED_LINKED_IN_EMAIL_V2	Yhteyshenkilöiden markkinointisähköposteissa napsauttamat linkit.
EVENTS_CLICKED_LINK_IN_TRACKED_INBOX_EMAIL_V8.	Yhteyshenkilöiden klikkaamat linkit Conversations Inbox -sähköpostiviesteissä.
EVENTS_COOKIE_BANNER_CLICKED	Yhteyshenkilöt, jotka napsauttivat evästeitä.
EVENTS_COOKIE_BANNER_VIEWED	Yhteyshenkilöt, jotka katsoivat evästeitä.
EVENTS_DOCUMENT_SHARED_V2	Myyntiasiakirjat, jotka on jaettu yhteystietojen kanssa ulkoisen linkin kautta.
EVENTS_DOCUMENT_VIEWED_V2	Myyntiasiakirjat ja kontaktit, jotka ovat katsoneet niitä avaamalla ulkoisen linkin.
EVENTS_DOCUMENT_COMPLETED_V2	Myyntiasiakirjat ja yhteystiedot, jotka ovat sulkeneet ne.
EVENTS_HS_SCHEDULED_EMAIL_V2	HubSpotin sähköpostipalvelimille lähetettäväksi toimitetut sähköpostit.
EVENTS_MTA_DELIVERED_EMAIL_V2	Sähköpostit, jotka HubSpotin sähköpostipalvelimet ovat onnistuneesti toimittaneet vastaanottajille.
EVENTS_MTA_BOUNCED_EMAIL_V2	Sähköpostin toimitusyritykset, jotka vastaanottajan sähköpostipalvelin hylkäsi.
EVENTS_OPENED_EMAIL_V2	Yhteyshenkilöiden avaamat sähköpostit.
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_OPENENED_TRACKED_INBOX_EMAIL_V8	Yhteyshenkilöiden avaamat Conservations Inbox -sähköpostilaatikon avaukset.
EVENTS_MB_MEDIA_PLAYED	Yhteyshenkilöiden videotoistoaktiviteetti.
EVENTS_V2_CONTACT_BOOKED_MEETING_THROUGH_SEQUENCE (YHTEYSTIEDOT)	Yhteyshenkilö varasi kokouksen sekvenssin kautta.
EVENTS_V2_CONTACT_ENROLLED_IN_EQUENCE	Yhteyshenkilö ilmoittautui sarjaan.
EVENTS_V2_CONTACT_FINISHED_SEQUENCE (TAPAHTUMAT_V2_YHTEYSHENKILÖ_VALMISTUI_JAKSOSTA)	Sequence päättyi.
EVENTS_V2_CONTACT_REPLIED_SEQUENCE_EMAIL	Yhteyshenkilö vastasi sähköpostiin (tai saapuvaan sähköpostiin, joka poisti sarjan rekisteröinnin), joka lähetettiin sarjan kautta.
EVENTS_V2_CONTACT_UNENROLLED_FROM_SEQUENCE	Yhteyshenkilö poistui sekvenssistä.
EVENTS_V2_CONTACT_UNENROLLED_MANUALLY_FROM_SEQUENCE (TAPAHTUMAT_V2_KONTAKTI_POISTETTU_MANUAALISESTI_JAKSOSTA)	Käyttäjä poisti kontaktin manuaalisesti.
EVENTS_V2_CONTACT_UNSUBSCRIBED_SEQUENCE_EMAIL	Yhteyshenkilö poistui tilauksesta, jolloin sarjan rekisteröinti lopetettiin.
EVENTS_V2_SEQUENCE_EMAIL_BOUNCED	Sequence-sähköpostiviesti hylättiin.
EVENTS_V2_SEQUENCE_ERRORED	Sequence errored causing unenrolment.
EVENTS_V2_SEQUENCE_STEP_EXECUTED (EVENTS_V2_SEQUENCE_STEP_EXECUTED)	Sequence step executed.
EVENTS_VISITED_PAGE	Yhteyshenkilöiden verkkosivukäynnit.
EVENTS_<INTEGRATION_EVENT_NAME>_<UNIQUE_IDENTIFIER>	Integraatiotapahtumat(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ä tietokantaobjektia tai näkymää, joka sisältää tapahtumia näiden sarakkeiden avulla, epäonnistuvat. Lue lisää 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 tapahtumatyyppikohtaisesti. Kahdella tietueella ei ole samaa ID:tä tietyn tapahtumatyypin sisällä.
`OBJECTTYPEID`	Varchar	Tapahtuman suorittaneen objektin tyyppi. Esimerkiksi sähköpostilinkin napsautus näyttää tässä sarakkeessa `0-1`, joka edustaa yhteystieto-objektia.
`OBJECTID`	Numero	Tapahtuman suorittaneen 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 sarakkeella `OCCURREDATDATEINT`.
`OCCUREDAT`	Aikaleima	Milloin tapahtuma tapahtui. Huomaa: tämä sarake poistetaan käytöstä 24. marraskuuta 2022 ja korvataan `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

Haetaan 50 viimeisintä sähköpostin klikkaustapahtumaa.

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;

Palauttaa:

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ällä kyselyllä saadaan 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;

Palauttaa:

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	Baron
2018-11-08 09:37:41.400	https://www.website.net/webinar-case-study?utm_source=hs_automation&utm_medium=email&utm_content=55200164	Milo	Gold
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: Object_and_event_type_quies

object_and_event_type_määritelmät

Tämä tietokantaobjekti sisältää kaikkien HubSpot-tililläsi käytettävissä olevien objektien ja tapahtumien määritelmät.

Tämä tietokantaobjekti voi palauttaa seuraavat sarakkeet:

Sarakkeen nimi	Tyyppi	Kuvaus
`OBJECTTYPEID`	Varchar	Sen kohteen ID, jonka putki voi sisältää (esim. sopimukset tai liput).
`FULLYQUALIFIEDNAME`	Varchar	Kohteen 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 objektit ja tapahtumat.

Kysely:

SELECT objectTypeId, fullyQualifiedName
FROM object_and_event_type_definitions;

Palauttaa:

OBJECTTYPEID	FULLYQUALIFIEDNAME
0-1	CONTACT
0-8	LINE_ITEM
0-11	CONVERSATION
...	...

Segmentit-kyselyt

Seuraavassa kerrotaan, miten voit kysyä segmenttejäsi, kuten käytettävissä olevia yhteyshenkilö- ja yrityssegmenttejä ja näihin segmentteihin sisältyviä tietueita.

segmentit

Tämä tietokantaobjekti sisältää tietoja HubSpotin kontakti- ja yrityssegmenteistä. Palauttaa yhden rivin segmenttiä kohti, ja sarakkeisiin sisältyvät segmentin tiedot, kuten segmentin nimi, koko ja sen sisältämien tietueiden objektityyppi. Ei sisällä tietoja yksittäisistä tietueista kussakin segmentissä (katso segment_membership).

Tämä tietokantaobjekti voi palauttaa seuraavat sarakkeet:

Sarakkeen nimi	Tyyppi	Kuvaus
`OBJECTTYPEID`	Varchar	Segmentin tietueiden tyyppi (esim. yhteyshenkilö tai yritys).
`SEGMENTID`	Number	Segmentin tunnus. Yhdistetään segmentti-jäsenyystaulukon SEGMENTID-sarakkeeseen.
`CLASSICSEGMENTID`	Number	Yhteydenottosegmenteille ominainen tunnus, joka vastaa HubSpotissa olevan segmentin URL-osoitteessa olevaa tunnusta.
`NAME`	Varchar	Segmentin nimi.
`SIZE`	Number	Segmentissä olevien tietueiden määrä.
`CREATEDBYUSERID`	Number	Segmentin luoneen käyttäjän tunnus.
`CREATEDAT`	Aikaleima	Milloin segmentti luotiin HubSpotissa.
`UPDATEDBYUSERID`	Number	Segmentin viimeksi päivittäneen käyttäjän tunnus.
`UPDATEDAT`	Aikaleima	Päivämäärä ja kellonaika, jolloin päivitys viimeksi päivitettiin HubSpotissa. Lisätietoja sarakkeen tietotyypeistä.
`INGESTEDAT`	Aikaleima	Päivämäärä ja kellonaika, jolloin Snowflake on viimeksi syöttänyt tiedot.

Esimerkki 1

Haetaan kaikki yhteystietosegmentit.

Kysely:

SELECT segmentId, name, size
FROM segments
WHERE objectTypeId = '0-1';

Palauttaa:

SEGMENTSID	NAME	SIZE
118131	Viikoittainen toiminta	103
66156	Blogin tilaajat	455
771852	Parhaat tilaajat 2021	37
...	...	...

Esimerkki 2

Hae tietty yhteystietosegmentti nimeltä Top-tilaajat 2021.

Kysely:

SELECT segmentId, name, size
FROM segments
WHERE objectTypeId = '0-1' ANDsegmentName = 'Top subscribers 2021';

Palauttaa:

SEGMENTID	NAME	KOKO
771852	Parhaat tilaajat 2021	37

segment_membership

Tämä tietokantaobjekti sisältää tietoa siitä, mitkä tietueet ovat minkäkin segmentin jäseniä, ja siinä on yksi rivi jokaista segmentin tietuetta kohti. Jos sinulla on esimerkiksi Blogitilaajat-segmentti, jossa on 500 yhteystietoa, tietokantaobjekti palauttaa 500 riviä.

Sisältää vain segmentin tunnukset ja objektin tunnukset. Lisätietoja saat liittymällä segmentit-tietokantaobjektiin.

Tämä tietokantaobjekti voi palauttaa seuraavat sarakkeet:

Sarakkeen nimi	Tyyppi	Kuvaus
`SEGMENTID`	Varchar	Segmentin tunnus. Yhdistetään segmenttitaulukon HS_SEGMENT_ID-sarakkeeseen.
`OBJECTID`	Varchar	Segmentin tietueen ID.
`UPDATEDAT`	Timestamp	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 subscribers 2021 -segmentin yhteystietojen tunnukset.

Kysely:

SELECT objectId
FROM segment_memberships
INNER JOIN segments
ON segment_memberships.segmentId = segments.segmentId
WHERE segments.objectTypeId = '0-1'
AND segments.name = 'Top Subscribers 2021';

Palauttaa:

OBJECTID

54325098

96805401

6922028

...

Esimerkki 2

Hae Top subscribers 2021 -segmentin 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 segment_memberships ON contact.objectId = segment_memberships.objectId INNER JOIN segments ON segments_memberships.segmentId = segments.segmentId WHERE segments.objectTypeId = '0-1' AND segments.name = 'Top Subscribers 2021'

Palauttaa:

OBJECTID	ENSIMMÄINEN NIMI	VIIMEINEN NIMI
54325098	Hobbes	Paroni
96805401	Milo	Gold
6922028	Henry	Riley
...	...	...

FAQ

Haluan luoda Hubspot-sovelluksen raportin kaltaisia tietoja, miten teen sen?

Yleisesti ottaen haluaisit tarkastella sarakkeita, jotka ovat läsnä raportissa, johon vertaat. 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ä löydy tarkkaa vastaavuutta, koska jotkin ominaisuuksien nimet on yleensä ratkaistu sovelluksessa kuvaavammaksi nimeksi. Tällaisissa tapauksissa epäselvän 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, esim. miten haen kampanjan lomakkeita?

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 erilaiset assosiaatiot on lueteltu association_definitions-kohdassa. Yllä olevassa esimerkissä, jos haluat tietää, mihin kaikkiin lomakkeisiin 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 muodossa:

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

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 käyttökatkokset.

Oliko tästä artikkelista apua?

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

HubSpotin tietojen kysely Snowflakessa

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

Data lag ja Snowflake-tilisi alue

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

Tietojen yleiskatsaus

Palautettujen tietojen rajoittaminen ja järjestäminen

Sarakkeen tietotyypit

Tietotyyppien muuntaminen

Objektikyselyt

objects_x-näkymät

Esimerkki 1

Esimerkki 2

Esimerkki 3

object_with_object_properties (objekti_objekti_ominaisuuksilla)

Esimerkki 1

Esimerkki 2

Objektit

Esimerkki 1

object_properties

Esimerkki 1

Esimerkki 2

object_properties_history

Esimerkki 1

Esimerkki 2

Yhdistelmäkyselyt

associations_x_to_y-näkymät

Esimerkki 1

Esimerkki 2

Esimerkki 3

association_definitions

Esimerkki 1

Esimerkki 2

.

Esimerkki 1

Esimerkki 2

Esimerkki 3

Omistajakyselyt

owners

Esimerkki 1

Esimerkki 2

Esimerkki 3

Tiimikyselyt

teams

Esimerkki 1

omistaja_joukkue

Esimerkki 1

Putkiston kyselyt

putkistot

Esimerkki 1

Esimerkki 2

Esimerkki 3

pipeline_stages

Esimerkki 1

Esimerkki 2

Kiinteistökyselyt

property_definitions

Esimerkki 1

Tapahtumakyselyt

Esimerkki 1

Esimerkki 2

Object_and_event_type_queries: Object_and_event_type_quies

object_and_event_type_määritelmät

Esimerkki 1

Segmentit-kyselyt

segmentit

Esimerkki 1

Esimerkki 2

segment_membership

Esimerkki 1

Esimerkki 2

FAQ

Haluan luoda Hubspot-sovelluksen raportin kaltaisia tietoja, miten teen sen?

Miten linkitän tämän tietotyypin toiseen, esim. miten haen kampanjan lomakkeita?

Miten tiedän HubSpot-Snowflake-integraation tilan?

Asiaan liittyvä sisältö