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.
# Amazon RDS/Aurora
Vous pouvez indexer des documents stockés dans une base de données à l'aide d'une source de données de base de données. Après avoir fourni les informations de connexion pour la base de données, Amazon Kendra connecte et indexe les documents.
Amazon Kendraprend en charge les bases de données suivantes :
+ Amazon Aurora MySQL
+ Amazon Aurora PostgreSQL
+ Amazon RDSpour MySQL
+ Amazon RDSpour PostgreSQL
**Note**
Les bases de données Aurora sans serveur ne sont pas prises en charge.
**Important**
La dépréciation de ce RDS/Aurora connecteur Amazon est prévue pour fin 2023.
Amazon Kendraprend désormais en charge les nouveaux connecteurs de source de données de base de données. Pour une meilleure expérience, nous vous recommandons de choisir l'un des nouveaux connecteurs suivants pour votre cas d'utilisation :
[Aurora(MySQL)](https://docs.aws.amazon.com/kendra/latest/dg/data-source-aurora-mysql.html)
[Aurora(PostgreSQL)](https://docs.aws.amazon.com/kendra/latest/dg/data-source-aurora-postgresql.html)
[Amazon RDS(MySQL)](https://docs.aws.amazon.com/kendra/latest/dg/data-source-rds-mysql.html)
[Amazon RDS(Microsoft SQL Server)](https://docs.aws.amazon.com/kendra/latest/dg/data-source-rds-ms-sql-server.html)
[Amazon RDS(Oracle)](https://docs.aws.amazon.com/kendra/latest/dg/data-source-rds-oracle.html)
[Amazon RDS(PostgreSQL)](https://docs.aws.amazon.com/kendra/latest/dg/data-source-rds-postgresql.html)
[IBM DB2](https://docs.aws.amazon.com/kendra/latest/dg/data-source-ibm-db2.html)
[Microsoft SQL Server](https://docs.aws.amazon.com/kendra/latest/dg/data-source-ms-sql-server.html)
[MySQL](https://docs.aws.amazon.com/kendra/latest/dg/data-source-mysql.html)
[Base de données Oracle](https://docs.aws.amazon.com/kendra/latest/dg/data-source-oracle-database.html)
[PostgreSQL](https://docs.aws.amazon.com/kendra/latest/dg/data-source-postgresql.html)
Vous pouvez vous connecter Amazon Kendra à la source de données de votre base de données à l'aide de la [Amazon Kendraconsole](https://console.aws.amazon.com/kendra/) et de l'[DatabaseConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_DatabaseConfiguration.html)API.
Pour résoudre les problèmes liés à votre connecteur de source de données de Amazon Kendra base de données, consultez[Dépannage des sources de données](troubleshooting-data-sources.md).
**Topics**
+ [Fonctionnalités prises en charge](#supported-features-database)
+ [Conditions préalables](#prerequisites-database)
+ [Instructions de connexion](#data-source-procedure-database)
## Fonctionnalités prises en charge
Amazon Kendrale connecteur de source de données de base de données prend en charge les fonctionnalités suivantes :
+ Mappages de champs
+ Filtrage du contexte utilisateur
+ Cloud privé virtuel (VPC)
## Conditions préalables
Avant de pouvoir Amazon Kendra indexer la source de données de votre base de données, apportez ces modifications à votre base de données et à vos AWS comptes.
**Dans votre base de données, assurez-vous d'avoir :**
+ Notez vos informations d'authentification de base, à savoir le nom d'utilisateur et le mot de passe de votre base de données.
+ Vous avez copié le nom d'hôte, le numéro de port, l'adresse de l'hôte, le nom de la base de données et le nom de la table de données contenant les données du document. Pour PostgreSQL, la table de données doit être une table publique ou un schéma public.
**Note**
L'hôte et le port indiquent Amazon Kendra où se trouve le serveur de base de données sur Internet. Le nom de la base de données et le nom de la table indiquent Amazon Kendra où se trouvent les données du document sur le serveur de base de données.
+ Les noms des colonnes de la table de données contenant les données du document ont été copiés. Vous devez inclure l'ID du document, le corps du document, les colonnes pour détecter si un document a changé (par exemple, dernière colonne mise à jour) et les colonnes facultatives de la table de données qui correspondent à des champs d'index personnalisés. Vous pouvez également associer n'importe quel [nom de champ Amazon Kendra réservé](https://docs.aws.amazon.com/kendra/latest/dg/hiw-document-attributes.html#index-reserved-fields) à une colonne de table.
+ Vous avez copié les informations relatives au type de moteur de base de données, par exemple si vous l'utilisez Amazon RDS pour MySQL ou un autre type.
+ Il est vérifié que chaque document est unique dans la base de données et dans les autres sources de données que vous prévoyez d'utiliser pour le même index. Chaque source de données que vous souhaitez utiliser pour un index ne doit pas contenir le même document dans toutes les sources de données. IDs Les documents sont globaux par rapport à un index et doivent être uniques par index.
**Dans votreCompte AWS, assurez-vous d'avoir :**
+ [Création d'un Amazon Kendra index](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) et, si vous utilisez l'API, notez l'ID de l'index.
+ Vous avez [créé un IAM rôle](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) pour votre source de données et, si vous utilisez l'API, notez l'ARN du IAM rôle.
**Note**
Si vous modifiez votre type d'authentification et vos informations d'identification, vous devez mettre à jour votre IAM rôle pour accéder au bon identifiant AWS Secrets Manager secret.
+ Stockez les informations d'authentification de votre base de données dans un AWS Secrets Manager secret et, si vous utilisez l'API, notez l'ARN du secret.
**Note**
Nous vous recommandons d’actualiser ou de modifier régulièrement vos informations d’identification et votre secret. Pour votre propre sécurité, fournissez uniquement le niveau d’accès nécessaire. Nous vous **déconseillons** de réutiliser les informations d'identification et les secrets entre les sources de données et les versions 1.0 et 2.0 du connecteur (le cas échéant).
Si vous n'avez pas de IAM rôle ou de secret existant, vous pouvez utiliser la console pour créer un nouveau IAM rôle et un nouveau Secrets Manager secret lorsque vous connectez votre source de données de base de données àAmazon Kendra. Si vous utilisez l'API, vous devez fournir l'ARN d'un IAM rôle et d'un Secrets Manager secret existants, ainsi qu'un identifiant d'index.
## Instructions de connexion
Pour vous connecter Amazon Kendra à votre source de données de base de données, vous devez fournir les informations nécessaires sur votre source de données de base de données afin de Amazon Kendra pouvoir accéder à vos données. Si vous n'avez pas encore configuré la base de données pourAmazon Kendra, consultez[Conditions préalables](#prerequisites-database).
------
#### [ Console ]
**Pour se connecter Amazon Kendra à une base de données**
1. Connectez-vous à la [Amazon Kendraconsole AWS Management Console et ouvrez-la](https://console.aws.amazon.com/kendra/).
1. Dans le volet de navigation de gauche, choisissez **Index**, puis choisissez l'index que vous souhaitez utiliser dans la liste des index.
**Note**
Vous pouvez choisir de configurer ou de modifier vos paramètres de **contrôle d'accès utilisateur** dans les paramètres de **l'index**.
1. Sur la page de **démarrage**, choisissez **Ajouter une source de données**.
1. Sur la page **Ajouter une source de données**, choisissez le **connecteur de base** de données, puis sélectionnez **Ajouter un connecteur**. Si vous utilisez la version 2 (le cas échéant), choisissez le **connecteur de base de données** avec la balise « V2.0 ».
1. Sur la page **Spécifier les détails de la source de données**, entrez les informations suivantes :
1. Dans **Nom et description**, pour Nom de la **source de données** : entrez le nom de votre source de données. Vous pouvez inclure des traits d'union, mais pas des espaces.
1. (Facultatif) **Description** : entrez une description facultative pour votre source de données.
1. Dans la **langue par défaut** : choisissez une langue pour filtrer vos documents pour l'index. Sauf indication contraire, la langue par défaut est l'anglais. La langue spécifiée dans les métadonnées du document remplace la langue sélectionnée.
1. Dans **Balises**, pour **Ajouter une nouvelle balise** : incluez des balises facultatives pour rechercher et filtrer vos ressources ou suivre vos AWS coûts.
1. Choisissez **Suivant**.
1. Sur la page **Définir l'accès et la sécurité**, entrez les informations suivantes :
1. **Point de terminaison** : nom d'hôte DNS, IPv4 adresse ou IPv6 adresse.
1. **Port** : numéro de port.
1. **Base de données** : nom de la base de données.
1. **Nom de la table —Nom** de la table.
1. Pour **Type d'authentification**, choisissez entre **Existant** et **Nouveau** pour stocker les informations d'authentification de votre base de données. Si vous choisissez de créer un nouveau secret, une fenêtre AWS Secrets Manager secrète s'ouvre.
1. Entrez les informations suivantes dans la **fenêtre Créer un AWS Secrets Manager secret** :
1. **Nom du secret** : nom de votre secret. Le préfixe « AmazonKendra -database-» est automatiquement ajouté à votre nom secret.
1. Pour le **nom d'utilisateur** et le **mot de passe** : entrez les valeurs d'authentification de votre compte de base de données.
1. Choisissez **Enregistrer l'authentification**.
1. **Virtual Private Cloud (VPC)** —Vous pouvez choisir d'utiliser un VPC. Dans ce cas, vous devez ajouter des **sous-réseaux et des** groupes de **sécurité VPC.**
**Note**
Vous devez utiliser un sous-réseau privé. Si votre instance RDS se trouve dans un sous-réseau public de votre VPC, vous pouvez créer un sous-réseau privé doté d'un accès sortant à une passerelle NAT dans le sous-réseau public. Les sous-réseaux fournis dans la configuration VPC doivent se trouver dans l'ouest des États-Unis (Oregon), dans l'est des États-Unis (Virginie du Nord) ou dans l'UE (Irlande).
1. **IAMrôle** —Choisissez un IAM rôle existant ou créez-en un nouveau IAM pour accéder aux informations d'identification de votre référentiel et indexer le contenu.
**Note**
IAMles rôles utilisés pour les index ne peuvent pas être utilisés pour les sources de données. Si vous ne savez pas si un rôle existant est utilisé pour un index ou une FAQ, choisissez **Créer un nouveau rôle** pour éviter les erreurs.
1. Choisissez **Suivant**.
1. Sur la page **Configurer les paramètres de synchronisation**, entrez les informations suivantes :
1. Choisissez entre **Aurora MySQL**, **MySQL**, **Aurora PostgreSQL** et **PostgreSQL en fonction de votre cas d'utilisation**.
1. **Placer les identificateurs SQL entre guillemets** : sélectionnez cette option pour placer les identificateurs SQL entre guillemets doubles. Par exemple, « ColumnName ».
1. **Colonne ACL** et **colonnes de détection des modifications** : configurez les colonnes Amazon Kendra utilisées pour la détection des modifications (par exemple, dernière colonne mise à jour) et votre liste de contrôle d'accès.
1. Dans **Synchroniser le calendrier d'exécution**, pour **Fréquence** : choisissez la fréquence de synchronisation avec votre source de données. Amazon Kendra
1. Choisissez **Suivant**.
1. Sur la page **Définir les mappages de champs**, entrez les informations suivantes :
1. **Amazon Kendramappages de champs par défaut** : sélectionnez parmi les champs de source de données par défaut Amazon Kendra générés que vous souhaitez mapper à votre index. Vous devez ajouter les valeurs des **colonnes de base** de données pour `document_id` et `document_body`
1. **Mappages de champs personnalisés** : pour ajouter des champs de source de données personnalisés afin de créer un nom de champ d'index à mapper et le type de données du champ.
1. Choisissez **Suivant**.
1. Sur la page **Réviser et créer**, vérifiez que les informations saisies sont correctes, puis sélectionnez **Ajouter une source de données**. Vous pouvez également choisir de modifier vos informations depuis cette page. Votre source de données apparaîtra sur la page **Sources de données** une fois que la source de données aura été ajoutée avec succès.
------
#### [ API ]
**Pour se connecter Amazon Kendra à une base de données**
Vous devez spécifier l'[DatabaseConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_DatabaseConfiguration.html)API suivante :
+ **ColumnConfiguration**—Informations sur l'endroit où l'index doit obtenir les informations du document à partir de la base de données. Pour en savoir plus, consultez [ColumnConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_ColumnConfiguration.html). Vous devez spécifier les champs `DocumentDataColumnName` (corps du document ou texte principal) et `DocumentIdColumnName` `ChangeDetectingColumn` (par exemple, dernière colonne mise à jour). La colonne mappée au `DocumentIdColumnName` champ doit être une colonne entière. L'exemple suivant montre une configuration de colonne simple pour une source de données de base de données :
```
"ColumnConfiguration": {
"ChangeDetectingColumns": [
"LastUpdateDate",
"LastUpdateTime"
],
"DocumentDataColumnName": "TextColumn",
"DocumentIdColumnName": "IdentifierColumn",
"DocoumentTitleColumnName": "TitleColumn",
"FieldMappings": [
{
"DataSourceFieldName": "AbstractColumn",
"IndexFieldName": "Abstract"
}
]
}
```
+ **ConnectionConfiguration**: informations de configuration requises pour se connecter à une base de données. Pour en savoir plus, consultez [ConnectionConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_ConnectionConfiguration.html).
+ **DatabaseEngineType**: type de moteur de base de données qui exécute la base de données. Le `DatabaseHost` champ pour `ConnectionConfiguration` doit être le point de terminaison de l'instance Amazon Relational Database Service (Amazon RDS) de la base de données. N'utilisez pas le point de terminaison du cluster.
+ **Nom de ressource Amazon (ARN) secret** : indiquez le nom de ressource Amazon (ARN) d'un Secrets Manager secret contenant les informations d'authentification de votre compte de base de données. Le secret est stocké dans une structure JSON avec les clés suivantes :
```
{
"username": "user name",
"password": "password"
}
```
L'exemple suivant montre une configuration de base de données, y compris l'ARN secret.
```
"DatabaseConfiguration": {
"ConnectionConfiguration": {
"DatabaseHost": "host.subdomain.domain.tld",
"DatabaseName": "DocumentDatabase",
"DatabasePort": 3306,
"SecretArn": "arn:aws:secretmanager:region:account ID:secret/secret name",
"TableName": "DocumentTable"
}
}
```
**Note**
Nous vous recommandons d’actualiser ou de modifier régulièrement vos informations d’identification et votre secret. Pour votre propre sécurité, fournissez uniquement le niveau d’accès nécessaire. Nous vous **déconseillons** de réutiliser les informations d'identification et les secrets entre les sources de données et les versions 1.0 et 2.0 du connecteur (le cas échéant).
+ **IAMrole** —Spécifiez à `RoleArn` quel moment vous appelez `CreateDataSource` pour fournir à un IAM rôle les autorisations d'accéder à votre Secrets Manager secret et pour appeler le public requis APIs pour le connecteur de base de données etAmazon Kendra. Pour plus d'informations, consultez la section [IAMRôles des sources de données de base](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) de données.
Vous pouvez également ajouter les fonctionnalités optionnelles suivantes :
+ **Virtual Private Cloud (VPC)** —Spécifiez dans le `VpcConfiguration` cadre de la configuration de la source de données. Consultez [la section Configuration Amazon Kendra pour utiliser un VPC](https://docs.aws.amazon.com/kendra/latest/dg/vpc-configuration.html).
**Note**
Vous ne devez utiliser qu'un sous-réseau privé. Si votre instance RDS se trouve dans un sous-réseau public de votre VPC, vous pouvez créer un sous-réseau privé doté d'un accès sortant à une passerelle NAT dans le sous-réseau public. Les sous-réseaux fournis dans la configuration VPC doivent se trouver dans l'ouest des États-Unis (Oregon), dans l'est des États-Unis (Virginie du Nord) ou dans l'UE (Irlande).
+ **Mappages de champs : choisissez de mapper** les champs de votre source de données de base de données à vos champs d'Amazon Kendraindex. Pour plus d’informations, consultez [Mappage des champs de source de données](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html).
**Note**
Le champ du corps du document ou l'équivalent du corps du document pour vos documents est requis pour Amazon Kendra effectuer une recherche dans vos documents. Vous devez associer le nom du champ du corps du document dans votre source de données au nom du champ d'index`_document_body`. Tous les autres champs sont facultatifs.
+ **Filtrage du contexte utilisateur et contrôle d'accès** Amazon Kendra : analyse la liste de contrôle d'accès (ACL) de vos documents, si vous disposez d'une ACL pour vos documents. Les informations ACL sont utilisées pour filtrer les résultats de recherche en fonction de l'accès de l'utilisateur ou de son groupe aux documents. Pour plus d'informations, consultez la section [Filtrage du contexte utilisateur](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#datasource-context-filter).
------