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.
# Configuration d'une CDB RDS for Oracle
La configuration d'une CDB est similaire à la configuration d'une base de données non-CDB.
**Topics**
+ [Création d'une instance de CDB RDS for Oracle](#Oracle.Concepts.single-tenant.creation)
+ [Connexion à une PDB dans votre CDB RDS for Oracle](#Oracle.Concepts.connecting.pdb)
## Création d'une instance de CDB RDS for Oracle
Dans RDS for Oracle, la création d’une instance CDB est quasiment identique à la création d’une instance non-CDB. La différence réside dans le fait que vous devez choisir l'architecture multilocataire Oracle lors de la création de votre instance de base de données et devez également choisir une configuration d'architecture : multilocataire ou à locataire unique. Si vous créez des balises lorsque vous créez une CDB dans la configuration multilocataire, RDS les propage vers la base de données locataire initiale. Pour créer un CDB, utilisez l'API AWS Management Console AWS CLI, la ou l'API RDS.
### Console
**Pour créer une instance de CDB**
1. Connectez-vous à la console Amazon RDS AWS Management Console et ouvrez-la à [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)l'adresse.
1. Dans le coin supérieur droit de la console Amazon RDS, choisissez l'instance Région AWS dans laquelle vous souhaitez créer l'instance CDB.
1. Dans le panneau de navigation, choisissez **Databases** (Bases de données).
1. Choisissez **Create database (Créer une base de données)**.
1. Dans **Choose a database creation method (Choisir une méthode de création de base de données)**, sélectionnez **Standard Create (Création standard)**.
1. Sous **Engine options (Options de moteur)**, choisissez **Oracle**.
1. Pour **Type de gestion de base de données**, choisissez **Amazon RDS**.
1. Pour **Paramètres d'architecture**, choisissez **Architecture à locataires multiples Oracle**.
1. Pour **Configuration de l'architecture**, effectuez l'une des opérations suivantes :
+ Choisissez **Configuration à locataires multiples** et passez à l'étape suivante.
+ Choisissez **Configuration à locataire unique** et passez à l'étape 11.
1. (Configuration à locataires multiples) Pour **Paramètres de base de données locataire**, apportez les modifications suivantes :
+ Pour **Nom de la base de données locataire**, entrez le nom de votre PDB initiale. Le nom de la PDB doit être différent du nom de CDB, qui est par défaut `RDSCDB`.
+ Pour **Nom d'utilisateur principal de la base de données locataire**, entrez le nom d'utilisateur principal de votre PDB. Vous ne pouvez pas utiliser le nom d'utilisateur principal de la base de données locataire pour vous connecter à la CDB elle-même.
+ Pour la **Gestion des informations d’identification**, choisissez l’une des options suivantes :
+ **Géré dans AWS Secrets Manager**
Le mot de passe géré est destiné à la base de données locataire initiale plutôt qu’à l’instance. Dans **Sélectionner la clé de chiffrement**, choisissez soit une clé KMS créée par Secrets Manager, soit une clé que vous avez créée.
**Note**
C'est la technique la plus sûre AWS Secrets Manager que nous recommandons pour gérer les informations d'identification. Des frais supplémentaires s’appliquent. Pour de plus amples informations, veuillez consulter [Gestion des mots de passe avec Amazon RDS, et AWS Secrets Manager](rds-secrets-manager.md).
+ **Autogéré**
Pour spécifier un mot de passe, désactivez la case à cocher **Générer automatiquement un mot de passe**, le cas échéant. Saisissez le même mot de passe dans **Mot de passe principal** et **Confirmer le mot de passe principal**.
+ Pour **Jeu de caractères de base de données locataire**, choisissez un jeu de caractères pour la PDB. Vous pouvez choisir un jeu de caractères de base de données locataire différent du jeu de caractères de CDB.
Le jeu de caractères PDB par défaut est **AL32UTF8**. Si vous choisissez un jeu de caractères PDB autre que celui par défaut, la création de CDB peut être plus lente.
**Note**
Vous ne pouvez pas spécifier plusieurs bases de données locataires au cours de l’opération de création. La CDB possède un PDB lorsqu’elle est créée. Vous pouvez l'ajouter PDBs à un CDB existant dans le cadre d'une opération séparée.
1. (Configuration à locataire unique) Choisissez les paramètres souhaités en fonction des options répertoriées dans [Paramètres des instances de base de données](USER_CreateDBInstance.Settings.md) :
1. Dans la section **Settings (Paramètres)**, ouvrez **Credential Settings (Paramètres des informations d’identification)**. Ensuite, procédez comme suit :
1. Pour **Identifiant principal**, entrez le nom d'un utilisateur local dans votre PDB. Vous ne pouvez pas utiliser l'identifiant principal pour vous connecter à la racine de la CDB.
1. Pour la **Gestion des informations d’identification**, choisissez l’une des options suivantes :
+ **Géré dans AWS Secrets Manager**
Dans **Sélectionner la clé de chiffrement**, choisissez soit une clé KMS créée par Secrets Manager, soit une clé que vous avez créée.
**Note**
C'est la technique la plus sûre AWS Secrets Manager que nous recommandons pour gérer les informations d'identification. Des frais supplémentaires s’appliquent. Pour de plus amples informations, veuillez consulter [Gestion des mots de passe avec Amazon RDS, et AWS Secrets Manager](rds-secrets-manager.md).
+ **Autogéré**
Pour spécifier un mot de passe, désactivez la case à cocher **Générer automatiquement un mot de passe**, le cas échéant. Saisissez le même mot de passe dans **Mot de passe principal** et **Confirmer le mot de passe principal**.
1. Pour les sections restantes, spécifiez vos paramètres d’instance de base de données. Pour plus d’informations sur chaque paramètre, consultez [Paramètres pour les instances de base de données](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_CreateDBInstance.Settings.html).
1. Choisissez **Créer une base de données**.
### AWS CLI
Pour créer un CDB dans la configuration multi-locataires, utilisez la [create-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-instance.html)commande avec les paramètres suivants :
+ `--db-instance-identifier`
+ `--db-instance-class`
+ `--engine { oracle-ee-cdb | oracle-se2-cdb }`
+ `--master-username`
+ `--master-user-password` ou `--manage-master-user-password`
+ `--multi-tenant` (pour la configuration à locataire unique, ne spécifiez pas `multi-tenant` ou spécifiez `--no-multi-tenant`)
+ `--allocated-storage`
+ `--backup-retention-period`
Pour plus d’informations sur chaque paramètre, consultez [Paramètres des instances de base de données](USER_CreateDBInstance.Settings.md).
L'exemple suivant crée une instance de base de données RDS pour Oracle nommée *my-cdb-inst* dans la configuration multi-locataires. Si vous spécifiez `--no-multi-tenant` ou que vous ne spécifiez pas `--multi-tenant`, la configuration de CDB par défaut est à locataire unique. Le moteur est `oracle-ee-cdb` : une commande qui spécifie `oracle-ee` et `--multi-tenant` échoue avec une erreur. La base de données des locataires initiale est nommée*mypdb*.
**Example**
Pour Linux, macOS ou Unix :
```
1. aws rds create-db-instance \
2. --engine oracle-ee-cdb \
3. --db-instance-identifier my-cdb-inst \
4. --multi-tenant \
5. --db-name mypdb \
6. --allocated-storage 250 \
7. --db-instance-class db.t3.large \
8. --master-username pdb_admin \
9. --manage-master-user-password \
10. --backup-retention-period 3
```
Pour Windows :
```
1. aws rds create-db-instance ^
2. --engine oracle-ee-cdb ^
3. --db-instance-identifier my-cdb-inst ^
4. --multi-tenant ^
5. --db-name mypdb ^
6. --allocated-storage 250 ^
7. --db-instance-class db.t3.large ^
8. --master-username pdb_admin ^
9. --manage-master-user-password \ ^
10. --backup-retention-period 3
```
Spécifiez un mot de passe autre que celui indiqué ici, en tant que bonne pratique de sécurité.
Le résultat produit lors de l’exécution de cette commande est semblable à ce qui suit : Le nom de la base de données, le jeu de caractères, le jeu de caractères national, l’utilisateur principal et le secret de l’utilisateur principal ne sont pas inclus dans la sortie. Vous pouvez afficher ces informations à l'aide de la commande CLI `describe-tenant-databases`.
```
1. {
2. "DBInstance": {
3. "DBInstanceIdentifier": "my-cdb-inst",
4. "DBInstanceClass": "db.t3.large",
5. "MultiTenant": true,
6. "Engine": "oracle-ee-cdb",
7. "DBResourceId": "db-ABCDEFGJIJKLMNOPQRSTUVWXYZ",
8. "DBInstanceStatus": "creating",
9. "AllocatedStorage": 250,
10. "PreferredBackupWindow": "04:59-05:29",
11. "BackupRetentionPeriod": 3,
12. "DBSecurityGroups": [],
13. "VpcSecurityGroups": [
14. {
15. "VpcSecurityGroupId": "sg-0a1bcd2e",
16. "Status": "active"
17. }
18. ],
19. "DBParameterGroups": [
20. {
21. "DBParameterGroupName": "default.oracle-ee-cdb-19",
22. "ParameterApplyStatus": "in-sync"
23. }
24. ],
25. "DBSubnetGroup": {
26. "DBSubnetGroupName": "default",
27. "DBSubnetGroupDescription": "default",
28. "VpcId": "vpc-1234567a",
29. "SubnetGroupStatus": "Complete",
30. ...
```
### API RDS
Pour créer une instance de base de données à l'aide de l'API Amazon RDS, appelez l'DBInstanceopération [Create](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBInstance.html).
Pour plus d’informations sur chaque paramètre, consultez [Paramètres des instances de base de données](USER_CreateDBInstance.Settings.md).
## Connexion à une PDB dans votre CDB RDS for Oracle
Vous pouvez utiliser un utilitaire tel que SQL\$1Plus pour vous connecter à une PDB. Pour télécharger Oracle Instant Client, qui inclut une version autonome de SQL\$1Plus, consultez la page [ des téléchargements d'Oracle Instant Client](https://www.oracle.com/database/technologies/instant-client/downloads.html).
Pour connecter SQL\$1Plus à votre PDB, vous avez besoin des informations suivantes :
+ Nom de la PDB
+ Nom d’utilisateur et mot de passe de la base de données
+ Point de terminaison pour votre instance de base de données
+ Numéro de port
Pour obtenir des informations sur la recherche des informations précédentes, consultez [Recherche du point de terminaison de votre instance de base de données RDS for Oracle](USER_Endpoint.md).
**Example Pour vous connecter à votre PDB à l'aide de SQL\$1Plus**
Dans les exemples suivants, remplacez votre utilisateur principal par*master\$1user\$1name*. Remplacez également le point de terminaison par votre instance de base de données, puis incluez le numéro de port et le SID Oracle. La valeur SID est le nom de la PDB que vous avez spécifié lors de la création de votre instance de base de données, et non pas l'identifiant de l'instance de base de données.
Pour Linux, macOS ou Unix :
```
1. sqlplus 'master_user_name@(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=endpoint)(PORT=port))(CONNECT_DATA=(SID=pdb_name)))'
```
Pour Windows :
```
1. sqlplus master_user_name@(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=endpoint)(PORT=port))(CONNECT_DATA=(SID=pdb_name)))
```
Vous devez visualiser des résultats similaires à ce qui suit.
```
SQL*Plus: Release 19.0.0.0.0 Production on Mon Aug 21 09:42:20 2021
```
Une fois que vous avez saisi le mot de passe de l'utilisateur, l'invite SQL apparaît.
```
SQL>
```
**Note**
La chaîne de connexion de format court (Easy connect ou EZCONNECT), comme `sqlplus username/password@LONGER-THAN-63-CHARS-RDS-ENDPOINT-HERE:1521/database-identifier`, peut comporter une limite de caractères maximale et ne doit pas être utilisée pour se connecter.