BetaKäytä HubSpot-tietojasi PostgreSQL- tai MySQL-tietokannasta

Käytä PostgreSQL- ja MySQL-tukia sisältävää Data Out -toimintoa viedäksesi valitut HubSpot CRM -tiedot omistamaasi tietokannan taulukoihin. Jokainen synkronointikierros tallentaa valituista tiedoista täydellisen tilannekuvan ja korvaa edellisen tilannekuvan. Synkronoinnin jälkeen voit tehdä kyselyjä taulukoihin SQL:n avulla tai haluamillasi BI- ja analytiikkatyökaluilla yhdistääksesi HubSpot-tiedot muihin liiketoimintatietoihin.

Huomaa: jos olet pääkäyttäjä, liitä tilisiData Studio -beetaversioon, jottavoit käyttää tätä ominaisuutta.

Tutustu rajoituksiin ja huomioitaviin seikkoihin

Ennen kuin alat käyttää tätä ominaisuutta, varmista, että ymmärrät täysin, mitkä toimenpiteet on suoritettava etukäteen, sekä ominaisuuden rajoitukset ja sen käytön mahdolliset seuraukset.

• Jokainen synkronointi korvaa kohdetabellit uusimmalla tilannekuvalla. HubSpot ei säilytä aiempia tilannekuvia.
• Jokainen objekti, tapahtumatyyppi tai assosiaatiopari voidaan sisällyttää yhteen toistuvaan PostgreSQL-synkronointiin ja yhteen toistuvaan MySQL-synkronointiin HubSpot-tiliä kohden. Nämä synkronoinnit ovat toisistaan ja muista Data Out -palveluntarjoajista riippumattomia.
• Herkkiä tietoja ei vielä tueta. Herkät ominaisuudet voidaan jättää pois viennistä.
• Objektikohtaisia taulukoita, kuten OBJECTS_CONTACTS, ei vielä tueta.
• Taulukko- ja sarakkeiden nimissä otetaan PostgreSQL:ssä huomioon kirjainkoko, ja sama voi päteä myös MySQL:ssä. Tutustu kyselysyntaksiin ennen kyselyjen kirjoittamista.

Tutustu viedäisiin tietoihin

Voit synkronoida seuraavat tiedot HubSpotista PostgreSQL:ään tai MySQL:ään:

• Objektit: vakio- ja mukautetut objektit, kuten yhteystiedot, yritykset, kaupat, tiketit ja tuotteet.
• Tietueet: valittujen objektien yksittäiset tietueet.
• Ominaisuudet: valitut ominaisuusarvot ja ominaisuushistoria tietueissa.
• Yhteydet: valitut suhteet tietueiden välillä, mukaan lukien yhteysmääritelmät.
• Tapahtumat: valitut HubSpotin vakiotapahtumat ja mukautetut käyttäytymistapahtumat, mukaan lukien valitut tapahtumaominaisuudet.

Eri objektien tiedot yhdistetään objektitaulukoihin. Kun luet objektitaulukkoa, käytä OBJECTTYPEID suodattaaksesi tietyn objektin. Esimerkiksi yhteystiedoille käytetään 0-1. Mukautetuille objekteille annetaan tunnus niiden luomisen yhteydessä, ja ne tunnistetaan muodossa 2-{unique_id}, kuten 2-12345.

Tutustu vientimuotoon

Asennuksen aikana valitset:

• Kohdetietokanta. Tämä koskee vain PostgreSQL:ää. MySQL:n tapauksessa HubSpot luo tietokannan.
• Synkronoitavat tietolähteet: objektit, tapahtumat, assosiaatiot tai näiden lähteiden yhdistelmä.
• Synkronointiaikataulu.

HubSpot vie tiedot Parquet-tiedostoina ja lataa ne suoraan tietokantasi taulukoihin. PostgreSQL ja MySQL eivät käytä asiakkaan omistamaa väliaikaista tallennustilaa. HubSpot hallinnoi väliaikaista tallennustilaa sisäisesti.

Etsi tiedot tietokannastasi

HubSpot luo yhden taulukon kutakin tietolähdettä kohti HubSpotin hallinnoimaan skeemaan, joka on nimetty kohteesi mukaan. Löydät tarkan skeeman nimen synkronoinnin asetussivulta.

• PostgreSQL: <database>.hubspot_data_out_<destination-id>.<table-name>
• MySQL: hubspot_data_out_<destination-id>.<table-name>. MySQL:ssä skeema ja tietokanta ovat sama asia, ja HubSpot luo ne. Erillistä tietokantatasoa ei tarvitse valita.

Esimerkiksi PostgreSQL:ssä:

• your_database.hubspot_data_out_456.OBJECT_WITH_OBJECT_PROPERTIES
• your_database.hubspot_data_out_456.EVENTS_VISITED_PAGE
• your_database.hubspot_data_out_456.ASSOCIATIONS_CONTACTS_TO_COMPANIES

Esimerkiksi MySQL:ssä:

• hubspot_data_out_456.OBJECT_WITH_OBJECT_PROPERTIES
• hubspot_data_out_456.EVENTS_VISITED_PAGE
• hubspot_data_out_456.ASSOCIATIONS_CONTACTS_TO_COMPANIES

Jokainen synkronointi korvaa taulukon uusimmalla tilannekuvalla. HubSpot ei säilytä aiempia tilannekuvia. Jos taulukon synkronointi epäonnistuu, sen aiemmat tiedot säilyvät paikallaan seuraavaan onnistuneeseen synkronointiin asti.

Taulukko- ja sarakkeen nimet

Taulukko- ja sarakkeen nimet peräisin viedyistä tiedoista. PostgreSQL-tunnisteiden pituus on rajoitettu 63 merkkiin ja MySQL-tunnisteiden 64 merkkiin. HubSpot lyhentää pidemmät nimet sopiviksi.

Tunnisteiden kirjainkoko

Tunnisteiden kirjainkoko on merkitsevä. HubSpot luo kaikki taulukot ja sarakkeet lainausmerkeillä varustetuilla, kirjainkokoa säilyttävillä nimillä, jotka ovat isoja kirjaimia ja vastaavat tämän artikkelin taulukoita.

• PostgreSQL: kirjoita nimet tarkalleen kuten kuvassa on esitetty kaksoislainausmerkeissä. PostgreSQL muuttaa lainausmerkeillä ympäröimättömät nimet pieniksi kirjaimiksi, jolloin ne eivät täsmää.
• MySQL: käytä takaviivoja ja noudata esitettyä kirjainkokoa. Taulujen nimien kirjainkoko riippuu palvelimesi asetuksista.

PostgreSQL-esimerkki:

SELECT * FROM your_database.hubspot_data_out_456."OBJECT_WITH_OBJECT_PROPERTIES" WHERE "OBJECTTYPEID" = '0-1';

MySQL-esimerkki:

SELECT * FROM `hubspot_data_out_456`.`OBJECT_WITH_OBJECT_PROPERTIES` WHERE `OBJECTTYPEID` = '0-1';

Saraketyypit

Saraketyypit noudattavat vietyjä tietoja ja vastaavat PostgreSQL- ja MySQL-tyyppejä seuraavasti:

Huomaa: PROPERTIES on OBJECT_WITH_OBJECT_PROPERTIES sarake viedään JSON-muotoisena merkkijonona. Se tallennetaan PostgreSQL:ssä TEXT yppisenä ja MySQL:ssä LONGTEXT, ei JSON-saraketyyppinä. Kyselyesimerkkejä on FAQ-osiossa.

Tarkista objektitaulukot

Jos valitset objektitiedot, HubSpot vie seuraavat taulukot.

OBJECT_PROPERTIES

Tämä taulukko sisältää yhden rivin kutakin ominaisuusarvoa kohti. Voit lukea tietyn objektin suodattamalla OBJECTTYPEID mukaan.

OBJECT_WITH_OBJECT_PROPERTIES

Tämä taulukko sisältää yhden rivin kutakin tietuetta kohti, ja valitut ominaisuusarvot on ryhmitelty yhteen PROPERTIES -sarakkeeseen. Voit lukea tietyn objektin suodattamalla OBJECTTYPEID mukaan.

OBJECT_PROPERTIES_HISTORY

Tämä taulukko sisältää ominaisuuksien muutoshistorian. Toisin kuin OBJECT_PROPERTIES, joka sisältää vain nykyisen arvon, tässä taulukossa on yksi rivi kutakin ominaisuuden historiallista arvoa kohden. Jos haluat nähdä yksittäisen tietueen ja ominaisuuden koko aikajanan, lajittele tulokset UPDATEDAT mukaan.

Tarkista assosiaatiotaulukot

Jos valitset assosiaatiotiedot, HubSpot vie assosiaatiotietueet ja assosiaatiomääritelmät.

ASSOCIATIONS

Tämä taulukko sisältää yhden rivin kutakin valittua kahden tietueen välistä assosiaatiota kohti.

ASSOCIATION_DEFINITIONS

Tämä taulukko sisältää yhden rivin kutakin valittua assosiaatiomääritelmää kohti.

ASSOCIATIONS_<FROM_OBJECT>_TO_<TO_OBJECT>

Valittujen liitosparien osalta HubSpot voi myös viedä parikohtaisia liitostaulukoita, kuten ASSOCIATIONS_CONTACTS_TO_COMPANIES. Nämä taulukot sisältävät liitostietueet sekä liitosten määritelmien metatiedot.

Tarkista tapahtumataulukot

Jos valitset tapahtumatietoja, HubSpot vie yhden taulukon kutakin tapahtumatyyppiä kohti. Taulukoiden nimet ovat muodossa EVENTS_<EVENT_NAME>, kuten EVENTS_VISITED_PAGE.

Jokainen tapahtumataulukko sisältää vakiotapahtumasarakkeet ja yhden sarakkeen kutakin valittua tapahtumaominaisuutta kohti.

Hallitse synkronointiaikataulua

Määrität synkronointiaikataulun HubSpotin asennuksen yhteydessä. Voit myös käynnistää synkronoinnin manuaalisesti HubSpotista. Jokainen synkronointikierros tuottaa täydellisen tilannekuvan valituista tiedoista. Voit hallita tietomäärää valitsemalla, mitkä objektit, tapahtumat, assosiaatiot ja ominaisuudet sisällytetään.

Huomaa: beetavaiheen aikana saatavilla voi olla vain rajoitettu joukko synkronointivälejä, kuten kerran, 6 tunnin välein, 12 tunnin välein, päivittäin, viikoittain ja kuukausittain. Lisää synkronointiväliä saatetaan lisätä tulevissa versioissa.

Synkronointien seuranta ja virheiden käsittely

Voit seurata PostgreSQL- ja MySQL-synkronointeja HubSpotissa. Synkronoinnilla voi olla jokin seuraavista tiloista:

Kun synkronointi epäonnistuu:

• HubSpot näyttää tilan Epäonnistui ja taulukoittain tiedot siitä, mitkä taulukot onnistuivat ja mitkä epäonnistuivat.
• Taulukko päivitetään vasta, kun HubSpot on ladannut kaikki sen tiedot, joten et näe koskaan osittain ladattua taulukkoa.
• Jos taulukon synkronointi epäonnistuu, sen aiemmat tiedot säilyvät paikallaan seuraavaan onnistuneeseen synkronointiin asti.
• Seuraava ajoitettu synkronointi yrittää automaattisesti suorittaa täyden synkronoinnin uudelleen.
• Voit käynnistää synkronoinnin uudelleen manuaalisesti milloin tahansa HubSpotissa.

Taulukoita, joiden synkronointi onnistui edellisellä kerralla, ei muuteta, vaikka myöhempi synkronointi epäonnistuisi.

Usein kysytyt kysymykset

Miten voin tehdä kyselyjä dataan?

Kysele kohdeskeeman taulukoista SQL:n avulla.

PostgreSQL

Lue kaikki yhteystietotietueet:

SELECT * FROM your_database.hubspot_data_out_456."OBJECT_WITH_OBJECT_PROPERTIES" WHERE "OBJECTTYPEID" = '0-1';

Lue tietty ominaisuus PROPERTIES -JSON-sarakkeesta. Muunna sarake ensin JSON-muotoon, koska se on tallennettu tekstinä:

SELECT "OBJECTID", json_extract_path_text("PROPERTIES"::json, 'email') AS email FROM your_database.hubspot_data_out_456."OBJECT_WITH_OBJECT_PROPERTIES" WHERE "OBJECTTYPEID" = '0-1';

MySQL

Lue kaikki yhteystietotietueet:

SELECT * FROM `hubspot_data_out_456`.`OBJECT_WITH_OBJECT_PROPERTIES` WHERE `OBJECTTYPEID` = '0-1';

Lue tietty ominaisuus PROPERTIES -JSON-sarakkeesta:

SELECT `OBJECTID`, JSON_EXTRACT(`PROPERTIES`, '$.email') AS email FROM `hubspot_data_out_456`.`OBJECT_WITH_OBJECT_PROPERTIES` WHERE `OBJECTTYPEID` = '0-1';

Voinko viedä yhtä tietotyyppiä useissa synkronoinneissa?

Jokainen objekti, tapahtumatyyppi tai assosiaatiopari voidaan sisällyttää yhteen toistuvaan PostgreSQL-synkronointiin ja yhteen toistuvaan MySQL-synkronointiin HubSpot-tiliä kohden. Nämä synkronoinnit ovat toisistaan ja muista Data Out -palveluntarjoajista riippumattomia. Jos esimerkiksi yhteystiedot on jo viety toistuvaan PostgreSQL-kohteeseen, et voi lisätä yhteystietoja toiseen toistuvaan PostgreSQL-synkronointiin, ennen kuin olet arkistoinut ensimmäisen synkronoinnin. Voit kuitenkin viedä yhteystietoja samanaikaisesti toistuvaan MySQL-synkronointiin.

Tuetaanko objektikohtaisia taulukoita?

Ei. Objektikohtaisia taulukoita, kuten OBJECTS_CONTACTS, ei vielä tueta. Käytä OBJECT_WITH_OBJECT_PROPERTIES ja suodata OBJECTTYPEID perusteella saadaksesi tietueet tietystä objektista.

Tuetaanko arkaluonteisia tietoja?

Ei. Arkaluonteisia tietoja ei tueta vielä Data Out -toiminnossa. Arkaluonteiset ominaisuudet voidaan jättää pois viennistä.

Säilyttääkö HubSpot aiemmat tilannekuvat?

Ei. Jokainen synkronointi korvaa kohdetabelin uusimmalla tilannekuvalla, joten aiempia tilannekuvia ei säilytetä.