Vie HubSpot-tiedot PostgreSQL:ään tai MySQL:ään

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

Yhteenveto

Käytä Data Out -toimintoa viedäksesi valitut HubSpot CRM -tiedot hallinnoimaasi PostgreSQL- tai MySQL-tietokantaan. Voit synkronoida objekti-, assosiaatio- ja tapahtumatiedot tietokantasi taulukoihin ja sitten hakea tietoja SQL:llä tai käyttää niitä liiketoimintatiedon hallinta- ja analyysityökaluissasi.

Jokainen synkronointi luo täydellisen tilannekuvan valituista tiedoista. Kun synkronointi onnistuu, se korvaa edellisen tilannekuvan kohdetabeleissa.

Ennen kuin aloitat

Tutustu vaatimuksiin

• PostgreSQL- tai MySQL-tietokantasi on oltava saavutettavissa tilisi alueen HubSpot-IP-alueista.
• Tietokantapalvelimesi on tuettava SSL-yhteyksiä.
• Sinulla on oltava tietokantakäyttäjä, jolla on tarvittavat käyttöoikeudet:
  • PostgreSQL: CREATE -oikeus ja kirjoitusoikeus kohdeskeemaan.
  • MySQL: CREATE -oikeus tietokantaan ja kirjoitusoikeus.
• Varmista, että tietokantakäyttäjälläsi on oikeus luoda taulukoita ja kirjoittaa tietoja.
• Pidä HubSpot-tilisi ja tietokantakonsolit auki erillisissä välilehdissä.

Salli HubSpotin IP-osoitteet

Lisää tilisi alueen HubSpot-IP-alue tietokantapalvelimesi sallittujen listalle.

Tutustu rajoituksiin ja huomioitaviin seikkoihin

• Jokainen synkronointi luo täydellisen tilannekuvan valituista tiedoista.
• Onnistunut synkronointi korvaa edellisen tilannekuvan kohdetabeleissa.
• HubSpot ei säilytä aiempia tilannekuvia.
• Jos taulukon synkronointi epäonnistuu, sen aiemmat tiedot pysyvät käytettävissä seuraavaan onnistuneeseen synkronointiin asti.
• Jokainen objektityyppi, tapahtumatyyppi tai assosiaatiopari voidaan sisällyttää yhteen toistuvaan PostgreSQL-synkronointiin ja yhteen toistuvaan MySQL-synkronointiin tiliä kohden.
• Jokainen synkronointi korvaa kohdetabelin. Tietokantapalveluntarjoajaan lisätyt taulukoiden tasoiset käyttöoikeudet tai asetukset eivät säily synkronointien välillä.
• Jos muodostat yhteyden uudelleen eri tietokantakäyttäjän avulla, sinun on myönnettävä kyseiselle käyttäjälle käyttöoikeudet olemassa oleviin HubSpotin hallinnoimiin skeemoihin, tietokantoihin tai taulukoihin.

Yhdistä HubSpot PostgreSQL- tai MySQL-tietokantaan

1. Napsauta HubSpot-tilissäsi Lisää ja siirry sitten kohtaan Tietojenhallinta > Data Studio. Jos Lisää-kohtaa ei näy tilissäsi, siirry suoraan kohtaan Tietojenhallinta > Data Studio.
2. Napsauta oikeassa yläkulmassa kohtaa Yhdistä ulkoinen tietolähde.
3. Etsi tai selaa tietokantapalveluntarjoajaa Lisää tietolähde -paneelissa.
4. Napsauta PostgreSQL tai MySQL.
5. Syötä tietokantayhteyden tiedot:
   • Isäntä
   • Portti
   • SSL
   • Käyttäjätunnus
   • Salasana
6. PostgreSQL:n osalta syötä sen tietokannan nimi, johon HubSpotin tulisi luoda skeema.
7. Napsauta Yhdistä PostgreSQL:ään tai Yhdistä MySQL:ään.

HubSpot käyttää yhdistettyä tietokantakäyttäjää taulukoiden luomiseen ja tietojen lataamiseen tietokantaasi.

Määritä synkronointi

1. Valitse vietävät tietolähteet:
   • Objektit
   • Yhteydet
   • Tapahtumat
2. Valitse mukaan otettavat objektit, ominaisuudet, assosiaatiot tai tapahtumat.
3. Valitse, kuinka usein synkronointi suoritetaan ja milloin se aloitetaan.
4. Napsauta Aloita synkronointi.

Käytettävissä olevat synkronointivälit voivat vaihdella beta-vaiheen aikana. Vaihtoehtoja voivat olla kerran, 6 tunnin välein, 12 tunnin välein, päivittäin, viikoittain tai kuukausittain.

Käytä vietyjä tietojasi

HubSpot luo HubSpotin hallinnoiman skeeman tai tietokannan jokaiselle kohteelle.

PostgreSQL

PostgreSQL-taulukot käyttävät seuraavaa muotoa:

<database>.hubspot_data_out_<destination-id>.<table-name>

Esimerkiksi:

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"

MySQL

MySQL-taulukot noudattavat seuraavaa muotoa:

hubspot_data_out_<destination-id>.<table-name>

Esimerkiksi:

hubspot_data_out_456.OBJECT_WITH_OBJECT_PROPERTIES
hubspot_data_out_456.EVENTS_VISITED_PAGE
hubspot_data_out_456.ASSOCIATIONS_CONTACTS_TO_COMPANIES

Tarkka skeema tai tietokannan nimi löytyy synkronointiasetussivulta.

Taulukko- ja sarakkeen nimet

Taulukko- ja sarakkeen nimet perustuvat vietyihin tietoihin. PostgreSQL-tunnisteet voivat sisältää enintään 63 merkkiä. MySQL-tunnisteet voivat sisältää enintään 64 merkkiä. Pidemmät nimet lyhennetään sovellettavan rajoituksen mukaisiksi.

HubSpot luo PostgreSQL-taulukoita ja -sarakkeita, joiden nimet on kirjoitettu lainausmerkeissä ja joissa kirjainkoko on säilytetty. Kun teet kyselyjä PostgreSQL:ään, käytä kaksoislainausmerkkejä ja noudata taulukon ja sarakkeen nimissä näkyvää kirjainkokoa.

MySQL:ssä käytä takaviivoja ja noudata esitettyä isojen ja pienten kirjainten käyttöä. Taulukkonimien kirjainkokoa koskeva herkkyys voi vaihdella MySQL-palvelimen määritysten mukaan.

Saraketyypit

PROPERTIES -taulukon OBJECT_WITH_OBJECT_PROPERTIES -sarake tallennetaan JSON-muotoisena merkkijonona. Se tallennetaan PostgreSQL:ssä TEXT tyyppisenä ja MySQL:ssä LONGTEXT, ei natiivina JSON-saraketyyppinä.

Objektitaulukot

Jos valitset objektitietoja, HubSpot vie seuraavat taulukot.

OBJECT_PROPERTIES

Tämä taulukko sisältää yhden rivin jokaiselle objektin ominaisuusarvolle.

OBJECT_WITH_OBJECT_PROPERTIES

Tämä taulukko sisältää yhden rivin jokaisesta objektitietueesta. Valitut ominaisuusarvot on ryhmitelty PROPERTIES -sarakkeeseen.

Eri objektityyppien objektitiedot yhdistetään tässä taulukossa. Suodata OBJECTTYPEID mukaan, jos haluat lukea tietueita tietystä objektityypistä.

• Yhteystiedot: 0-1
• Mukautetut objektit: 2-{unique_id}, esimerkiksi 2-12345

OBJECT_PROPERTIES_HISTORY

Tämä taulukko sisältää ominaisuuksien muutoshistorian. Se sisältää yhden rivin jokaiselle ominaisuuden historialliselle arvolle.

Voit tarkastella tietyn tietueen ja ominaisuuden koko historiaa lajittelemalla tulokset UPDATEDAT mukaan.

Yhdistämistaulukot

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

ASSOCIATIONS

Tämä taulukko sisältää yhden rivin jokaiselle valitulle kahden tietueen väliselle assosiaatiolle.

ASSOCIATION_DEFINITIONS

Tämä taulukko sisältää yhden rivin jokaiselle valitulle assosiaatiomääritelmälle.

Parikohtaiset assosiaatiotaulukot

Valittujen yhdistelmäparien osalta HubSpot voi myös viedä taulukoita seuraavassa muodossa:

ASSOCIATIONS_<FROM_OBJECT_TYPE>_TO_<TO_OBJECT_TYPE>

Esimerkiksi:

ASSOCIATIONS_CONTACTS_TO_COMPANIES

Nämä taulukot sisältävät assosiaatiotietueita ja assosiaatiomääritelmien metatietoja.

Tapahtumataulukot

Jos valitset tapahtumatiedot, HubSpot vie yhden taulukon kutakin tapahtumatyyppiä kohti. Tapahtumataulukoiden nimet noudattavat seuraavaa muotoa:

EVENTS_<EVENT_NAME>

Esimerkiksi:

EVENTS_VISITED_PAGE

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

Seuraa synkronointia

1. Napsauta HubSpot-tilissäsi Lisää ja siirry sitten kohtaan Tietojenhallinta > Tietojen integraatio. Jos Lisää-kohtaa ei näy tilissäsi, siirry suoraan kohtaan Tietojenhallinta > Tietojen integraatio.
2. Napsauta vasemmalla puolella Sovellusten synkronoinnit.
3. Etsi tai valitse PostgreSQL- tai MySQL-synkronointi.

Synkronoinnin tietosivulta voit tarkastella synkronoinnin tilaa, viimeisintä synkronointiaikaa, virheitä, synkronointitoimintaa ja synkronointihistoriaa. Voit myös keskeyttää, arkistoida tai suorittaa synkronoinnin manuaalisesti.

Synkronointitilat

Synkronointiongelmien ratkaiseminen

Kun synkronointi epäonnistuu:

• HubSpotin käyttöliittymässä näkyy tila Epäonnistui sekä taulukotason tiedot, joista käy ilmi, mitkä taulukot onnistuivat ja mitkä epäonnistuivat.
• Taulukko päivitetään vasta, kun HubSpot on ladannut kaikki sen tiedot.
• Jos taulukon synkronointi epäonnistuu, sen aiemmat tiedot säilyvät ennallaan seuraavaan onnistuneeseen synkronointiin asti.
• Seuraava ajoitettu synkronointi yrittää automaattisesti koko synkronointia uudelleen.
• Voit suorittaa synkronoinnin manuaalisesti synkronoinnin tietosivulta.

Taulukot, joiden synkronointi onnistui aikaisemmalla ajolla, eivät muutu, vaikka myöhempi ajo epäonnistuisi.

Usein kysytyt kysymykset

Miten voin tehdä kyselyjä vietyihin tietoihin?

Kysele taulukoita kohdeskeemasta tai -tietokannasta SQL:n avulla.

PostgreSQL

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

-- Read a property from the PROPERTIES column
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

-- Read all contact records
SELECT *
FROM `hubspot_data_out_456`.`OBJECT_WITH_OBJECT_PROPERTIES`
WHERE `OBJECTTYPEID` = '0-1';

-- Read a property from the PROPERTIES column
SELECT
  `OBJECTID`,
  JSON_EXTRACT(`PROPERTIES`, '$.email') AS email
FROM `hubspot_data_out_456`.`OBJECT_WITH_OBJECT_PROPERTIES`
WHERE `OBJECTTYPEID` = '0-1';

Voinko viedä yhden tietotyypin useissa synkronoinneissa?

Jokainen objektityyppi, tapahtumatyyppi tai assosiaatiopari voidaan sisällyttää yhteen toistuvaan PostgreSQL-synkronointiin ja yhteen toistuvaan MySQL-synkronointiin HubSpot-tiliä kohden.

Esimerkiksi, jos yhteystiedot on jo viety toistuvaan PostgreSQL-kohteeseen, et voi lisätä yhteystietoja toiseen toistuvaan PostgreSQL-määritykseen, ennen kuin olet arkistoinut ensimmäisen määrityksen. Voit kuitenkin viedä yhteystietoja samanaikaisesti toistuvaan MySQL-määritykseen.

Tuetaanko objektikohtaisia taulukoita?

Objektikohtaisia taulukoita, kuten OBJECTS_CONTACTS, ei tällä hetkellä tueta. Käytä OBJECT_WITH_OBJECT_PROPERTIES ja suodata OBJECTTYPEID mukaan, kun haluat hakea tietueita tietyn objektityypin osalta.

Tuetaanko arkaluonteisia tietoja?

Herkkiä tietoja ei tällä hetkellä tueta Data Out -toiminnossa. Herkät ominaisuudet voidaan jättää pois viennistä.

Säilyttääkö HubSpot aiemmat tilannekuvat?

Ei. Jokainen onnistunut synkronointi korvaa kohdetabelin uusimmalla tilannekuvalla. HubSpot ei säilytä aiempia tilannekuvia.

Jos taulukon synkronointi epäonnistuu, sen aiemmat tiedot säilyvät paikallaan, kunnes taulukko päivitetään onnistuneesti.

Käyttääkö HubSpot minun hallinnoimaani väliaikaista tallennustilaa?

Ei. HubSpot vie tiedot Parquet-muodossa ja hallinnoi väliaikaista tallennustilaa sisäisesti. Sinun ei tarvitse tarjota asiakkaan omistamaa väliaikaista tallennustilaa PostgreSQL:lle tai MySQL:lle.

Mitä tapahtuu, jos vaihdan tietokannan käyttäjää?

Jos muodostat yhteyden uudelleen eri tietokantakäyttäjällä, sinun on myönnettävä uudelle käyttäjälle pääsy olemassa oleviin HubSpotin hallinnoimiin skeemoihin, tietokantoihin tai taulukoihin.