Oracle DBMS_SHARDING_UPGRADE
Version 26ai

General Information
Library Note Morgan's Library Page Header
The best Oracle News for FY2026

Oracle Database 26ai is now availble. If you haven't you downloaded already: Why?
Purpose Upgrade Sharding Data Guard (SDG) to Shard Native Replication (SNR).

The ten steps required for the upgrade are detailed in the .sql source file's header.
AUTHID DEFINER
Data Types TYPE number_list IS TABLE OF NUMBER;
Dependencies
ALL_TABLES DBMS_GSM_COMMON RI_PEERS
BROKER_CONFIGS DBMS_GSM_FIXED RU_SEQUENCE
CHUNKS DBMS_GSM_UTILITY SHARD_GROUP
CHUNK_LOC DBMS_INTERNAL_TRIGGER SHARD_SPACE
CLOUD DBMS_OUTPUT V$PARAMETER
CONTAINER_DATABASE DBMS_SYS_ERROR V_$DATABASE
DATABASE REGION V_$DATAGUARD_CONFIG
DATABASE_POOL REPLICATION_UNIT V_STANDBY_LOG
DBMS_DRS    
Documented No
Exceptions
Error Code Reason
ORA-05144 Database instance is not a shard.
First Available 26ai
Pragmas SUPPLEMENTAL_LOG_DATA(default, UNSUPPORTED_WITH_COMMIT);
Security Model Owned bySYS with EXECUTE granted to the EXECUTE_CATALOG_ROLE role.
Source {ORACLE_HOME}/rdbms/admin/{ORACLE_HOME}/rdbms/admin/utlsdg2snr.sql
Subprograms
 
CHANGEDGPROTECTMODE (new 26ai)
Changes data protection mode to Max Protection in Primary shard dbms_sharding_upgrade.changedgprotectmode;
exec dbms_sharding_upgrade.changedgprotectmode;
 
CLEARDGCONFIG (new 26ai)
On Primary deletes standby logs. On Standby, cancels MRP and converts it to a primary database dbms_sharding_upgrade.cleardgconfig;
exec dbms_sharding_upgrade.cleardgconfig;
 
ISUPGRADETONATIVEREPLICATIONFEASIBLE (new 26ai)
Check whether current sharding environment is ready to upgrade to SNR dbms_sharding_upgrade.isUpgradeToNativeReplicationfeasible RETURN NUMBER;
TBD
 
RESTORESHARDINGMETADATA (new 26ai)
Restores sharding metadata dbms_sharding_upgrade.restoreShardingMetadata;
exec dbms_sharding_upgrade.restoreShardinMetadata;
 
SETUPNATIVEREPLICATIONONCATALOG (new 26ai)
Create metadata on catalog that is required for SNR dbms_sharding_upgrade.setupNativeReplicationOnCatalog(rep_units IN NUMBER DEFAULT 0);
TBD
 
SETUPNATIVEREPLICATIONONSHARD (new 26ai)
Sets SNR hidden parameters, and returns SNR metadata from the catalog, Enable the sharding trigger on all  sharded tables and starts RUs dbms_sharding_upgrade.setupNativeReplicationOnShard(shardgroup_id IN NUMBER);
TBD
 
STORESHARDINGMETADATA (new 26ai)
Stores sharding metadata dbms_sharding_upgrade.storeShardingMetadata;
exec dbms_sharding_upgrade.storeShardingMetadata;

Related Topics
Built-in Functions
Built-in Packages
Database Security
DBMS_GSM_NOPRIV
DBMS_GSM_SHDUSR
DBMS_SHARDING_DIRECTORY
What's New In 21c
What's New In 26ai

Morgan's Library Page Footer
This site is maintained by Daniel Morgan. Last Updated: This site is protected by copyright and trademark laws under U.S. and International law. © 1998-2026 Daniel A. Morgan All Rights Reserved