Olet tässä:
Amazon S3 -yhteys
Luo etäyhteys käyttämällä Amazon S3 -liitintä synkronoidaksesi CSV-dataasi S3-säiliöstä CRM Analyticsiin.
Yhteyden lisätiedot
On tärkeää, että tunnet S3-säiliösi hierarkian, jotta voit määrittää tämän liittimen. Määritä S3-säiliöasetuksesi ja pääkansion kansiopolun, kun luot yhteyttä. Valitse sitten yksi tai useampi objekti, eli ylätason kansion alikansiot, jotka sisältävät CSV-tiedostot, jotka haluat synkronoida CRM Analyticsiin. Kun synkronoit yhdistetyn objektin, CRM Analytics etsii CSV-tiedoston nimeltään schema_sample.csv havaitakseen CSV-datan muodon kansiossa ja näyttääkseen datan esikatselun. Huomaa kuitenkin, että mitään tietoja ei tuoda schema_sample.csv-tiedostosta. Esikatselussa voit tarkastella ja muuttaa kaikkien kansiosta lataamiesi tiedostojen kenttäattribuutteja.
CRM Analytics käyttää schema_sample.csv-tiedostoa luodakseen käytettävissä olevat kentät, jotta voit valita haluamasi kentät. Liitin lataa sitten alikansiossa valittua kenttää vastaavat CSV-tiedostot ja liittää rivit yhteen objektiin.
Tämän yhteyden luomiseen käytetyn Amazon S3 -tilin käyttöoikeuksien täytyy sisältää ListBucket ja GetObject. Käyttöoikeuksien täytyy sisältää resurssien myönnät kategorialle ja joko "mikä tahansa objekti" tai tarkasti määrittämäsi ARN-numerot, jotka edustavat viitattavaa polkua ja objekteja. Esimerkki:
Luo yhteys
- Napsauta Datan hallinta -sivun Yhteydet-välilehdestä Uusi yhteys.
- Napsauta liittimen nimeä ja napsauta Seuraava.
- Syötä liittimen asetukset.
- Vahvista asetuksesi ja yritä muodostaa yhteys lähteeseen napsauttamalla Tallenna ja testaa. Jos yhteys epäonnistuu, CRM Analytics näyttää mahdolliset syyt.
Jokainen asetus vaatii arvon, ellei toisin osoiteta.
| Asetus | Kuvaus |
|---|---|
| Yhteyden nimi | Tunnistaa yhteyden. Käytä nimeämiskäytäntöä, jonka avulla voit tunnistaa eri yhteydet toisistaan. |
| Kehitysnimi | Yhteyden API-nimi. Tämä nimi ei voi sisältää välilyöntejä. API-nimeä käytetään resepteissäsi viittaamaan tämän yhteyden kautta noudettuun dataan. Et voi muuttaa kehitysnimeä yhteyden luomisen jälkeen. |
| Kuvaus | Yhteyden kuvaus. |
| Authentication Type (Todennuksen tyyppi) | Syötä standarditodennukseksi Root. Syötä AWS Identity Access Management (IAM) -todennukseksi IAM. Jos haluat tarkentaa AWS-datan käyttöä, käytä IAM-todennusta ja määritä IAM-käyttäjiä ja -rooleja AWS:ssä. Lisätietoja AWS IAM:stä on kohdassa AWS:n IAM:n käytön aloittaminen. |
| Käyttöoikeusavain | Amazon S3 -säiliösi käyttöoikeuden avaintunnus. |
| Salainen avain | Salainen Amazon-käyttöoikeusavaimesi. |
| AWS Role ARN | Vain IAM-todennuksen IAM-roolin ARN. Löydät sen AWS:n IAM-roolien määrityksistä. |
| Kansion polku | Polku kansioon, johon haluat muodostaa yhteyden. Polun täytyy alkaa kategorian nimellä eikä se voi sisältää sen alikansion nimeä, jonka dataa haluat synkronoida. |
| Master Symmetric Key | Asiakaspuolen salauksen hallintaan tarkoitettu valinnainen asetus. Voit muodostaa yhteyden objekteihin, jotka on salattu AWS Key Management Service -palvelussa säilytetyillä asiakkaan pääavaimilla tai asiakkaan luomalla avaimella 256-bittisessä AES-muodossa. Lisätietoja on Amazonin dokumentaatiossa. |
| Alueen nimi | S3-palvelusi alue, esimerkiksi EU (Irlanti). Katso luettelo alueiden nimistä CRM Analyticsin S3-alueiden nimet -osiosta. |
| Alueen nimi | Amazon-koodi |
|---|---|
| Yhdysvallat (Ohio) | us-east-2 |
| Yhdysvallat (N. Virginia) | us-east-1 |
| Yhdysvallat West (Kalifornia) | us-west-1 |
| Yhdysvallat West (Oregon) | us-west-2 |
| Afrikka (Kap Verde Town) | af-south-1 |
| Asiaankuuluva Tyynenmeren alue (Hongkong) | ap-east-1 |
| Asia-alue (Mumbai) | ap-south-1 |
| Asia-alue (Osaka) | ap-northeast-3 |
| Asia-alue (Seoul) | ap-northeast-2 |
| Asiaankuuluva Tyynenmeren alue (Singapore) | ap-southeast-1 |
| Asia-alue (Sydney) | ap-southeast-2 |
| Asia-alue (Tokyo) | ap-northeast-1 |
| Kanada (keskitetty) | ca-central-1 |
| Kiina (Beijing) | cn-north-1 |
| Kiina (Ningxia) | cn-northwest-1 |
| EU (Frankfurt) | eu-central-1 |
| EU (Irlanti) | eu-west-1 |
| EU (Lontoo) | eu-west-2 |
| Eurooppa (Milan) | eu-south-1 |
| EU (Paris) | eu-west-3 |
| EU (Stockholm) | eu-north-1 |
| Middle East (Bahrain) | me-south-1 |
| Etelä-Amerikka (Sao Paulo) | sa-east-1 |
| AWS GovCloud (Yhdysvallat) | us-gov-east-1 |
| AWS GovCloud (Yhdysvallat, Länsi) | us-gov-west-1 |
Pidä seuraavat toimintatavat mielessäsi, kun työskentelet Amazon S3 -liittimen kanssa.
- Yhdistettyjen objektien nimien täytyy alkaa kirjaimella ja sisältää vain kirjaimia, numeroita tai alaviivoja. Objektin nimi ei voi loppua alaviivaan.
- Vain aakkosnumeerisia, pisteitä, alaviivoja tai väliviivoja sisältävien kenttien nimiä tuetaan. Jos liitin sisältää kenttien nimiä, jotka sisältävät muita merkkejä, kuten välilyöntejä tai hakasulkeita, synkronointi epäonnistuu.
- Liitin voi synkronoida enintään 100 miljoonaa riviä tai 50 Gt per objekti, kumpi niistä ylittyy ensin. Kun käytät liitintä, Salesforce Government Cloud -organisaation data on suojattu siirrettäessä edistyneellä salauksella ja se voi synkronoida enintään 10 miljoonaa riviä tai 5 Gt kullekin yhdistetylle objektille, kumpi tahansa rajoitus saavutetaan ensin.
- Valitse kansiopolku, jossa on alle 5 000 syöttövaihtoehtoa, jotta Amazon S3 -liittimen määritysaikakatkaisu ei vaarannu. Merkintä sisältää synkronoitavan kansion, kansion sisäiset tiedostot sekä kaikki alikansiot ja alitiedostot. Suosittelemme parhaaksi käytännöksi luoda datan synkronointiin tarkoitetussa säiliössä kategoria tai kansio, joka on täytetty vain synkronoitavilla tiedostoilla.
- Jokainen yhteys voi tukea enintään 512 saraketta. Jos data sisältää enemmän sarakkeita, jaa data, luo useita yhteyksiä ja käytä reseptiä yhdistääksesi datajoukot.
- Laita kaikki kentät, jotka sisältävät lainausmerkkejä ja kaksoislainausmerkeissä olevia pilkkuja. Jotkin CSV-generaattorit tekevät lainausmerkkikentistä automaattisesti kaksinkertaisia tarvittaessa, kun taas toiset eivät tee niin. Koska generaattori toimii epäjohdonmukaisesti, suosittelemme lisäämään kaikki tekstikentät kaksoislainausmerkkeihin varmistaaksesi, että esimerkiksi'tai, eivät aiheuta ongelmia datan synkronoinnissa.
- Yhteysasetuksissa määrittämäsi kansion polun täytyy alkaa säiliön ja pääkansion nimellä. Älä sisällytä kansiota, johon haluat muodostaa yhteyden. Katsotaanpa alla olevaa esimerkkiä. Haluat ladata tiedostoja S3-kansiosta nimeltään Call_Back_Logs_2018_Jan. Kansion polku näytetään kansion yläpuolella, kun avaat sen S3:ssa.Kansion polku S3:ssa alkaa kategorian nimellä (1), jonka jälkeen tulee kansion nimi (2). Tässä esimerkissä alikansio (3) sisältää CSV-datan, jonka haluat synkronoida. Kun määrität tämän kansion yhteyden kansion polun asetukset, sisällytät vain kategorian (1) ja pääkansion (2), mutta et alikansiota (3), jota olet synkronoimassa. Kun olet luonut yhteyden, kaikki alikansiot näkyvät suoraan pääkansiossa (2), mukaan lukien Call_Back_Logs_2018_Jan, mahdollisina objekteina, joita voit synkronoida tämän yhteyden avulla.
- S3-kansioiden nimien täytyy noudattaa kehittäjien nimeämiskäytäntöjä, eli ne eivät voi sisältää välilyöntejä tai erikoismerkkejä.
- Kopioi jokin alikansiossa olevista tiedostoista ja nimeä se uudelleen schema_sample.csv. Poista kaikki rivit schema_sample.csv-tiedostosta paitsi ylätunnisteen rivi ja yksi esimerkkidatan rivi oikeassa muodossa kullekin sarakkeelle. CRM Analytics käyttää tätä tiedostoa havaitakseen CSV-datan rakenteen eikä tuo tästä tiedostosta mitään dataa.
- Kaikilla S3-alikansiosta ladattavilla tiedostoilla täytyy olla tiedostopääte .csv. Jokaisella tiedostolla täytyy olla otsikkorivi ja samat kentät kuin schema_sample.csv-tiedostossa. Tiedostossa voi olla ylimääräisiä kenttiä, mutta niitä ei ladata. CRM Analytics ei huomioi tiedostoja, jotka eivät täytä näitä vaatimuksia.
- Kunkin tiedoston otsikkorivissä olevien kenttien nimien täytyy noudattaa kehittäjien nimeämiskäytäntöjä, eli ne eivät voi sisältää välilyöntejä tai erikoismerkkejä. Skeema-tiedostosi ja datatiedostosi otsikkorivit ovat merkkikokoriippuvaisia, joten käytä samaa merkkikokoa kaikkialla.
- Voit ladata vain kokonaisia tiedostoja, et tiedostojen osia.
Yhteysesimerkki
Tutustu S3:n seuraavaan hierarkiaan ymmärtääksesi paremmin miten S3-liitin toimii monimutkaisemmissa skenaarioissa. Hierarkiassa on kaksi säiliötä: Quarterly_Financial_Data ja Call_Logs. Ensimmäisessä säiliössä on yksi kansiotaso. Toisella kategorialla on kaksi tasoa: pääkansiot ja alikansiot. Tässä on S3:n hierarkia.
- Quarterly_Financial_Data
- 2018
- 2018_quarter1_results.csv
- 2018_quarter2_results.csv
- 2018_quarter3_results.csv
- 2018_quarter4_results.csv
- 2019
- 2019_quarter1_results.csv
- 2019_quarter2_results.csv
- 2019_quarter3_results.csv
- 2019_quarter4_results.csv
- 2018
- Call_Logs
- 2018_Call_Logs
- Q1_2018
- call_logs_2018_01.csv
- call_logs_2018_02.csv
- call_logs_2018_03.csv
- Q2_2018
- call_logs_2018_04.csv
- call_logs_2018_05.csv
- call_logs_2018_06.csv
- Q3_2018
- call_logs_2018_07.csv
- call_logs_2018_08.csv
- call_logs_2018_09.csv
- Q4_2018
- call_logs_2018_10.csv
- call_logs_2018_11.csv
- call_logs_2018_12.csv
- Q1_2018
- 2018_Call_Logs
Nyt katsomme, miten voit määrittää yhteydet ja yhdistetyt objektit seuraavien tavoitteiden saavuttamiseksi.
| Tavoite | Toiminto |
|---|---|
| Nouda dataa useista säiliöistä CRM Analyticsiin. | Jokainen yhteys on liitetty yhteen säiliöön, joten luo erillinen yhteys jokaiselle säiliölle. Jos esimerkiksi haluat noutaa dataa Quarterly_Financial_Data- ja Call_Logs-säiliöistä, luo kaksi yhteyttä, toinen Quarterly_Financial_Data-säiliölle ja toinen Call_Logs-säiliölle. Määritä jokaiselle yhteydelle sopiva säiliön nimi yhteyden Folder Path (Kansion polku) -ominaisuudessa. |
| Nouda pääkansiosta määritetyt kansiot, mutta älä kaikkia alikansioita. | Luo yhteys pääkansiolle ja käytä sitten yhteyttä muodostaaksesi yhteyden tiettyihin alikansioihin. Jos haluat esimerkiksi noutaa puhelulokit Q1_2018- ja Q2_2018-kansioista, luo yhteys, jonka kansiopolku on Call_Logs/2018_Call_Logs. Luo sitten yhdistetyt objektit Q1_2018- ja Q2_2018-kansioille. |
| Noudata dataa kansiossa olevista CSV-tiedostoista. | Siirrä tiedostot alikansioon, luo yhteys pääkansioon ja käytä yhteyttä muodostaaksesi yhteyden alikansioon. Jos haluat noutaa dataa esimerkiksi call_logs_2018_11.csv- ja call_logs_2018_12.csv-tiedostoista, siirrä nämä CSV-tiedostot Q4_2018-kansion uuteen alikansioon. Luo seuraavaksi yhteys, jonka kansiopolku on Call_Logs/2018_Call_Logs/Q4_2018. Luo lopuksi yhdistetty objekti uuden alikansion perusteella. |
