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 4 : Création d'un index Amazon Kendra et ingestion des métadonnées Pour implémenter votre solution de recherche intelligente, vous devez créer un index Amazon Kendra et y ingérer vos données et métadonnées S3. Avant d'ajouter des métadonnées à votre index Amazon Kendra, vous devez créer des champs d'index personnalisés correspondant à des attributs de document personnalisés, qui à leur tour correspondent aux types d'entités Amazon Comprehend. Amazon Kendra utilise les champs d'index et les attributs de document personnalisés que vous créez pour rechercher et filtrer vos documents. Pour plus d'informations, voir [Index](https://docs.aws.amazon.com/kendra/latest/dg/hiw-index.html) et [Création d'attributs de document personnalisés](https://docs.aws.amazon.com/kendra/latest/dg/custom-attributes.html). **Topics** + [Création d'un index Amazon Kendra](#tutorial-search-metadata-create-index) + [Mise à jour du rôle IAM pour l'accès à Amazon S3](#tutorial-search-metadata-create-index-update-IAM) + [Création de champs d'index de recherche personnalisés pour Amazon Kendra](#tutorial-search-metadata-create-index-custom-fields) + [Ajout du compartiment Amazon S3 en tant que source de données pour l'index](#tutorial-search-metadata-create-index-connect-data) + [Synchronisation de l'index Amazon Kendra](#tutorial-search-metadata-create-index-sync) ## Création d'un index Amazon Kendra Pour interroger vos documents sources, vous devez créer un index Amazon Kendra. Si vous utilisez le AWS CLI dans cette étape, vous créez et attachez un rôle et une politique AWS IAM qui permettent à Amazon Kendra d'accéder à CloudWatch vos journaux avant de créer un index. Pour plus d'informations, veuillez consulter les [Prérequis](https://docs.aws.amazon.com/kendra/latest/dg/gs-prerequisites.html). ### Pour créer un index Amazon Kendra (console) 1. Ouvrez la console Amazon Kendra à l'adresse. [https://console.aws.amazon.com/kendra/](https://console.aws.amazon.com/kendra/) **Important** Assurez-vous que vous vous trouvez dans la même région que celle dans laquelle vous avez créé votre tâche d'analyse des entités Amazon Comprehend et votre compartiment Amazon S3. Si vous vous trouvez dans une autre région, choisissez la AWS région dans laquelle vous avez créé votre compartiment Amazon S3 dans le **sélecteur de région situé** dans la barre de navigation supérieure. 1. Choisissez **Créer un index**. 1. Pour les **détails de l'index** sur la page **Spécifier les détails de l'index**, procédez comme suit : 1. Pour **Nom de l'index**, saisissez **kendra-index**. 1. Laissez le champ **Description** vide. 1. Pour Rôle IAM, choisissez Créer un rôle.******** Ce rôle permet d'accéder à votre compartiment Amazon S3. 1. Pour le **Nom du rôle**, saisissez **kendra-role**. Le rôle IAM aura le préfixe`AmazonKendra-`. 1. Conservez les paramètres par défaut pour **le chiffrement** et les **balises**, puis choisissez **Next**. 1. Pour les **paramètres de contrôle** **d'accès sur la page Configurer le contrôle d'accès utilisateur**, choisissez **Non**, puis **Suivant**. 1. **Pour les **éditions Provisioning** sur la page des **détails de Provisioning**, choisissez **Developer edition puis Create**.** ### Pour créer un index Amazon Kendra ()AWS CLI 1. Pour créer et associer un rôle IAM à Amazon Kendra qui le reconnaisse comme une entité de confiance, procédez comme suit : 1. Enregistrez la politique de confiance suivante sous forme de fichier JSON appelé `kendra-trust-policy.json` dans un éditeur de texte sur votre appareil local. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": { "Effect": "Allow", "Principal": { "Service": "kendra.amazonaws.com" }, "Action": "sts:AssumeRole" } } ``` ------ 1. Pour créer un rôle IAM appelé `kendra-role` et y joindre votre `kendra-trust-policy.json` fichier enregistré, utilisez la commande [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 ``` Où : + *path/*est le chemin du fichier vers votre `kendra-trust-policy.json` appareil local. ------ #### [ macOS ] ``` aws iam create-role \ --role-name kendra-role \ --assume-role-policy-document file://path/kendra-trust-policy.json ``` Où : + *path/*est le chemin du fichier vers votre `kendra-trust-policy.json` appareil local. ------ #### [ Windows ] ``` aws iam create-role ^ --role-name kendra-role ^ --assume-role-policy-document file://path/kendra-trust-policy.json ``` Où : + *path/*est le chemin du fichier vers votre `kendra-trust-policy.json` appareil local. ------ 1. Copiez l'Amazon Resource Name (ARN) dans votre éditeur de texte et enregistrez-le localement sous le nom de`kendra-role-arn`. **Note** Le format de l'ARN est similaire à*arn:aws:iam::123456789012:role/kendra-role*. Vous avez besoin de l'ARN sous lequel vous avez enregistré `kendra-role-arn` pour exécuter les tâches Amazon Kendra. 1. Avant de créer un index, vous devez autoriser `kendra-role` l'écriture dans CloudWatch Logs. Pour y arriver, exécutez les étapes suivantes. 1. Enregistrez la politique de confiance suivante sous forme de fichier JSON appelé `kendra-cloudwatch-policy.json` dans un éditeur de texte sur votre appareil local. Remplacez *aws-region* par votre AWS région et *aws-account-id* par votre identifiant de AWS compte à 12 chiffres. 1. Pour créer une politique IAM permettant d'accéder aux CloudWatch journaux, utilisez la commande [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 ``` Où : + *path/*est le chemin du fichier vers votre `kendra-cloudwatch-policy.json` appareil local. ------ #### [ macOS ] ``` aws iam create-policy \ --policy-name kendra-cloudwatch-policy \ --policy-document file://path/kendra-cloudwatch-policy.json ``` Où : + *path/*est le chemin du fichier vers votre `kendra-cloudwatch-policy.json` appareil local. ------ #### [ Windows ] ``` aws iam create-policy ^ --policy-name kendra-cloudwatch-policy ^ --policy-document file://path/kendra-cloudwatch-policy.json ``` Où : + *path/*est le chemin du fichier vers votre `kendra-cloudwatch-policy.json` appareil local. ------ 1. Copiez l'Amazon Resource Name (ARN) dans votre éditeur de texte et enregistrez-le localement sous le nom de`kendra-cloudwatch-arn`. **Note** Le format de l'ARN est similaire à*arn:aws:iam::123456789012:role/kendra-cloudwatch-policy*. Vous avez besoin de l'ARN sous lequel vous avez enregistré `kendra-cloudwatch-arn` pour l'associer `kendra-cloudwatch-policy` à votre rôle IAM. 1. Pour l'associer `kendra-cloudwatch-policy` à votre rôle IAM, utilisez la [attach-role-policy](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iam/attach-role-policy.html)commande : ------ #### [ Linux ] ``` aws iam attach-role-policy \ --policy-arn policy-arn \ --role-name kendra-role ``` Où : + *policy-arn*est votre sauvegarde`kendra-cloudwatch-arn`. ------ #### [ macOS ] ``` aws iam attach-role-policy \ --policy-arn policy-arn \ --role-name kendra-role ``` Où : + *policy-arn*est votre sauvegarde`kendra-cloudwatch-arn`. ------ #### [ Windows ] ``` aws iam attach-role-policy ^ --policy-arn policy-arn ^ --role-name kendra-role ``` Où : + *policy-arn*est votre sauvegarde`kendra-cloudwatch-arn`. ------ 1. Pour créer un index, utilisez la commande [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 ``` Où : + *role-arn*est votre sauvegarde`kendra-role-arn`, + *aws-region*est votre AWS région. ------ #### [ macOS ] ``` aws kendra create-index \ --name kendra-index \ --edition DEVELOPER_EDITION \ --role-arn role-arn \ --region aws-region ``` Où : + *role-arn*est votre sauvegarde`kendra-role-arn`, + *aws-region*est votre AWS région. ------ #### [ Windows ] ``` aws kendra create-index ^ --name kendra-index ^ --edition DEVELOPER_EDITION ^ --role-arn role-arn ^ --region aws-region ``` Où : + *role-arn*est votre sauvegarde`kendra-role-arn`, + *aws-region*est votre AWS région. ------ 1. Copiez l'index `Id` et enregistrez-le dans un éditeur de texte sous`kendra-index-id`. `Id`Cela vous permet de suivre l'état de la création de votre index. 1. Pour suivre la progression de votre tâche de création d'index, utilisez la commande [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 ``` Où : + *kendra-index-id*est votre sauvegarde`kendra-index-id`, + *aws-region*est votre AWS région. ------ #### [ macOS ] ``` aws kendra describe-index \ --id kendra-index-id \ --region aws-region ``` Où : + *kendra-index-id*est votre sauvegarde`kendra-index-id`, + *aws-region*est votre AWS région. ------ #### [ Windows ] ``` aws kendra describe-index ^ --id kendra-index-id ^ --region aws-region ``` Où : + *kendra-index-id*est votre sauvegarde`kendra-index-id`, + *aws-region*est votre AWS région. ------ Le processus de création d'index prend en moyenne 15 minutes, mais peut prendre plus de temps. Lorsque le statut de l'index est actif, votre index est prêt à être utilisé. Pendant la création de votre index, vous pouvez passer à l'étape suivante. Si vous utilisez le AWS CLI dans cette étape, vous créez et associez une politique IAM à votre rôle Amazon Kendra IAM qui donne à votre index les autorisations d'accéder à votre compartiment S3. ## Mise à jour du rôle IAM pour l'accès à Amazon S3 Pendant la création de l'index, vous mettez à jour votre rôle Amazon Kendra IAM pour permettre à l'index que vous avez créé de lire les données de votre compartiment Amazon S3. Pour plus d'informations, consultez la section [Rôles d'accès IAM pour Amazon Kendra](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html). ### Pour mettre à jour votre rôle IAM (console) 1. Ouvrez la console IAM à l’adresse [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/). 1. Dans le volet de navigation de gauche, choisissez **Rôles** et entrez **kendra-role** dans la zone **de recherche** au-dessus **du nom du rôle**. 1. Parmi les options proposées, cliquez sur`kendra-role`. 1. Dans **Résumé**, choisissez **Joindre des politiques**. 1. Dans **Autorisations d'attachement**, dans la zone **de recherche**, entrez **S3** et cochez la case à côté de la ReadOnlyAccess politique **AmazonS3** parmi les options suggérées. 1. Choisissez **Attach policy** (Attacher la politique). Sur la page **Résumé**, vous pouvez désormais voir deux politiques associées au rôle IAM. 1. Revenez à la console Amazon Kendra à l'adresse [https://console.aws.amazon.com/kendra/](https://console.aws.amazon.com/kendra/)et attendez que le statut de votre index passe de **Création** à **Actif** avant de passer à l'étape suivante. ### Pour mettre à jour votre rôle IAM ()AWS CLI 1. Enregistrez le texte suivant dans un fichier JSON appelé `kendra-S3-access-policy.json` dans un éditeur de texte sur votre appareil local. Remplacez amzn-s3-demo-bucket par le nom de votre compartiment S3, par votre AWS région, *aws-region* par votre identifiant de compte à 12 chiffres et *aws-account-id* par votre sauvegarde AWS . *kendra-index-id* `kendra-index-id` 1. Pour créer une politique IAM permettant d'accéder à votre compartiment S3, utilisez la commande [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 ``` Où : + *path/*est le chemin du fichier vers votre `kendra-S3-access-policy.json` appareil local. ------ #### [ macOS ] ``` aws iam create-policy \ --policy-name kendra-S3-access-policy \ --policy-document file://path/kendra-S3-access-policy.json ``` Où : + *path/*est le chemin du fichier vers votre `kendra-S3-access-policy.json` appareil local. ------ #### [ Windows ] ``` aws iam create-policy ^ --policy-name kendra-S3-access-policy ^ --policy-document file://path/kendra-S3-access-policy.json ``` Où : + *path/*est le chemin du fichier vers votre `kendra-S3-access-policy.json` appareil local. ------ 1. Copiez l'Amazon Resource Name (ARN) dans votre éditeur de texte et enregistrez-le localement sous le nom de`kendra-S3-access-arn`. **Note** Le format de l'ARN est similaire à*arn:aws:iam::123456789012:role/kendra-S3-access-policy*. Vous avez besoin de l'ARN sous lequel vous avez enregistré `kendra-S3-access-arn` pour l'associer `kendra-S3-access-policy` à votre rôle IAM. 1. Pour l'associer `kendra-S3-access-policy` à votre rôle Amazon Kendra IAM, utilisez la commande suivante : [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 ``` Où : + *policy-arn*est votre sauvegarde`kendra-S3-access-arn`. ------ #### [ macOS ] ``` aws iam attach-role-policy \ --policy-arn policy-arn \ --role-name kendra-role ``` Où : + *policy-arn*est votre sauvegarde`kendra-S3-access-arn`. ------ #### [ Windows ] ``` aws iam attach-role-policy ^ --policy-arn policy-arn ^ --role-name kendra-role ``` Où : + *policy-arn*est votre sauvegarde`kendra-S3-access-arn`. ------ ## Création de champs d'index de recherche personnalisés pour Amazon Kendra Pour préparer Amazon Kendra à reconnaître vos métadonnées comme des attributs de document personnalisés, vous devez créer des champs personnalisés correspondant aux types d'entités Amazon Comprehend. Vous saisissez les neuf types d'entités Amazon Comprehend suivants sous forme de champs personnalisés : + ARTICLE\$1COMMERCIAL + DATE + ÉVÉNEMENT + LOCATION + ORGANISATION + OTHER + LA PERSONNE + QUANTITÉ + TITLE **Important** Les types d'entités mal orthographiés ne seront pas reconnus par l'index. ### Pour créer des champs personnalisés pour votre index Amazon Kendra (console) 1. Ouvrez la console Amazon Kendra à l'adresse. [https://console.aws.amazon.com/kendra/](https://console.aws.amazon.com/kendra/) 1. Dans la liste **des index**, cliquez sur`kendra-index`. 1. Dans le panneau de navigation de gauche, sous **Gestion des données**, choisissez **Définition des facettes**. 1. Dans le menu **des champs d'index**, choisissez **Ajouter un champ**. 1. Dans la boîte de dialogue **Ajouter un champ d'index**, procédez comme suit : 1. Dans **Nom du champ**, entrez**COMMERCIAL\$1ITEM**. 1. Dans **Type de données**, sélectionnez **Liste de chaînes**. 1. **Dans **Types d'utilisation**, sélectionnez **Facetable**, **Consultable et **Displayable****, puis choisissez Ajouter.** 1. Répétez les étapes a à c pour chaque type d'entité Amazon Comprehend : COMMERCIAL\$1ITEM, DATE, ÉVÉNEMENT, LIEU, ORGANISATION, AUTRE, PERSONNE, QUANTITÉ, TITRE. La console affiche les messages d'ajout de champs réussis. Vous pouvez choisir de les fermer avant de passer à l'étape suivante. ### Pour créer des champs personnalisés pour votre index Amazon Kendra ()AWS CLI 1. Enregistrez le texte suivant sous forme de fichier JSON appelé `custom-attributes.json` dans un éditeur de texte sur votre appareil local. ``` [ { "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. Pour créer des champs personnalisés dans votre index, utilisez la commande [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 ``` Où : + *kendra-index-id*est votre sauvegarde`kendra-index-id`, + *path/*est le chemin du fichier vers votre `custom-attributes.json` appareil local, + *aws-region*est votre AWS région. ------ #### [ macOS ] ``` aws kendra update-index \ --id kendra-index-id \ --document-metadata-configuration-updates file://path/custom-attributes.json \ --region aws-region ``` Où : + *kendra-index-id*est votre sauvegarde`kendra-index-id`, + *path/*est le chemin du fichier vers votre `custom-attributes.json` appareil local, + *aws-region*est votre AWS région. ------ #### [ Windows ] ``` aws kendra update-index ^ --id kendra-index-id ^ --document-metadata-configuration-updates file://path/custom-attributes.json ^ --region aws-region ``` Où : + *kendra-index-id*est votre sauvegarde`kendra-index-id`, + *path/*est le chemin du fichier vers votre `custom-attributes.json` appareil local, + *aws-region*est votre AWS région. ------ 1. Pour vérifier que les attributs personnalisés ont été ajoutés à votre index, utilisez la commande [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 ``` Où : + *kendra-index-id*est votre sauvegarde`kendra-index-id`, + *aws-region*est votre AWS région. ------ #### [ macOS ] ``` aws kendra describe-index \ --id kendra-index-id \ --region aws-region ``` Où : + *kendra-index-id*est votre sauvegarde`kendra-index-id`, + *aws-region*est votre AWS région. ------ #### [ Windows ] ``` aws kendra describe-index ^ --id kendra-index-id ^ --region aws-region ``` Où : + *kendra-index-id*est votre sauvegarde`kendra-index-id`, + *aws-region*est votre AWS région. ------ ## Ajout du compartiment Amazon S3 en tant que source de données pour l'index Avant de synchroniser votre index, vous devez y connecter votre source de données S3. ### Pour connecter un compartiment S3 à votre index Amazon Kendra (console) 1. Ouvrez la console Amazon Kendra à l'adresse. [https://console.aws.amazon.com/kendra/](https://console.aws.amazon.com/kendra/) 1. Dans la liste **des index**, cliquez sur`kendra-index`. 1. Dans le menu de navigation de gauche, sous **Gestion des données**, sélectionnez **Sources de données**. 1. Dans la section **Sélectionner le type de connecteur de source de données**, accédez à **Amazon S3** et choisissez **Ajouter un connecteur**. 1. Sur la page **Spécifier les détails de la source de données**, procédez comme suit : 1. Sous **Nom et description**, dans **Nom de la source de données**, entrez**S3-data-source**. 1. Laissez la section **Description** vide. 1. Conservez les paramètres par défaut pour les **balises**. 1. Choisissez **Suivant**. 1. Sur la page **Configurer les paramètres de synchronisation**, dans la section **Étendue de la synchronisation**, procédez comme suit : 1. Dans **Entrez l'emplacement de la source de données**, choisissez **Parcourir S3**. 1. Dans **Choisir les ressources**, sélectionnez votre compartiment S3, puis **choisissez Choose**. 1. Dans **Emplacement du dossier de préfixes des fichiers de métadonnées**, choisissez **Parcourir S3**. 1. Dans **Choisir les ressources**, cliquez sur le nom de votre bucket dans la liste des buckets. 1. Pour **Objets**, cochez la case d'option correspondant à `metadata` et **choisissez Choisir**. Le champ de localisation doit maintenant indiquer`metadata/`. 1. Conservez les paramètres par défaut pour l'**emplacement du fichier de configuration de la liste de contrôle d'accès**, la **sélection de la clé de déchiffrement** et **la configuration supplémentaire**. 1. Pour le **rôle IAM**, sur la page **Configurer les paramètres de synchronisation**, sélectionnez`kendra-role`. 1. Sur la page **Configurer les paramètres** de **synchronisation, sous Calendrier d'exécution de** synchronisation, pour **Fréquence**, choisissez **Exécuter à la demande**, puis **Suivant**. 1. Sur la page **Révision et création**, passez en revue vos choix concernant les détails de la source de données et choisissez **Ajouter une source de données**. ### Pour connecter un compartiment S3 à votre index Amazon Kendra ()AWS CLI 1. Enregistrez le texte suivant sous forme de fichier JSON appelé `S3-data-connector.json` dans un éditeur de texte sur votre appareil local. ``` { "S3Configuration":{ "BucketName":"amzn-s3-demo-bucket", "DocumentsMetadataConfiguration":{ "S3Prefix":"metadata" } } } ``` Remplacez amzn-s3-demo-bucket par le nom de votre compartiment S3. 1. Pour connecter votre compartiment S3 à votre index, utilisez la [create-data-source](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kendra/create-data-source.html)commande suivante : ------ #### [ 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 ``` Où : + *kendra-index-id*est votre sauvegarde`kendra-index-id`, + *path/*est le chemin du fichier vers votre `S3-data-connector.json` appareil local, + *role-arn*est votre sauvegarde`kendra-role-arn`, + *aws-region*est votre AWS région. ------ #### [ 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 ``` Où : + *kendra-index-id*est votre sauvegarde`kendra-index-id`, + *path/*est le chemin du fichier vers votre `S3-data-connector.json` appareil local, + *role-arn*est votre sauvegarde`kendra-role-arn`, + *aws-region*est votre AWS région. ------ #### [ 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 ``` Où : + *kendra-index-id*est votre sauvegarde`kendra-index-id`, + *path/*est le chemin du fichier vers votre `S3-data-connector.json` appareil local, + *role-arn*est votre sauvegarde`kendra-role-arn`, + *aws-region*est votre AWS région. ------ 1. Copiez le connecteur `Id` et enregistrez-le dans un éditeur de texte sous`S3-connector-id`. `Id`Cela vous permet de suivre l'état du processus de connexion des données. 1. Pour vous assurer que votre source de données S3 a été correctement connectée, utilisez la [describe-data-source](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kendra/describe-data-source.html)commande suivante : ------ #### [ Linux ] ``` aws kendra describe-data-source \ --id S3-connector-id \ --index-id kendra-index-id \ --region aws-region ``` Où : + *S3-connector-id*est votre sauvegarde`S3-connector-id`, + *kendra-index-id*est votre sauvegarde`kendra-index-id`, + *aws-region*est votre AWS région. ------ #### [ macOS ] ``` aws kendra describe-data-source \ --id S3-connector-id \ --index-id kendra-index-id \ --region aws-region ``` Où : + *S3-connector-id*est votre sauvegarde`S3-connector-id`, + *kendra-index-id*est votre sauvegarde`kendra-index-id`, + *aws-region*est votre AWS région. ------ #### [ Windows ] ``` aws kendra describe-data-source ^ --id S3-connector-id ^ --index-id kendra-index-id ^ --region aws-region ``` Où : + *S3-connector-id*est votre sauvegarde`S3-connector-id`, + *kendra-index-id*est votre sauvegarde`kendra-index-id`, + *aws-region*est votre AWS région. ------ À la fin de cette étape, votre source de données Amazon S3 est connectée à l'index. ## Synchronisation de l'index Amazon Kendra Avec l'ajout de la source de données Amazon S3, vous pouvez désormais synchroniser votre index Amazon Kendra avec celle-ci. ### Pour synchroniser votre index Amazon Kendra (console) 1. Ouvrez la console Amazon Kendra à l'adresse. [https://console.aws.amazon.com/kendra/](https://console.aws.amazon.com/kendra/) 1. Dans la liste **des index**, cliquez sur`kendra-index`. 1. Dans le menu de navigation de gauche, choisissez **Sources de données**. 1. Dans **Sources de données**, sélectionnez`S3-data-source`. 1. Dans la barre de navigation supérieure, choisissez **Synchroniser maintenant**. ### Pour synchroniser votre index Amazon Kendra ()AWS CLI 1. Pour synchroniser votre index, utilisez la commande [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 ``` Où : + *S3-connector-id*est votre sauvegarde`S3-connector-id`, + *kendra-index-id*est votre sauvegarde`kendra-index-id`, + *aws-region*est votre AWS région. ------ #### [ macOS ] ``` aws kendra start-data-source-sync-job \ --id S3-connector-id \ --index-id kendra-index-id \ --region aws-region ``` Où : + *S3-connector-id*est votre sauvegarde`S3-connector-id`, + *kendra-index-id*est votre sauvegarde`kendra-index-id`, + *aws-region*est votre AWS région. ------ #### [ Windows ] ``` aws kendra start-data-source-sync-job ^ --id S3-connector-id ^ --index-id kendra-index-id ^ --region aws-region ``` Où : + *S3-connector-id*est votre sauvegarde`S3-connector-id`, + *kendra-index-id*est votre sauvegarde`kendra-index-id`, + *aws-region*est votre AWS région. ------ 1. Pour vérifier l'état de la synchronisation des index, utilisez la commande [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 ``` Où : + *S3-connector-id*est votre sauvegarde`S3-connector-id`, + *kendra-index-id*est votre sauvegarde`kendra-index-id`, + *aws-region*est votre AWS région. ------ #### [ macOS ] ``` aws kendra list-data-source-sync-jobs \ --id S3-connector-id \ --index-id kendra-index-id \ --region aws-region ``` Où : + *S3-connector-id*est votre sauvegarde`S3-connector-id`, + *kendra-index-id*est votre sauvegarde`kendra-index-id`, + *aws-region*est votre AWS région. ------ #### [ Windows ] ``` aws kendra list-data-source-sync-jobs ^ --id S3-connector-id ^ --index-id kendra-index-id ^ --region aws-region ``` Où : + *S3-connector-id*est votre sauvegarde`S3-connector-id`, + *kendra-index-id*est votre sauvegarde`kendra-index-id`, + *aws-region*est votre AWS région. ------ À la fin de cette étape, vous avez créé un index Amazon Kendra consultable et filtrable pour votre ensemble de données.