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

HubSpot-tietojen kysely Snowflakessa

Päivitetty viimeksi: 24 syyskuuta 2026

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

Data Hub Enterprise

Kun olet liittänyt Snowflaken HubSpot-tiliisi, voit käyttää Snowflaken Data Share -toimintoa HubSpot-tietojen hakemiseen Snowflake-tililtäsi.

Tietojen viive ja Snowflake-tilisi alue

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

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

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

Jotta voit hakea HubSpot-tietojasi Snowflakessa, sinun on valittava varasto, tietokanta ja skeema, joista haluat tehdä kyselyn. Voit joko määrittää ne laskentataulukon tasolla, jolloin ne sisällytetään automaattisesti kyselyihisi, tai lisätä ne manuaalisesti.

Tallennustilan, tietokannan ja skeeman valitseminen laskentataulukon tasolla:

Napsauta laskentataulukon ylärivilläLaskentataulukon toimintopalkkia.
Ponnahdusikkunassa:
- NapsautaVarasto -pudotusvalikkoa ja valitsevarastosi.
- NapsautaTietokanta -pudotusvalikkoa ja valitse sitten HubSpot-tietokantasi.
- NapsautaSchema -pudotusvalikkoa ja valitse sitten haluamasi skeema:

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

Voit lisätä tietokannan ja skeematyypin kyselyihin manuaalisesti lisäämällä tietokannan nimen ja sen perään skeeman FROM -kentän alkuun. Esimerkki:

SELECT objectTypeId, objectId, updatedAt

FROM hubspot_share_name.V2_LIVE.objects

WHERE objectTypeId = '0-3'

RAJOITUS 1;

Tietojen yleiskatsaus

Kyselyt laaditaan SQL-kielellä, ja niiden avulla voidaan hakea esimerkiksi seuraavia HubSpot-tietoja:

Objektit: vakio- ja mukautetut objektit, kuten yhteyshenkilöt, yritykset ja tuotteet.
Tietueet: yksittäiset tietueet, kuten yksittäinen yhteyshenkilö tai yritys.
Yhteydet: kaikki käytettävissä olevat yhteystyypit ja tällä hetkellä liitetyt tietueet.
Tapahtumat: tapahtumatiedot sekä HubSpotin vakiotapahtumista, kuten sähköpostien avaamisista, että mukautetuista käyttäytymistapahtumista.
Segmentit: HubSpot -yhteystieto- ja yrityssegmentit.
Omistajat: HubSpot-tilisi käyttäjät suhteessa niihin tietueisiin, joiden omistajiksi heidät on määritetty.
Pipeline-prosessit: kauppa-ja tikettiprosessit, mukaan lukien prosessin vaiheet.
Ominaisuudet: CRM-tietueiden ominaisuudet ja niiden arvot, mukaan lukien ominaisuuksien historia.

Lisätietoja HubSpotin CRM-tietomallista.

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

Palautettavien tietojen rajoittaminen ja järjestäminen

Kyselyjä laadittaessa voit hallita palautettavan datan määrää ja järjestystä lisäämällä kyselyynLIMIT ja ORDER BY. Jos esimerkiksi haluat hakea kaikki kontaktit niiden ominaisuuksineen, mutta palauttaa vain kolme tulosta ja järjestää ne kontaktitunnuksen mukaan, voit laatia kyselyn seuraavasti:

SELECT objectTypeId, updatedAt, ingestedAt

FROM objects

WHERE objectTypeId = '0-1'

JÄRJESTYKSEN MUKAAN objektin tunnus

LIMIT 10;

Sarakkeiden tietotyypit

Kun teet kyselyjä Snowflakessa, palautettavat sarakkeet riippuvat kyseltävistä tiedoista. Voit tarkastella tietyn taulukon tai näkymän käytettävissä olevia sarakkeita Snowflakessa valitsemalla näkymän vasemmasta sivupalkista.

Huomaa:Tämän asiakirjan loppuosassa käytämme termiä tietokantaobjekti, kun konteksti koskee sekä taulukoita että näkymiä.

snowflake-sidebar-view-column-details0

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

SELECT objectTypeId, updatedAt, ingestedAt

FROM objects

WHERE objectTypeId = '0-1'

JÄRJESTYKSEN MUKAAN objektin tunnus

LIMIT 10;

Alla on yleisiä määritelmiä sarakkeille, joita kysely saattaa palauttaa. Jos et löydä etsimääsi määritelmää alla olevasta luettelosta, katso yksittäisten näkymien määritelmät yllä olevasta artikkelista.

OBJECTTYPEID: VARCHAR-arvo, joka edustaa objektin tyyppiä. Esimerkiksi 0-1 edustaa yhteystietojen objektia, 0-2 edustaa yritysten objektia ja 2-1232 saattaa edustaa tilisi mukautettua objektia. Segmenteissä tämä viittaa segmentin tyyppiin (esim. yhteystieto tai yritys). Voit hakea kaikki tilisi objektien ja tapahtumien tunnukset object_and_event_type_definitions -näkymän avulla.
OBJECTID: BIGINT-luku, joka edustaa yhtä tietyn tyyppistä objektitietuetta HubSpot-tililläsi. Tietueen tunnistamiseksi sinun on käytettävä sekä objektityypin tunnusta että objektitunnusta.
INGESTEDAT: aikaleima, joka ilmaisee, milloin tietorivi lisättiin Snowflakeen, ilmaistuna TIMESTAMP_NTZ- arvona. Ei liity HubSpotin luonti- tai päivitystoiminnon loogiseen aikaleimaan.
- HubSpotin sisäisen käsittelyn vuoksi rivin syöttöaikaleima voi päivittyä, vaikka mikään muu sarakkeen sarake ei olisi muuttunut.
- Kun luot ETL-prosesseja, jotka kopioivat äskettäin muuttuneita tietoja, on suositeltavaa perustaa kyselyt syöttöajan leimaan. Lisäksi, jos virtaasi kopioi tietoja päivittäin, on suositeltavaa kopioida tiedot kahdelta edelliseltä päivältä viiveiden varalta.
CREATEDAT ja UPDATEDAT: looginen aikaleima, joka ilmaisee, milloin tiedot luotiin tai päivitettiin HubSpotissa, ja joka esitetään TIMESTAMP_NTZ-arvona . Nämä aikaleimat vastaavat HubSpotin aikaleimoja. Esimerkiksi HubSpotissa näkyvä tietueen luontipäivämäärä on sama kuin Snowflaken CREATEDAT-sarakkeen aikaleima. Nämä eivät liity suoraan tuontiaikaleimaan, eikä ETL-prosessien perustamista näihin ominaisuuksiin suositella.
COMBINEDASSOCIATIONTYPE: VARCHAR -arvo, joka yksilöi assosiaatiomääritelmän.

Tietotyyppien muuntaminen

Joskus kysely palauttaa tietoja VARCHAR-sarakkeina, vaikka olisi toivottavaa saada ne eri tyyppisinä. Tällaisissa tapauksissa on suositeltavaa muuntaa VARCHAR-tietotyyppi haluttuihin tyyppeihin Snowflake-funktioiden avulla. Esimerkiksi objektitietueen ominaisuudet tallennetaan useimmissa tietokantaobjekteissa VARCHAR-tietotyyppeinä, mutta ne sisältävät toisinaan numero- ja päivämäärä-aika-arvoja. Seuraavanlaisia funktioita:
try_to_number ja try_to_timestamp_ntz voidaan käyttää muuntamaan nämä VARCHAR-tiedot vastaavasti NUMBER- ja DATETIME -tyypeiksi:

SELECT objectid, value AS amount_str, try_to_number(value) AS amount
FROM object_properties WHERE objecttypeid='0-3' AND name='amount' LIMIT 1

Objektikyselyt

Seuraavassa kerrotaan, miten tietoja haetaan tietyistä HubSpot-objekteista ja -tietueista, sekä mitä tietoja haun tuloksena palautetaan.

Objektitiedot ovat saatavilla jaetuissa tietokantaobjekteissa. Suodata objectTypeId mukaan hakemaan tiettyä objektityyppiä. Käytä OBJECT_WITH_OBJECT_PROPERTIES , kun tarvitset kunkin tietueen nykyiset ominaisuudet. Ominaisuusarvot tallennetaan properties JSON-sarakkeeseen. Käytä OBJECTS tietueen ydinattribuutteihin ja OBJECT_PROPERTIES tai OBJECT_PROPERTIES_HISTORY ominaiskohtaisille tiedoille.

Objektin nimi	ObjectTypeId
Yhteystiedot	0–1
Yritykset	0–2
Rivitiedot	0–8

Mukautetuille objekteille annetaan tunniste niiden luomisen yhteydessä, ja ne tunnistetaan muodossa2-unique_ID. Esimerkiksi2-12345. Lue lisää kohdista object_and_event_type_definitions.

Katso lisätietoja kohdista object_with_object_properties, object_properties, objects ja object_properties_history alla.

object_with_object_properties

Tämä tietokantaobjekti sisältää tietoja HubSpot-tietueistasi. Tähän tietokantaobjektiin kohdistetut kyselyt palauttavat yhden rivin jokaisesta objektityypin sisältämästä tietueesta (esim. kaikki kontaktitietueet objektityypissä contacts). 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 tunniste (esim. yhteystiedot on `0-1`).
`OBJECTID`	Luku	Tietueen tunnus (esim. yhteystietotietue, jonka tunnus on `123752`).
`PROPERTIES`	Variant	Tietueen ominaisuusarvot.
`UPDATEDAT`	Aikaleima	Päivämäärä ja kellonaika, jolloin tietuetta päivitettiin viimeksi HubSpotissa. Lue lisää sarakkeiden tietotyypeistä.
`INGESTEDAT`	Aikaleima	Päivämäärä ja kellonaika, jolloin Snowflake on viimeksi tuonut tiedot järjestelmään.

Huomaa: 25. tammikuuta 2022 object_with_object_properties-taulukon ja -näkymän sarake timestamp, joka edustaa päivämäärää ja kellonaikaa, jolloin objektitietue päivitettiin viimeksi HubSpotissa, muutetaan nimeksi updatedat. Tämä tehdään, jotta se vastaa tapaa, jolla datetime-tiedot esitetään muussa tietojen jakamisessa.

Koska kyseessä on yhteensopivuutta rikkovan muutoksen, uusi sarake updatedat on lisätty taulukkoon ja näkymään. Seuraavien 90 päivän ajan nämä kaksi uutta saraketta ovat rinnakkain timestamp-sarakkeen kanssa, jonka ne 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 tehdä kyselyjä object_with_object_properties-tauluk koon tai -näkymään käyttämällä timestamp-sarakkeita epäonnistuvat.

Esimerkki 1

Hae kaikki yhteystiedot ja niiden ominaisuudet.

Kysely:

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

Tulokset:

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;

Palauttaa:

OBJECTID	SOPIMUKSEN NIMI	SOPIMUSVAIHE	SOPIMUKSEN SUMMA
38960439	Kaupan nimi 1	suljettu/hävinnyt	7488939
321740651	Kaupan nimi 1	suljettu, voitettu	9292029
98392101	Kaupan nimi 1	suljettu, hävitty	62626528

objektit

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

Tämä tietokantaobjekti sisältää nykyiset objektitiedot ilman ominaisuusarvoja. Käytä sitä, kun tarvitset vain tietueen ydinattribuutteja, tai yhdistä se OBJECT_PROPERTIES-objektiin, kun tarvitset valittuja ominaisuuksia. Tämän tietokantaobjektin käyttö yhdessä object_properties-tietokantaobjektin kanssa mahdollistaa object_with_object_properties-taulukon tietojen replikoinnin samalla, kun voit hallita, mitkä ominaisuudet palautetaan.

Tämä tietokantaobjekti voi palauttaa seuraavat sarakkeet:

Sarakkeen nimi	Tyyppi	Kuvaus
`OBJECTTYPEID`	Varchar	Objektityypin tunniste (esim. yhteystiedot on `0-1`).
`OBJECTID`	Luku	Tietueen tunnus (esim. yhteystietotietue, jonka tunnus on `123752`).
`INGESTEDAT`	Aikaleima	Päivämäärä ja kellonaika, jolloin Snowflake on viimeksi ottanut tiedot vastaan. Lue lisää sarakkeiden tietotyypeistä.

Esimerkki 1

Hae kaikki yhteystietotietueet.

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 object_with_object_properties-tietokantaobjektin osajoukko. Jokainen rivi sisältää tietyn tietueen nykyisen ominaisuusarvon. Esimerkiksi yhteystiedolla on yksi rivi etunimi-ominaisu udelle ja yksi rivisukunimi-ominaisuud elle. Jos tietueella ei ole arvoa jollekin ominaisuudelle, rivillä näkyy joko tyhjä merkkijono tai riviä ei näy lainkaan.

Tämä tietokantaobjekti voi palauttaa seuraavat sarakkeet:

Sarakkeen nimi	Tyyppi	Kuvaus
`OBJECTTYPEID`	Varchar	Objektityypin tunniste (esim. yhteystiedot on `0-1`).
`OBJECTID`	Luku	Tietueen tunnus (esim. yhteystietotietue, jonka tunnus on `123752`).
`NAME`	Varchar	Ominaisuuden nimi.
`VALUE`	Aikaleima	Ominaisuuden arvo.
`UPDATEDAT`	Aikaleima	Päivämäärä ja kellonaika, jolloin tietuetta viimeksi päivitettiin HubSpotissa. Lue lisää sarakkeiden tietotyypeistä.
`INGESTEDAT`	Aikaleima	Päivämäärä ja kellonaika, jolloin Snowflake on viimeksi tuonut tiedot järjestelmään.

Esimerkki 1

Hae kaikkien yhteyshenkilöiden 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	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 kaikkien kontaktien etunimi, sukunimi ja elinkaaren vaihe ja yhdistä ne yhdeksi riviksi kutakin kontaktia kohti. Tässä esimerkissä käytetään SQL 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);

Tulokset:

OBJECTTYPEID	OBJECTID	ETUNIMI	SUKUNIMI	ELINKAAREN VAIHE
0–1	54325098	Hobbes	Baron	lyijy
0–1	96805401	Milo	Kulta	johto
0–1	6922028	Henry	Riley	johto
...	...	...	...	...

object_properties_history

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

Tämä tietokantaobjekti voi palauttaa seuraavat sarakkeet:

Sarakkeen nimi	Tyyppi	Kuvaus
`OBJECTTYPEID`	Varchar	Objektityypin tunniste (esim. ”yhteystiedot” on `0-1`).
`OBJECTID`	Luku	Tietueen tunnus (esim. yhteystietotietue, jonka tunnus on `123752`).
`NAME`	Varchar	Ominaisuuden nimi.
`VALUE`	Aikaleima	Ominaisuuden arvo.
`UPDATEDAT`	Aikaleima	Päivämäärä ja kellonaika, jolloin tiedot päivitettiin viimeksi HubSpotissa. Lue lisää sarakkeiden tietotyypeistä.
`INGESTEDAT`	Aikaleima	Päivämäärä ja kellonaika, jolloin Snowflake on viimeksi tuonut tiedot järjestelmään.

Esimerkki 1

Hae yhden kontaktin yhden 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;

Palauttaa:

OBJECTID	NAME	ARVO	PÄIVITYSPÄIVÄ
136493192	hs_ennustepisteytystaso	tier_1	22.6.2022 22:45:05,931
136493192	hs_ennustepisteytystaso	tier_2	18.9.2021 08:20:56.622
136493192	hs_ennustepisteytystaso	tier_3	31.11.2019 18:20:22.851
...	...	...	...

Esimerkki 2

Hae kaikkien niiden kontaktien nykyinen nimi, joiden elinkaarivaihe on joskus ollut Tilaaja.

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

Tulokset:

OBJECTID	ETUNIMI	SUKUNIMI
54325098	Hobbes	Baron
96805401	Milo	Gold
6922028	Henry	Riley
...	...	...

Yhdistelmäkyselyt

Yhdistelmätiedot ovat saatavilla taulukosta ASSOCIATIONS. Suodata combinedAssociationTypeId avulla hakemaan tietty yhdistelmätyyppi. Yhdistä ASSOCIATIONS ja ASSOCIATION_DEFINITIONS tunnistaaksesi liittyvät objektityypit ja yhdistelmämääritelmät.

association_definitions

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

Saman objektin välillä voi olla useita eri assosiaatiotyyppejä. Pääassosiaatiotyyppi, eli tyyppi, joka näkyy HubSpotissa, kun tietueet on liitetty toisiinsa, on se assosiaatio, jossa ISMAINASSOCIATIONDEFINITION on true.

Tämä tietokantaobjekti voi palauttaa seuraavat sarakkeet:

Sarakkeen nimi	Tyyppi	Kuvaus
`COMBINEDASSOCIATIONTYPEID`	Varchar	Yhdistelmämäärittelyn yksilöllinen tunniste.
`CATEGORY`	Varchar	Yhdistelmätyypin lähde. Yksi seuraavista: `HUBSPOT_DEFINED`, `USER_DEFINED`, `INTEGRATOR_DEFINED`
`ID`	Luku	Yhdistelmämäärittelyn tunniste sen kategoriassa.
`FROMOBJECTTYPEID`	Varchar	Yhdistelmämäärittelyn lähteenä olevan objektin tunnus.
`TOOBJECTTYPEID`	Varchar	Yhdistelmämäärittelyn kohteena olevan objektin tunnus.
`NAME`	Varchar	Yhdistelmämäärittelyn nimi.
`LABEL`	Varchar	Yhdistelmämäärittelyn nimi.
`ISMAINASSOCIATIONDEFINITION`	Boolean	Onko assosiaatiomääritelmä päätyyppi. Kun arvo on true, HubSpot näyttää tämän määritelmän assosioituneissa tietueissa.
`INGESTEDAT`	Aikaleima	Päivämäärä ja kellonaika, jolloin Snowflake on viimeksi ottanut tiedot vastaan. Lue lisää 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:

YHDISTETTYYHTEYDEN TYYPPI	FROMOBJECTTYPEID	TOOBJECTTYPEID	NAME
0–1	0–1	0–2	YHTEYSTIEDOT_YRITYKSEEN
0-2	0-2	0-1	Yrityksen yhteystiedot
0–3	0–3	0–1	DEAL_TO_CONTACT
0-4	0-1	0-3	YHTEYDENOTTO_Kauppaan
0–5	0–3	0-2	SOPIMUS_YRITYKSELLE
...	...	...	...

Esimerkki 2

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

Kysely:

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

Tulokset:

YHDISTETTYYHDISTYSTYYPPI	OBJEKTITYYPPIID:STÄ	OBJEKTITYYPPI-ID:HIN	NIMI
0–5	0–3	0–2	DEAL_TO_COMPANY
0–271	0–3	0-2	SOPIMUS_PÄÄYRITYKSEN_KANSSA
0–341	0–3	0-2	SOPIMUS_YRITYKSELLE_NIMETÖN

associations

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

Tämä tietokantaobjekti sisältää yhteystietueita kaikille yhteystyypeille. Suodata combinedAssociationTypeId mukaan ja liitä ASSOCIATION_DEFINITIONS taulukkoon, kun tarvitset yhteyksien metatietoja.

Tämä tietokantaobjekti voi palauttaa seuraavat sarakkeet:

Sarakkeen nimi	Tyyppi	Kuvaus
`COMBINEDASSOCIATIONTYPEID`	Varchar	Yhdistelmämäärittelyn yksilöllinen tunniste.
`FROMOBJECTID`	Luku	Lähdeobjektin tunnus.
`TOOBJECTID`	Luku	Kohdeobjektin tunnus.
`INGESTEDAT`	Aikaleima	Päivämäärä ja kellonaika, jolloin Snowflake on viimeksi ottanut tiedot vastaan. Lue lisää sarakkeiden tietotyypeistä.

Esimerkki 1

Hae kaikki liitetyt kaupat ja yhteyshenkilöt.

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

Tulokset:

YHDISTETTYYHDISTYSTYYPPI	OBJEKTITUNNUS	OBJEKTITUNNUKSEEN
0–5	6626541373	233620335

Esimerkki 3

Hae kaikki tiettyyn kontaktiin (kontaktitunnus: 4464) liittyvät kaupat. Sen sijaan, että combinedAssociationTypeId olisi koodattu kiinteästi, tässä esimerkissä tehdään liitos association_definitions-taulukon avulla.

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;

Tulokset:

YHDISTETTYYHTEYSTYYPPITUNNUS	FROMOBJECTID	TOOBJECTID
0–5	6626541373	233620335

Omistajakyselyt

omistajat

Tämä tietokantaobjekti sisältää tietoja HubSpot-tilisi käyttäjistä. Käyttäjät voidaan määrittää tietueiden omistajiksi, ja niillä on sekä käyttäjätunnus että omistajatunnus 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`	Luku	Käyttäjän omistajan tunnus.
`USERID`	Luku	Käyttäjän käyttäjätunnus. Käyttäjät, joiden tässä sarakkeessa on arvo NULL, 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 sarakkeiden tietotyypeistä.
`UPDATEDAT`	Aikaleima	Päivämäärä ja kellonaika, jolloin käyttäjä päivitettiin viimeksi HubSpotissa. Katso lisätietoja sarakkeiden tietotyypeistä.
`INGESTEDAT`	Aikaleima	Päivämäärä ja kellonaika, jolloin Snowflake on viimeksi tuonut tiedot järjestelmään.

Esimerkki 1

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

Kysely:

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

Palauttaa:

OWNERID	USERID	SÄHKÖPOSTI	ETUNIMI	SUKUNIMI
29584574	4621126	233620335	Hobbes	Baron
30532717	4874784	3866015468	Pablo	Walters
30580321	925511	7132752747	Milo	Kulta
...	...	...	...	...

Esimerkki 2

Hae tietty omistaja omistajan tunnuksen perusteella.

Kysely:

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

Tulokset:

OWNERID	KÄYTTÄJÄTUNNUS	SÄHKÖPOSTI	ETUNIMI	SUKUNIMI
29584574	4621126	233620335	Hobbes	Baron

Esimerkki 3

Hae kaikki kontaktit ja niiden omistajat. Tämä kysely yhdistää tietueet omistajiin object_with_object_properties-ominaisuuden ja kontaktin hubspot_owner_id-ominaisuuden avulla.

SELECT

contact.objectId AS contact_id,

contact.properties:firstname::string AS contact_firstname,

contact.properties:lastname::string AS contact_lastname,

contact.properties:hubspot_owner_id::number AS contact_hubspot_owner_id,

omistaja.etunimi AS omistajan_etunimi,

omistaja.sukunimi AS omistajan_sukunimi,

omistaja.sähköposti AS omistajan_sähköpostiosoite

FROM objekti_jossa_on_objektin_ominaisuudet AS contact

LIITÄ omistajat AS omistaja

ON contact.properties:hubspot_owner_id::number = owner.ownerId

WHERE contact.objectTypeId = '0-1';

Tulokset:

YHTEYSTUNNUS	YHTEYSHENKILÖN_ETUNIMI	YHTEYSHENKILÖN_SUKUNIMI	YHTEYSHENKILÖN_HUBSPOT_OMISTAJA_TUNNUS	OMISTAJAN_ETUNIMI	OMISTAJAN_SUKUNIMI	OWNER_SÄHKÖPOSTI
113834202	Richard	Greenfield	29584574	Hobbes	Baron	hobbes.b@business.com
53540801	Ford	Karl	30241125	Milo	Gold	milo.g@business.com
...	...	...	...	...	...	...

Tiimikyselyt

tiimit

HubSpotin tiimien avulla voit järjestää käyttäjät ryhmiin organisaation hallintaa ja raportointia varten. Voit luoda päätiimin ja lisä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	Luku	Ylätason joukkueen tunnus.
CHILDTEAMIDS	Taulukko	Alajoukkueiden tunnukset.
PRIMARYOWNERMEMBERS	Varchar	Joukkueen pääjäsenten omistajatunnukset.
SECONDARYOWNERMEMBERS	Boolean	Tiimin toissijaisten jäsenten omistajatunnukset.
INGESTEDAT	Aikaleima	Päivämäärä ja kellonaika, jolloin Snowflake on viimeksi ottanut tiedot vastaan.

Esimerkki 1

Hae kaikki tiimit.

Kysely:

SELECT teamId,teamName, primaryOwnerMembers

FROM teams

Palauttaa:

JOUKKUEEN TUNNUS	JOUKKUEEN NIMI	PÄÄOMISTAJAT
29584574	Alajoukkue	[233620335, 1234553]
30532717	Superjoukkue	[3866015468, 126221873]
3058032	A-joukkue	[7132752747]

owner_team

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

Tämä tietokantaobjekti voi palauttaa seuraavat sarakkeet:

Sarakkeen nimi	Tyyppi	Kuvaus
TEAMID	Luku	Joukkueen tunnus.
OWNERID	Numero	Käyttäjän omistajan tunnus.
ISTEAMPRIMARY	Boolilainen	Onko tämä tiimi tämän omistajan ensisijainen tiimi.
INGESTEDAT	Aikaleima	Päivämäärä ja kellonaika, jolloin Snowflake on viimeksi ottanut tiedot vastaan.

Esimerkki 1

Hae tietyn joukkueen kaikki omistajat.

Kysely:

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

Palauttaa

TEAMID	TEAMNAME	ISTEAMPRIMARY
29584574	233620335	TRUE
29584574	1234553	TRUE

Pipeline-kyselyt

Alla on ohjeet kauppa- ja tikettiputkistotietoja, kuten tililläsi käytettävissä olevat putkistot ja niiden vaiheet.

Voit yhdistää nämä tiedot objektitietoihin, jolloin saat kattavan kuvan myyntiprosesseistasi. Voit esimerkiksi hakea kauppoja ja niiden myyntiprosesseja yhdistämällä object_with_object_properties pipelines.

pipelines

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

Tämä taulukko voi palauttaa seuraavat sarakkeet:

Sarakkeen nimi	Tyyppi	Kuvaus
`PIPELINEID`	Varchar	Putkilinjan tunnus.
`OBJECTTYPEID`	Varchar	Pipelinessa mahdollisesti olevan objektin (esim. kaupan tai tiketin) tunnus.
`LABEL`	Varchar	Pipelin nimi HubSpotissa.
`DISPLAYORDER`	Luku	Järjestys, jossa myyntiputki näkyy HubSpotissa.
`ARCHIVED`	Booli	Onko myyntiputki poistettu.
`CREATEDAT`	Aikaleima	Milloin putkisto luotiin.
`UPDATEDAT`	Aikaleima	Päivämäärä ja kellonaika, jolloin tiedot päivitettiin viimeksi HubSpotissa. Lue lisää sarakkeiden tietotyypeistä.
`INGESTEDAT`	Aikaleima	Päivämäärä ja kellonaika, jolloin Snowflake on viimeksi tuonut tiedot järjestelmään.

Esimerkki 1

Hae kaikki käytettävissä olevat kauppaputket 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 myyntiputken sisällä olevat kaupat käyttämälläobject_with_object_properties-funktiota.

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 -rekisteröityminen	Myyntiputki
605457408	Friskiesin brändiuudistus	Myyntiputki
604362473	Fresh Step -sovelluksen kehittäminen	Myyntiputki

pipeline_stages

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

Tämä tietokantaobjekti voi palauttaa seuraavat sarakkeet:

Sarakkeen nimi	Tyyppi	Kuvaus
`PIPELINEID`	Varchar	Putkilinjan tunnus.
`STAGEID`	Varchar	Vaiheen tunnus.
`LABEL`	Varchar	Vaiheen nimi HubSpotissa.
`DISPLAYORDER`	Numero	Järjestys, jossa myyntiputki näkyy HubSpotissa.
`METADATA`	Variant	JSON-muotoinen kuvaus vaiheesta, mukaan lukien tieto siitä, onko se avoin vai suljettu
`ARCHIVED`	Booli	Onko putkistovaihe poistettu.
`CREATEDAT`	Aikaleima	Milloin putkistovaihe luotiin.

Esimerkki 1

Hae myyntiputken nimeltäSales pipeline vaiheet.

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	Yhteyttä otettu
941650	941652	Tapaaminen sovittu
941650	941653	Lasku lähetetty
...	...	...

Esimerkki 2

Hae kaikki kaupat ja niiden vastaavat myyntiputken vaiheet.

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

Tulokset:

DEAL_ID	DEAL_NAME	PIPELINE_NAME	PIPELINE_STAGE_NAME
605140072	Meowmix Global -rekisteröityminen	Myyntiputki	Sopimus lähetetty
605457408	Friskiesin brändiuudistus	Myyntiputki	Tapaaminen sovittu
604362473	Fresh Step -sovelluksen kehittäminen	Myyntiputki	Sopimus allekirjoitettu
...	...	...	...

Kiinteistökyselyt

property_definitions

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

Voit tunnistaa tiettyjä ominaisuuksia yhdistämällä niiden objektityypin tunnuksen ja nimen. Voit hakea vastaavia tietoja properties-sovellusliittymän avulla.

Tämä tietokantaobjekti voi palauttaa seuraavat sarakkeet:

Sarakkeen nimi	Tyyppi	Kuvaus
`OBJECTYPEID`	Varchar	Tapahtuman kohteena olevan objektin tunnus.
`NAME`	Varchar	Ominaisuuden sisäinen nimi.
`LABEL`	Varchar	Ominaisuuden nimike.
`DESCRIPTION`	Varchar	Ominaisuuden kuvaus.
`TYPE`	Varchar	Kiinteistön tyyppi (esim. merkkijono, luku, päivämäärä ja kellonaika).
`FIELDTYPE`	Varchar	Ominaisuuden kenttätyyppi. Määrittää, miten ominaisuus näkyy HubSpotissa ja lomakkeissa (esim. valintaruutu, pudotusvalikko).
`DISPLAYORDER`	Luku	Ominaisuuden näyttöjärjestys.
`GROUPNAME`	Varchar	Kiinteistön ryhmän nimi.
`OPTIONS`	Variant	Luettelomaisissa ominaisuuksissa taulukko, joka sisältää ominaisuuden vaihtoehdot sekä kunkin vaihtoehdon attribuutit (esim. näyttöjärjestys, nimike).
`CREATEDUSERID`	Luku	Ominaisuuden luoneen käyttäjän tunnus.
`REFERENCEDOBJECTTYPE`	Varchar	Objektin tyyppi, johon ominaisuus viittaa. Omistajaominaisuudet palauttavat arvon OWNER.
`CALCULATED`	Boolean	Onko ominaisuus laskettu ominaisuus.
`EXTERNALOPTIONS`	Boolean	Määrittääkö ominaisuuden asetukset on määritelty ulkoisessa järjestelmässä.
`HASUNIQUEVALUE`	Boolean	Onko ominaisuuden arvot yksilöllisiä. Voidaan asettaa vain luotaessa ominaisuutta API:n kautta.
`HIDDEN`	Boolean	Onko ominaisuus piilotettu HubSpotissa.
`SHOWCURRENCYSYMBOL`	Boolean	Onko numeerisen ominaisuuden arvo muotoiltu valuuttamuotoon.
`FORMFIELD`	Booli	Voidaanko tätä ominaisuutta käyttää lomakkeissa.
`READONLYDEFINITION`	Boolean	Voidaanko ominaisuutta muokata HubSpotissa.
`READONLYVALUE`	Boolean	Voidaanko ominaisuuden arvoa muokata HubSpotissa.
`HUBSPOTDEFINED`	Booli	Onko ominaisuus HubSpotin luoma vai käyttäjän luoma.
`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 päivitettiin viimeksi HubSpotissa. Lue lisää sarakkeiden tietotyypeistä.
`INGESTEDAT`	Aikaleima	Päivämäärä ja kellonaika, jolloin Snowflake on viimeksi tuonut tiedot järjestelmään.

Esimerkki 1

Hae kaikkien kontaktien ominaisuuksien nimet ja kuvaukset.

Kysely:

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

Palauttaa:

NAME	LABEL	KUVAUS
entered_sql_stage	Siirretty SQL-vaiheeseen	Aloita SQL-vaiheen päivien laskeminen.
ensimmäisen_konversiotapahtuman_nimi	Ensimmäinen muuntaminen	Ensimmäinen lomake, jonka tämä kontakti lähetti.
osoite	Katuosoite	Yhteyshenkilön osoite.

Tapahtumakyselyt

Tapahtumiin kuuluvat HubSpotin vakiotapahtumat ja mukautetut käyttäytymistapahtumat. Jokaisella tapahtumalla on oma tietokantaobjektinsa, jonka nimi on events_eventname.

Nimi
EVENTS_AD_INTERACTION	Mainoksen tiedot ja kontaktit, jotka ovat olleet vuorovaikutuksessa mainoksen kanssa napsauttamalla sitä tai lähettämällä lomakkeen sen kanssa vuorovaikutuksen jälkeen.
EVENTS_AD_METRICS_IMPORTED_V0	Mainoksen tiedot ja sen suorituskykymittarit.
EVENTS_CALL_MENTIONED_KEYWORD	Tiedot avainsanoista, jotka osallistujat ovat maininneet puhelujen aikana.
EVENTS_CLICKED_LINK_IN_EMAIL_V2	Yhteyshenkilöiden markkinointisähköposteissa napsautetut linkit.
EVENTS_CLICKED_LINK_IN_TRACKED_INBOX_EMAIL_V8	Yhteyshenkilöiden Conversations-postilaatikon sähköposteissa napsautetut linkit.
EVENTS_COOKIE_BANNER_CLICKED	Yhteyshenkilöt, jotka ovat napsauttaneet evästeitä.
EVENTS_COOKIE_BANNER_VIEWED	Yhteyshenkilöt, jotka ovat katsoneet evästeitä.
EVENTS_DOCUMENT_SHARED_V2	Myyntiasiakirjat, jotka on jaettu yhteyshenkilöille ulkoisen linkin kautta.
EVENTS_DOCUMENT_VIEWED_V2	Myyntiasiakirjat ja yhteyshenkilöt, jotka ovat katsoneet niitä avaamalla ulkoisen linkin.
EVENTS_DOCUMENT_COMPLETED_V2	Myyntiasiakirjat ja yhteyshenkilöt, jotka ovat saattaneet ne päätökseen.
EVENTS_HS_SCHEDULED_EMAIL_V2	HubSpotin sähköpostipalvelimille lähetettäväksi toimitetut sähköpostit.
EVENTS_MTA_DELIVERED_EMAIL_V2	HubSpotin sähköpostipalvelimien vastaanottajille onnistuneesti toimittamat sähköpostit.
EVENTS_MTA_BOUNCED_EMAIL_V2	Sähköpostin toimitusyritykset, jotka vastaanottajan sähköpostipalvelin on hylännyt.
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_OPENED_TRACKED_INBOX_EMAIL_V8	Yhteyshenkilöiden avaamat sähköpostit seurannassa olevassa postilaatikossa.
EVENTS_MB_MEDIA_PLAYED	Yhteyshenkilöiden videotoistotoiminta.
EVENTS_V2_CONTACT_BOOKED_MEETING_THROUGH_SEQUENCE	Yhteyshenkilö on varannut tapaamisen sekvenssin kautta.
EVENTS_V2_CONTACT_ENROLLED_IN_SEQUENCE	Yhteyshenkilö on ilmoittautunut sekvenssiin.
EVENTS_V2_CONTACT_FINISHED_SEQUENCE	Sekvenssi on päättynyt.
EVENTS_V2_CONTACT_REPLIED_SEQUENCE_EMAIL	Yhteyshenkilö vastasi sekvenssin kautta lähetettyyn sähköpostiin (tai saapuneeseen sähköpostiin, jolla hän poistui sekvenssistä).
EVENTS_V2_CONTACT_UNENROLLED_FROM_SEQUENCE	Yhteyshenkilö on poistunut sekvenssistä.
EVENTS_V2_CONTACT_UNENROLLED_MANUALLY_FROM_SEQUENCE	Käyttäjä poisti kontaktin manuaalisesti sekvenssistä.
EVENTS_V2_CONTACT_UNSUBSCRIBED_SEQUENCE_EMAIL	Yhteyshenkilö on peruuttanut tilauksensa, jolloin hänet on poistettu sekvenssistä.
EVENTS_V2_SEQUENCE_EMAIL_BOUNCED	Sarjan sähköposti palautui.
EVENTS_V2_SEQUENCE_ERRORED	Sarjassa ilmeni virhe, joka johti poistumiseen.
EVENTS_V2_SEQUENCE_STEP_EXECUTED	Sarjan vaihe suoritettu.
EVENTS_VISITED_PAGE	Yhteyshenkilöiden verkkosivuvierailut.
EVENTS_<INTEGRATION_EVENT_NAME>_<UNIQUE_IDENTIFIER>	Integrointitapahtumat (Timeline V3 API)

Voit tunnistaa tapahtumat yhdistämällä niiden tapahtumatyypin tunnuksen ja tunnuksen. Palautettavat sarakkeet riippuvat tapahtumasta, ja jokaiselle tapahtuman ominaisuudelle on yksi sarake. Kaikista tapahtumista palautetaan seuraavat sarakkeet:

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

occurredat
occurredatdateint

Nämä sarakkeet korvaavat occuredat ja occuredatdateint 24. marraskuuta 2022. Tuona päivänä vanhat sarakkeet eivät enää ole käytettävissä, ja yritykset hakea tietokantaobjektia tai näkymää, joka sisältää tapahtumia näiden sarakkeiden avulla, epäonnistuvat. Lue lisää Snowflake-tietojen jakamisen merkittävistä muutoksista.

Sarakkeen nimi	Tyyppi	Kuvaus
`EVENTTYPEID`	Varchar	Tapahtumatyypin tunnus, samanlainen kuin OBJECTTYPEID Voit hakea kaikki tilisi tapahtumatyyppitunnukset object_and_event_type_definitions -näkymän avulla.
`ID`	Varchar	Tunnus on yksilöllinen kunkin tapahtumatyypin osalta. Kahdella tietueella ei voi olla samaa tunnusta saman tapahtumatyypin sisällä.
`OBJECTTYPEID`	Varchar	Tapahtuman suorittaneen objektin tyyppi. Esimerkiksi sähköpostilinkin klikkauksessa tässä sarakkeessa näkyy`0-1`, mikä edustaa kontaktiobjektia.
`OBJECTID`	Luku	Tapahtuman suorittaneen tietueen tunnus.
`OCCURREDAT`	Aikaleima	Milloin tapahtuma tapahtui.
`OCCURREDATDATEINT`	Luku	Luku, joka edustaa tapahtuman ajankohtaa. Sisältää samat tiedot kuin `OCCURREDAT` ake, mutta on muotoiltu lukuna ja sitä käytetään osana taulukon klusteriavainta. Useimmissa tapauksissa voit käyttää `OCCURREDAT` tämän luvun sijaan.
`OCCUREDATDATEINT`	Luku	Luku, joka edustaa tapahtuman ajankohtaa. Sisältää samat tiedot kuin `OCCURREDAT` ake, mutta on muotoiltu lukuna ja sitä käytetään osana taulukon klusteriavainta. Useimmissa tapauksissa voit käyttää `OCCURREDAT` tämän luvun sijaan. Huomaa: tämä sarake poistuu käytöstä 24. marraskuuta 2022 ja korvataan sarakkeella `OCCURREDATDATEINT`.
`OCCUREDAT`	Aikaleima	Milloin tapahtuma tapahtui. Huomaa: tämä sarake poistuu käytöstä 24. marraskuuta 2022 ja korvataan sarakkeella `OCCURREDAT`.
`INGESTEDAT`	Aikaleima	Päivämäärä ja kellonaika, jolloin Snowflake on viimeksi ottanut tiedot vastaan. Lue lisää sarakkeiden tietotyypeistä.
`PROPERTY_*`	Varchar	Yksittäiset sarakkeet, jotka sisältävät tapahtuman ominaisuudet.

Esimerkki 1

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

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	4.8.2016 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	29.8.2016 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	30.11.2017 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 klikkaus tapahtumat niiden kontaktien osalta, jotka ovat klikanneet. Tämä kysely hakee kontaktitiedot yhdistämällä object_with_object_properties-taulukoita.

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;

Tulokset:

CLICK_TIMESTAMP	CLICK_URL	CONTACT_FIRSTNAME	CONTACT_LASTNAME
4.1.2019 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
8.11.2018 09:37:41.400	https://www.website.net/webinar-case-study?utm_source=hs_automation&utm_medium=email&utm_content=55200164	Milo	Kulta
8.11.2018 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_definitions

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

Tämä tietokantaobjekti voi palauttaa seuraavat sarakkeet:

Sarakkeen nimi	Tyyppi	Kuvaus
`OBJECTTYPEID`	Varchar	Pipelineen sisältämän objektin (esim. kaupan tai tiketin) tunniste.
`FULLYQUALIFIEDNAME`	Varchar	Objektin tai tapahtuman nimi.
`INGESTEDAT`	Aikaleima	Päivämäärä ja kellonaika, jolloin Snowflake on viimeksi ottanut tiedot vastaan. Lue lisää 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	KESKUSTELU
...	...

Segmenttikyselyt

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

segmentit

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

Tämä tietokantaobjekti voi palauttaa seuraavat sarakkeet:

Sarakkeen nimi	Tyyppi	Kuvaus
`OBJECTTYPEID`	Varchar	Segmentin tietueiden tyyppi (esim. yhteyshenkilö tai yritys).
`SEGMENTID`	Luku	Segmentin tunniste. Liitetään segmenttijäsenyystaulukonSEGMENTID- sarakkeeseen.
`CLASSICSEGMENTID`	Luku	Yhteyssegmenteille ominaista tunnusta, joka vastaa segmentin URL-osoitteessa HubSpotissa olevaa tunnusta.
`NAME`	Varchar	Segmentin nimi.
`SIZE`	Luku	Segmentin tietueiden lukumäärä.
`CREATEDBYUSERID`	Luku	Segmentin luoneen käyttäjän tunnus.
`CREATEDAT`	Aikaleima	Milloin segmentti luotiin HubSpotissa.
`UPDATEDBYUSERID`	Luku	Sen käyttäjän tunnus, joka on viimeksi päivittänyt segmentin.
`UPDATEDAT`	Aikaleima	Päivämäärä ja kellonaika, jolloin segmentti päivitettiin viimeksi HubSpotissa. Lue lisää sarakkeiden tietotyypeistä.
`INGESTEDAT`	Aikaleima	Päivämäärä ja kellonaika, jolloin Snowflake on viimeksi tuonut tiedot järjestelmään.

Esimerkki 1

Hae kaikki kontaktisegmentit.

Kysely:

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

Palauttaa:

SEGMENTSID	NAME	KOKO
118131	Viikoittainen tavoittavuus	103
66156	Blogin tilaajat	455
771 852	Suosituimmat tilaajat 2021	37
...	...	...

Esimerkki 2

Hae tietty yhteyshenkilösegmentti nimeltä Top subscribers 2021.

Kysely:

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

Tulokset:

SEGMENTID	NIMI	KOKO
771 852	Suosituimmat tilaajat 2021	37

segment_membership

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

Sisältää vain segmenttitunnukset ja objektitunnukset. Lisätietoja saat yhdistämällä segmenttitietokantaobjekt in.

Tämä tietokantaobjekti voi palauttaa seuraavat sarakkeet:

Sarakkeen nimi	Tyyppi	Kuvaus
`SEGMENTID`	Varchar	Segmentin tunniste. Liittyy segmenttitabelin HS_SEGMENT_ID-sarakkeeseen.
`OBJECTID`	Varchar	Segmentin tietueen tunnus.
`UPDATEDAT`	Aikaleima	Päivämäärä ja kellonaika, jolloin tiedot päivitettiin viimeksi HubSpotissa. Lue lisää sarakkeiden tietotyypeistä.
`INGESTEDAT`	Aikaleima	Päivämäärä ja kellonaika, jolloin Snowflake on viimeksi tuonut tiedot järjestelmään.

Esimerkki 1

Hae kaikkien”Top subscribers 2021 ” -segmentin kontaktien 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 segmentin Top subscribers 2021 kontaktien etu- ja sukunimet.

Kysely:

SELECT

contact.objectId AS object_id,

contact.properties:firstname::string AS etunimi,

contact.properties:lastname::string AS sukunimi

FROM object_with_object_properties AS yhteystieto

SISÄLIITOS segmentin_jäsenyydet AS jäsenyys

ON contact.objectId = membership.objectId

INNER JOIN segmentit

ON jäsenyys.segmentti-ID = segmentit.segmentti-ID

WHERE contact.objectTypeId = '0-1'

JA segments.objectTypeId = '0-1'

JA segmentit.nimi = 'Suosituimmat tilaajat 2021';

Tulokset:

OBJECTID	ETUNIMI	SUKUNIMI
54325098	Hobbes	Baron
96805401	Milo	Gold
6922028	Henry	Riley
...	...	...

Usein kysytyt kysymykset

Haluan luoda Hubspot-sovelluksen raportin kaltaisia tietoja. Miten se tehdään?

Yleensä kannattaa tarkastella vertailukohteena olevan raportin sarakkeita. Jos raportin visualisointi ei ole taulukkomuotoinen, sen muuntaminen taulukoksi paljastaa raportin sisältämät sarakkeet. Nämä sarakkeet ovat yleensä objektityypin tai tapahtumatyypin ominaisuuksia. Seuraava vaihe on selvittää, mihin objektityypin ominaisuuteen sarake vastaa. Voit tehdä tämän tekemällä kyselyn property_definitions-taulukkoon:

SELECT * FROM property_definitions

WHERE label = [column_name]

Aina ei välttämättä löydy tarkkaa vastaavuutta, koska jotkin ominaisuusnimet on sovelluksessa yleensä muutettu kuvaavammiksi nimiksi. Tällaisissa tapauksissa voi olla apua tehdä likimääräinen haku LIKE-operaattorilla property_definitions-taulukon label-sarakkeesta (tai jopa description-sarakkeesta).

Kun on selvitetty, mihin objektityyppiin sarake kuuluu, on helppo määrittää, mitä kyseltävä. Tee kysely object_with_object_properties ja suodata kyseisen tyypin objectTypeId n mukaan. Lue tarvittavat ominaisuusarvot properties-JSON-sarakkeesta.

Miten voin linkittää tämän tietotyypin toiseen, esimerkiksi miten haetaan kampanjan lomakkeet?

Voit hakea kuhunkin kampanjaan liittyvät lomakkeet yhdistämällä OBJECT_WITH_OBJECT_PROPERTIES, ASSOCIATIONS- ja ASSOCIATION_DEFINITIONS.

SELECT DISTINCT

campaigns.properties:hs_name::string AS kampanjan_nimi,

lomakkeet.ominaisuudet:hs_lomake_id::merkkijono AS form_id

FROM object_with_object_properties AS kampanjat

LIITÄ yhdistykset AS yhdistys

ON yhdistys.objectId = kampanjat.objectId

LIITÄ association_definitions AS määritelmä

ON määritelmä.yhdistettyYhdistelmäTyyppiTunnus =

association.combinedAssociationTypeId

LIITÄ object_with_object_properties AS lomakkeet

ON forms.objectId = association.toObjectId

WHERE campaigns.objectTypeId = '0-35'

JA lomakkeet.objektityyppi = '0-28'

JA määritelmä.objektityyppitunnus = '0-35'

JA määritelmä.kohdetyyppitunnus = '0-28';

Miten saan selville HubSpot-Snowflake-integraation tilan?

Voit saada reaaliaikaisia tilapäivityksiä HubSpot-Snowflake-integraation häiriöistä ja ongelmista tekemällä kyselyn data_share_status-näkymään:

SELECT * FROM hubspot.public.data_share_status LIMIT 1

Tulokset näytetään seuraavasti:

TILA	VIESTI	PÄIVITYSPÄIVÄ
OK	TÄLLÄ HETKELLÄ EI TIEDETÄ MITÄÄN TAPAHTUMAA	10.4.2023 klo 09:21:20.123

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

Oliko tästä artikkelista apua?

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

HubSpot-tietojen kysely Snowflakessa

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

Tietojen viive ja Snowflake-tilisi alue

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

Tietojen yleiskatsaus

Palautettavien tietojen rajoittaminen ja järjestäminen

Sarakkeiden tietotyypit

Tietotyyppien muuntaminen

Objektikyselyt

object_with_object_properties

Esimerkki 1

Esimerkki 2

objektit

Esimerkki 1

object_properties

Esimerkki 1

Esimerkki 2

object_properties_history

Esimerkki 1

Esimerkki 2

Yhdistelmäkyselyt

association_definitions

Esimerkki 1

Esimerkki 2

associations

Esimerkki 1

Esimerkki 2

Esimerkki 3

Omistajakyselyt

omistajat

Esimerkki 1

Esimerkki 2

Esimerkki 3

Tiimikyselyt

tiimit

Esimerkki 1

owner_team

Esimerkki 1

Pipeline-kyselyt

pipelines

Esimerkki 1

Esimerkki 2

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_definitions

Esimerkki 1

Segmenttikyselyt

segmentit

Esimerkki 1

Esimerkki 2

segment_membership

Esimerkki 1

Esimerkki 2

Usein kysytyt kysymykset

Haluan luoda Hubspot-sovelluksen raportin kaltaisia tietoja. Miten se tehdään?

Miten voin linkittää tämän tietotyypin toiseen, esimerkiksi miten haetaan kampanjan lomakkeet?

Miten saan selville HubSpot-Snowflake-integraation tilan?

Asiaan liittyvä sisältö