BetaKäytä HubSpot-tietojasi Amazon Redshiftin kautta

Käytä Data Out for Amazon Redshift -toimintoa viedäksesi valitut HubSpot CRM -tiedot taulukoihin omistamassasi Amazon Redshift -tietokannassa. 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 kohdetabelit uusimmalla tilannekuvalla. HubSpot ei säilytä aiempia tilannekuvia Redshiftissä.
• HubSpot ei poista S3-säilöön väliaikaisesti tallentamiaan Parquet-tiedostoja. Jos haluat poistaa ne automaattisesti, määritä S3-elinkaarikäytäntö säilölle tai etuliitteelle.
• Jokainen objekti, tapahtumatyyppi tai assosiaatiopari voidaan sisällyttää yhteen toistuvaan Redshift Data Out -synkronointiin HubSpot-tiliä kohden.
• Herkkiä tietoja ei vielä tueta. Herkät ominaisuudet voidaan jättää pois viennistä.
• Objektikohtaisia taulukoita, kuten OBJECTS_CONTACTS, ei vielä tueta.

Tutustu viedäisiin tietoihin

Voit synkronoida seuraavat tiedot HubSpotista Amazon Redshiftiin:

• Objektit: vakio- ja mukautetut objektit, kuten kontaktit, yritykset, kaupat, tiketit ja tuotteet.
• Tietueet: valittujen objektien yksittäiset tietueet.
• Ominaisuudet: valitut ominaisuusarvot ja tietueiden ominaisuushistoria.
• 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 seuraavat asetukset:

• Redshift-tietokanta sekä klusteri tai palvelimeton työryhmä, johon HubSpot luo taulukoita.
• S3-säilö, jota HubSpot käyttää tietojen välivarastointiin ennen niiden lataamista Redshiftiin.
• Synkronoitavat tietolähteet: objektit, tapahtumat, assosiaatiot tai näiden lähteiden yhdistelmä.
• Synkronointiaikataulu.

HubSpot vie tiedot Parquet-tiedostoina, tallentaa tiedostot väliaikaisesti S3-säilöön ja lataa ne Redshift-taulukoihin.

Huomaa: HubSpot ei poista tietoja väliaikaisesta säilytyspaikasta. On suositeltavaa määrittää säilytyspaikan elinkaarikäytäntö, joka puhdistaa säilytyspaikan automaattisesti.

Etsi tietosi Redshiftistä

HubSpot luo yhden taulukon kutakin tietolähdettä kohti HubSpotin hallinnoimassa skeemassa, joka on nimetty kohteesi mukaan:

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

Löydät skeeman nimen Redshift-synkronoinnin määrityssivulta. Esimerkki:

• 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

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

HubSpot tallentaa Parquet-tiedostot S3-säilöön HubSpotin hallinnoiman etuliitteen alle ja lataa ne sitten Redshiftiin:

s3://<bucket>/<prefix>/hubspot-dataout/<portal-id>/<destination-id>/<run-id>/<table-name>/

Nämä väliaikaiset tiedostot pysyvät säilytyspaikassasi, kunnes poistat ne. Jos haluat poistaa ne automaattisesti, määritä S3-elinkaarikäytäntö säilytyspaikalle tai etuliitteelle.

Huomaa: taulukko- ja sarakkeen nimet ovat peräisin viedyistä tiedoista. Niitä saatetaan lyhentää, jotta ne mahtuvat Redshiftin 127 merkin tunnisteen pituusrajoitukseen. Saraketyypit noudattavat vietyjä tietoja.

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 Amazon Redshift -synkronointeja HubSpotissa. Synkronoinnilla voi olla jokin seuraavista tiloista:

Kun synkronointi epäonnistuu:

• HubSpot näyttää tilan ”Epäonnistui”, ja taulukoittain esitettävissä yksityiskohdissa näkyy, mitkä taulukot latautuivat onnistuneesti ja mitkä eivät.
• Taulukko päivitetään vasta, kun HubSpot on ladannut kaikki sen tiedot, joten osittain ladattuja taulukoita ei näy.
• Jos taulukon synkronointi epäonnistuu, sen aiemmat tiedot säilyvät ennallaan seuraavaan onnistuneeseen synkronointiin asti.
• Seuraava ajoitettu synkronointi yrittää automaattisesti suorittaa täydellisen 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 taulukoita SQL:llä. Esimerkiksi:

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:

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

Voinko viedä yhden tietotyypin useissa Redshift-synkronoinneissa?

Jokainen objekti, tapahtumatyyppi tai assosiaatiopari voidaan sisällyttää yhteen toistuvaan Redshift Data Out -synkronointiin HubSpot-tiliä kohden. Esimerkiksi, jos yhteystiedot on jo viety yhteen toistuvaan Redshift-kohteeseen, et voi lisätä yhteystietoja toiseen toistuvaan Redshift-synkronointiin, ennen kuin olet arkistoinut ensimmäisen synkronoinnin.

Tuetaanko objektikohtaisia taulukoita?

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

Tuetaanko arkaluonteisia tietoja?

Ei. Arkaluonteisia tietoja ei vielä tueta Data Out to Redshift -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ä Redshiftissä. HubSpot ei myöskään poista väliaikaisia Parquet-tiedostoja, jotka se tallentaa S3-säilöön. Määritä S3-elinkaarikäytäntö, jotta ne vanhenevat automaattisesti.