19c PDB service remove/add:
By default, Container Database (CDB) provides only one service for every Pluggable Database (PDB) for connections, but we can create our own services for various entries of applications.
There're two ways to add a service to a PDB:
- DBMS_SERVICE Create Service to PDB
- Srvctl Add Service to PDB
It's an administration package for managing services of a database.
For RAC databases or Oracle Restart, we can use it to manage services.
To add a service to a normal, non-CDB database, you may go for that post.
DBMS_SERVICE.CREATE_SERVICE to PDB
For single-instance, we can only use DBMS_SERVICE to add services to a PDB.
Check Listener
Let's see current status of listener.
[oracle@test ~]$ lsnrctl status
...
Services Summary...
Service "ORCLCDB" has 1 instance(s).
Instance "ORCLCDB", status READY, has 1 handler(s) for this service...
Service "ORCLCDBXDB" has 1 instance(s).
Instance "ORCLCDB", status READY, has 1 handler(s) for this service...
Service "aa736f65d66215cce053992aa8c08959" has 1 instance(s).
Instance "ORCLCDB", status READY, has 1 handler(s) for this service...
Service "orclpdb" has 1 instance(s).
Instance "ORCLCDB", status READY, has 1 handler(s) for this service...
The command completed successfullyAs you can see, the default service ORCLPDB of the PDB now registers with listener.
Switch Container
Let's see what PDB we have.
SQL> show pdbs
CON_ID CON_NAME OPEN MODE RESTRICTED
---------- ------------------------------ ---------- ----------
2 PDB$SEED READ ONLY NO
3 ORCLPDB READ WRITE NOLet's switch container to the PDB.
SQL> alter session set container=ORCLPDB;
Session altered.Make sure that we are in the right container.
SQL> show con_name
CON_NAME
------------------------------
ORCLPDBLet's see current services of the container before adding a service to it.
SQL> column con_id format 99
SQL> column pdb format a15
SQL> column network_name format a30
SQL> select con_id, pdb, network_name from cdb_services where pdb is not null and con_id > 2 order by pdb;
CON_ID PDB NETWORK_NAME
------ --------------- ------------------------------
3 ORCLPDB ORCLPDB Where dynamic view CDB_SERVICES is derived from DBA_SERVICES.
Add a Service to PDB
Create a service
SQL> exec dbms_service.create_service('ERP', 'ERP');
PL/SQL procedure successfully completed.The service is added to current PDB, no matter a single-instance or a RAC database.
There're more variations on adding a failover service to the cluster by DBMS_SERVICE.
Start the service
SQL> exec dbms_service.start_service('ERP');
PL/SQL procedure successfully completed.For RAC database, you should start the services on all instances in the cluster:
SQL> exec dbms_service.start_service('ERP', DBMS_SERVICE.ALL_INSTANCES);
PL/SQL procedure successfully completed.DBMS_SERVICE.START_SERVICE Automatically in PDB
To automatically start the service after PDB is open, you just need to save current state for the PDB.
SQL> alter pluggable database orclpdb save state;
Pluggable database altered.For RAC database, you should save the state of PDB on all instances in the cluster:
SQL> alter pluggable database orclpdb save state instances=all;
Pluggable database altered.There're more variations on saving state of a PDB or all PDB.
Check services of the container
Let's see current services of the container after adding a service to it.
SQL> select con_id, pdb, network_name from cdb_services where pdb is not null and con_id > 2 order by pdb;
CON_ID PDB NETWORK_NAME
------ --------------- ------------------------------
3 ORCLPDB ERP
3 ORCLPDB ORCLPDBLet's check online services of current PDB.
SQL> column name format a30;
SQL> column network_name format a30;
SQL> select name, network_name from v$active_services;
NAME NETWORK_NAME
------------------------------ ------------------------------
orclpdb orclpdb
ERP ERPFor RAC databases, you may see the information like this:
SQL> select inst_id, name, network_name from gv$active_services;
INST_ID NAME NETWORK_NAME
---------- ------------------------------ ------------------------------
1 orclpdb orclpdb
1 ERP ERP
2 orclpdb orclpdb
2 ERP ERPCheck Listener Again
Let's see current status of listener.
[oracle@test ~]$ lsnrctl status
...
Services Summary...
Service "ERP" has 1 instance(s).
Instance "ORCLCDB", status READY, has 1 handler(s) for this service...
Service "ORCLCDB" has 1 instance(s).
Instance "ORCLCDB", status READY, has 1 handler(s) for this service...
Service "ORCLCDBXDB" has 1 instance(s).
Instance "ORCLCDB", status READY, has 1 handler(s) for this service...
Service "aa736f65d66215cce053992aa8c08959" has 1 instance(s).
Instance "ORCLCDB", status READY, has 1 handler(s) for this service...
Service "orclpdb" has 1 instance(s).
Instance "ORCLCDB", status READY, has 1 handler(s) for this service...
The command completed successfullyWe have a new service which registers with the new listener.
Connection Test
We use SQL*Plus to test the connection from an external client.
C:\Users\edchen>sqlplus hr/hr@192.168.0.11:1521/erp
...
SQL> select count(*) from employees;
COUNT(*)
----------
107We have connected to the PDB.
Remove Service
If you want to remove the service from the PDB, you have to stop it first.
SQL> show con_name
CON_NAME
------------------------------
ORCLPDB
SQL> exec dbms_service.stop_service('ERP', DBMS_SERVICE.ALL_INSTANCES);
PL/SQL procedure successfully completed.Then delete it.
SQL> exec dbms_service.delete_service('ERP');
PL/SQL procedure successfully completed.
