Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Langkah 1: Menambahkan dokumen ke Amazon S3
<a name="tutorial-search-metadata-add-documents"></a>

Sebelum menjalankan tugas analisis entitas Amazon Comprehend pada kumpulan data, Anda membuat bucket Amazon S3 untuk meng-host data, metadata, dan keluaran analisis entitas Amazon Comprehend.

**Topics**
+ [Mengunduh kumpulan data sampel](#tutorial-search-metadata-add-documents-download-extract)
+ [Membuat sebuah bucket Amazon S3](#tutorial-search-metadata-add-documents-create-bucket)
+ [Membuat folder data dan metadata di bucket S3 Anda](#tutorial-search-metadata-add-documents-data-metadata)
+ [Mengunggah data input](#tutorial-search-metadata-add-documents-upload-data)

## Mengunduh kumpulan data sampel
<a name="tutorial-search-metadata-add-documents-download-extract"></a>

Sebelum Amazon Comprehend dapat menjalankan tugas analisis entitas pada data Anda, Anda harus mengunduh dan mengekstrak kumpulan data dan mengunggahnya ke bucket S3.

### Untuk mengunduh dan mengekstrak kumpulan data (Konsol)
<a name="tutorial-search-metadata-download-extract-console"></a>

1. Unduh folder [tutorial-dataset.zip](https://docs.aws.amazon.com/kendra/latest/dg/samples/tutorial-dataset.zip) di perangkat Anda.

1. Ekstrak `tutorial-dataset` folder untuk mengakses `data` folder.

### Untuk mengunduh dan mengekstrak dataset (Terminal)
<a name="tutorial-search-metadata-download-extract-cli"></a>

1. Untuk mengunduh`tutorial-dataset`, jalankan perintah berikut pada jendela terminal:

------
#### [ Linux ]

   ```
   curl -o path/tutorial-dataset.zip https://docs.aws.amazon.com/kendra/latest/dg/samples/tutorial-dataset.zip
   ```

   Di mana:
   + *path/*adalah jalur file lokal ke lokasi tempat Anda ingin menyimpan folder zip.

------
#### [ macOS ]

   ```
   curl -o path/tutorial-dataset.zip https://docs.aws.amazon.com/kendra/latest/dg/samples/tutorial-dataset.zip
   ```

   Di mana:
   + *path/*adalah jalur file lokal ke lokasi tempat Anda ingin menyimpan folder zip.

------
#### [ Windows ]

   ```
   curl -o path/tutorial-dataset.zip https://docs.aws.amazon.com/kendra/latest/dg/samples/tutorial-dataset.zip
   ```

   Di mana:
   + *path/*adalah jalur file lokal ke lokasi tempat Anda ingin menyimpan folder zip.

------

1. Untuk mengekstrak data dari folder zip, jalankan perintah berikut di jendela terminal:

------
#### [ Linux ]

   ```
   unzip path/tutorial-dataset.zip -d path/
   ```

   Di mana:
   + *path/*adalah jalur file lokal ke folder zip Anda yang disimpan.

------
#### [ macOS ]

   ```
   unzip path/tutorial-dataset.zip -d path/
   ```

   Di mana:
   + *path/*adalah jalur file lokal ke folder zip Anda yang disimpan.

------
#### [ Windows ]

   ```
   tar -xf path/tutorial-dataset.zip -C path/
   ```

   Di mana:
   + *path/*adalah jalur file lokal ke folder zip Anda yang disimpan.

------

Pada akhir langkah ini, Anda harus memiliki file yang diekstraksi dalam folder didekompresi yang disebut. `tutorial-dataset` Folder ini berisi `README` file dengan atribusi open source Apache 2.0 dan folder bernama `data` berisi dataset untuk tutorial ini. Dataset terdiri dari 100 file dengan `.story` ekstensi.

## Membuat sebuah bucket Amazon S3
<a name="tutorial-search-metadata-add-documents-create-bucket"></a>

Setelah mengunduh dan mengekstrak folder data sampel, Anda menyimpannya di bucket Amazon S3.

**penting**  
Nama bucket Amazon S3 harus unik di semua. AWS

### Untuk membuat bucket S3 (Konsol)
<a name="tutorial-search-metadata-create-bucket-console"></a>

1. Masuk ke Konsol Manajemen AWS dan buka konsol Amazon S3 di. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)

1. Di **Bucket**, pilih **Buat ember**.

1. Untuk **Nama bucket**, masukkan nama yang unik.

1. Untuk **Wilayah**, pilih AWS wilayah tempat Anda ingin membuat bucket.
**catatan**  
Anda harus memilih wilayah yang mendukung Amazon Comprehend dan Amazon Kendra. Anda tidak dapat mengubah wilayah ember setelah Anda membuatnya.

1. **Simpan pengaturan default untuk pengaturan **Blokir Akses Publik untuk bucket, **Bucket Versioning**, dan Tag ini**.**

1. Untuk **enkripsi Default**, pilih **Nonaktifkan**.

1. Simpan pengaturan default untuk **Pengaturan lanjutan**.

1. Tinjau konfigurasi bucket Anda, lalu pilih **Buat bucket**.

### Untuk membuat bucket S3 ()AWS CLI
<a name="tutorial-search-metadata-create-bucket-cli"></a>

1. Untuk membuat bucket S3, gunakan perintah [create-bucket di](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3control/create-bucket.html): AWS CLI

------
#### [ Linux ]

   ```
   aws s3api create-bucket \
           --bucket amzn-s3-demo-bucket \
           --region aws-region \
           --create-bucket-configuration LocationConstraint=aws-region
   ```

   Di mana:
   + amzn-s3-demo-bucket adalah nama bucket Anda,
   + *aws-region*adalah wilayah tempat Anda ingin membuat ember Anda.

------
#### [ macOS ]

   ```
   aws s3api create-bucket \
           --bucket amzn-s3-demo-bucket \
           --region aws-region \
           --create-bucket-configuration LocationConstraint=aws-region
   ```

   Di mana:
   + amzn-s3-demo-bucket adalah nama bucket Anda,
   + *aws-region*adalah wilayah tempat Anda ingin membuat ember Anda.

------
#### [ Windows ]

   ```
   aws s3api create-bucket ^
           --bucket amzn-s3-demo-bucket ^
           --region aws-region ^
           --create-bucket-configuration LocationConstraint=aws-region
   ```

   Di mana:
   + amzn-s3-demo-bucket adalah nama bucket Anda,
   + *aws-region*adalah wilayah tempat Anda ingin membuat ember Anda.

------
**catatan**  
Anda harus memilih wilayah yang mendukung Amazon Comprehend dan Amazon Kendra. Anda tidak dapat mengubah wilayah ember setelah Anda membuatnya.

1. Untuk memastikan bucket berhasil dibuat, gunakan perintah [list](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3/ls.html):

------
#### [ Linux ]

   ```
   aws s3 ls
   ```

------
#### [ macOS ]

   ```
   aws s3 ls
   ```

------
#### [ Windows ]

   ```
   aws s3 ls
   ```

------

## Membuat folder data dan metadata di bucket S3 Anda
<a name="tutorial-search-metadata-add-documents-data-metadata"></a>

Setelah membuat bucket S3, Anda membuat folder data dan metadata di dalamnya.

### Untuk membuat folder di bucket S3 Anda (Konsol)
<a name="tutorial-search-metadata-create-folders-console"></a>

1. Buka konsol Amazon S3 di. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)

1. Di **Bucket**, klik nama ember Anda dari daftar ember.

1. Dari tab **Objek**, pilih **Buat folder**.

1. Untuk nama folder baru, masukkan**data**.

1. Untuk pengaturan enkripsi, pilih **Nonaktifkan**.

1. Pilih **Buat folder**.

1. Ulangi langkah 3 hingga 6 untuk membuat folder lain untuk menyimpan metadata Amazon Kendra dan beri nama folder yang dibuat pada langkah 4. **metadata**

### Untuk membuat folder di bucket S3 Anda ()AWS CLI
<a name="tutorial-search-metadata-create-folders-cli"></a>

1. Untuk membuat `data` folder di bucket S3 Anda, gunakan perintah [put-object](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3api/put-object.html) di: AWS CLI

------
#### [ Linux ]

   ```
   aws s3api put-object \
           --bucket amzn-s3-demo-bucket \
           --key data/
   ```

   Di mana:
   + amzn-s3-demo-bucket adalah nama bucket Anda.

------
#### [ macOS ]

   ```
   aws s3api put-object \
           --bucket amzn-s3-demo-bucket \
           --key data/
   ```

   Di mana:
   + amzn-s3-demo-bucket adalah nama bucket Anda.

------
#### [ Windows ]

   ```
   aws s3api put-object ^
           --bucket amzn-s3-demo-bucket ^
           --key data/
   ```

   Di mana:
   + amzn-s3-demo-bucket adalah nama bucket Anda.

------

1. Untuk membuat `metadata` folder di bucket S3 Anda, gunakan perintah [put-object](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3api/put-object.html) di: AWS CLI

------
#### [ Linux ]

   ```
   aws s3api put-object \
           --bucket amzn-s3-demo-bucket \
           --key metadata/
   ```

   Di mana:
   + amzn-s3-demo-bucket adalah nama bucket Anda.

------
#### [ macOS ]

   ```
   aws s3api put-object \
           --bucket amzn-s3-demo-bucket \
           --key metadata/
   ```

   Di mana:
   + amzn-s3-demo-bucket adalah nama bucket Anda.

------
#### [ Windows ]

   ```
   aws s3api put-object ^
           --bucket amzn-s3-demo-bucket ^
           --key metadata/
   ```

   Di mana:
   + amzn-s3-demo-bucket adalah nama bucket Anda.

------

1. Untuk memastikan bahwa folder Anda berhasil dibuat, periksa isi bucket Anda menggunakan perintah [list](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3/ls.html):

------
#### [ Linux ]

   ```
   aws s3 ls s3://amzn-s3-demo-bucket/
   ```

   Di mana:
   + amzn-s3-demo-bucket adalah nama bucket Anda.

------
#### [ macOS ]

   ```
   aws s3 ls s3://amzn-s3-demo-bucket/
   ```

   Di mana:
   + amzn-s3-demo-bucket adalah nama bucket Anda.

------
#### [ Windows ]

   ```
   aws s3 ls s3://amzn-s3-demo-bucket/
   ```

   Di mana:
   + amzn-s3-demo-bucket adalah nama bucket Anda.

------

## Mengunggah data input
<a name="tutorial-search-metadata-add-documents-upload-data"></a>

Setelah membuat folder data dan metadata, Anda mengunggah kumpulan data sampel ke dalam folder. `data`

### Untuk mengunggah kumpulan data sampel ke folder data (Konsol)
<a name="tutorial-search-metadata-upload-data-console"></a>

1. Buka konsol Amazon S3 di. [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/)

1. Di **Bucket**, klik nama ember Anda dari daftar ember dan kemudian klik. `data`

1. Pilih **Unggah** lalu pilih **Tambahkan file**.

1. Di kotak dialog, navigasikan ke `data` folder di dalam `tutorial-dataset` folder di perangkat lokal Anda, pilih semua file, lalu pilih **Buka**.

1. Simpan pengaturan default untuk **Tujuan**, **Izin**, dan **Properti**.

1. Pilih **Unggah**.

### Untuk mengunggah kumpulan data sampel ke folder data ()AWS CLI
<a name="tutorial-search-metadata-upload-data-cli"></a>

1. Untuk mengunggah data sampel ke dalam `data` folder, gunakan perintah [salin](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3/cp.html) di AWS CLI:

------
#### [ Linux ]

   ```
   aws s3 cp path/tutorial-dataset/data s3://amzn-s3-demo-bucket/data/ --recursive
   ```

   Di mana:
   + *path/*adalah jalur file ke `tutorial-dataset` folder di perangkat Anda,
   + amzn-s3-demo-bucket adalah nama bucket Anda.

------
#### [ macOS ]

   ```
   aws s3 cp path/tutorial-dataset/data s3://amzn-s3-demo-bucket/data/ --recursive
   ```

   Di mana:
   + *path/*adalah jalur file ke `tutorial-dataset` folder di perangkat Anda,
   + amzn-s3-demo-bucket adalah nama bucket Anda.

------
#### [ Windows ]

   ```
   aws s3 cp path/tutorial-dataset/data s3://amzn-s3-demo-bucket/data/ --recursive
   ```

   Di mana:
   + *path/*adalah jalur file ke `tutorial-dataset` folder di perangkat Anda,
   + amzn-s3-demo-bucket adalah nama bucket Anda.

------

1. Untuk memastikan bahwa file dataset Anda berhasil diunggah ke `data` folder Anda, gunakan perintah [list](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3/ls.html) di: AWS CLI

------
#### [ Linux ]

   ```
   aws s3 ls s3://amzn-s3-demo-bucket/data/
   ```

   Di mana:
   + amzn-s3-demo-bucket adalah nama bucket S3 Anda.

------
#### [ macOS ]

   ```
   aws s3 ls s3://amzn-s3-demo-bucket/data/
   ```

   Di mana:
   + amzn-s3-demo-bucket adalah nama bucket S3 Anda.

------
#### [ Windows ]

   ```
   aws s3 ls s3://amzn-s3-demo-bucket/data/
   ```

   Di mana:
   + amzn-s3-demo-bucket adalah nama bucket S3 Anda.

------

Di akhir langkah ini, Anda memiliki bucket S3 dengan kumpulan data Anda disimpan di dalam `data` folder, dan `metadata` folder kosong, yang akan menyimpan metadata Amazon Kendra Anda.