Purpose
ALTER SYSTEM ENABLE RESTRICTED SESSION enables restricted session mode, and ALTER SYSTEM DISABLE RESTRICTED SESSION disables restricted session mode.
After restricted session mode is enabled, the database rejects new normal connections. Only users with the RESTRICTED SESSION system privilege can log in. This mode is commonly used for access control during application upgrades and maintenance. After the upgrade or maintenance is complete, you can use ALTER SYSTEM DISABLE RESTRICTED SESSION to restore the database to normal service mode.
Note
This statement was introduced in V4.4.2 BP1.
Syntax
ALTER SYSTEM { ENABLE | DISABLE } RESTRICTED SESSION;
Parameters
Parameter |
Description |
|---|---|
| ENABLE | Enables restricted session mode. After this mode is enabled, the database rejects new normal connections. Users with the RESTRICTED SESSION system privilege can still log in. Restricted session mode remains enabled even after the tenant is restarted. |
| DISABLE | Disables restricted session mode. After this mode is disabled, the database returns to normal service mode. |
Examples
Enable restricted session mode.
obclient> ALTER SYSTEM ENABLE RESTRICTED SESSION;Disable restricted session mode.
obclient> ALTER SYSTEM DISABLE RESTRICTED SESSION;
References
- RESTRICTED SESSION privilege
- After you enable or disable restricted session mode, you can query the
LOGINScolumn of the [G]V$INSTANCE view to check the instance mode. If the value isRESTRICTED, restricted session mode is enabled.
