Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Étape 1 : ajout de documents à Amazon S3
Avant de commencer les tâches d'analyse Amazon Comprehend, vous devez stocker un exemple de jeu de données d'avis clients dans Amazon Simple Storage Service (Amazon S3). Amazon S3 héberge vos données dans des conteneurs appelés buckets. Amazon Comprehend peut analyser les documents stockés dans un compartiment et envoyer les résultats de l'analyse à un compartiment. Au cours de cette étape, vous allez créer un compartiment S3, créer des dossiers d'entrée et de sortie dans le compartiment et télécharger un exemple de jeu de données dans le compartiment.
**Topics**
+ [Conditions préalables](#tutorial-reviews-add-docs-prereqs)
+ [Télécharger des exemples de données](#tutorial-reviews-add-docs-download)
+ [Créer un compartiment Amazon S3](#tutorial-reviews-add-docs-bucket)
+ [(Console uniquement) créer des dossiers](#tutorial-reviews-add-docs-folders)
+ [Téléchargez les données d'entrée](#tutorial-reviews-add-docs-upload)
## Conditions préalables
Avant de commencer, passez en revue [Tutoriel : Analyse des informations issues des avis clients avec Amazon Comprehend](tutorial-reviews.md) et complétez les prérequis.
## Télécharger des exemples de données
L'exemple de jeu de données suivant contient des critiques Amazon extraites du jeu de données plus vaste « Amazon reviews - Full », publié avec l'article « Character-level Convolutional Networks for Text Classification » (Xiang Zhang et al., 2015). Téléchargez le jeu de données sur votre ordinateur.
**Pour obtenir les exemples de données**
1. Téléchargez le fichier zip [tutorial-reviews-data.zip](samples/tutorial-reviews-data.zip) sur votre ordinateur.
1. Décompressez le fichier zip sur votre ordinateur. Il y a deux fichiers. Le fichier `THIRD_PARTY_LICENSES.txt` est la licence open source pour le jeu de données publié par Xiang Zhang et al. Le fichier `amazon-reviews.csv` est le jeu de données que vous analysez dans le didacticiel.
## Créer un compartiment Amazon S3
Après avoir téléchargé l'exemple de jeu de données, créez un compartiment Amazon S3 pour stocker vos données d'entrée et de sortie. Vous pouvez créer un compartiment S3 à l'aide de la console Amazon S3 ou du AWS Command Line Interface (AWS CLI).
### Création d'un compartiment Amazon S3 (console)
Dans la console Amazon S3, vous créez un compartiment dont le nom est unique dans tous les compartiments AWS.
**Pour créer un compartiment S3 (console)**
1. Connectez-vous à la console Amazon S3 AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).
1. Dans **Buckets**, choisissez **Create bucket.**
1. Dans le **champ Nom du compartiment**, entrez un nom unique au monde qui décrit l'objectif du compartiment.
1. Pour **Région**, choisissez la AWS région dans laquelle vous souhaitez créer le bucket. La région que vous choisissez doit prendre en charge Amazon Comprehend. Pour réduire le temps de latence, choisissez la AWS région la plus proche de votre situation géographique prise en charge par Amazon Comprehend. Pour obtenir la liste des régions qui prennent en charge Amazon Comprehend, consultez le [tableau des régions](https://aws.amazon.com/about-aws/global-infrastructure/regional-product-services/) du Guide *mondial de l'infrastructure*.
1. Conservez les paramètres par défaut pour la **propriété de l'objet**, **les paramètres du compartiment pour le blocage de l'accès public**, le **versionnement des** compartiments et les **balises**.
1. Pour le **chiffrement par défaut**, choisissez **Désactiver**.
**Astuce**
Bien que ce didacticiel n'utilise pas le chiffrement, vous souhaiterez peut-être utiliser le chiffrement lors de l'analyse de données importantes. Pour end-to-end le chiffrement, vous pouvez chiffrer vos données au repos dans le compartiment et également lorsque vous exécutez des tâches d'analyse. Pour plus d'informations sur le chiffrement avec AWS, voir [Qu'est-ce que c'est AWS Key Management Service ?](https://docs.aws.amazon.com/kms/latest/developerguide/overview.html) dans le *Guide AWS Key Management Service du développeur*.
1. Passez en revue les configurations de votre compartiment, puis choisissez **Create bucket**.
### Création d'un compartiment Amazon S3 (AWS CLI)
Après avoir ouvert le AWS CLI, vous exécutez la `create-bucket` commande pour créer un compartiment qui stockera les données d'entrée et de sortie.
**Pour créer un compartiment Amazon S3 (AWS CLI)**
1. Pour créer votre bucket, exécutez la commande suivante dans le AWS CLI. Remplacez amzn-s3-demo-bucket par un nom unique pour le bucket. AWS
```
aws s3api create-bucket --bucket amzn-s3-demo-bucket
```
Par défaut, la `create-bucket` commande crée un compartiment dans la `us-east-1` AWS région. Pour créer un compartiment dans un Région AWS autre que`us-east-1`, ajoutez le `LocationConstraint` paramètre pour spécifier votre région. Par exemple, la commande suivante crée un compartiment dans la `us-west-2` région.
```
aws s3api create-bucket --bucket amzn-s3-demo-bucket
--region us-west-2 --create-bucket-configuration LocationConstraint=us-west-2
```
Notez que seules certaines régions prennent en charge Amazon Comprehend. Pour obtenir la liste des régions qui prennent en charge Amazon Comprehend, consultez le [tableau des régions](https://aws.amazon.com/about-aws/global-infrastructure/regional-product-services/) du Guide *mondial de l'infrastructure*.
1. Pour vous assurer que votre bucket a bien été créé, exécutez la commande suivante. La commande répertorie tous les compartiments S3 associés à votre compte.
```
aws s3 ls
```
## (Console uniquement) créer des dossiers
Créez ensuite deux dossiers dans votre compartiment S3. Le premier dossier est destiné à vos données d'entrée. Le deuxième dossier est l'endroit où Amazon Comprehend envoie les résultats de l'analyse. Si vous utilisez la console Amazon S3, vous devez créer les dossiers manuellement. Si vous utilisez le AWS CLI, vous pouvez créer des dossiers lorsque vous chargez l'exemple de jeu de données ou que vous exécutez une tâche d'analyse. C'est pourquoi nous proposons une procédure permettant de créer des dossiers uniquement pour les utilisateurs de la console. Si vous utilisez la AWS CLI, vous allez créer des dossiers dans [Téléchargez les données d'entrée](#tutorial-reviews-add-docs-upload) et dans[Étape 3 : Exécution de tâches d'analyse sur des documents dans Amazon S3](tutorial-reviews-analysis.md).
**Pour créer des dossiers dans votre compartiment S3 (console)**
1. Ouvrez la console Amazon S3 à l'adresse [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).
1. Dans **Buckets**, choisissez votre bucket dans la liste des buckets.
1. Dans l'onglet **Vue d'ensemble**, choisissez **Créer un dossier**.
1. Pour le nouveau nom du dossier, entrez`input`.
1. Pour les paramètres de chiffrement, choisissez **Aucun (Utiliser les paramètres du bucket)**.
1. Choisissez **Enregistrer**.
1. Répétez les étapes 3 à 6 pour créer un autre dossier pour la sortie des tâches d'analyse, mais à l'étape 4, entrez le nouveau nom du dossier`output`.
## Téléchargez les données d'entrée
Maintenant que vous avez un bucket, chargez l'exemple de jeu de données`amazon-reviews.csv`. Vous pouvez télécharger des données dans des compartiments S3 à l'aide de la console Amazon S3 ou du AWS CLI.
### Charger des exemples de documents dans un bucket (console)
Dans la console Amazon S3, chargez le fichier d'exemple de jeu de données dans le dossier d'entrée.
**Pour télécharger les exemples de documents (console)**
1. Ouvrez la console Amazon S3 à l'adresse [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).
1. Dans **Buckets**, choisissez votre bucket dans la liste des buckets.
1. Choisissez le `input` dossier, puis choisissez **Upload**.
1. Choisissez **Ajouter des fichiers**, puis sélectionnez le `amazon-reviews.csv` fichier sur votre ordinateur.
1. Conservez les valeurs par défaut des autres paramètres.
1. Choisissez **Charger**.
### Charger des exemples de documents dans un bucket (AWS CLI)
Créez un dossier d'entrée dans votre compartiment S3 et téléchargez le fichier du jeu de données dans le nouveau dossier à l'aide de la `cp` commande.
**Pour télécharger les exemples de documents (AWS CLI)**
1. Pour télécharger le `amazon-reviews.csv` fichier dans un nouveau dossier de votre bucket, exécutez la AWS CLI commande suivante. Remplacez amzn-s3-demo-bucket par le nom de votre bucket. En ajoutant le chemin `/input/` à la fin, Amazon S3 crée automatiquement un nouveau dossier appelé `input` dans votre compartiment et télécharge le fichier du jeu de données dans ce dossier.
```
aws s3 cp amazon-reviews.csv s3://amzn-s3-demo-bucket/input/
```
1. Pour vous assurer que votre fichier a bien été chargé, exécutez la commande suivante. La commande répertorie le contenu du `input` dossier de votre bucket.
```
aws s3 ls s3://amzn-s3-demo-bucket/input/
```
Vous disposez maintenant d'un compartiment S3 contenant le `amazon-reviews.csv` fichier dans un dossier appelé`input`. Si vous avez utilisé la console, le compartiment contient également un `output` dossier. Si vous avez utilisé le AWS CLI, vous créerez le dossier de sortie lors de l'exécution des tâches d'analyse Amazon Comprehend.