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.
# Utilisation des CDB dans RDS for Oracle
Dans l'architecture multilocataire d'Oracle, une base de données de conteneurs (CDB) peut inclure des bases de données enfichables (PDB) créées par le client. Pour plus d'informations sur les CDB, consultez [Introduction à l'architecture multilocataire](https://docs.oracle.com/en/database/oracle/oracle-database/19/multi/introduction-to-the-multitenant-architecture.html#GUID-267F7D12-D33F-4AC9-AA45-E9CD671B6F22) (langue française non garantie) dans la documentation Oracle Database.
**Topics**
+ [Présentation de RDS pour Oracle CDBs](Oracle.Concepts.CDBs.md)
+ [Configuration d'une CDB RDS for Oracle](oracle-cdb.configuring.md)
+ [Sauvegarde et restauration d'une CDB](Oracle.Concepts.single-tenant.snapshots.md)
+ [Conversion d'une base de données non-CDB RDS for Oracle en CDB](oracle-cdb-converting.md)
+ [Conversion de la configuration à locataire unique en configuration à locataires multiples](oracle-single-tenant-converting.md)
+ [Ajout d'une base de données locataire RDS for Oracle à votre instance de CDB](oracle-cdb-configuring.adding.pdb.md)
+ [Modification d'une base de données locataire RDS for Oracle](oracle-cdb-configuring.modifying.pdb.md)
+ [Suppression d'une base de données locataire RDS for Oracle de votre CDB](oracle-cdb-configuring.deleting.pdb.md)
+ [Affichage des détails de la base de données locataire](oracle-cdb-configuring.describing.pdb.md)
+ [Mise à niveau de votre CDB](Oracle.Concepts.single-tenant.upgrades.md)
# Présentation de RDS pour Oracle CDBs
Vous pouvez créer une instance de base de données RDS for Oracle en tant que base de données de conteneurs (CDB) lorsque vous exécutez Oracle Database 19c ou version ultérieure. À partir d'Oracle Database 21c, toutes les bases de données le sont CDBs. Une CDB se distingue d'une non-CDB car elle peut contenir des bases de données enfichables (PDBs), appelées bases de données mutualisées dans RDS pour Oracle. Une PDB est une collection portable de schémas et d'objets qui apparaît à une application en tant que base de données distincte.
Vous créez votre base de données locataire initiale (PDB) lorsque vous créez votre instance de CDB. Dans RDS for Oracle, votre application cliente interagit avec la PDB plutôt qu’avec la CDB. Votre expérience avec une PDB est essentiellement identique à votre expérience avec une base de données non-CDB.
**Topics**
+ [Configuration à locataires multiples de l'architecture CDB](#multi-tenant-configuration)
+ [Configuration à locataire unique de l'architecture CDB](#Oracle.Concepts.single-tenant)
+ [Options de création et de conversion pour CDBs](#oracle-cdb-creation-conversion)
+ [Comptes d'utilisateur et privilèges dans une CDB](#Oracle.Concepts.single-tenant.users)
+ [Familles de groupes de paramètres dans une CDB](#Oracle.Concepts.single-tenant.parameters)
+ [Limites de RDS pour Oracle CDBs](#Oracle.Concepts.single-tenant-limitations)
## Configuration à locataires multiples de l'architecture CDB
RDS for Oracle prend en charge la configuration à locataires multiples de l’architecture multilocataire Oracle, également appelée *architecture CDB*. Avec cette configuration, votre instance de CDB RDS for Oracle peut contenir 1 à 30 bases de données client, selon l’édition de base de données et les licences d’option requises. Dans une base de données Oracle, une base de données locataire est une PDB. Votre instance de base de données doit utiliser la version 19.0.0.0.ru-2022-01.rur-2022.r1 ou versions ultérieures de la base de données Oracle.
**Note**
La fonctionnalité Amazon RDS est appelée « à locataires multiples » plutôt que « multilocataire », car il s’agit d’une fonctionnalité Amazon RDS, et pas seulement du moteur de base de données Oracle. De même, le terme « locataire » du RDS fait référence à tout locataire d'une configuration RDS, et pas seulement à Oracle. PDBs Dans la documentation RDS, le terme sans trait d’union « multilocataire Oracle » fait exclusivement référence à l’architecture CDB de base de données Oracle, qui est compatible à la fois avec les déploiements sur site et RDS.
Vous pouvez à présent configurer les paramètres suivants :
+ Nom de la base de données locataire
+ Nom d'utilisateur principal de la base de données locataire
+ Mot de passe principal de la base de données locataire (éventuellement intégré à Secrets Manager)
+ Jeu de caractères de base de données locataire
+ Jeu de caractères national de base de données locataire
Le jeu de caractères de base de données locataire peut être différent du jeu de caractères de CDB. Il en va de même pour le jeu de caractères national. Après avoir créé votre base de données de locataires initiale, vous pouvez créer, modifier ou supprimer des bases de données de locataires à l'aide de RDS. APIs Le nom de la CDB est défini par défaut sur `RDSCDB` et ne peut pas être modifié. Pour plus d’informations, consultez [Paramètres des instances de base de données](USER_CreateDBInstance.Settings.md) et [Modification d'une base de données locataire RDS for Oracle](oracle-cdb-configuring.modifying.pdb.md).
## Configuration à locataire unique de l'architecture CDB
RDS for Oracle prend en charge la configuration existante de l'architecture multilocataire Oracle appelée configuration à locataire unique. Dans cette configuration, une instance de CDB RDS for Oracle CDB ne peut contenir qu’un seul locataire (PDB). Vous ne pourrez pas en créer d'autres PDBs ultérieurement.
## Options de création et de conversion pour CDBs
Oracle Database 21c prend uniquement en charge CDBs, tandis qu'Oracle Database 19c prend en charge les deux CDBs et non. CDBs Toutes les instances de CDB RDS for Oracle prennent en charge à la fois les configurations à locataires multiples et à locataire unique.
### Options de création, de conversion et de mise à niveau pour l'architecture de base de données Oracle
Le tableau suivant présente les différentes options d'architecture pour la création et la mise à niveau des bases de données RDS for Oracle.
| Version | Options de création de base de données | Options de conversion d'architecture | Cibles de mise à niveau de version majeure |
| --- | --- | --- | --- |
| Oracle Database 21c | Architecture CDB uniquement | N/A | N/A |
| Oracle Database 19c | Architecture CDB ou non CDB | Architecture non CDB vers CDB (RU d'avril 2021 ou supérieure) | CDB Oracle Database 21c |
Comme indiqué dans le tableau précédent, vous ne pouvez pas directement effectuer la mise à niveau d'une base de données non CDB vers une base de données CDB dans une nouvelle version majeure de base de données. En revanche, vous pouvez convertir une base de données non-CDB Oracle Database 19c en CDB Oracle Database 19c, puis mettre à niveau la CDB Oracle Database 19c en une CDB Oracle Database 21c. Pour plus d’informations, consultez [Conversion d'une base de données non-CDB RDS for Oracle en CDB](oracle-cdb-converting.md).
### Options de conversion pour les configurations d'architecture CDB
Le tableau suivant présente les différentes options de conversion de la configuration d'architecture d'une instance de base de données RDS for Oracle.
| Architecture et configuration actuelles | Conversion vers la configuration à locataire unique de l'architecture CDB | Conversion vers la configuration à locataires multiples de l'architecture CDB | Conversion vers l'architecture non CDB |
| --- | --- | --- | --- |
| Non CDB | Pris en charge | Pris en charge\$1 | N/A |
| CDB utilisant la configuration à locataire unique | N/A | Pris en charge | Non pris en charge |
| CDB utilisant la configuration à locataires multiples | Non pris en charge | N/A | Non pris en charge |
\$1 Vous ne pouvez pas convertir une base de données non CDB en configuration à locataires multiples au cours d'une seule opération. Lorsque vous convertissez une base de données non CDB en CDB, la CDB est dans la configuration à locataire unique. Vous pouvez ensuite convertir la configuration à locataire unique en configuration à locataires multiples dans le cadre d'une opération distincte.
## Comptes d'utilisateur et privilèges dans une CDB
Dans l'architecture multilocataire d'Oracle, tous les comptes d'utilisateur sont des utilisateurs courants ou des utilisateurs locaux. Un utilisateur courant de base de données de conteneur (CDB) est un utilisateur de base de données dont l'identité unique et le mot de passe sont connus à la racine de la CDB et dans chaque base de données enfichable (PDB) existante et future. En revanche, un utilisateur local n'existe que dans une seule PDB.
L'utilisateur principal RDS est un compte d'utilisateur local dans la PDB, que vous nommez lorsque vous créez votre instance de base de données. Si vous créez de nouveaux comptes d'utilisateur, ces utilisateurs seront également des utilisateurs locaux résidant dans la PDB. Vous ne pouvez utiliser aucun compte utilisateur pour créer un nouveau PDB PDBs ou modifier l'état de celui-ci.
L'utilisateur `rdsadmin` est un compte d'utilisateur courant. Vous pouvez exécuter des packages RDS for Oracle qui existent dans ce compte, mais vous ne pouvez pas vous connecter en tant que `rdsadmin`. Pour plus d'informations, reportez-vous à la section [À propos des utilisateurs courants et des utilisateurs locaux](https://docs.oracle.com/en/database/oracle/oracle-database/19/dbseg/managing-security-for-oracle-database-users.html#GUID-BBBD9904-F2F3-442B-9AFC-8ACDD9A588D8) dans la documentation Oracle.
Pour les utilisateurs principaux dans les configurations à locataires multiples et à locataire unique, vous pouvez utiliser des informations d'identification autogérées ou gérées par. AWS Secrets Manager Dans la configuration à locataire unique, vous utilisez des commandes CLI au niveau de l’instance, par exemple `create-db-instance` pour les mots de passe principaux gérés. Dans la configuration à locataires multiples, vous utilisez des commandes de base de données locataire, par exemple `create-tenant-database` pour les mots de passe principaux gérés. Pour plus d’informations sur l’intégration de Secrets Manager, consultez [Gestion du mot de passe d’utilisateur principal pour une base de données locataire RDS for Oracle avec Secrets Manager](rds-secrets-manager.md#rds-secrets-manager-tenant).
## Familles de groupes de paramètres dans une CDB
CDBs ont leurs propres familles de groupes de paramètres et leurs propres valeurs de paramètres par défaut. Les familles de groupes de paramètres de CDB sont les suivantes :
+ oracle-ee-cdb-21
+ oracle-se2-cdb-21
+ oracle-ee-cdb-19
+ oracle-se2-cdb-19
## Limites de RDS pour Oracle CDBs
RDS for Oracle prend en charge un sous-ensemble de fonctionnalités disponibles dans une CDB sur site.
### Limitations de CDB
Les limitations suivantes s’appliquent à RDS for Oracle au niveau de la CDB :
+ Vous ne pouvez pas vous connecter à une CDB. Vous vous connectez toujours à la base de données locataire (PDB) plutôt qu'à la CDB. Spécifiez le point de terminaison pour la base de données enfichable (PDB), tout comme pour une base de données non-CDB. La seule différence est que vous spécifiez * pdb\$1name* pour le nom de base de données, où *pdb\$1name* est le nom que vous avez choisi pour votre base de données enfichable (PDB).
+ Vous ne pouvez pas convertir une CDB dans la configuration à locataires multiples en une CDB dans la configuration à locataire unique. La conversion vers la configuration à locataires multiples est unidirectionnelle et irréversible.
+ Vous ne pouvez pas activer la configuration à locataires multiples ni effectuer une conversion vers ce type de configuration si votre instance de base de données utilise une version de la base de données Oracle antérieure à 19.0.0.0.ru-2022-01.rur-2022.r1.
+ Vous ne pouvez pas utiliser les flux d’activité de base de données dans une CDB.
+ Vous ne pouvez pas activer l’audit depuis `CDB$ROOT`. Vous devez activer l’audit au sein de chaque PDB individuellement.
### Limitations de la base de données locataire (PDB)
Les limitations suivantes s'appliquent aux bases de données locataire dans la configuration à locataires multiples RDS for Oracle :
+ Vous ne pouvez pas reporter les opérations de la base de données locataire vers la fenêtre de maintenance. Toutes les modifications sont effectuées immédiatement.
+ Vous ne pouvez pas ajouter une base de données locataire à une CDB qui utilise la configuration à locataire unique.
+ Vous ne pouvez pas ajouter ou modifier plusieurs bases de données locataire au cours d'une seule opération. Vous ne pouvez les ajouter ou les modifier qu'une par une.
+ Vous ne pouvez pas modifier une base de données locataire pour qu'elle soit nommée `CDB$ROOT` ou `PDB$SEED`.
+ Vous ne pouvez pas supprimer une base de données locataire si elle est le seul locataire de la CDB.
+ Tous les types de classes d'instance de base de données ne disposent pas de ressources suffisantes pour prendre PDBs en charge plusieurs dans une instance RDS pour Oracle CDB. L'augmentation du nombre de PDB affecte les performances et la stabilité des classes d'instances plus petites et augmente la durée de la plupart des opérations au niveau de l'instance, par exemple les mises à niveau de base de données.
+ Vous ne pouvez pas renommer un PDB en utilisant`rdsadmin.rdsadmin_util.rename_global_name`, vous devez plutôt utiliser l'`modify-tenant-database`API.
+ Vous ne pouvez pas utiliser plusieurs Comptes AWS pour créer PDBs dans le même CDB. PDBsdoivent appartenir au même compte que l'instance de base de données sur laquelle PDBs ils sont hébergés.
+ Tous les PDBs composants d'un CDB utilisent le même point de terminaison et le même écouteur de base de données.
+ Les opérations suivantes ne sont pas prises en charge au niveau de la PDB mais le sont au niveau de la CDB :
+ Sauvegarde et restauration
+ Mises à niveau de base de données
+ Opérations de maintenance
+ Les fonctionnalités suivantes ne sont pas prises en charge au niveau de la PDB mais le sont au niveau de la CDB :
+ Groupes d'options (les options sont installées PDBs sur toutes les instances de votre instance CDB)
+ Groupes de paramètres (tous les paramètres sont dérivés du groupe de paramètres associé à votre instance de CDB)
+ Les opérations au niveau de la PDB qui sont prises en charge dans l'architecture CDB sur site mais qui ne le sont pas dans une CDB RDS for Oracle sont les suivantes :
**Note**
La liste suivante n'est pas exhaustive.
+ Demande PDBs
+ Proxy PDBs
+ Démarrage et arrêt d'une PDB
+ Débranchement et branchement PDBs
Pour faire entrer des données dans votre CDB ou les en faire sortir, utilisez les mêmes techniques que pour une base de données non-CDB. Pour en savoir plus sur la migration de données, consultez [Importation de données dans Oracle sur Amazon RDS](Oracle.Procedural.Importing.md).
+ Configuration des options au niveau de la PDB
La PDB hérite des paramètres d'options du groupe d'options de la CDB. Pour plus d'informations sur la configuration des options, consultez [Groupes de paramètres pour Amazon RDS](USER_WorkingWithParamGroups.md). Pour connaître les bonnes pratiques, consultez [Utilisation des groupes de paramètres DB](CHAP_BestPractices.md#CHAP_BestPractices.DBParameterGroup).
+ Configuration des paramètres dans une PDB
La PDB hérite des paramètres de la CDB. Pour plus d'informations sur la configuration des options, consultez [Ajout d'options aux instances de base de données Oracle](Appendix.Oracle.Options.md).
+ Configuration de différents auditeurs PDBs dans le même CDB
+ Fonctionnalités Oracle Flashback
# 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.
# Sauvegarde et restauration d'une CDB
Vous pouvez sauvegarder et restaurer votre CDB à l'aide d'instantanés de base de données RDS ou de Recovery Manager (RMAN).
## Sauvegarde et restauration d'une CDB à l'aide d'instantanés de base de données
Les instantanés de base de données fonctionnent de la même manière dans les architectures CDB et non CDB. Les principales différences sont les suivantes :
+ Lorsque vous restaurez un instantané de base de données d'une CDB, vous ne pouvez pas renommer la CDB. Le nom de la CDB est `RDSCDB` et ne peut pas être modifié.
+ Lorsque vous restaurez un instantané de base de données d'un CDB, vous ne pouvez pas le renommer PDBs. Vous pouvez modifier le nom du PDB à l'aide de la [modify-tenant-database](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyTenantDatabase.html)commande.
+ Pour rechercher des bases de données mutualisées dans un instantané, utilisez la commande CLI [describe-db-snapshot-tenant-databases](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeDBSnapshotTenantDatabases.html).
+ Vous ne pouvez pas interagir directement avec les bases de données locataire dans un instantané de CDB qui utilise la configuration de l'architecture à locataires multiples. Si vous restaurez l'instantané de base de données, vous restaurez toutes ses bases de données locataire.
+ RDS for Oracle copie implicitement les balises d'une base de données locataire vers la base de données locataire située dans un instantané de base de données. Lorsque vous restaurez une base de données locataire, les balises apparaissent dans la base de données restaurée.
+ Si vous restaurez un instantané de base de données et que vous spécifiez de nouvelles balises à l'aide du paramètre `--tags`, les nouvelles balises remplacent toutes les balises existantes.
+ Si vous prenez un instantané de base de données d'une instance de CDB comportant des balises et que vous spécifiez `--copy-tags-to-snapshot`, RDS for Oracle copie les balises des bases de données locataire vers les bases de données locataire situées dans l'instantané.
Pour de plus amples informations, veuillez consulter [Considérations relatives à Oracle Database](USER_RestoreFromSnapshot.md#USER_RestoreFromSnapshot.Oracle).
## Sauvegarde et restauration d'une CDB à l'aide de RMAN
Pour découvrir comment sauvegarder et restaurer une CDB ou une base de données locataire individuelle à l'aide de RMAN, consultez [Exécution des tâches RMAN courantes pour les instances de base de données Oracle](Appendix.Oracle.CommonDBATasks.RMAN.md).
# Conversion d'une base de données non-CDB RDS for Oracle en CDB
Vous pouvez modifier l’architecture d’une base de données Oracle en passant de l’architecture non-CDB à l’architecture multilocataire Oracle, également appelée *architecture CDB*, avec la commande `modify-db-instance`. Dans la plupart des cas, cette technique est préférable à la création d’une nouvelle CDB et à l’importation de données. L’opération de conversion entraîne une durée d’indisponibilité.
Lorsque vous mettez à niveau la version de votre moteur de base de données, vous ne pouvez pas modifier l'architecture de base de données lors de la même opération. Par conséquent, pour mettre à niveau une base de données non CDB Oracle Database 19c vers une CDB Oracle Database 21c, vous devez d'abord convertir la base de données non CDB en CDB au cours d'une étape, puis mettre à niveau la CDB 19c vers une CDB 21c au cours d'une étape distincte.
L'opération de conversion de la base de données non-CDB présente les exigences suivantes :
+ Vous devez spécifier `oracle-ee-cdb` ou `oracle-se2-cdb` pour le type de moteur de base de données. Ce sont les seules valeurs prises en charge.
+ Votre moteur de base de données doit utiliser Oracle Database 19c avec une mise à jour de version (RU) d'avril 2021 ou ultérieure.
Les restrictions suivantes s'appliquent à l'opération :
+ Vous ne pouvez pas convertir une CDB en base de données non-CDB. Vous pouvez uniquement convertir une base de données non-CDB en CDB.
+ Vous ne pouvez pas convertir une base de données non CDB en configuration multilocataire au cours d'un seul appel `modify-db-instance`. Une fois que vous avez converti une base de données non CDB en CDB, votre CDB est dans la configuration à locataire unique. Pour convertir la configuration à locataire unique en configuration multilocataire, réexécutez `modify-db-instance`. Pour plus d’informations, consultez [Conversion de la configuration à locataire unique en configuration à locataires multiples](oracle-single-tenant-converting.md).
+ Vous ne pouvez pas convertir une base de données principale ou de réplica sur laquelle Oracle Data Guard est activé. Pour convertir une base de données non CDB contenant des réplicas en lecture, supprimez d'abord toutes les réplicas en lecture.
+ Vous ne pouvez pas mettre à niveau la version du moteur de base de données et convertir une base de données non-CDB en CDB dans la même opération.
Avant de convertir votre fichier non-CDB, tenez compte des éléments suivants :
+ Les considérations relatives aux groupes d'options et de paramètres sont les mêmes que pour la mise à niveau du moteur de base de données. Pour plus d’informations, consultez [Considérations relatives aux mises à niveau de la base de données Oracle](USER_UpgradeDBInstance.Oracle.OGPG.md).
+ Vous pouvez convertir des instances non-CDB existantes qui utilisent des mots de passe principaux gérés en instances à locataire unique en une seule opération. Les instances à locataire unique héritent des mots de passe gérés.
+ Si l’option `OEMAGENT` est installée sur votre instance de base de données, il est recommandé de supprimer cette option avant de convertir votre instance non-CDB. Une fois que votre fichier non-CDB est converti en CDB, réinstallez l’option. Pour plus d’informations, consultez [Oracle Management Agent pour Enterprise Manager Cloud Control](Oracle.Options.OEMAgent.md).
+ Au cours du processus de conversion, RDS rétablit la taille du journal de restauration en ligne à 128 Mo par défaut.
## Console
**Pour convertir une base de données non-CDB en CDB**
1. Connectez-vous à la AWS Management Console et ouvrez la console Amazon RDS à l’adresse [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/).
1. Dans le coin supérieur droit de la console Amazon RDS, choisissez la Région AWS où réside votre instance de base de données.
1. Dans le panneau de navigation, choisissez **Bases de données**, puis l'instance de base de données non-CDB que vous voulez convertir en instance de CDB.
1. Sélectionnez **Modifier**.
1. Pour **Paramètres d'architecture**, sélectionnez **Architecture à locataires multiples Oracle**. Après la conversion, votre CDB sera dans la configuration à locataire unique.
1. (Facultatif) Pour **Groupe de paramètres de base de données**, choisissez un nouveau groupe de paramètres pour votre instance de CDB. Les mêmes considérations relatives aux groupes de paramètres s'appliquent lors de la conversion d'une instance de base de données que lors de la mise à niveau d'une instance de base de données. Pour plus d’informations, consultez [Considérations relatives au groupe de paramètres](USER_UpgradeDBInstance.Oracle.OGPG.md#USER_UpgradeDBInstance.Oracle.OGPG.PG).
1. (Facultatif) Pour **Groupe d'options**, choisissez un nouveau groupe d'options pour votre instance de CDB. Les mêmes considérations relatives aux groupes d'options s'appliquent lors de la conversion d'une instance de base de données que lors de la mise à niveau d'une instance de base de données. Pour plus d’informations, consultez [Considérations relatives au groupe d'options](USER_UpgradeDBInstance.Oracle.OGPG.md#USER_UpgradeDBInstance.Oracle.OGPG.OG).
1. (Facultatif) Pour la **gestion des informations d’identification**, choisissez **Géré dans AWS Secrets Manager** ou **Autogéré**. Pour plus d’informations, consultez [Gestion du mot de passe d’utilisateur principal pour une instance de base de données avec Secrets Manager](rds-secrets-manager.md#rds-secrets-manager-db-instance).
1. Lorsque tous les changements vous conviennent, choisissez **Continuer** et vérifiez le résumé des modifications.
1. (Facultatif) Choisissez **Appliquer immédiatement** pour appliquer les modifications immédiatement. La sélection de cette option peut entraîner des temps d'arrêt dans certains cas. Pour plus d'informations, consultez [Utilisation du paramètre de planification des modifications](USER_ModifyInstance.ApplyImmediately.md).
1. Sur la page de confirmation, examinez vos modifications. Si elles sont correctes, choisissez **Modifier l'instance de base de données**.
Ou choisissez **Retour** pour revoir vos modifications, ou choisissez **Annuler** pour les annuler.
## AWS CLI
Pour convertir la base de données non CDB de votre instance de base de données en une CDB dans la configuration à locataire unique, définissez `--engine` sur `oracle-ee-cdb` ou `oracle-se2-cdb` dans la commande AWS CLI [modify-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-instance.html). Pour plus d’informations, consultez [Paramètres des instances de base de données](USER_ModifyInstance.Settings.md).
L'exemple suivant convertit l'instance de base de données nommée *my-non-cdb* et spécifie un groupe d'options et un groupe de paramètres personnalisés. La commande permet également de gérer les mots de passe avec Secrets Manager.
**Example**
Pour Linux, macOS ou Unix :
```
aws rds modify-db-instance \
--db-instance-identifier my-non-cdb \
--engine oracle-ee-cdb \
--option-group-name custom-option-group \
--db-parameter-group-name custom-parameter-group \
--manage-master-user-password
```
Pour Windows :
```
aws rds modify-db-instance ^
--db-instance-identifier my-non-cdb ^
--engine oracle-ee-cdb ^
--option-group-name custom-option-group ^
--db-parameter-group-name custom-parameter-group ^
--manage-master-user-password
```
## API RDS
Pour convertir une base de données non-CDB en CDB, spécifiez `Engine` dans l'opération [ModifyDBInstance](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBInstance.html) de l'API RDS.
# Conversion de la configuration à locataire unique en configuration à locataires multiples
Vous pouvez remplacer la configuration à locataire unique par la configuration à locataires multiples pour l'architecture d'une CDB RDS for Oracle. Avant et après la conversion, votre CDB contient une base de données à locataire unique (PDB). Les balises de l’instance de base de données sont propagées vers la base de données locataire initiale créée lors de la conversion.
Avant de commencer, assurez-vous que votre politique IAM est autorisée à créer une base de données mutualisée. Au cours de la conversion, RDS for Oracle migre les métadonnées suivantes vers la nouvelle base de données locataire :
+ L'identifiant principal
+ Le mot de passe principal géré (si la CDB source s’intègre à Secrets Manager)
+ Le nom de la base de données
+ Le jeu de caractères
+ Le jeu de caractères national
Avant la conversion, vous pouviez afficher les informations précédentes à l’aide de la commande `describe-db-instances`. Après la conversion, vous les affichez à l'aide de la commande `describe-tenant-database`.
La conversion du statut de locataire unique à celui de locataire multiple présente les limites suivantes :
+ Vous ne pouvez pas reconvertir la configuration à locataire unique après avoir effectué la conversion en configuration à locataires multiples. La conversion est irréversible.
+ Vous ne pouvez pas convertir une base de données principale ou de réplica sur laquelle Oracle Data Guard est activé.
+ Vous ne pouvez pas mettre à niveau la version du moteur de base de données et effectuer une conversion vers une configuration à locataires multiples au cours de la même opération.
+ Vous ne pouvez pas activer ni désactiver les mots de passe des utilisateurs principaux gérés pendant la conversion.
## Console
**Pour convertir une CDB utilisant la configuration à locataire unique en configuration à locataires multiples**
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 la Région AWS où réside votre instance de base de données.
1. Dans le panneau de navigation, choisissez **Bases de données**, puis l'instance de base de données non-CDB que vous voulez convertir en instance de CDB.
1. Sélectionnez **Modifier**.
1. Pour **Paramètres d'architecture**, sélectionnez **Architecture à locataires multiples Oracle**.
1. Pour **Configuration de l'architecture**, sélectionnez **Configuration à locataires multiples**.
1. (Facultatif) Pour **Groupe de paramètres de base de données**, choisissez un nouveau groupe de paramètres pour votre instance de CDB. Les mêmes considérations relatives aux groupes de paramètres s’appliquent lors de la conversion d’une instance de base de données que lors de la mise à niveau d’une instance de base de données.
1. (Facultatif) Pour **Groupe d’options**, choisissez un nouveau groupe d’options pour votre instance de CDB. Les mêmes considérations relatives aux groupes d’options s’appliquent lors de la conversion d’une instance de base de données que lors de la mise à niveau d’une instance de base de données.
1. Lorsque tous les changements vous conviennent, choisissez **Continuer** et vérifiez le résumé des modifications.
1. Choisissez **Apply immediately (Appliquer immédiatement)**. Cette option est requise lorsque vous basculez vers une configuration à locataires multiples. Notes que cette option peut entraîner des temps d'arrêt dans certains cas.
1. Sur la page de confirmation, examinez vos modifications. Si elles sont correctes, choisissez **Modifier l'instance de base de données**.
Vous pouvez également sélectionner **Retour** pour revoir vos modifications ou **Annuler** pour les annuler.
## AWS CLI
Pour convertir un CDB utilisant la configuration mono-locataire en configuration multi-tenant, spécifiez-le `--multi-tenant` dans la commande. AWS CLI [modify-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-instance.html)
L'exemple suivant convertit l'instance de base de données nommée `my-st-cdb` de la configuration à locataire unique en configuration à locataires multiples. L’option `--apply-immediately` est obligatoire.
**Example**
Pour Linux, macOS ou Unix :
```
aws rds modify-db-instance --region us-east-1\
--db-instance-identifier my-st-cdb \
--multi-tenant \
--apply-immediately
```
Pour Windows :
```
aws rds modify-db-instance --region us-east-1 ^
--db-instance-identifier my-st-cdb ^
--multi-tenant ^
--apply-immediately
```
Le résultat se présente comme suit.
```
{
"DBInstance": {
"DBInstanceIdentifier": "my-st-cdb",
"DBInstanceClass": "db.r5.large",
"MultiTenant": false,
"Engine": "oracle-ee-cdb",
"DBResourceId": "db-AB1CDE2FGHIJK34LMNOPRLXTXU",
"DBInstanceStatus": "modifying",
"MasterUsername": "admin",
"DBName": "ORCL",
...
"EngineVersion": "19.0.0.0.ru-2022-01.rur-2022-01.r1",
"AutoMinorVersionUpgrade": true,
"ReadReplicaDBInstanceIdentifiers": [],
"LicenseModel": "bring-your-own-license",
"OptionGroupMemberships": [
{
"OptionGroupName": "default:oracle-ee-cdb-19",
"Status": "in-sync"
}
],
...
"PendingModifiedValues": {
"MultiTenant": "true"
}
}
}
```
# Ajout d'une base de données locataire RDS for Oracle à votre instance de CDB
Dans la configuration multi-locataires RDS for Oracle, une base de données locataire est une PDB. Pour ajouter une base de données locataire, vérifiez que vous respectez les conditions prérequises suivantes :
+ La configuration multi-locataires est activée sur votre CDB. Pour de plus amples informations, veuillez consulter [Configuration à locataires multiples de l'architecture CDB](Oracle.Concepts.CDBs.md#multi-tenant-configuration).
+ Vous disposez des autorisations IAM nécessaires pour créer la base de données locataire.
Vous pouvez ajouter une base de données mutualisée à l'aide de l'API AWS Management Console, de AWS CLI, ou de l'API RDS. Vous ne pouvez pas ajouter plusieurs bases de données locataire au cours d'une seule opération : vous devez les ajouter une par une. Si la conservation des sauvegardes est activée sur la CDB, Amazon RDS sauvegarde l'instance de base de données avant et après l'ajout d'une nouvelle base de données locataire. Si le CDB a lu des répliques, vous pouvez uniquement ajouter une base de données locataire à l'instance de base de données principale ; Amazon RDS crée automatiquement la base de données locataire sur les répliques. L'état de la réplication est également validé, ce qui garantit que toutes les répliques sont disponibles et que le délai de réplication est inférieur à 5 minutes avant la création du locataire.
## Console
**Pour ajouter une base de données locataire à votre instance de base de données**
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 la Région AWS dans laquelle vous voulez créer la base de données locataire.
1. Dans le panneau de navigation, choisissez **Databases (Bases de données)**.
1. Choisissez l'instance de CDB à laquelle vous souhaitez ajouter une base de données locataire. Votre instance de base de données doit utiliser la configuration multilocataire de l'architecture CDB.
1. Choisissez **Actions**, puis **Ajouter une base de données locataire**.
1. Pour **Paramètres de base de données locataire**, procédez comme suit :
+ Pour **Nom de la base de données locataire**, entrez le nom de votre nouvelle PDB.
+ Pour **Nom d'utilisateur principal de la base de données locataire**, entrez le nom de l'utilisateur principal de votre PDB.
+ Choisissez l’une des options suivantes de gestion des informations d’identification :
+ **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. AWS Secrets Manager n'est pas pris en charge pour les instances utilisant des répliques de lecture. 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**.
+ Sous **Configuration supplémentaire**, saisissez le nom de votre PDB pour **Nom de la base de données initiale**. Vous ne pouvez pas nommer la CDB, qui porte le nom par défaut `RDSCDB`.
+ Pour **Jeu de caractères de base de données locataire**, choisissez un jeu de caractères pour la PDB. La valeur par défaut est **AL32UTF8**. Vous pouvez choisir un jeu de caractères de PDB différent du jeu de caractères de CDB. Si l'instance possède des répliques lues, les locataires ne peuvent pas être créés avec un jeu de caractères personnalisé. Vous pouvez créer vos locataires avec un jeu de caractères personnalisé avant de créer une réplique en lecture si nécessaire.
+ Pour **Jeu de caractères national de base de données locataire**, choisissez un jeu de caractères national pour la PDB. La valeur par défaut est **AL32UTF8**. Le jeu de caractères national spécifie l'encodage uniquement pour les colonnes qui utilisent le type de données `NCHAR` (`NCHAR`, `NVARCHAR2` et `NCLOB`) et n'affecte pas les métadonnées de la base de données.
Pour plus d'informations sur les paramètres précédents, consultez [Paramètres des instances de base de données](USER_CreateDBInstance.Settings.md).
1. Choisissez **Ajouter un locataire**.
## AWS CLI
Pour ajouter une base de données mutualisée à votre CDB à l'aide du AWS CLI, utilisez la commande [create-tenant-database](https://docs.aws.amazon.com/cli/latest/reference/rds/create-tenant-database.html)avec les paramètres obligatoires suivants :
+ `--db-instance-identifier`
+ `--tenant-db-name`
+ `--master-username`
+ `--master-user-password`
L'exemple suivant crée une base de données de locataires nommée *mypdb2* dans l'instance RDS pour Oracle CDB nommée. *my-cdb-inst* Le jeu de caractères de PDB est `UTF-16`.
**Example**
Pour Linux, macOS ou Unix :
```
1. aws rds create-tenant-database --region us-east-1 \
2. --db-instance-identifier my-cdb-inst \
3. --tenant-db-name mypdb2 \
4. --master-username mypdb2-admin \
5. --master-user-password mypdb2-pwd \
6. --character-set-name UTF-16
```
Pour Windows :
```
1. aws rds create-tenant-database --region us-east-1 \
2. --db-instance-identifier my-cdb-inst ^
3. --tenant-db-name mypdb2 ^
4. --master-username mypdb2-admin ^
5. --master-user-password mypdb2-pwd ^
6. --character-set-name UTF-16
```
La sortie ressemble à ce qui suit.
```
...}
"TenantDatabase" :
{
"DbiResourceId" : "db-abc123",
"TenantDatabaseResourceId" : "tdb-bac567",
"TenantDatabaseArn" : "arn:aws:rds:us-east-1:123456789012:db:my-cdb-inst:mypdb2",
"DBInstanceIdentifier" : "my-cdb-inst",
"TenantDBName" : "mypdb2",
"Status" : "creating",
"MasterUsername" : "mypdb2",
"CharacterSetName" : "UTF-16",
...
}
}...
```
# Modification d'une base de données locataire RDS for Oracle
Vous pouvez uniquement modifier le nom de la PDB et le mot de passe utilisateur principal d'une base de données locataire dans votre CDB. Prenez note des exigences et limitations suivantes :
+ Pour modifier les paramètres d'une base de données locataire dans votre instance de base de données, la base de données locataire doit exister.
+ Vous ne pouvez pas modifier plusieurs bases de données locataire au cours d'une seule opération. Vous ne pouvez modifier qu'une seule base de données locataire à la fois.
+ Vous ne pouvez pas remplacer le nom d'une base de données locataire par `CDB$ROOT` ou `PDB$SEED`.
+ Si votre instance de base de données possède des répliques de lecture, vous ne pouvez modifier les locataires que sur l'instance de base de données principale. L'état de la réplication est également validé, ce qui garantit que les répliques sont disponibles et que le délai de réplication est inférieur à 5 minutes avant que le locataire ne soit modifié.
Vous pouvez effectuer des modifications PDBs à l'aide de AWS Management Console l'API AWS CLI, de, ou de l'API RDS.
## Console
**Pour modifier le nom de PDB ou le mot de passe principal d'une base de données locataire**
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 la Région AWS dans laquelle vous voulez créer la base de données locataire.
1. Dans le panneau de navigation, choisissez **Databases (Bases de données)**.
1. Choisissez la base de données locataire dont vous souhaitez modifier le nom de base de données ou le mot de passe utilisateur principal.
1. Sélectionnez **Modifier**.
1. Pour **Paramètres de base de données locataire**, effectuez l'une des opérations suivantes :
+ Pour **Nom de la base de données locataire**, entrez le nouveau nom de votre nouvelle PDB.
+ Pour **Mot de passe principal de base de données locataire**, entrez un nouveau mot de passe.
1. Choisissez **Modifier le locataire**.
## AWS CLI
Pour modifier une base de données mutualisée à l'aide de AWS CLI, appelez la [modify-tenant-database](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-tenant-database.html)commande avec les paramètres suivants :
+ `--db-instance-identifier` *value*
+ `--tenant-db-name value`
+ `[--new-tenant-db-name value]`
+ `[--master-user-password value]`
L'exemple suivant renomme la base de données locataire `pdb1` en `pdb-hr` sur l'instance de base de données `my-cdb-inst`.
**Example**
Pour Linux, macOS ou Unix :
```
1. aws rds modify-tenant-database --region us-east-1 \
2. --db-instance-identifier my-cdb-inst \
3. --tenant-db-name pdb1 \
4. --new-tenant-db-name pdb-hr
```
Pour Windows :
```
1. aws rds modify-tenant-database --region us-east-1 ^
2. --db-instance-identifier my-cdb-inst ^
3. --tenant-db-name pdb1 ^
4. --new-tenant-db-name pdb-hr
```
Le résultat produit lors de l’exécution de cette commande est semblable à ce qui suit :
```
{
"TenantDatabase" : {
"DbiResourceId" : "db-abc123",
"TenantDatabaseResourceId" : "tdb-bac567",
"TenantDatabaseArn" : "arn:aws:rds:us-east-1:123456789012:db:my-cdb-inst:pdb1",
"DBInstanceIdentifier" : "my-cdb-inst",
"TenantDBName" : "pdb1",
"Status" : "modifying",
"MasterUsername" : "tenant-admin-user"
"Port" : "6555",
"CharacterSetName" : "UTF-16",
"MaxAllocatedStorage" : "1000",
"ParameterGroups": [
{
"ParameterGroupName": "pdb1-params",
"ParameterApplyStatus": "in-sync"
}
],
"OptionGroupMemberships": [
{
"OptionGroupName": "pdb1-options",
"Status": "in-sync"
}
],
"PendingModifiedValues": {
"TenantDBName": "pdb-hr"
}
}
}
```
# Suppression d'une base de données locataire RDS for Oracle de votre CDB
Vous pouvez supprimer une base de données mutualisée (PDB) à l'aide de l'API AWS Management Console, de AWS CLI, ou de l'API RDS. Tenez compte des conditions préalables requises et des limitations suivantes :
+ La base de données locataire et l'instance de base de données doivent exister.
+ Pour que la suppression réussisse, l'une des situations suivantes doit exister :
+ La base de données locataire et l'instance de base de données sont disponibles.
**Note**
Vous pouvez prendre un instantané final, mais uniquement si la base de données locataire et l'instance de base de données étaient disponibles avant l'émission de la commande `delete-tenant-database`. Cet instantané ne sera pris sur l'instance principale que si l'instance de base de données a lu des répliques.
+ La base de données locataire est en cours de création.
+ L'instance de base de données modifie la base de données locataire.
+ Si l'instance de base de données a lu des répliques, ces contraintes s'appliquent à toutes les répliques.
+ Vous ne pouvez pas supprimer plusieurs bases de données locataire au cours d'une seule opération.
+ Vous ne pouvez pas supprimer une base de données locataire si elle est le seul locataire de la CDB.
+ Vous ne pouvez pas supprimer une base de données mutualisée sur une réplique en lecture, vous pouvez uniquement supprimer un locataire sur l'instance de base de données principale. L'état de la réplication est également validé, ce qui garantit que le délai de réplication est inférieur à 5 minutes avant la suppression du locataire.
## Console
**Pour supprimer une base de données locataire**
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 panneau de navigation, choisissez **Bases de données**, puis choisissez la base de données locataire que vous souhaitez supprimer.
1. Pour **Actions**, choisissez **Supprimer**.
1. Pour créer un instantané de base de données final pour l'instance de base de données, choisissez **Create final snapshot? (Créer un instantané final ?)**.
1. Si vous avez choisi de créer un instantané final, entrez le paramètre **Final snapshot name (Nom de l'instantané final)**.
1. Saisissez **delete me** dans la zone.
1. Sélectionnez **Delete (Supprimer)**.
## AWS CLI
Pour supprimer une base de données mutualisée à l'aide de AWS CLI, appelez la [delete-tenant-database](https://docs.aws.amazon.com/cli/latest/reference/rds/delete-tenant-database.html)commande avec les paramètres suivants :
+ `--db-instance-identifier value`
+ `--tenant-db-name value`
+ `[--skip-final-snapshot | --no-skip-final-snapshot]`
+ `[--final-snapshot-identifier value]`
L'exemple suivant supprime la base de données mutualisée nommée à *pdb-test* partir de la base de données CDB nommée. *my-cdb-inst* Par défaut, l'opération crée un instantané final.
**Example**
Pour Linux, macOS ou Unix :
```
1. aws rds delete-tenant-database --region us-east-1 \
2. --db-instance-identifier my-cdb-inst \
3. --tenant-db-name pdb-test \
4. --final-snapshot-identifier final-snap-pdb-test
```
Pour Windows :
```
1. aws rds delete-tenant-database --region us-east-1 ^
2. --db-instance-identifier my-cdb-inst ^
3. --tenant-db-name pdb-test ^
4. --final-snapshot-identifier final-snap-pdb-test
```
Le résultat produit lors de l’exécution de cette commande est semblable à ce qui suit :
```
{
"TenantDatabase" : {
"DbiResourceId" : "db-abc123",
"TenantDatabaseResourceId" : "tdb-bac456",
"TenantDatabaseArn" : "arn:aws:rds:us-east-1:123456789012:db:my-cdb-inst:pdb-test",
"DBInstanceIdentifier" : "my-cdb-inst",
"TenantDBName" : "pdb-test",
"Status" : "deleting",
"MasterUsername" : "pdb-test-admin"
"Port" : "6555",
"CharacterSetName" : "UTF-16",
"MaxAllocatedStorage" : "1000",
"ParameterGroups": [
{
"ParameterGroupName": "tenant-1-params",
"ParameterApplyStatus": "in-sync"
}
],
"OptionGroupMemberships": [
{
"OptionGroupName": "tenant-1-options",
"Status": "in-sync"
}
]
}
}
```
# Affichage des détails de la base de données locataire
Vous pouvez afficher les détails d'une base de données locataire de la même manière que pour une base de données non CDB ou CDB.
## Console
**Pour afficher les détails d'une base de données locataire**
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 la Région AWS où réside votre instance de base de données.
1. Dans le panneau de navigation, choisissez **Databases (Bases de données)**.
![\[Afficher les détails d'une CDB\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/cdb-list.png)
Dans l'image précédente, la base de données locataire unique (PDB) apparaît en tant qu'enfant de l'instance de base de données.
1. Choisissez le nom d'une base de données locataire.
![\[Afficher les détails d'une PDB\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/UserGuide/images/pdb-details.png)
## AWS CLI
Pour obtenir des informations sur votre PDBs, utilisez la AWS CLI commande [describe-tenant-databases](https://docs.aws.amazon.com/cli/latest/reference/rds/describe-tenant-databases.html).
L'exemple suivant décrit toutes les bases de données locataire de la région spécifiée.
**Example**
Pour Linux, macOS ou Unix :
```
1. aws rds describe-tenant-databases --region us-east-1
```
Pour Windows :
```
1. aws rds describe-tenant-databases --region us-east-1
```
Le résultat produit lors de l’exécution de cette commande est semblable à ce qui suit :
```
"TenantDatabases" : [
{
"DBInstanceIdentifier" : "my-cdb-inst",
"TenantDBName" : "pdb-test",
"Status" : "available",
"MasterUsername" : "pdb-test-admin",
"DbiResourceId" : "db-abc123",
"TenantDatabaseResourceId" : "tdb-bac456",
"TenantDatabaseArn" : "arn:aws:rds:us-east-1:123456789012:db:my-cdb-inst:pdb-test",
"CharacterSetName": "AL32UTF8",
"NcharCharacterSetName": "AL16UTF16",
"DeletionProtection": false,
"PendingModifiedValues": {
"MasterUserPassword": "****"
},
"TagList": []
},
{
"DBInstanceIdentifier" : "my-cdb-inst2",
"TenantDBName" : "pdb-dev",
"Status" : "modifying",
"MasterUsername" : "masterrdsuser"
"DbiResourceId" : "db-xyz789",
"TenantDatabaseResourceId" : "tdb-ghp890",
"TenantDatabaseArn" : "arn:aws:rds:us-east-1:123456789012:db:my-cdb-inst2:pdb-dev",
"CharacterSetName": "AL32UTF8",
"NcharCharacterSetName": "AL16UTF16",
"DeletionProtection": false,
"PendingModifiedValues": {
"MasterUserPassword": "****"
},
"TagList": []
},
... other truncated data
```
L'exemple suivant décrit les bases de données locataire sur l'instance de base de données `my-cdb-inst` dans la région spécifiée.
**Example**
Pour Linux, macOS ou Unix :
```
1. aws rds describe-tenant-databases --region us-east-1 \
2. --db-instance-identifier my-cdb-inst
```
Pour Windows :
```
1. aws rds describe-tenant-databases --region us-east-1 ^
2. --db-instance-identifier my-cdb-inst
```
Le résultat produit lors de l’exécution de cette commande est semblable à ce qui suit :
```
{
"TenantDatabase": {
"TenantDatabaseCreateTime": "2023-10-19T23:55:30.046Z",
"DBInstanceIdentifier": "my-cdb-inst",
"TenantDBName": "pdb-hr",
"Status": "creating",
"MasterUsername": "tenant-admin-user",
"DbiResourceId": "db-abc123",
"TenantDatabaseResourceId": "tdb-bac567",
"TenantDatabaseARN": "arn:aws:rds:us-west-2:579508833180:pdb-hr:tdb-abcdefghi1jklmno2p3qrst4uvw5xy6zabc7defghi8jklmn90op",
"CharacterSetName": "AL32UTF8",
"NcharCharacterSetName": "AL16UTF16",
"DeletionProtection": false,
"PendingModifiedValues": {
"MasterUserPassword": "****"
},
"TagList": [
{
"Key": "TEST",
"Value": "testValue"
}
]
}
}
```
L'exemple suivant décrit la base de données locataire `pdb1` sur l'instance de base de données `my-cdb-inst` dans la région USA Est (Virginie du Nord).
**Example**
Pour Linux, macOS ou Unix :
```
1. aws rds describe-tenant-databases --region us-east-1 \
2. --db-instance-identifier my-cdb-inst \
3. --tenant-db-name pdb1
```
Pour Windows :
```
1. aws rds describe-tenant-databases --region us-east-1 ^
2. --db-instance-identifier my-cdb-inst ^
3. --tenant-db-name pdb1
```
Le résultat produit lors de l’exécution de cette commande est semblable à ce qui suit :
```
{
"TenantDatabases" : [
{
"DbiResourceId" : "db-abc123",
"TenantDatabaseResourceId" : "tdb-bac567",
"TenantDatabaseArn" : "arn:aws:rds:us-east-1:123456789012:db:my-cdb-inst:pdb1"
"DBInstanceIdentifier" : "my-cdb-inst",
"TenantDBName" : "pdb1",
"Status" : "ACTIVE",
"MasterUsername" : "masterawsuser"
"Port" : "1234",
"CharacterSetName": "UTF-8",
"ParameterGroups": [
{
"ParameterGroupName": "tenant-custom-pg",
"ParameterApplyStatus": "in-sync"
}
],
{
"OptionGroupMemberships": [
{
"OptionGroupName": "tenant-custom-og",
"Status": "in-sync"
}
]
}
]
}
```
# Mise à niveau de votre CDB
Vous pouvez mettre à niveau une instance CDB vers une version différente de Oracle Database. Par exemple, vous pouvez mettre à niveau une CDB Oracle Database 19c en CDB Oracle Database 21c. Vous ne pouvez pas modifier l'architecture de base de données au cours d'une mise à niveau. Ainsi, vous ne pouvez pas mettre à niveau une base de données non-CDB en CDB ni mettre à niveau une CDB en base de données non-CDB.
La procédure de mise à niveau d'une CDB vers une CDB est la même que pour la mise à niveau d'une base de données non-CDB vers une base de données non-CDB. Pour de plus amples informations, consultez [Mise à niveau du moteur de base de données RDS for Oracle](USER_UpgradeDBInstance.Oracle.md).