UNDO_RETENTION not inherited to PDBs anymore since 19.9.0

Behavior changes introduced via a bug fix may not be something you like a lot. And thanks to Sreedhar from one of our most important customers I learned on the weekend: UNDO_RETENTION not inherited to PDBs anymore since 19.9.0.

UNDO_RETENTION not inherited to PDBs anymore since 19.9.0

Photo by Ben Wicks on Unsplash

What is happening before 19.9.0?

Until Oracle 19.8.0 you could change the UNDO_RETENTION in the CDB$ROOT, and it applied to all PDBs automatically. You may or may not have cared. But there are cases when you’d like to change an undo related parameter in the CDB$ROOT without its propagation into all PDBs.



What is happening from 19.9.0 onward?

Now with the fix for BUG 30577591 – LOCAL UNDO RELATED PARAMETER VALUES AUTOMATICALLY PROPAGATING FROM ROOT TO PDBS being included in 19.9.0 and all future bundle patches for Oracle Database 19c on:

alter session set container=CDB$ROOT;
alter system set UNDO_RETENTION=5000;

will apply only to CDB$ROOT now. In the PDBs at this point the default of 900 (unless you changed it beforehand already) will be valid.

If you’d like the change to be rolled forward to all PDBs, too, then you could issue instead:

alter system set UNDO_RETENTION=5000 container=all;

This makes more sense and gives you more control. But it is a change you should be aware of.

There is not much information available on MOS except for a one-off patch available for SPARC on top of 19.8.0.

Local vs Shared Undo?

This change of course applies to (the default) local undo only. When you use shared undo as it was the only available option in Oracle 12.1 with Multitenant, then a change will implicitly apply to the PDBs as well. But I don’t think that anybody is using shared undo from Oracle on anymore since this would limit the use of key features.


To which parameters does this apply?

This is the list of parameters where the behavior has been changed from 19.9.0 onward.


Hence, if you change any of them with an ALTER SYSTEM command within the root container be aware that it won’t be propagated to the PDBs unless you use the CONTAINER=ALL clause in your ALTER SYSTEM statement. Please be aware, too, that the CONTAINER clause allows only two values: ALL and CURRENT but no list of PDBs.


Additional Information (Oct 26, 2023)

I realized that this blog post needs a slight update. After the initial fix for the base bug had been done and included into the 19.9.0 RU, there were regressions detected, mostly in the way that the command to change the value did not get propagated to the PDB correctly.

So this is the actually bug tree:

  • Base bug 30577591 => present since 19.9.0
  • Regression fix 1: 32368480 => present since 19.13.0
  • Regression fix 2: 33295267 => present since 19.13.0

This means, from 19.13.0 onward you should expect the commands and the propagation to work correctly.


Further Information and Links


Thanks Sreedhar!


Share this: