This chapter explains how you can manage pluggable databases (PDBs) using Oracle Enterprise Manager Cloud Control (Cloud Control). In particular, this chapter covers the following:
This section helps you get started with this chapter by providing an overview of the steps involved in creating a new pluggable database (PDB), cloning a PDB, migrating a non-container database (CDB) as a PDB, unplugging a PDB, and deleting PDBs. Consider this section to be a documentation map to understand the sequence of actions you must perform to successfully perform these tasks using Cloud Control. Click the reference links provided against the steps to reach the relevant sections that provide more information.
Table 14-1 Getting Started with Managing Pluggable Databases
Step | Description | Reference Links |
---|---|---|
Step 1 |
Obtaining an Overview Obtain a conceptual overview of PDBs. |
To obtain a conceptual overview of PDBs, see Overview of Managing Pluggable Databases Using Enterprise Manager. |
Step 2 |
Selecting the Use Case Among the following use cases, select the one that best matches your requirement:
|
|
Step 3 |
Meeting the Prerequisites Meet the prerequisites for the selected use case. |
|
Step 4 |
Following the Procedure Follow the procedure for the selected use case. |
|
An Oracle Database can contain a portable collection of schemas, schema objects, and nonschema objects, that appear to an Oracle Net client as a separate database. This self-contained collection is called a pluggable database (PDB). A multitenant container database (CDB) is a database that includes one or more PDBs. Oracle Database 12c Release 1 (12.1) and later versions allow you to create many PDBs within a single CDB. Applications that connect to databases view PDBs and earlier versions of Oracle Database (earlier than 12.1) in the same manner.
Cloud Control enables administrators to manage the entire PDB lifecycle, including provisioning CDBs, provisioning PDBs (from the seed or from an unplugged PDB), cloning existing PDBs, migrating non-CDBs as PDBs, unplugging PDBs, and deleting PDBs.
Note:
To manage the PDB lifecycle using Cloud Control, you must have the 12.1.0.3 Enterprise Manager for Oracle Database plug-in, or a later version, deployed. To delete PDBs using Cloud Control, you must have the 12.1.0.5 Enterprise Manager for Oracle Database plug-in deployed.
For information on how to deploy a plug-in and upgrade an existing plug-in, see Oracle Enterprise Manager Cloud Control Administrator's Guide.
Figure 14-1 provides a graphical overview of how you can manage the PDB lifecycle in Cloud Control.
Figure 14-1 Managing Pluggable Databases
For more information about PDBs and CDBs, see Managing Plug-Ins in the Oracle Database Administrator’s Guide..
You can provision PDBs by creating a new PDB within a CDB, by cloning an existing PDB, or by migrating existing non-CDBs to a CDB as PDBs. You can also use unplugged PDBs for provisioning, by plugging them into a CDB.
This section provides information about provisioning a PDB using the Cloud Control console. In particular, it contains the following:
Plugging In an Unplugged Pluggable Database Using Enterprise Manager
Migrating a Non-CDB as a Pluggable Database Using Enterprise Manager
Note:
You can also provision PDBs using EM CLI. For information on how to do so, see Provisioning Pluggable Databases.
This section provides information about creating a new PDB using Cloud Control. In particular, it contains the following:
Before creating a new PDB using Cloud Control, ensure that you meet the following prerequisites:
Oracle Software Library (Software Library) must be set up in Cloud Control.
For information on how to set up Software Library in Cloud Control, see Setting Up Oracle Software Library.
The CDB within which you want to create a PDB must exist, and must be a Cloud Control target.
Note:
For information on how to create a new CDB, see Creating Databases.
The CDB (within which you want to create a PDB) must not be in read-only, upgrade, or downgrade mode.
The target host user must be the owner of the Oracle home that the CDB (within which you want to create the PDB) belongs to.
This section provides information about plugging in an unplugged PDB into a CDB, using Cloud Control. In particular, it contains the following:
Before plugging in an unplugged PDB using Cloud Control, ensure that you meet the following prerequisites:
Oracle Software Library (Software Library) must be set up in Cloud Control.
For information on how to set up Software Library in Cloud Control, see Setting Up Oracle Software Library.
The target CDB (the CDB within which you want to plug in the unplugged PDB) must exist, and must be a Cloud Control target.
Note:
For information on how to create a new CDB, see Creating Databases.
The target CDB must not be in read-only, upgrade, or downgrade mode.
The XML file that describes the unplugged PDB, and the other files associated with the unplugged PDB, such as the datafiles and the wallet file, must exist and must be readable.
The target host user must be the owner of the Oracle home that the CDB (within which you want to plug in the unplugged PDB) belongs to.
The platforms of the source CDB host (the host on which the CDB that previously contained the unplugged PDB is installed) and the target CDB host (the host on which the target CDB is installed) must have the same endianness, and must have compatible database options installed.
The source CDB (the CDB that previously contained the unplugged PDB) and the target CDB must have compatible character sets and national character sets. Every character in the source CDB character set must be available in the target CDB character set, and the code point value of every character available in the source CDB character set must be the same in the target CDB character set.
You can clone a PDB using either the Full Clone method, or the Snap Clone method. This section provides information about cloning a PDB using these methods, in Cloud Control. In particular, it contains the following:
To clone a PDB using Cloud Control, you must meet the following prerequisites:
Oracle Software Library (Software Library) must be set up in Cloud Control.
For information on how to set up Software Library in Cloud Control, see Setting Up Oracle Software Library.
The source PDB (the PDB that you want to clone) must exist, and must be a Cloud Control target.
Note:
For information on how to create a new PDB, see Creating a New Pluggable Database Using Enterprise Manager.
The source PDB must be open.
The target CDB (the CDB into which you want to plug in the cloned PDB) must exist, and must be a Cloud Control target.
Note:
For information on how to create a new CDB, see Creating Databases.
The target CDB must not be in read-only, upgrade, or downgrade mode.
The target host user must be the owner of the Oracle home that the target CDB belongs to.
To clone a PDB using the Snap Clone method, you must meet the following additional prerequisites:
The 12.1.0.5 Enterprise Manager for Oracle Database plug-in must be downloaded and deployed. Also, the 12.1.0.3 SMF plug-in or higher must be downloaded and deployed.
The PDB that you want to clone must reside on a registered storage server. This storage server must be synchronized.
For information on how to register a storage server and synchronize storage servers, see Oracle Enterprise Manager Cloud Administration Guide.
All the datafiles of the PDB that you want to clone must reside on the storage volumes of the storage server, and not on the local disk.
Metric collections must be run on the source CDB (the CDB containing the PDB that you want to clone), the source CDB host, and the PDB that you want to clone.
The Snap Clone feature must be enabled for the PDB that you want to clone.
For information on how to enable the Snap Clone feature, see Oracle Enterprise Manager Cloud Administration Guide.
This section provides information about migrating a non-CDB as a PDB using Cloud Control. In particular, it contains the following:
Before migrating a non-CDB as a PDB using Cloud Control, ensure that you meet the following prerequisites:
Oracle Software Library (Software Library) must be set up in Cloud Control.
For information on how to set up Software Library in Cloud Control, see Setting Up Oracle Software Library.
The target CDB (the CDB to which you want to migrate a non-CDB as a PDB) must exist, and must be a Cloud Control target.
Note:
For information on how to create a new CDB, see Creating Databases.
The target CDB must not be in read-only, upgrade, or downgrade mode.
The non-CDB that you want to migrate and the target CDB must be running in ARCHIVELOG
mode.
For information on setting the archiving mode of a database, see Oracle Database Administrator’s Guide.
The database administrators of the database you want to migrate, and the target CDB must have SYSDBA
privileges.
The target host user must be the owner of the Oracle home that the target CDB belongs to.
This section provides information about relocating a Pluggable Database (PDB). By following the steps for relocation, a Pluggable Database is moved from one Container Database (source) to another (destination). While cloning a Pluggable Database to a different Container Database (CDB) creates a copy of the PDB while the original still exists in the parent CDB, relocation completely moves the PDB from one CDB to another.
Note:
The relocation of Pluggable Databases is applicable only to Database versions 12.2 and above.In particular, this section contains the following:
This section provides information related to unplugging PDBs and deleting PDBs. In particular, it contains the following:
This section provides information about unplugging and dropping a PDB using Cloud Control. In particular, it contains the following:
Note:
As an alternative to using the method described in this section, you can use EM CLI to unplug and drop PDBs. For more information, see Unplugging and Dropping a Pluggable Database.
Before unplugging and dropping a PDB using Cloud Control, ensure that you meet the following prerequisites:
Oracle Software Library (Software Library) must be set up in Cloud Control.
For information on how to set up Software Library in Cloud Control, see Setting Up Oracle Software Library.
The PDB that you want to unplug and drop must have been opened at least once.
The target host user must be the owner of the Oracle home that the CDB (containing the PDB that you want to unplug and drop) belongs to.
This section provides information about permanently deleting PDBs from a CDB, using Cloud Control. In particular, it contains the following:
Before permanently deleting a set of PDBs from a CDB using Cloud Control, ensure that you meet the following prerequisites:
The 12.1.0.5 Enterprise Manager for Oracle Database plug-in must be downloaded and deployed.
For information on how to download and deploy a plug-in, see Oracle Enterprise Manager Cloud Control Administrator's Guide.
Oracle Software Library (Software Library) must be set up in Cloud Control.
For information on how to set up Software Library in Cloud Control, see Setting Up Oracle Software Library.
The PDBs that you want to delete must have been opened at least once.
The target host user must be the owner of the Oracle home that the CDB (containing the PDBs that you want to delete) belongs to.
This section provides information about viewing the details of the jobs that are created by the Enterprise Manager job system when you create a PDB, unplug a PDB, or delete a PDB. It contains the following:
To view the details of a create PDB job, follow these steps:
To view the details of an unplug PDB job, follow these steps:
This section provides information about performing PDB administration tasks using Cloud Control. It contains the following:
If you are performing a task such as granting user privileges or performance reporting, and you need to perform the same task on another PDB, then you can switch to another PDB using Cloud Control. To switch between PDBs while staying on the same feature page, follow these steps:
To change the state of a single-instance PDB to Open or Close using Cloud Control, follow these steps:
From the Oracle Database menu, select Control, then select Open/Close Pluggable Database.
From the Open/Close PDB page, select a PDB from the list.
Click the Action drop-down menu and select the appropriate actions. Your choices are Open, Open Read Only, and Close.
In the Confirmation dialog window, click Yes to complete the change. A Processing dialog window appears to show you the progress of your choice.
Once state change completes, the Open/Close PDB page will update to show the new state of the PDB.
To change the state of a PDB in a Cluster/RAC to Open or Close, follow these steps: