BetaHubSpot-tietojen synkronointi Amazon S3:een

Käytä Amazon S3 -integraatiota synkronoidaksesi HubSpot CRM -tiedot omistamaasi Amazon S3 -säilytyspaikkaan. Voit valita, mitkä objektit, liitännät ja tapahtumat synkronoidaan, määrittää toistuvan synkronointiaikataulun ja seurata synkronoinnin tilaa suoraan HubSpotista.

Jokainen synkronointi vie valittujen tietojen täydellisen tilannekuvan Parquet-muodossa Amazon S3 -säilytyspaikkaasi. Voit sitten käyttää synkronoituja tietoja analytiikka- ja tietojenkäsittelytyökaluissa, kuten AWS Glue, Amazon Athena, Amazon EMR, Spark, Databricks tai Python-muistikirjoissa.

Huomaa: Amazon S3 -integraatio on käytettävissä uusille Amazon S3 -käyttäjille, jotka eivät käytä vanhaa Amazon S3 -integraatiota. Jos olet pääkäyttäjä, voit ottaa tilisi mukaan uuteen Amazon S3 -integraation beetaversioon.

Ennen kuin aloitat

Ennen kuin aloitat tietojen synkronoinnin Amazon S3:een, tutustu seuraaviin vaatimuksiin ja rajoituksiin.

Tutustu vaatimuksiin

• Jos olet pääkäyttäjä, liitä tilisi Amazon S3 -integraation beetaversioon.
• Sinun on luotava HubSpot-tiliisi liitetty AWS Identity and Access Management (IAM) -rooli.

Tutustu rajoituksiin ja huomioitaviin seikkoihin

• Beta-vaiheen aikana tiedot synkronoidaan vain Parquet-muodossa.
• Jokainen synkronointi luo täydellisen tilannekuvan valituista tiedoista.
• HubSpot luo uuden kansion jokaiselle synkronoinnille eikä poista aiempia synkronointeja S3-säilöstäsi.
• Arkaluonteisten tietojen synkronointia ei tueta.

Luo IAM-rooli AWS:ssä

Voit määrittää HubSpotin käyttöoikeudet AWS Management Consolessa seuraavasti:

1. Kirjaudu sisään AWS-hallintakonsoliin.
2. Napsauta kotisivun hallintapaneelissa Palvelut > Turvallisuus, identiteetti ja vaatimustenmukaisuus > IAM.
3. Napsauta vasemmassa sivupalkissa Roolit.
4. Napsauta Luo rooli.
5. Valitse Luotettu entiteettityyppi -osiosta oma AWS-tilisi.
6. Valitse AWS-tili -osiosta Another AWS account ja syötä oma AWS-tilisi tunnus. Muutat myöhemmin luottamussuhdetta, jotta HubSpot saa käyttöoikeuden.
7. Valitse Vaadi ulkoinen tunnus ja syötä paikkamerkki-tunnus, kuten 0000. Muutat myöhemmin IAM-roolisi luottamussuhdetta ja määrität ulkoisen tunnuksen tallennusintegraatiollesi. Ulkoista tunnusta käytetään myöntämään pääsy AWS-resursseihisi kolmannen osapuolen sovellukselle, kuten HubSpotille.

8. Napsauta Seuraava.
9. Syötä Roolin tiedot -osiossa Roolin nimi ja Kuvaus roolin tunnistamista varten.
10. Napsauta Luo rooli.
11. Kopioi Yhteenveto -sivulta ARN-arvo. Käytät tätä arvoa seuraavassa vaiheessa.

Yhdistä HubSpot ja AWS S3

1. Napsauta HubSpot-tilisi ylänavigointipalkin kauppakuvaketta ja valitse HubSpot-kauppa.
2. Etsi hakupalkista Amazon S3 ja valitse se.
3. Napsauta Asenna.
4. Valitse AWS IAM -roolisi ja napsauta sitten Asenna.
5. Napsauta Seuraava.
6. Syötä AWS IAM -roolin ARN-arvo Role ARN -kenttään.
7. Napsauta Yhdistä Amazon S3:een.

Määritä säilytyspaikan käyttöoikeudet

HubSpot tarvitsee seuraavat käyttöoikeudet AWS S3 -säilöön ja -kansioon, jotta se pääsee käsiksi kansion ja alikansioiden tiedostoihin:

• s3:GetBucketLocation
• s3:GetObject
• s3:GetObjectVersion
• s3:ListBucket
• s3:LisääObjekti
• s3:PoistaObjekti

Kun olet yhdistänyt sovelluksen, myönnä HubSpotille oikeus synkronoida tietoja S3-säilöön.

1. Napsauta HubSpot-tilisi ylänavigointipalkin asetuskuvaketta. Siiry vasemman sivuvalikkopalkin kohtaan Integraatiot > Yhdistetyt sovellukset.
2. Napsauta Amazon S3.
3. Napsauta oikeanpuoleisessa paneelissa Valitse sen Amazon S3 -tilin kohdalla, johon haluat synkronoida tietoja.
4. Napsauta Oikeudet-s ivulla Kopioi-painiketta kopioidaksesi esimerkkioikeuskäytännön ja liittääksesi sen aiemmin luomaasi AWS IAM -rooliin. Muista päivittää oikeuskäytäntö omilla säilytyspaikkasi nimillä.

5. Kirjaudu sisään AWS Management Consoleen.
6. Napsauta kotisivun hallintapaneelissa Palvelut > Turvallisuus, identiteetti ja vaatimustenmukaisuus > IAM.
7. Napsauta vasemmassa sivupalkissa Tilin asetukset.
8. Etsi Security Token Service (STS) -osiosta se AWS-alue, joka vastaa AWS-tilisi sijaintialuetta. Napsauta kytkintä akt ivoidaksesi alueen.
9. Napsauta vasemmassa sivupalkissa Policies.
10. Napsauta Luo käytäntö.
11. Napsauta JSON -välilehdessä Lisää uusi lauseke.
12. Lisää vaiheessa 4 kopioimasi käytäntö, joka antaa HubSpotille tarvittavat käyttöoikeudet tietojen lataamiseen tai poistamiseen yhden säilytyspaikan ja kansiopolun avulla.

13. Napsauta Seuraava.
14. Lisää Tarkista ja luo -osiossa käytäntönimi ja valinnainen kuvaus.
15. Napsauta Luo käytäntö.

Määritä kohdebucket

1. Palaa HubSpotin Oikeudet -sivulle ja kirjoita Bucket -kenttään säilytyspaikan nimi.
2. Napsauta Testaa yhteys.

3. Jos yhteystesti onnistuu, napsauta Seuraava.

Määritä synkronointi

1. Valitse Tietolähde-sivulla tiedot, jotka haluat synkronoida.
2. Valitse valintaruudut niiden objektien, assosiaatioiden ja tapahtumien kohdalla, jotka haluat synkronoida HubSpotista Amazon S3:een.

3. Napsauta Seuraava.
4. Napsauta Tiedot-sivulla Synkronointitiheys-pudotusvalikkoa ja valitse, kuinka usein haluat synkronoida tiedot HubSpotista Amazon S3:een.

5. Napsauta Aloita synkronointi.

Hallitse synkronointia

Kun synkronointi on määritetty ja tietojen synkronointi HubSpotista Amazon S3:een on alkanut, voit tarkistaa sen tilan, tunnistaa virheitä, päivittää asetuksia tai arkistoida synkronoinnin.

Synkronoinnin tarkistaminen ja hallinta:

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. Siirry Sovellusten synkronoinnit -välilehdelle ja etsi taulukosta Amazon S3 -synkronointisi.
3. Tarkista synkronoinnin tila:

• • Synkronointi: synkronointia suoritetaan parhaillaan.
  • Synkronoitu: viimeisin synkronointi suoritettiin onnistuneesti.
  • Epäonnistui: viimeisimmässä synkronoinnissa ilmeni virhe.
  • Arkistoitu: synkronointimääritykset on poistettu.

4. Napsauta synkronoinnin nimeä nähdäksesi lisätietoja, kuten onnistuneesti synkronoidut ja epäonnistuneet tietueet.

Synkronoinnin muokkaaminen tai poistaminen:

1. Napsauta taulukossa Amazon S3 -synkronointia.
2. Napsauta oikeassa yläkulmassa Toiminnot -pudotusvalikkoa ja valitse sitten jokin seuraavista:

• • Muokkaa synkronointia: päivitä synkronointiasetukset.
  • Arkistoi synkronointi: poista synkronointiasetukset.

HubSpotin ja Amazon S3:n välisen synkronoinnin tietomuoto

Synkronoitavat tiedot

Voit synkronoida seuraavat tiedot HubSpotista AWS S3:een:

• Objektit: vakio- ja mukautetut objektit, kuten yhteystiedot, yritykset, tiketit tai tuotteet.
• Tietueet: yksittäiset objektitietueet.
• Ominaisuudet: objektitietueiden ominaisuudet ja niiden arvot, mukaan lukien ominaisuuksien historia.
• Yhteydet: kaikki yhteystyypit ja niihin liittyvät tietueet.
• Tapahtumat: valitut HubSpotin vakiotapahtumat ja mukautetut käyttäytymistapahtumat, mukaan lukien valitut tapahtumaominaisuudet.

Erilaiset objektitiedot on järjestetty ja saatavilla kahdella tavalla:

• Yksittäinen: kukin objektityyppi tallennetaan omaan taulukkoonsa, ja siinä on vain saman objektityypin tietueita. Esimerkiksi objects_contacts sisältää vain yhteystietueita.
• Yhdistetty: kaikkien objektityyppien kaikki tietueet yhdistetään yhdeksi tietokantaobjektiksi. Siksi kyselyä tehdessäsi sinun on määritettävä suodatin, kuten ”WHERE objectTypeId=’0-1’

Mukautetuille objekteille annetaan tunnus luomisen yhteydessä, ja ne tunnistetaan muodossa 2-unique_ID. Esimerkiksi 2-12345.

S3-kansiostorakenne

HubSpot tallentaa jokaisen onnistuneen synkronoinnin HubSpotin hallinnoimaan etuliitteeseen Amazon S3 -säilössäsi seuraavan rakenteen mukaisesti:

s3://<bucket-name>/hubspot-dataout/<account-id>/<run-id>/<table-name>/<file-name>

Esimerkiksi:

s3://my-company-hubspot-data/hubspot-dataout/12345678/98765/OBJECT_WITH_OBJECT_PROPERTIES/part-000.parquet

s3://my-company-hubspot-data/hubspot-dataout/12345678/98765/EVENTS_VISITED_PAGE/part-000.parquet

s3://my-company-hubspot-data/hubspot-dataout/12345678/98765/ASSOCIATIONS_CONTACTS_TO_COMPANIES/part-000.parquet

Jokainen synkronointi luo uuden run-id kansion. HubSpot ei poista aiempien synkronointikierrosten tietoja.

Jos haluat poistaa vanhemmat synkronointitiedot automaattisesti, määritä Amazon S3 -elinkaarikäytäntö säilytyspaikalle tai etuliitteelle.

HubSpot luo tiedostonimet jokaiselle synkronointikierrokselle, ja tiedostonimet voivat vaihdella synkronointikierrosten välillä. Älä määritä jatkoprosesseja riippuvaisiksi tietyistä tiedostonimistä. Lue sen sijaan kaikki tiedostot siitä table-name, joka vastaa käsiteltävää vientikierrosta.

Objektitiedostot

Jos valitset objektitiedot, HubSpot vie seuraavat kansiot.

OBJECTS_PROPERTIES

Yksi rivi kutakin objektin ominaisuusarvoa kohti.

OBJECT_WITH_OBJECT_PROPERTIES

Yksi rivi kutakin objektitietuetta kohti, ja valitut ominaisuusarvot on ryhmitelty yhteen PROPERTIES -sarakkeeseen.

Jos haluat lukea tietyn objektityypin tästä kansiosta, suodata tuloksia OBJECTTYPEID-tunnisteen perusteella.

Yhdistämistiedostot

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

ASSOCIATIONS

Yksi rivi kutakin valittua kahden objektitietueen välistä assosiaatiota kohti.

ASSOCIATION_DEFINITIONS

Yksi rivi kutakin valittua assosiaatiomääritelmää kohti.

ASSOCIATIONS_<LÄHTÖOBJEKTITYYPPI>_TO_<KOHDEOBJEKTITYYPPI>

Valittujen assosiaatioparien osalta HubSpot synkronoi myös tiettyjä assosiaatiopareja koskevat kansiot, kuten ASSOCIATIONS_CONTACTS_TO_COMPANIES. Nämä kansiot sisältävät assosiaatiotietueet ja niihin liittyvät määritelmien metatiedot.

Tapahtumatiedostot

Jos valitset tapahtumatiedot, HubSpot vie yhden kansion kutakin tapahtumatyyppiä kohti. Kansioiden nimet ovat muodossa EVENTS_<EVENT_NAME>, kuten EVENTS_VISITED_PAGE.

Jokainen tapahtumakansio sisältää vakiotapahtumasarakkeet sekä sarakkeen jokaiselle asetusten määrittelyn yhteydessä valitulle tapahtumaominaisuudelle.