Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Fase 1: aggiunta di documenti ad Amazon S3
Prima di iniziare i processi di analisi di Amazon Comprehend, devi archiviare un set di dati di esempio delle recensioni dei clienti in Amazon Simple Storage Service (Amazon S3) Simple Storage Service (Amazon S3). Amazon S3 ospita i dati in contenitori chiamati bucket. Amazon Comprehend è in grado di analizzare i documenti archiviati in un bucket e invia i risultati dell'analisi a un bucket. In questo passaggio, crei un bucket S3, crei cartelle di input e output nel bucket e carichi un set di dati di esempio nel bucket.
**Topics**
+ [Prerequisiti](#tutorial-reviews-add-docs-prereqs)
+ [Scarica dati di esempio](#tutorial-reviews-add-docs-download)
+ [Crea un bucket Amazon S3](#tutorial-reviews-add-docs-bucket)
+ [(Solo console) crea cartelle](#tutorial-reviews-add-docs-folders)
+ [Caricate i dati di input](#tutorial-reviews-add-docs-upload)
## Prerequisiti
Prima di iniziare, esamina [Tutorial: analisi delle informazioni ricavate dalle recensioni dei clienti con Amazon Comprehend](tutorial-reviews.md) e completa i prerequisiti.
## Scarica dati di esempio
Il seguente set di dati di esempio contiene recensioni Amazon tratte dal set di dati più ampio «Amazon reviews - Full», che è stato pubblicato con l'articolo «Character-level Convolutional Networks for Text Classification» (Xiang Zhang et al., 2015). Scarica il set di dati sul tuo computer.
**Per ottenere i dati di esempio**
1. Scarica il file zip [tutorial-reviews-data.zip](samples/tutorial-reviews-data.zip) sul tuo computer.
1. Estrai il file zip sul tuo computer. Ci sono due file. Il file `THIRD_PARTY_LICENSES.txt` è la licenza open source per il set di dati pubblicato da Xiang Zhang et al. Il file `amazon-reviews.csv` è il set di dati che analizzi nel tutorial.
## Crea un bucket Amazon S3
Dopo aver scaricato il set di dati di esempio, crea un bucket Amazon S3 per archiviare i dati di input e output. Puoi creare un bucket S3 utilizzando la console Amazon S3 o AWS Command Line Interface ().AWS CLI
### Crea un bucket Amazon S3 (console)
Nella console Amazon S3, crei un bucket con un nome unico in tutto. AWS
**Per creare un bucket S3 (console)**
1. Accedi a Console di gestione AWS e apri la console Amazon S3 all'indirizzo. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)
1. In **Bucket, scegli **Crea** bucket**.
1. Per **Bucket name, inserisci un nome** univoco globale che descriva lo scopo del bucket.
1. Per **Regione**, scegli la AWS regione in cui desideri creare il bucket. La regione scelta deve supportare Amazon Comprehend. Per ridurre la latenza, scegli la AWS regione più vicina alla tua posizione geografica supportata da Amazon Comprehend. Per un elenco delle regioni che supportano Amazon Comprehend, consulta la [tabella delle regioni nella](https://aws.amazon.com/about-aws/global-infrastructure/regional-product-services/) *Global Infrastructure Guide*.
1. **Lascia le impostazioni predefinite per **Object Ownership**, **Bucket per Block Public Access**, **Bucket Versioning** e Tags.**
1. **Per **Crittografia predefinita**, scegli Disabilita.**
**Suggerimento**
Sebbene questo tutorial non utilizzi la crittografia, potresti volerla utilizzare per analizzare dati importanti. Per quanto riguarda end-to-end la crittografia, è possibile crittografare i dati inattivi nel bucket e anche quando si eseguono processi di analisi. Per ulteriori informazioni sulla crittografia con AWS, vedi [Cos'è? AWS Key Management Service](https://docs.aws.amazon.com/kms/latest/developerguide/overview.html) nella *Guida per gli AWS Key Management Service sviluppatori*.
1. Controlla le configurazioni del bucket, quindi scegli **Crea** bucket.
### Crea un bucket Amazon S3 ()AWS CLI
Dopo aver aperto AWS CLI, esegui il `create-bucket` comando per creare un bucket che memorizzerà i dati di input e output.
**Per creare un bucket Amazon S3 ()AWS CLI**
1. Per creare il tuo bucket, esegui il seguente comando in. AWS CLI Sostituisci amzn-s3-demo-bucket con un nome per il bucket che sia unico in tutto. AWS
```
aws s3api create-bucket --bucket amzn-s3-demo-bucket
```
Per impostazione predefinita, il comando crea un bucket nella regione. `create-bucket` `us-east-1` AWS Per creare un bucket in un Regione AWS altro formato`us-east-1`, aggiungi il `LocationConstraint` parametro per specificare la tua regione. Ad esempio, il comando seguente crea un bucket nella `us-west-2` regione.
```
aws s3api create-bucket --bucket amzn-s3-demo-bucket
--region us-west-2 --create-bucket-configuration LocationConstraint=us-west-2
```
Tieni presente che solo alcune regioni supportano Amazon Comprehend. Per un elenco delle regioni che supportano Amazon Comprehend, consulta la [tabella delle regioni nella](https://aws.amazon.com/about-aws/global-infrastructure/regional-product-services/) *Global Infrastructure Guide*.
1. Per assicurarti che il bucket sia stato creato correttamente, esegui il comando seguente. Il comando elenca tutti i bucket S3 associati al tuo account.
```
aws s3 ls
```
## (Solo console) crea cartelle
Quindi, crea due cartelle nel tuo bucket S3. La prima cartella è per i dati di input. La seconda cartella è dove Amazon Comprehend invia i risultati dell'analisi. Se utilizzi la console Amazon S3, devi creare manualmente le cartelle. Se utilizzi AWS CLI, puoi creare cartelle quando carichi il set di dati di esempio o esegui un processo di analisi. Per questo motivo, forniamo una procedura per la creazione di cartelle solo per gli utenti della console. Se utilizzi la AWS CLI, creerai cartelle in entrata [Caricate i dati di input](#tutorial-reviews-add-docs-upload) e in uscita. [Fase 3: Esecuzione di processi di analisi su documenti in Amazon S3](tutorial-reviews-analysis.md)
**Per creare cartelle nel bucket S3 (console)**
1. Apri la console Amazon S3 all'indirizzo. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)
1. In **Bucket**, scegli il tuo bucket dall'elenco dei bucket.
1. **Nella scheda **Panoramica**, scegli Crea cartella.**
1. Per il nuovo nome della cartella, inserisci`input`.
1. Per le impostazioni di crittografia, scegli **Nessuno (Usa le impostazioni del bucket).**
1. Scegli **Save** (Salva).
1. Ripetete i passaggi da 3 a 6 per creare un'altra cartella per l'output dei lavori di analisi, ma nel passaggio 4 inserite il nuovo nome `output` della cartella.
## Caricate i dati di input
Ora che hai un bucket, carica il set di dati `amazon-reviews.csv` di esempio. Puoi caricare dati su bucket S3 con la console Amazon S3 o il. AWS CLI
### Carica documenti di esempio in un bucket (console)
Nella console Amazon S3, carica il file del set di dati di esempio nella cartella di input.
**Per caricare i documenti di esempio (console)**
1. Apri la console Amazon S3 all'indirizzo. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)
1. In **Bucket**, scegli il tuo bucket dall'elenco dei bucket.
1. **Scegli la `input` cartella, quindi scegli Carica.**
1. Scegli **Aggiungi file**, quindi scegli il `amazon-reviews.csv` file sul tuo computer.
1. Lascia le altre impostazioni ai valori predefiniti.
1. Scegli **Carica**.
### Carica documenti di esempio in un bucket ()AWS CLI
Crea una cartella di input nel tuo bucket S3 e carica il file del set di dati nella nuova cartella con il comando. `cp`
**Per caricare i documenti di esempio ()AWS CLI**
1. Per caricare il `amazon-reviews.csv` file in una nuova cartella nel bucket, esegui il AWS CLI comando seguente. Sostituisci amzn-s3-demo-bucket con il nome del tuo bucket. Aggiungendo il percorso `/input/` alla fine, Amazon S3 crea automaticamente una nuova cartella chiamata `input` nel bucket e carica il file del set di dati in quella cartella.
```
aws s3 cp amazon-reviews.csv s3://amzn-s3-demo-bucket/input/
```
1. Per assicurarti che il file sia stato caricato correttamente, esegui il seguente comando. Il comando elenca il contenuto della `input` cartella del bucket.
```
aws s3 ls s3://amzn-s3-demo-bucket/input/
```
Ora hai un bucket S3 con il `amazon-reviews.csv` file in una cartella chiamata. `input` Se hai usato la console, hai anche una `output` cartella nel bucket. Se hai utilizzato AWS CLI, creerai la cartella di output durante l'esecuzione dei processi di analisi di Amazon Comprehend.