翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# ステップ 4: Amazon Kendra インデックスを作成し、メタデータを取り込む
インテリジェント検索ソリューションを実装するには、Amazon Kendra インデックスを作成し、S3 データとメタデータをそこに取り込みます。
Amazon Kendra インデックスにメタデータを追加する前に、カスタムドキュメント属性に対応するカスタムインデックスフィールドを作成します。これは、Amazon Comprehend エンティティタイプに対応します。Amazon Kendra では、作成したインデックスフィールドとカスタムドキュメント属性を使用して、ドキュメントを検索およびフィルタリングします。
詳細については、[インデックス](https://docs.aws.amazon.com/kendra/latest/dg/hiw-index.html)および[カスタムドキュメント属性の作成](https://docs.aws.amazon.com/kendra/latest/dg/custom-attributes.html)を参照してください。
**Topics**
+ [
## Amazon Kendra インデックスの作成
](#tutorial-search-metadata-create-index)
+ [
## Amazon S3 アクセスのための IAM ロールの更新
](#tutorial-search-metadata-create-index-update-IAM)
+ [
## Amazon Kendra カスタム検索インデックスフィールドを作成する
](#tutorial-search-metadata-create-index-custom-fields)
+ [
## Amazon S3 バケットをインデックスのデータソースとして追加する
](#tutorial-search-metadata-create-index-connect-data)
+ [
## Amazon Kendra インデックスの同期
](#tutorial-search-metadata-create-index-sync)
## Amazon Kendra インデックスの作成
ソースドキュメントをクエリするには、Amazon Kendra インデックスを作成します。
このステップ AWS CLI で を使用している場合は、インデックスを作成する前に Amazon Kendra AWS が CloudWatch ログにアクセスできるようにする IAM ロールとポリシーを作成してアタッチします。詳細については、[前提条件](https://docs.aws.amazon.com/kendra/latest/dg/gs-prerequisites.html)を参照してください。
### Amazon Kendra インデックスを作成するには (コンソール)
1. Amazon Kendra コンソール ([https://console.aws.amazon.com/kendra/](https://console.aws.amazon.com/kendra/)) を開きます。
**重要**
Amazon Comprehend エンティティジョブと Amazon S3 バケットを作成したリージョンと同じリージョンに存在することを確認します。別のリージョンにいる場合は、上部のナビゲーションバーの AWS リージョンセレクターから Amazon S3 バケットを作成したリージョンを選択します。 ****
1. **[Create an index]** (インデックスの作成) を選択します。
1. **[Index details]** (インデックスの詳細の指定) ページの **[Specify index details]** (インデックスの詳細) で、次の操作を行います。
1. **[Index name]** (インデックス名) に **kendra-index** と入力します。
1. **[Description]** (説明) フィールドは空白のままにしておきます。
1. **[IAM role]** (IAM ロール) は、**[Create a new role]** (新しいロールの作成) を選択します。このロールは、Amazon S3 バケットへのアクセスを提供します。
1. **[Role name]** (ロール名) に **kendra-role** と入力します。IAM ロールにはプレフィックス `AmazonKendra-` が付いています。
1. **[Encryption]** (暗号化) と **[Tags]** (タグ) のデフォルト設定はそのままにして、**[Next]** (次へ) をクリックします。
1. **[Access control setting]** (アクセスコントロールの設定) ページの **[Configure user access control]** (アクセスコントロールの設定) で、**[No]** (いいえ) を選択してから、**[Next]** (次へ) をクリックします。
1. **[Provisioning editions]** (プロビジョニングの詳細) ページの** [Provisioning details]** (プロビジョニングエディション) で、**[Developer edition]** (デベロッパーエディション) を選択し、**[Create]** (作成) をクリックします。
### Amazon Kendra インデックスを作成するには (AWS CLI)
1. 信頼されたエンティティとして認識する Amazon Kendra の IAM ロールを作成してアタッチするには、以下の操作を行います。
1. 次の信頼ポリシーを、ローカルデバイスのテキストエディタで `kendra-trust-policy.json` という JSON ファイルとして保存します。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": {
"Effect": "Allow",
"Principal": {
"Service": "kendra.amazonaws.com"
},
"Action": "sts:AssumeRole"
}
}
```
------
1. `kendra-role` という IAM ロールを作成するには、保存した `kendra-trust-policy.json` ファイルをアタッチしてくださいそれをファイルして、[[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
```
コードの説明は以下のとおりです。
+ *path/* は、ローカルデバイス上の `kendra-trust-policy.json` フォルダへのファイルパスです。
------
#### [ macOS ]
```
aws iam create-role \
--role-name kendra-role \
--assume-role-policy-document file://path/kendra-trust-policy.json
```
コードの説明は以下のとおりです。
+ *path/* は、ローカルデバイス上の `kendra-trust-policy.json` フォルダへのファイルパスです。
------
#### [ Windows ]
```
aws iam create-role ^
--role-name kendra-role ^
--assume-role-policy-document file://path/kendra-trust-policy.json
```
コードの説明は以下のとおりです。
+ *path/* は、ローカルデバイス上の `kendra-trust-policy.json` フォルダへのファイルパスです。
------
1. Amazon リソースネーム (ARN) をテキストエディタにコピーし、`kendra-role-arn` としローカルに保存します。
**注記**
ARN は、*arn:aws:iam::123456789012:role/kendra-role* というような形式になります。Amazon Kendra ジョブを実行するには、`kendra-role-arn` として保存した ARN が必要になります。
1. インデックスを作成する前に、`kendra-role` に CloudWatch Logs への書き込み許可を提供する必要があります。そのためには、以下のステップを完了します。
1. 次の信頼ポリシーを、ローカルデバイスのテキストエディタで `kendra-cloudwatch-policy.json` という JSON ファイルとして保存します。
*aws-region* を自分の AWS リージョンに、*aws-account-id* を自分の 12 桁の AWS アカウント ID に置き換えます。
1. CloudWatch Logs にアクセスするための IAM ポリシーを作成するには、[[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
```
コードの説明は以下のとおりです。
+ *path/* は、ローカルデバイス上の `kendra-cloudwatch-policy.json` フォルダへのファイルパスです。
------
#### [ macOS ]
```
aws iam create-policy \
--policy-name kendra-cloudwatch-policy \
--policy-document file://path/kendra-cloudwatch-policy.json
```
コードの説明は以下のとおりです。
+ *path/* は、ローカルデバイス上の `kendra-cloudwatch-policy.json` フォルダへのファイルパスです。
------
#### [ Windows ]
```
aws iam create-policy ^
--policy-name kendra-cloudwatch-policy ^
--policy-document file://path/kendra-cloudwatch-policy.json
```
コードの説明は以下のとおりです。
+ *path/* は、ローカルデバイス上の `kendra-cloudwatch-policy.json` フォルダへのファイルパスです。
------
1. Amazon リソースネーム (ARN) をテキストエディタにコピーし、`kendra-cloudwatch-arn` としローカルに保存します。
**注記**
ARN は、*arn:aws:iam::123456789012:role/kendra-cloudwatch-policy* というような形式になります。`kendra-cloudwatch-arn` を IAM ロールにアタッチするには、`kendra-cloudwatch-policy` として保存した ARN が必要になります。
1. `kendra-cloudwatch-policy` を IAM ロールにアタッチするには、[[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
```
コードの説明は以下のとおりです。
+ *policy-arn* は、保存した `kendra-cloudwatch-arn` です。
------
#### [ macOS ]
```
aws iam attach-role-policy \
--policy-arn policy-arn \
--role-name kendra-role
```
コードの説明は以下のとおりです。
+ *policy-arn* は、保存した `kendra-cloudwatch-arn` です。
------
#### [ Windows ]
```
aws iam attach-role-policy ^
--policy-arn policy-arn ^
--role-name kendra-role
```
コードの説明は以下のとおりです。
+ *policy-arn* は、保存した `kendra-cloudwatch-arn` です。
------
1. インデックスを作成するには、[[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
```
コードの説明は以下のとおりです。
+ *role-arn* は、保存した `kendra-role-arn`、
+ *aws-region* はお客様の AWS リージョンです。
------
#### [ macOS ]
```
aws kendra create-index \
--name kendra-index \
--edition DEVELOPER_EDITION \
--role-arn role-arn \
--region aws-region
```
コードの説明は以下のとおりです。
+ *role-arn* は、保存した `kendra-role-arn`、
+ *aws-region* はお客様の AWS リージョンです。
------
#### [ Windows ]
```
aws kendra create-index ^
--name kendra-index ^
--edition DEVELOPER_EDITION ^
--role-arn role-arn ^
--region aws-region
```
コードの説明は以下のとおりです。
+ *role-arn* は、保存した `kendra-role-arn`、
+ *aws-region* はお客様の AWS リージョンです。
------
1. テキストエディタでインデックス `Id` をコピーし、`kendra-index-id` という名前を付けて保存します。`Id` は、インデックス作成のステータスを追跡するのに役立ちます。
1. インデックス作成ジョブの進行状況を追跡するには、[[describe-index]](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
```
コードの説明は以下のとおりです。
+ *kendra-index-id* は、保存した `kendra-index-id`、
+ *aws-region* はお客様の AWS リージョンです。
------
#### [ macOS ]
```
aws kendra describe-index \
--id kendra-index-id \
--region aws-region
```
コードの説明は以下のとおりです。
+ *kendra-index-id* は、保存した `kendra-index-id`、
+ *aws-region* はお客様の AWS リージョンです。
------
#### [ Windows ]
```
aws kendra describe-index ^
--id kendra-index-id ^
--region aws-region
```
コードの説明は以下のとおりです。
+ *kendra-index-id* は、保存した `kendra-index-id`、
+ *aws-region* はお客様の AWS リージョンです。
------
インデックスの作成プロセスには平均で 15 分かかりますが、さらに時間がかかる場合があります。インデックスのステータスがアクティブになると、インデックスが使用可能になります。インデックスの作成中に、次のステップを開始できます。
このステップ AWS CLI で を使用している場合は、S3 バケットへのアクセス許可をインデックスに付与する IAM ポリシーを作成して Amazon Kendra IAM ロールにアタッチします。
## Amazon S3 アクセスのための IAM ロールの更新
インデックスの作成中に、Amazon Kendra IAM ロールを更新して、作成したインデックスが Amazon S3 バケットからデータを読み取ることを許可します。詳細については、[Amazon Kendra の IAM アクセスロール](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html)を参照してください。
### IAM ロールを更新するには (コンソール)
1. IAM コンソール ([https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/)) を開きます。
1. 左側のナビゲーションペインで、**[Roles]** (ロール) を選択し、**[Role name]** (ロール名) の上の **[Search]** (検索) ボックスに **kendra-role** と入力します。
1. 提案されるオプションで、`kendra-role` をクリックします。
1. **[Summary]** (概要) で、**[Attach policies]** (ポリシーの添付) を選択します。
1. **[アクセス許可をアタッチ]** の **[検索]** ボックスで、「**S3**」と入力し、提案されたオプションで、**[AmazonS3ReadOnlyAccess]** ポリシーの隣にあるチェックボックスをオンにします。
1. **[Attach policy]** (ポリシーの添付) を選択します。**[Summary]** (概要) ページで、IAM ロールに添付された 2 つのポリシーが表示されます。
1. Amazon Kendra コンソール ([https://console.aws.amazon.com/kendra/](https://console.aws.amazon.com/kendra/)) に戻り、インデックスのステータスが **[Creating]** (作成中) から **[Active]** (アクティブ) に変わるのを待って次のステップに進みます。
### IAM ロールを更新するには (AWS CLI)
1. 次のテキストを、ローカルデバイスのテキストエディタで `kendra-S3-access-policy.json` という JSON ファイルに保存します。
amzn-s3-demo-bucket をご使用の S3 バケット名に、*aws-region* をご利用の AWS リージョンに、*aws-account-id* を 12 桁の AWS アカウント ID に、*kendra-index-id* を保存した `kendra-index-id` に置き換えます。
1. S3 バケットにアクセスする IAM ポリシーを作成するには、[[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
```
コードの説明は以下のとおりです。
+ *path/* は、ローカルデバイス上の `kendra-S3-access-policy.json` フォルダへのファイルパスです。
------
#### [ macOS ]
```
aws iam create-policy \
--policy-name kendra-S3-access-policy \
--policy-document file://path/kendra-S3-access-policy.json
```
コードの説明は以下のとおりです。
+ *path/* は、ローカルデバイス上の `kendra-S3-access-policy.json` フォルダへのファイルパスです。
------
#### [ Windows ]
```
aws iam create-policy ^
--policy-name kendra-S3-access-policy ^
--policy-document file://path/kendra-S3-access-policy.json
```
コードの説明は以下のとおりです。
+ *path/* は、ローカルデバイス上の `kendra-S3-access-policy.json` フォルダへのファイルパスです。
------
1. Amazon リソースネーム (ARN) をテキストエディタにコピーし、`kendra-S3-access-arn` としローカルに保存します。
**注記**
ARN は、*arn:aws:iam::123456789012:role/kendra-S3-access-policy* というような形式になります。`kendra-S3-access-policy` を IAM ロールにアタッチするには、`kendra-S3-access-arn` として保存した ARN が必要になります。
1. `kendra-S3-access-policy` を Amazon Kendra IAM ロールにアタッチするには、[[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
```
コードの説明は以下のとおりです。
+ *policy-arn* は、保存した `kendra-S3-access-arn` です。
------
#### [ macOS ]
```
aws iam attach-role-policy \
--policy-arn policy-arn \
--role-name kendra-role
```
コードの説明は以下のとおりです。
+ *policy-arn* は、保存した `kendra-S3-access-arn` です。
------
#### [ Windows ]
```
aws iam attach-role-policy ^
--policy-arn policy-arn ^
--role-name kendra-role
```
コードの説明は以下のとおりです。
+ *policy-arn* は、保存した `kendra-S3-access-arn` です。
------
## Amazon Kendra カスタム検索インデックスフィールドを作成する
メタデータをカスタムドキュメント属性として認識するように Amazon Kendra を準備するには、Amazon Comprehend エンティティタイプに対応するカスタムフィールドを作成します。次の 9 つの Amazon Comprehend エンティティタイプをカスタムフィールドとして入力します。
+ COMMERCIAL\$1ITEM
+ DATE
+ EVENT
+ LOCATION
+ ORGANIZATION
+ OTHER
+ PERSON
+ QUANTITY
+ TITLE
**重要**
スペルミスのあるエンティティタイプは、インデックスによって認識されません。
### Amazon Kendra インデックスのカスタムフィールドを作成するには (コンソール)
1. Amazon Kendra コンソール ([https://console.aws.amazon.com/kendra/](https://console.aws.amazon.com/kendra/)) を開きます。
1. **[Indexes]** (インデックス) リストから、`kendra-index` をクリックします。
1. 左側のナビゲーションパネルの **[Data management]** (データ管理) で、**[Facet definition]** (ファセット定義) を選択します。
1. **[Index fields]** (インデックスフィールド) メニューで、**[Add field]** (フィールドを追加) を選択します。
1. **[Add index field]** (インデックスフィールドの追加) ダイアログボックスで、以下の操作を行います。
1. **[Field name]** (フィールド名) に **COMMERCIAL\$1ITEM** と入力します。
1. **[Data type]** (データタイプ) で、**[String list]** (文字列リスト) を選択します。
1. **[Usage type]** (使用タイプ) で、**[Facetable]** (ファセット可能)、**[Searchable]** (検索可能)、および **[Displayable]** (表示可能)、を選択して **[Add]** (追加) を選択します。
1. Amazon Comprehend の各エンティティタイプ (COMMERCIAL\$1ITEM、DATE、EVENT、LOCATION、ORGANIZATION、OTHER、PERSON、QUANTITY、TITLE) について、ステップ a から c を繰り返します。
コンソールに成功したフィールド追加メッセージが表示されます。次のステップに進む前に、それらを閉じることができます。
### Amazon Kendra インデックスのカスタムフィールドを作成するには (AWS CLI)
1. 次のテキストを、ローカルデバイスのテキストエディタで `custom-attributes.json` という JSON ファイルとして保存します。
```
[
{
"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. インデックスにカスタムフィールドを作成するには、[[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
```
コードの説明は以下のとおりです。
+ *kendra-index-id* は、保存した `kendra-index-id`、
+ *path/* は、ローカルデバイス上の `custom-attributes.json` フォルダへのファイルパス、
+ *aws-region* はお客様の AWS リージョンです。
------
#### [ macOS ]
```
aws kendra update-index \
--id kendra-index-id \
--document-metadata-configuration-updates file://path/custom-attributes.json \
--region aws-region
```
コードの説明は以下のとおりです。
+ *kendra-index-id* は、保存した `kendra-index-id`、
+ *path/* は、ローカルデバイス上の `custom-attributes.json` フォルダへのファイルパス、
+ *aws-region* はお客様の AWS リージョンです。
------
#### [ Windows ]
```
aws kendra update-index ^
--id kendra-index-id ^
--document-metadata-configuration-updates file://path/custom-attributes.json ^
--region aws-region
```
コードの説明は以下のとおりです。
+ *kendra-index-id* は、保存した `kendra-index-id`、
+ *path/* は、ローカルデバイス上の `custom-attributes.json` フォルダへのファイルパス、
+ *aws-region* はお客様の AWS リージョンです。
------
1. カスタム属性がインデックスに追加されていることを確認するには、[[describe-index]](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
```
コードの説明は以下のとおりです。
+ *kendra-index-id* は、保存した `kendra-index-id`、
+ *aws-region* はお客様の AWS リージョンです。
------
#### [ macOS ]
```
aws kendra describe-index \
--id kendra-index-id \
--region aws-region
```
コードの説明は以下のとおりです。
+ *kendra-index-id* は、保存した `kendra-index-id`、
+ *aws-region* はお客様の AWS リージョンです。
------
#### [ Windows ]
```
aws kendra describe-index ^
--id kendra-index-id ^
--region aws-region
```
コードの説明は以下のとおりです。
+ *kendra-index-id* は、保存した `kendra-index-id`、
+ *aws-region* はお客様の AWS リージョンです。
------
## Amazon S3 バケットをインデックスのデータソースとして追加する
インデックスを同期する前に、S3 データソースをそのインデックスに接続する必要があります。
### S3 バケットを Amazon Kendra インデックスに接続するには (コンソール)
1. Amazon Kendra コンソール ([https://console.aws.amazon.com/kendra/](https://console.aws.amazon.com/kendra/)) を開きます。
1. **[Indexes]** (インデックス) リストから、`kendra-index` をクリックします。
1. 左側のナビゲーションメニューから、**[Data management]** (データ管理) で、**[Data sources]** (データソース) を選択します。
1. **[Select data source connector type]** (データソースコネクタのタイプを選択する) セクションで **[Amazon S3]** に移動し、**[Add connector]** (コネクタの追加) を選択します。
1. **[Specify data source details]** (データソースの詳細の指定) ページで、以下の操作を行います。
1. **[Name and description]** (名前と説明) の **[Data source name]** (データソース名) に、**S3-data-source** と入力します。
1. **[Description]** (説明) セクションは空白のままにしておきます。
1. **[Tags]** (タグ) は、デフォルト設定のままにしておきます。
1. **[Next]** (次へ) を選択します。
1. **[Configure sync settings]** (設定の定義) ページの **[Sync scope]** (同期の適用範囲) セクションで、以下の操作を行います。
1. **[Enter the data source location]** (データソースの場所を入力する) で、**[Browse S3]** (S3 を閲覧する)を選択します。
1. **[Choose resources]** (リソースの選択) で、S3 バケット、**[Choose]** (選択) の順に選択します。
1. **[Metadata files prefix folder location]** (メタデータファイルのプレフィックスフォルダの場所) で、**[Browse S3]** (S3 を閲覧する) を選択します。
1. **[Choose resources]** (リソースの選択) で、バケットのリストからバケットの名前をクリックします。
1. **[Objects]** (オブジェクト) で、`metadata` のオプションボックスを選択し、**[Choose]** (選択) をクリックします。ロケーションフィールドには、`metadata/` と表示されます。
1. **[Access control list configuration file location]** (アクセスコントロールリスト設定ファイルの場所)、**[Select decryption key]** (復号キーを選択)、および **[Additional configuration]** (追加設定) は、デフォルト設定のままにしておきます。
1. **[Configure sync settings]** (同期設定を構成する) ページの **[IAM role]** (IAM ロール) で、[`kendra-role`] を選択します。
1. **[Configure sync settings]** (同期設定を構成する) ページの **[Sync run schedule]** (同期実行スケジュール) で、**[Frequency]** (頻度) に **[Run on demand]** (オンデマンドで実行する) を選択して **[Next]** (次へ) をクリックします。
1. **[Review and create]** (確認と作成) ページで、データソースの詳細について選択内容を確認し、**[Add data source]** (データソースの追加) を選択します。
### S3 バケットを Amazon Kendra インデックスに接続するには (AWS CLI)
1. 次のテキストを、ローカルデバイスのテキストエディタで `S3-data-connector.json` という JSON ファイルとして保存します。
```
{
"S3Configuration":{
"BucketName":"amzn-s3-demo-bucket",
"DocumentsMetadataConfiguration":{
"S3Prefix":"metadata"
}
}
}
```
amzn-s3-demo-bucket は、実際の S3 バケット名に置き換えます。
1. S3 バケットをインデックスに接続するには、[[create-data-source](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kendra/create-data-source.html)] コマンドを使用します。
------
#### [ 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
```
コードの説明は以下のとおりです。
+ *kendra-index-id* は、保存した `kendra-index-id`、
+ *path/* は、ローカルデバイス上の `S3-data-connector.json` フォルダへのファイルパス、
+ *role-arn* は、保存した `kendra-role-arn`、
+ *aws-region* はお客様の AWS リージョンです。
------
#### [ 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
```
コードの説明は以下のとおりです。
+ *kendra-index-id* は、保存した `kendra-index-id`、
+ *path/* は、ローカルデバイス上の `S3-data-connector.json` フォルダへのファイルパス、
+ *role-arn* は、保存した `kendra-role-arn`、
+ *aws-region* はお客様の AWS リージョンです。
------
#### [ 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
```
コードの説明は以下のとおりです。
+ *kendra-index-id* は、保存した `kendra-index-id`、
+ *path/* は、ローカルデバイス上の `S3-data-connector.json` フォルダへのファイルパス、
+ *role-arn* は、保存した `kendra-role-arn`、
+ *aws-region* はお客様の AWS リージョンです。
------
1. テキストエディタでコネクタ `Id` をコピーし、`S3-connector-id` という名前を付けて保存します。`Id` は、データ接続プロセスのステータスを追跡するのに役立ちます。
1. S3 データソースが正常に接続されていることを確認するには、[[describe-data-source](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kendra/describe-data-source.html)] コマンドを使用します。
------
#### [ Linux ]
```
aws kendra describe-data-source \
--id S3-connector-id \
--index-id kendra-index-id \
--region aws-region
```
コードの説明は以下のとおりです。
+ *S3-connector-id* は、保存した `S3-connector-id`、
+ *kendra-index-id* は、保存した `kendra-index-id`、
+ *aws-region* はお客様の AWS リージョンです。
------
#### [ macOS ]
```
aws kendra describe-data-source \
--id S3-connector-id \
--index-id kendra-index-id \
--region aws-region
```
コードの説明は以下のとおりです。
+ *S3-connector-id* は、保存した `S3-connector-id`、
+ *kendra-index-id* は、保存した `kendra-index-id`、
+ *aws-region* はお客様の AWS リージョンです。
------
#### [ Windows ]
```
aws kendra describe-data-source ^
--id S3-connector-id ^
--index-id kendra-index-id ^
--region aws-region
```
コードの説明は以下のとおりです。
+ *S3-connector-id* は、保存した `S3-connector-id`、
+ *kendra-index-id* は、保存した `kendra-index-id`、
+ *aws-region* はお客様の AWS リージョンです。
------
このステップを終了すると、Amazon S3 データソースがインデックスに接続されます。
## Amazon Kendra インデックスの同期
Amazon S3 データソースを追加すると、Amazon Kendra インデックスが同期されます。
### Amazon Kendra インデックスを同期するには (コンソール)
1. Amazon Kendra コンソール ([https://console.aws.amazon.com/kendra/](https://console.aws.amazon.com/kendra/)) を開きます。
1. **[Indexes]** (インデックス) リストから、`kendra-index` をクリックします。
1. 左側のナビゲーションメニューから **[Data sources]** (データソース) を選択します。
1. **[Data sources]** (データソース) から、`S3-data-source` を選択します。
1. 上部のナビゲーションバーから、**[Sync now]** (今すぐ同期) を選択します。
### Amazon Kendra インデックスを同期するには (AWS CLI)
1. インデックスを同期するには、[[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
```
コードの説明は以下のとおりです。
+ *S3-connector-id* は、保存した `S3-connector-id`、
+ *kendra-index-id* は、保存した `kendra-index-id`、
+ *aws-region* はお客様の AWS リージョンです。
------
#### [ macOS ]
```
aws kendra start-data-source-sync-job \
--id S3-connector-id \
--index-id kendra-index-id \
--region aws-region
```
コードの説明は以下のとおりです。
+ *S3-connector-id* は、保存した `S3-connector-id`、
+ *kendra-index-id* は、保存した `kendra-index-id`、
+ *aws-region* はお客様の AWS リージョンです。
------
#### [ Windows ]
```
aws kendra start-data-source-sync-job ^
--id S3-connector-id ^
--index-id kendra-index-id ^
--region aws-region
```
コードの説明は以下のとおりです。
+ *S3-connector-id* は、保存した `S3-connector-id`、
+ *kendra-index-id* は、保存した `kendra-index-id`、
+ *aws-region* はお客様の AWS リージョンです。
------
1. インデックス同期のステータスを確認するには、[[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
```
コードの説明は以下のとおりです。
+ *S3-connector-id* は、保存した `S3-connector-id`、
+ *kendra-index-id* は、保存した `kendra-index-id`、
+ *aws-region* はお客様の AWS リージョンです。
------
#### [ macOS ]
```
aws kendra list-data-source-sync-jobs \
--id S3-connector-id \
--index-id kendra-index-id \
--region aws-region
```
コードの説明は以下のとおりです。
+ *S3-connector-id* は、保存した `S3-connector-id`、
+ *kendra-index-id* は、保存した `kendra-index-id`、
+ *aws-region* はお客様の AWS リージョンです。
------
#### [ Windows ]
```
aws kendra list-data-source-sync-jobs ^
--id S3-connector-id ^
--index-id kendra-index-id ^
--region aws-region
```
コードの説明は以下のとおりです。
+ *S3-connector-id* は、保存した `S3-connector-id`、
+ *kendra-index-id* は、保存した `kendra-index-id`、
+ *aws-region* はお客様の AWS リージョンです。
------
このステップを完了すると、データセットに検索可能でフィルター可能な Amazon Kendra インデックスが作成されます。