

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

# Langkah 4: Membuat indeks Amazon Kendra dan menelan metadata
<a name="tutorial-search-metadata-create-index-ingest"></a>

Untuk menerapkan solusi pencarian cerdas Anda, Anda membuat indeks Amazon Kendra dan menelan data dan metadata S3 Anda ke dalamnya.

Sebelum menambahkan metadata ke indeks Amazon Kendra, Anda membuat bidang indeks khusus yang sesuai dengan atribut dokumen khusus, yang pada gilirannya sesuai dengan jenis entitas Amazon Comprehend. Amazon Kendra menggunakan kolom indeks dan atribut dokumen khusus yang Anda buat untuk mencari dan memfilter dokumen Anda.

Untuk informasi selengkapnya, lihat [Mengindeks](https://docs.aws.amazon.com/kendra/latest/dg/hiw-index.html) dan [Membuat atribut dokumen kustom](https://docs.aws.amazon.com/kendra/latest/dg/custom-attributes.html).

**Topics**
+ [Membuat indeks Amazon Kendra](#tutorial-search-metadata-create-index)
+ [Memperbarui peran IAM untuk akses Amazon S3](#tutorial-search-metadata-create-index-update-IAM)
+ [Membuat bidang indeks pencarian kustom Amazon Kendra](#tutorial-search-metadata-create-index-custom-fields)
+ [Menambahkan bucket Amazon S3 sebagai sumber data untuk indeks](#tutorial-search-metadata-create-index-connect-data)
+ [Menyinkronkan indeks Amazon Kendra](#tutorial-search-metadata-create-index-sync)

## Membuat indeks Amazon Kendra
<a name="tutorial-search-metadata-create-index"></a>

Untuk menanyakan dokumen sumber Anda, Anda membuat indeks Amazon Kendra.

Jika Anda menggunakan langkah ini, Anda membuat dan melampirkan peran dan kebijakan AWS IAM yang memungkinkan Amazon Kendra mengakses log CloudWatch Anda sebelum membuat indeks. AWS CLI Untuk informasi lebih lanjut, lihat [Prasyarat](https://docs.aws.amazon.com/kendra/latest/dg/gs-prerequisites.html).

### Untuk membuat indeks Amazon Kendra (Konsol)
<a name="tutorial-search-metadata-create-index-console"></a>

1. Buka konsol Amazon Kendra di. [https://console.aws.amazon.com/kendra/](https://console.aws.amazon.com/kendra/)
**penting**  
Pastikan Anda berada di wilayah yang sama tempat Anda membuat tugas analisis entitas Amazon Comprehend dan bucket Amazon S3 Anda. Jika Anda berada di wilayah lain, pilih AWS wilayah tempat Anda membuat bucket Amazon S3 dari **pemilih Wilayah di bilah** navigasi atas.

1. Pilih **Buat indeks**.

1. Untuk **detail Indeks** pada halaman **Tentukan detail indeks**, lakukan hal berikut:

   1. Untuk **Nama indeks**, masukkan **kendra-index**.

   1. Biarkan kolom **Description** kosong.

   1. Untuk **Peran IAM**, pilih **Buat Peran Baru**. Peran ini menyediakan akses ke bucket Amazon S3 Anda.

   1. Untuk **Nama peran**, masukkan **kendra-role**. Peran IAM akan memiliki awalan`AmazonKendra-`.

   1. Simpan pengaturan default untuk **Enkripsi** dan **Tag** dan pilih **Berikutnya**.

1. Untuk **pengaturan kontrol akses** pada halaman **Konfigurasi kontrol akses pengguna**, pilih **Tidak** dan kemudian pilih **Berikutnya**.

1. **Untuk **edisi Penyediaan** di halaman **Detail penyediaan, pilih Edisi** **pengembang** dan pilih Buat.**

### Untuk membuat indeks Amazon Kendra ()AWS CLI
<a name="tutorial-search-metadata-create-index-cli"></a>

1. Untuk membuat dan melampirkan peran IAM untuk Amazon Kendra yang mengenalinya sebagai entitas tepercaya, lakukan hal berikut:

   1. Simpan kebijakan kepercayaan berikut sebagai file JSON yang dipanggil `kendra-trust-policy.json` dalam editor teks di perangkat lokal Anda.

------
#### [ JSON ]

****  

      ```
      {
          "Version":"2012-10-17",		 	 	 
          "Statement": {
              "Effect": "Allow",
              "Principal": {
                  "Service": "kendra.amazonaws.com"
              },
              "Action": "sts:AssumeRole"
          }
      }
      ```

------

   1. Untuk membuat peran IAM yang dipanggil `kendra-role` dan melampirkan `kendra-trust-policy.json` file yang disimpan ke dalamnya, gunakan perintah [create-role](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/create-role.html):

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

      ```
      aws iam create-role \
                --role-name kendra-role \
                --assume-role-policy-document file://path/kendra-trust-policy.json
      ```

      Di mana:
      + *path/*adalah jalur file ke `kendra-trust-policy.json` perangkat lokal Anda.

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

      ```
      aws iam create-role \
                --role-name kendra-role \
                --assume-role-policy-document file://path/kendra-trust-policy.json
      ```

      Di mana:
      + *path/*adalah jalur file ke `kendra-trust-policy.json` perangkat lokal Anda.

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

      ```
      aws iam create-role ^
                --role-name kendra-role ^
                --assume-role-policy-document file://path/kendra-trust-policy.json
      ```

      Di mana:
      + *path/*adalah jalur file ke `kendra-trust-policy.json` perangkat lokal Anda.

------

   1. Salin Nama Sumber Daya Amazon (ARN) ke editor teks Anda dan simpan secara lokal sebagai. `kendra-role-arn`
**catatan**  
ARN memiliki format yang mirip dengan. *arn:aws:iam::123456789012:role/kendra-role* Anda membutuhkan ARN yang Anda simpan `kendra-role-arn` untuk menjalankan pekerjaan Amazon Kendra.

1. Sebelum Anda membuat indeks, Anda harus memberikan izin untuk menulis ke CloudWatch Log. `kendra-role` Caranya, lakukan langkah-langkah berikut:

   1. Simpan kebijakan kepercayaan berikut sebagai file JSON yang dipanggil `kendra-cloudwatch-policy.json` dalam editor teks di perangkat lokal Anda.

      Ganti *aws-region* dengan AWS wilayah Anda, dan *aws-account-id* dengan ID AWS akun 12 digit Anda.

   1. Untuk membuat kebijakan IAM untuk mengakses CloudWatch Log, gunakan perintah [create-policy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/create-policy.html):

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

      ```
      aws iam create-policy \
                --policy-name kendra-cloudwatch-policy \
                --policy-document file://path/kendra-cloudwatch-policy.json
      ```

      Di mana:
      + *path/*adalah jalur file ke `kendra-cloudwatch-policy.json` perangkat lokal Anda.

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

      ```
      aws iam create-policy \
                --policy-name kendra-cloudwatch-policy \
                --policy-document file://path/kendra-cloudwatch-policy.json
      ```

      Di mana:
      + *path/*adalah jalur file ke `kendra-cloudwatch-policy.json` perangkat lokal Anda.

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

      ```
      aws iam create-policy ^
                --policy-name kendra-cloudwatch-policy ^
                --policy-document file://path/kendra-cloudwatch-policy.json
      ```

      Di mana:
      + *path/*adalah jalur file ke `kendra-cloudwatch-policy.json` perangkat lokal Anda.

------

   1. Salin Nama Sumber Daya Amazon (ARN) ke editor teks Anda dan simpan secara lokal sebagai. `kendra-cloudwatch-arn`
**catatan**  
ARN memiliki format yang mirip dengan. *arn:aws:iam::123456789012:role/kendra-cloudwatch-policy* Anda memerlukan ARN yang Anda simpan `kendra-cloudwatch-arn` untuk melampirkan ke peran IAM Anda. `kendra-cloudwatch-policy`

   1. Untuk melampirkan `kendra-cloudwatch-policy` ke peran IAM Anda, gunakan [attach-role-policy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/attach-role-policy.html)perintah:

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

      ```
      aws iam attach-role-policy \
                --policy-arn policy-arn \
                --role-name kendra-role
      ```

      Di mana:
      + *policy-arn*adalah Anda diselamatkan`kendra-cloudwatch-arn`.

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

      ```
      aws iam attach-role-policy \
                --policy-arn policy-arn \
                --role-name kendra-role
      ```

      Di mana:
      + *policy-arn*adalah Anda diselamatkan`kendra-cloudwatch-arn`.

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

      ```
      aws iam attach-role-policy ^
                --policy-arn policy-arn ^
                --role-name kendra-role
      ```

      Di mana:
      + *policy-arn*adalah Anda diselamatkan`kendra-cloudwatch-arn`.

------

1. Untuk membuat indeks, gunakan perintah [create-index](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kendra/create-index.html):

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

   ```
   aws kendra create-index \
           --name kendra-index \
           --edition DEVELOPER_EDITION \
           --role-arn role-arn \
           --region aws-region
   ```

   Di mana:
   + *role-arn*adalah Anda diselamatkan`kendra-role-arn`,
   + *aws-region*adalah AWS wilayah Anda.

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

   ```
   aws kendra create-index \
           --name kendra-index \
           --edition DEVELOPER_EDITION \
           --role-arn role-arn \
           --region aws-region
   ```

   Di mana:
   + *role-arn*adalah Anda diselamatkan`kendra-role-arn`,
   + *aws-region*adalah AWS wilayah Anda.

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

   ```
   aws kendra create-index ^
           --name kendra-index ^
           --edition DEVELOPER_EDITION ^
           --role-arn role-arn ^
           --region aws-region
   ```

   Di mana:
   + *role-arn*adalah Anda diselamatkan`kendra-role-arn`,
   + *aws-region*adalah AWS wilayah Anda.

------

1. Salin indeks `Id` dan simpan dalam editor teks sebagai`kendra-index-id`. `Id`Ini membantu Anda melacak status pembuatan indeks Anda.

1. Untuk melacak kemajuan pekerjaan pembuatan indeks Anda, gunakan [perintah deskripsi-indeks](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kendra/describe-index.html):

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

   ```
   aws kendra describe-index \
           --id kendra-index-id \
           --region aws-region
   ```

   Di mana:
   + *kendra-index-id*adalah Anda diselamatkan`kendra-index-id`,
   + *aws-region*adalah AWS wilayah Anda.

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

   ```
   aws kendra describe-index \
           --id kendra-index-id \
           --region aws-region
   ```

   Di mana:
   + *kendra-index-id*adalah Anda diselamatkan`kendra-index-id`,
   + *aws-region*adalah AWS wilayah Anda.

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

   ```
   aws kendra describe-index ^
           --id kendra-index-id ^
           --region aws-region
   ```

   Di mana:
   + *kendra-index-id*adalah Anda diselamatkan`kendra-index-id`,
   + *aws-region*adalah AWS wilayah Anda.

------

Proses pembuatan indeks rata-rata memakan waktu 15 menit, tetapi bisa memakan waktu lebih lama. Ketika status indeks aktif, indeks Anda siap digunakan. Saat indeks Anda sedang dibuat, Anda dapat memulai langkah berikutnya.

Jika Anda menggunakan langkah ini, Anda membuat dan melampirkan kebijakan IAM ke peran IAM Amazon Kendra Anda yang memberikan izin indeks untuk mengakses bucket S3 Anda. AWS CLI 

## Memperbarui peran IAM untuk akses Amazon S3
<a name="tutorial-search-metadata-create-index-update-IAM"></a>

Saat indeks sedang dibuat, Anda memperbarui peran IAM Amazon Kendra Anda untuk memungkinkan indeks yang Anda buat membaca data dari bucket Amazon S3 Anda. Untuk informasi lebih lanjut, lihat [Peran akses IAM untuk Amazon Kendra](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html).

### Untuk memperbarui peran IAM Anda (Konsol)
<a name="tutorial-search-metadata-update-role-console"></a>

1. Buka konsol IAM di [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).

1. Di panel navigasi kiri, pilih **Peran** dan masukkan kotak **Pencarian **kendra-role**** di atas **Nama peran**.

1. Dari opsi yang disarankan, klik`kendra-role`.

1. Dalam **Ringkasan**, pilih **Lampirkan kebijakan**.

1. Di **Lampirkan izin**, di kotak **Pencarian**, masukkan **S3** dan pilih kotak centang di sebelah ReadOnlyAccess kebijakan **AmazonS3** dari opsi yang disarankan.

1. Pilih **Lampirkan kebijakan**. Pada halaman **Ringkasan**, Anda sekarang akan melihat dua kebijakan yang dilampirkan pada peran IAM.

1. Kembali ke konsol Amazon Kendra di [https://console.aws.amazon.com/kendra/](https://console.aws.amazon.com/kendra/)dan tunggu status indeks Anda berubah dari **Membuat** ke **Aktif** sebelum melanjutkan ke langkah berikutnya.

### Untuk memperbarui peran IAM Anda ()AWS CLI
<a name="tutorial-search-metadata-update-role-cli"></a>

1. Simpan teks berikut dalam file JSON yang disebut `kendra-S3-access-policy.json` dalam editor teks di perangkat lokal Anda.

   Ganti amzn-s3-demo-bucket dengan nama bucket S3 Anda, dengan AWS wilayah Anda, *aws-region* dengan 12 AWS digit ID akun Anda, dan *aws-account-id* dengan yang Anda simpan. *kendra-index-id* `kendra-index-id`

1. Untuk membuat kebijakan IAM untuk mengakses bucket S3 Anda, gunakan perintah [create-policy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/create-policy.html):

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

   ```
   aws iam create-policy \
             --policy-name kendra-S3-access-policy \
             --policy-document file://path/kendra-S3-access-policy.json
   ```

   Di mana:
   + *path/*adalah jalur file ke `kendra-S3-access-policy.json` perangkat lokal Anda.

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

   ```
   aws iam create-policy \
             --policy-name kendra-S3-access-policy \
             --policy-document file://path/kendra-S3-access-policy.json
   ```

   Di mana:
   + *path/*adalah jalur file ke `kendra-S3-access-policy.json` perangkat lokal Anda.

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

   ```
   aws iam create-policy ^
             --policy-name kendra-S3-access-policy ^
             --policy-document file://path/kendra-S3-access-policy.json
   ```

   Di mana:
   + *path/*adalah jalur file ke `kendra-S3-access-policy.json` perangkat lokal Anda.

------

1. Salin Nama Sumber Daya Amazon (ARN) ke editor teks Anda dan simpan secara lokal sebagai. `kendra-S3-access-arn`
**catatan**  
ARN memiliki format yang mirip dengan. *arn:aws:iam::123456789012:role/kendra-S3-access-policy* Anda memerlukan ARN yang Anda simpan `kendra-S3-access-arn` untuk melampirkan ke peran IAM Anda. `kendra-S3-access-policy`

1. Untuk melampirkan `kendra-S3-access-policy` ke peran IAM Amazon Kendra Anda, gunakan perintah: [attach-role-policy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/attach-role-policy.html)

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

   ```
   aws iam attach-role-policy \
             --policy-arn policy-arn \
             --role-name kendra-role
   ```

   Di mana:
   + *policy-arn*adalah Anda diselamatkan`kendra-S3-access-arn`.

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

   ```
   aws iam attach-role-policy \
             --policy-arn policy-arn \
             --role-name kendra-role
   ```

   Di mana:
   + *policy-arn*adalah Anda diselamatkan`kendra-S3-access-arn`.

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

   ```
   aws iam attach-role-policy ^
             --policy-arn policy-arn ^
             --role-name kendra-role
   ```

   Di mana:
   + *policy-arn*adalah Anda diselamatkan`kendra-S3-access-arn`.

------

## Membuat bidang indeks pencarian kustom Amazon Kendra
<a name="tutorial-search-metadata-create-index-custom-fields"></a>

Untuk mempersiapkan Amazon Kendra untuk mengenali metadata Anda sebagai atribut dokumen kustom, Anda membuat bidang kustom yang sesuai dengan jenis entitas Amazon Comprehend. Anda memasukkan sembilan jenis entitas Amazon Comprehend berikut sebagai bidang khusus:
+ BARANG\$1KOMERSIAL
+ DATE
+ ACARA
+ LOKASI
+ ORGANISASI
+ LAINNYA
+ PRIBADI
+ KUANTITAS
+ JUDUL

**penting**  
Jenis entitas yang salah eja tidak akan dikenali oleh indeks.

### Untuk membuat bidang khusus untuk indeks Amazon Kendra Anda (Konsol)
<a name="tutorial-search-metadata-create-attributes-console"></a>

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

1. Dari daftar **Indeks**, klik`kendra-index`.

1. Dari panel navigasi kiri, di bawah **Manajemen data**, pilih **Definisi aspek**.

1. Dari menu **Bidang indeks**, pilih **Tambah bidang**.

1. Dalam kotak dialog **Add index field**, lakukan hal berikut:

   1. Di **Nama bidang**, masukkan**COMMERCIAL\$1ITEM**.

   1. Di **Tipe data**, pilih **Daftar string**.

   1. **Di **Usage types**, pilih **Facetable, Searchable****, dan **Displayable****, lalu pilih Add.**

   1. Ulangi langkah a hingga c untuk setiap jenis entitas Amazon Comprehend: COMMERCIAL\$1ITEM, DATE, EVENT, LOCATION, ORGANIZATION, OTHER, PERSON, QUANTITY, TITLE.

Konsol menampilkan pesan penambahan bidang yang berhasil. Anda dapat memilih untuk menutupnya sebelum melanjutkan ke langkah berikutnya.

### Untuk membuat bidang khusus untuk indeks Amazon Kendra Anda ()AWS CLI
<a name="tutorial-search-metadata-create-attributes-cli"></a>

1. Simpan teks berikut sebagai file JSON yang dipanggil `custom-attributes.json` dalam editor teks di perangkat lokal Anda.

   ```
   [
      {
          "Name": "COMMERCIAL_ITEM",
          "Type": "STRING_LIST_VALUE",
          "Search": {
              "Facetable": true,
              "Searchable": true,
              "Displayable": true
          }
      },
      {
          "Name": "DATE",
          "Type": "STRING_LIST_VALUE",
          "Search": {
              "Facetable": true,
              "Searchable": true,
              "Displayable": true
          }
      },
      {
          "Name": "EVENT",
          "Type": "STRING_LIST_VALUE",
          "Search": {
              "Facetable": true,
              "Searchable": true,
              "Displayable": true
          }
      },
      {
          "Name": "LOCATION",
          "Type": "STRING_LIST_VALUE",
          "Search": {
              "Facetable": true,
              "Searchable": true,
              "Displayable": true
          }
      },
      {
          "Name": "ORGANIZATION",
          "Type": "STRING_LIST_VALUE",
          "Search": {
              "Facetable": true,
              "Searchable": true,
              "Displayable": true
          }
      },
      {
          "Name": "OTHER",
          "Type": "STRING_LIST_VALUE",
          "Search": {
              "Facetable": true,
              "Searchable": true,
              "Displayable": true
          }
      },
      {
          "Name": "PERSON",
          "Type": "STRING_LIST_VALUE",
          "Search": {
              "Facetable": true,
              "Searchable": true,
              "Displayable": true
          }
      },
      {
          "Name": "QUANTITY",
          "Type": "STRING_LIST_VALUE",
          "Search": {
              "Facetable": true,
              "Searchable": true,
              "Displayable": true
          }
      },
      {
          "Name": "TITLE",
          "Type": "STRING_LIST_VALUE",
          "Search": {
              "Facetable": true,
              "Searchable": true,
              "Displayable": true
          }
      }
   ]
   ```

1. Untuk membuat bidang kustom dalam indeks Anda, gunakan perintah [update-index](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kendra/update-index.html):

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

   ```
   aws kendra update-index \
           --id kendra-index-id \
           --document-metadata-configuration-updates file://path/custom-attributes.json \
           --region aws-region
   ```

   Di mana:
   + *kendra-index-id*adalah Anda diselamatkan`kendra-index-id`,
   + *path/*adalah jalur file ke `custom-attributes.json` perangkat lokal Anda,
   + *aws-region*adalah AWS wilayah Anda.

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

   ```
   aws kendra update-index \
           --id kendra-index-id \
           --document-metadata-configuration-updates file://path/custom-attributes.json \
           --region aws-region
   ```

   Di mana:
   + *kendra-index-id*adalah Anda diselamatkan`kendra-index-id`,
   + *path/*adalah jalur file ke `custom-attributes.json` perangkat lokal Anda,
   + *aws-region*adalah AWS wilayah Anda.

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

   ```
   aws kendra update-index ^
           --id kendra-index-id ^
           --document-metadata-configuration-updates file://path/custom-attributes.json ^
           --region aws-region
   ```

   Di mana:
   + *kendra-index-id*adalah Anda diselamatkan`kendra-index-id`,
   + *path/*adalah jalur file ke `custom-attributes.json` perangkat lokal Anda,
   + *aws-region*adalah AWS wilayah Anda.

------

1. Untuk memverifikasi bahwa atribut kustom telah ditambahkan ke indeks Anda, gunakan [perintah deskripsi-indeks](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kendra/describe-index.html):

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

   ```
   aws kendra describe-index \
           --id kendra-index-id \
           --region aws-region
   ```

   Di mana:
   + *kendra-index-id*adalah Anda diselamatkan`kendra-index-id`,
   + *aws-region*adalah AWS wilayah Anda.

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

   ```
   aws kendra describe-index \
           --id kendra-index-id \
           --region aws-region
   ```

   Di mana:
   + *kendra-index-id*adalah Anda diselamatkan`kendra-index-id`,
   + *aws-region*adalah AWS wilayah Anda.

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

   ```
   aws kendra describe-index ^
           --id kendra-index-id ^
           --region aws-region
   ```

   Di mana:
   + *kendra-index-id*adalah Anda diselamatkan`kendra-index-id`,
   + *aws-region*adalah AWS wilayah Anda.

------

## Menambahkan bucket Amazon S3 sebagai sumber data untuk indeks
<a name="tutorial-search-metadata-create-index-connect-data"></a>

Sebelum Anda dapat menyinkronkan indeks Anda, Anda harus menghubungkan sumber data S3 Anda ke sana.

### Untuk menghubungkan bucket S3 ke indeks Amazon Kendra Anda (Konsol)
<a name="tutorial-search-metadata-connect-s3-console"></a>

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

1. Dari daftar **Indeks**, klik`kendra-index`.

1. Dari menu navigasi kiri, di bawah **Manajemen data**, pilih **Sumber data**.

1. Di bawah bagian **Pilih jenis konektor sumber data**, navigasikan ke **Amazon S3**, dan pilih **Tambah** konektor.

1. Dalam halaman **Tentukan detail sumber data**, lakukan hal berikut:

   1. Di bawah **Nama dan deskripsi**, untuk **nama sumber data**, masukkan**S3-data-source**.

   1. Biarkan bagian **Deskripsi** tetap kosong.

   1. Simpan pengaturan default untuk **Tag**.

   1. Pilih **Berikutnya**.

1. Pada halaman **Konfigurasi pengaturan sinkronisasi**, di bagian **Lingkup sinkronisasi**, lakukan hal berikut:

   1. Di **Masukkan lokasi sumber data**, pilih **Jelajahi S3**.

   1. Di **Pilih sumber daya**, pilih bucket S3 Anda, lalu pilih **Pilih**.

   1. **Di **lokasi folder awalan file Metadata**, pilih Jelajahi S3.**

   1. Di **Pilih sumber daya**, klik nama bucket Anda dari daftar bucket.

   1. Untuk **Objek**, pilih kotak opsi untuk `metadata` dan pilih **Pilih**. Bidang lokasi sekarang harus mengatakan`metadata/`.

   1. Simpan pengaturan default untuk **lokasi file konfigurasi daftar kontrol akses**, **Pilih kunci dekripsi**, dan Konfigurasi **tambahan**.

1. Untuk **peran IAM**, pada halaman **Konfigurasi pengaturan sinkronisasi**, pilih`kendra-role`.

1. Pada halaman **Konfigurasi pengaturan sinkronisasi**, di bawah **Sinkronkan jadwal berjalan**, untuk **Frekuensi**, pilih **Jalankan sesuai permintaan** dan kemudian pilih **Berikutnya**.

1. Pada halaman **Tinjau dan buat**, tinjau pilihan Anda untuk detail sumber data dan pilih **Tambahkan sumber data**.

### Untuk menghubungkan bucket S3 ke indeks Amazon Kendra Anda ()AWS CLI
<a name="tutorial-search-metadata-connect-s3-cli"></a>

1. Simpan teks berikut sebagai file JSON yang dipanggil `S3-data-connector.json` dalam editor teks di perangkat lokal Anda.

   ```
   {
      "S3Configuration":{
         "BucketName":"amzn-s3-demo-bucket",
         "DocumentsMetadataConfiguration":{
            "S3Prefix":"metadata"
         }
      }
   }
   ```

   Ganti amzn-s3-demo-bucket dengan nama bucket S3 Anda.

1. Untuk menghubungkan bucket S3 Anda ke indeks Anda, gunakan [create-data-source](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kendra/create-data-source.html)perintah:

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

   ```
   aws kendra create-data-source \
           --index-id kendra-index-id \
           --name S3-data-source \
           --type S3 \
           --configuration file://path/S3-data-connector.json \
           --role-arn role-arn \
           --region aws-region
   ```

   Di mana:
   + *kendra-index-id*adalah Anda diselamatkan`kendra-index-id`,
   + *path/*adalah jalur file ke `S3-data-connector.json` perangkat lokal Anda,
   + *role-arn*adalah Anda diselamatkan`kendra-role-arn`,
   + *aws-region*adalah AWS wilayah Anda.

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

   ```
   aws kendra create-data-source \
           --index-id kendra-index-id \
           --name S3-data-source \
           --type S3 \
           --configuration file://path/S3-data-connector.json \
           --role-arn role-arn \
           --region aws-region
   ```

   Di mana:
   + *kendra-index-id*adalah Anda diselamatkan`kendra-index-id`,
   + *path/*adalah jalur file ke `S3-data-connector.json` perangkat lokal Anda,
   + *role-arn*adalah Anda diselamatkan`kendra-role-arn`,
   + *aws-region*adalah AWS wilayah Anda.

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

   ```
   aws kendra create-data-source ^
           --index-id kendra-index-id ^
           --name S3-data-source ^
           --type S3 ^
           --configuration file://path/S3-data-connector.json ^
           --role-arn role-arn ^
           --region aws-region
   ```

   Di mana:
   + *kendra-index-id*adalah Anda diselamatkan`kendra-index-id`,
   + *path/*adalah jalur file ke `S3-data-connector.json` perangkat lokal Anda,
   + *role-arn*adalah Anda diselamatkan`kendra-role-arn`,
   + *aws-region*adalah AWS wilayah Anda.

------

1. Salin konektor `Id` dan simpan di editor teks sebagai`S3-connector-id`. `Id`Ini membantu Anda melacak status proses koneksi data.

1. Untuk memastikan bahwa sumber data S3 Anda berhasil terhubung, gunakan [describe-data-source](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kendra/describe-data-source.html)perintah:

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

   ```
   aws kendra describe-data-source \
           --id S3-connector-id \
           --index-id kendra-index-id \
           --region aws-region
   ```

   Di mana:
   + *S3-connector-id*adalah Anda diselamatkan`S3-connector-id`,
   + *kendra-index-id*adalah Anda diselamatkan`kendra-index-id`,
   + *aws-region*adalah AWS wilayah Anda.

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

   ```
   aws kendra describe-data-source \
           --id S3-connector-id \
           --index-id kendra-index-id \
           --region aws-region
   ```

   Di mana:
   + *S3-connector-id*adalah Anda diselamatkan`S3-connector-id`,
   + *kendra-index-id*adalah Anda diselamatkan`kendra-index-id`,
   + *aws-region*adalah AWS wilayah Anda.

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

   ```
   aws kendra describe-data-source ^
           --id S3-connector-id ^
           --index-id kendra-index-id ^
           --region aws-region
   ```

   Di mana:
   + *S3-connector-id*adalah Anda diselamatkan`S3-connector-id`,
   + *kendra-index-id*adalah Anda diselamatkan`kendra-index-id`,
   + *aws-region*adalah AWS wilayah Anda.

------

Di akhir langkah ini, sumber data Amazon S3 Anda terhubung ke indeks.

## Menyinkronkan indeks Amazon Kendra
<a name="tutorial-search-metadata-create-index-sync"></a>

Dengan sumber data Amazon S3 ditambahkan, Anda sekarang menyinkronkan indeks Amazon Kendra Anda ke sana.

### Untuk menyinkronkan indeks Amazon Kendra Anda (Konsol)
<a name="tutorial-search-metadata-sync-index-console"></a>

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

1. Dari daftar **Indeks**, klik`kendra-index`.

1. Dari menu navigasi kiri, pilih **Sumber data**.

1. Dari **sumber data**, pilih`S3-data-source`.

1. Dari bilah navigasi atas, pilih **Sinkronkan sekarang**.

### Untuk menyinkronkan indeks Amazon Kendra Anda ()AWS CLI
<a name="tutorial-search-metadata-sync-index-cli"></a>

1. Untuk menyinkronkan indeks Anda, gunakan perintah [start-data-source-sync-job](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kendra/start-data-source-sync-job.html):

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

   ```
   aws kendra start-data-source-sync-job \
           --id S3-connector-id \
           --index-id kendra-index-id \
           --region aws-region
   ```

   Di mana:
   + *S3-connector-id*adalah Anda diselamatkan`S3-connector-id`,
   + *kendra-index-id*adalah Anda diselamatkan`kendra-index-id`,
   + *aws-region*adalah AWS wilayah Anda.

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

   ```
   aws kendra start-data-source-sync-job \
           --id S3-connector-id \
           --index-id kendra-index-id \
           --region aws-region
   ```

   Di mana:
   + *S3-connector-id*adalah Anda diselamatkan`S3-connector-id`,
   + *kendra-index-id*adalah Anda diselamatkan`kendra-index-id`,
   + *aws-region*adalah AWS wilayah Anda.

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

   ```
   aws kendra start-data-source-sync-job ^
           --id S3-connector-id ^
           --index-id kendra-index-id ^
           --region aws-region
   ```

   Di mana:
   + *S3-connector-id*adalah Anda diselamatkan`S3-connector-id`,
   + *kendra-index-id*adalah Anda diselamatkan`kendra-index-id`,
   + *aws-region*adalah AWS wilayah Anda.

------

1. Untuk memeriksa status sinkronisasi indeks, gunakan perintah [list-data-source-sync-jobs](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kendra/list-data-source-sync-jobs.html):

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

   ```
   aws kendra list-data-source-sync-jobs \
           --id S3-connector-id \
           --index-id kendra-index-id \
           --region aws-region
   ```

   Di mana:
   + *S3-connector-id*adalah Anda diselamatkan`S3-connector-id`,
   + *kendra-index-id*adalah Anda diselamatkan`kendra-index-id`,
   + *aws-region*adalah AWS wilayah Anda.

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

   ```
   aws kendra list-data-source-sync-jobs \
           --id S3-connector-id \
           --index-id kendra-index-id \
           --region aws-region
   ```

   Di mana:
   + *S3-connector-id*adalah Anda diselamatkan`S3-connector-id`,
   + *kendra-index-id*adalah Anda diselamatkan`kendra-index-id`,
   + *aws-region*adalah AWS wilayah Anda.

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

   ```
   aws kendra list-data-source-sync-jobs ^
           --id S3-connector-id ^
           --index-id kendra-index-id ^
           --region aws-region
   ```

   Di mana:
   + *S3-connector-id*adalah Anda diselamatkan`S3-connector-id`,
   + *kendra-index-id*adalah Anda diselamatkan`kendra-index-id`,
   + *aws-region*adalah AWS wilayah Anda.

------

Di akhir langkah ini, Anda telah membuat indeks Amazon Kendra yang dapat dicari dan difilter untuk kumpulan data Anda.