|
Measures reported by OraPdbStatusTest
The multitenant architecture enables an Oracle database to function as a multitenant container database (CDB) that includes zero, one, or many customer-created pluggable databases (PDBs). A PDB is a portable collection of schemas, schema objects, and nonschema objects that appears to an Oracle Net client as a non-CDB. All Oracle databases before Oracle Database 12c were non-CDBs.
A container is either a PDB or the root container (also called the root). The root is a collection of schemas, schema objects, and nonschema objects to which all PDBs belong.
Every CDB has the following containers:
Exactly one root : The root stores Oracle-supplied metadata and common users. An example of metadata is the source code for Oracle-supplied PL/SQL packages. A common user is a database user known in every container. The root container is named CDB$ROOT. Exactly one seed PDB : The seed PDB is a system-supplied template that the CDB can use to create new PDBs. The seed PDB is named PDB$SEED. You cannot add or modify objects in PDB$SEED. Zero or more user-created PDBs : A PDB is a user-created entity that contains the data and code required for a specific set of features. For example, a PDB can support a specific application, such as a human resources or sales application. No PDBs exist at creation of the CDB. You add PDBs based on your business requirements.
If a user is experiencing errors when attempting to open a PDB, administrators must be able to quickly check the status of the PDB to figure out the reason for the error. For this purpose, administrators can use the OraPdbStatusTest test. This test automatically discovers the PDBs and reports the current status and mode of every PDB.
Output of the test : One set of results for every PDB on the Oracle server.
The measures made by this test are as follows:
| Measurement |
Description |
Measurement Unit |
Interpretation |
| Status |
Indicates the current status of this PDB. |
|
The values that this measure can report and their corresponding numeric values are discussed hereunder:
| Measure Value |
Description |
Numeric Value |
| new |
The PDB has never been opened since it was created. It must be opened in READ WRITE mode for Oracle to perform processing needed to complete the integration of the PDB into the CDB and mark it NORMAL. An error will be thrown if an attempt is made to open the PDB read only |
1 |
| normal |
The PDB is ready to be used |
2 |
| unplugged |
The PDB has been unplugged. The only operation that can be performed on it is DROP PLUGGABLE DATABASE. |
3 |
| needs upgrade |
A PDB needs to be upgraded to the version of the CDB into which it was plugged |
4 |
| converting |
A non-CDB was plugged into the CDB and is undergoing conversion required to make it behave like a real PDB. |
5 |
| unusable |
The PDB is being created or an unrecoverable error was encountered during its creation. The PDB cannot be opened while its state is set to UNUSABLE. If the PDB remains in this state because of an error encountered during its creation, it can only be dropped. The alert log can be checked to determine if there was an error during PDB creation. |
6 |
Note:
By default, this measure reports the above-mentioned Measure Values while indicating the current state of a PDB. However, in the graph of this measure, the same will be represented using the corresponding numeric equivalents only.
|
| Mode |
Indicates the mode in which this PDB has been opened currently. |
|
The values that this measure can report and their corresponding numeric values are discussed hereunder:
| Measure Value |
Numeric Value |
| mounted |
1 |
| read write |
2 |
| read only |
3 |
| migrate |
4 |
Note:
By default, this measure reports the above-mentioned Measure Values while indicating the mode in which the PDB is opened. However, in the graph of this measure, the same will be represented using the corresponding numeric equivalents only.
|
|