Delphix Continuous Data Engine 2026.6.0.0 and later automatically detects Oracle Data Guard configurations and models each one as a Data Guard group. You choose which database role SnapSync continues from: primary, standby, or no preference. After a switchover or failover, the next SnapSync detaches the dSource and reattaches it to the member that now holds the chosen role, unless syncFrom is NO_PREFERENCE or the group is disabled. A dSource linked to a CDB is not moved.
For example, you can configure SnapSync to always run from the physical standby database, which offloads backup I/O from the production primary. After a planned or unplanned role change, Delphix follows the correct member on the next SnapSync.
This feature is always on and changes the behavior of existing dSources on Data Guard databases. Upgrading does not create Data Guard groups. Delphix creates the group for an existing dSource the next time you refresh its environment, link another dSource in the same Data Guard configuration, or run refreshDgRoles. SnapSync does not create groups. Detection during an environment refresh requires the environment OS user to be a member of the OSDBA or OSBACKUPDBA group. When Delphix creates the group during an environment refresh, it sets syncFrom to the role of the database that's already linked. When it creates the group while linking a dSource or running refreshDgRoles, it sets syncFrom to the role of the database you link or run refreshDgRoles on. Delphix does not change syncFrom afterward. After a later switchover or failover, SnapSync moves the dSource to the member that holds that original role, which earlier versions did not do. See Create the Data Guard group for a dSource linked before the upgrade.
Setting syncFrom to NO_PREFERENCE or enabled to false takes effect immediately but does not last. A disabled group is re-enabled the next time Delphix detects the group during an environment refresh. Linking a dSource to a database that Delphix hasn't yet added to the group can also re-enable it; linking a database that's already in the group does not. If a member of the group is linked as a dSource, Delphix also replaces NO_PREFERENCE with the current role of a linked member the next time it detects the group during an environment refresh, when a dSource is linked, or when you run refreshDgRoles on a linked member while the group is enabled. For a CDB, only a linked PDB in that CDB counts as linked; a dSource linked to the CDB itself does not. For more information, see Configure and manage Oracle Data Guard groups.
Key concepts
|
Concept |
Description |
|---|---|
|
Data Guard group |
Delphix object that represents one Oracle Data Guard configuration. Delphix names the group |
|
Member |
Database in a Data Guard group. Each member has one of the following roles:
|
|
Resolved and unresolved members |
A member is resolved when its environment has been added to the Delphix Engine. A member is unresolved when Delphix knows it only by its |
|
Sync-from role ( |
Group setting that controls which member SnapSync continues from:
|
|
Enabled ( |
Group setting that turns Data Guard-aware SnapSync on or off. When a group is disabled, SnapSync behaves as if the group does not exist. A disabled group is re-enabled the next time Delphix detects the group during an environment refresh. Linking a dSource to a database that Delphix hasn't yet added to the group can also re-enable it; linking a database that's already in the group does not. |
|
PDBs |
A PDB is never a member of a Data Guard group. PDB dSources are associated with their CDB's group and follow the CDB. |
When roles are re-read and when the dSource moves
Several operations re-read member roles, but only SnapSync moves the dSource to the member that holds the syncFrom role.
|
Operation |
Re-reads all member roles? |
Moves dSource to the |
|---|---|---|
|
SnapSync |
Yes, when the group is enabled and |
Yes, when the group is enabled and |
|
Environment refresh |
Yes |
No |
|
|
Yes, when the group is enabled |
No |
|
LogSync |
Reads only the currently connected database's role |
No — raises WARNING fault "LogSync DG role mismatch detected (pending SnapSync)" |
"Environment refresh" in this topic means the Refresh action in the UI, CLI, or API. Adding an environment and the lightweightDiscover API operation also detect Data Guard. Automatic host refreshes, such as those after an upgrade or when an environment is enabled, don't.
How Delphix detects a Data Guard configuration
Delphix detects Data Guard configurations in two ways.
When you add or refresh an environment
-
Delphix connects to each database by OS authentication and reads its Data Guard role and configuration from
v$databaseandv$dataguard_config. -
The environment OS user must belong to the OSDBA or OSBACKUPDBA group, which provides SYSDBA or SYSBACKUP access. If it does not, Delphix skips Data Guard detection for that database without raising an error. If Delphix has not yet checked the OS user's privileges for that Oracle home, it skips the database and the job shows a warning that SYSDBA or SYSBACKUP is required.
-
VDBs and auxiliary CDBs are excluded from detection. PDBs are not detected separately; they are covered through their CDB.
-
Members whose environments have not been added to the Delphix Engine are added as unresolved members.
When you link a dSource
-
Delphix parses the
DG_CONFIGvalue of theLOG_ARCHIVE_CONFIGparameter. -
Delphix connects to each peer database listed in DG_CONFIG. Peers whose environments haven't been added to the Delphix Engine, are disabled, or can't be reached are skipped.
-
Delphix creates a group only if at least two members, including the linked database, are reachable. Linking a dSource to a CDB alone does not create a group; a PDB in that CDB, or in another CDB in the same Data Guard configuration, must be linked.
Group lifecycle
-
Creation: Delphix creates Data Guard groups automatically when it detects a configuration.
-
Role updates: Delphix updates member roles at environment refresh, at dSource link, when you run
refreshDgRoles(when the group is enabled), and at SnapSync (when the group is enabled andsyncFromisPRIMARYorSTANDBY). -
Automatic deletion: Delphix deletes a group when
DG_CONFIGis removed or when the group drops below two members. -
Deletion with a dSource: Delphix deletes a group when the dSource of any member is deleted, including a PDB dSource whose CDB is a member. It re-creates the group at the next environment refresh, dSource link, or
refreshDgRoles. -
Re-created groups: A group that Delphix re-creates after any deletion uses default settings, so you must reapply any changes you made to
syncFrom,skipFullSync,description, orenabled. -
Re-enabling: A disabled group is re-enabled the next time Delphix detects the group during an environment refresh. Linking a dSource to a database that Delphix hasn't yet added to the group can also re-enable it; linking a database that's already in the group does not.
Prerequisites
-
Each Oracle database must have a unique
DB_UNIQUE_NAMEacross all environments added to the Delphix Engine. Do not add environments whose databases share aDB_UNIQUE_NAME. -
The environment OS user must belong to the OSDBA or OSBACKUPDBA group for Data Guard detection to run on a database when you add or refresh an environment.
-
At least two eligible members must be reachable for a group to be created when you link a dSource.
-
API version 1.11.50 or later is required for
dataguardInfo. API version 1.11.52 or later is required fordataguardGroupRefand the Data Guard group list endpoints.
Supported configurations and limitations
-
Single-instance, RAC, and CDB databases can be Data Guard group members. PDB dSources follow their CDB.
-
Only
PRIMARYand physical standby members are eligible for SnapSync. Logical, snapshot, and far-sync standbys have the roleINVALIDand are never selected. -
Data Guard groups are managed through the Delphix Engine API and CLI only. There is no Delphix Engine UI.
-
Data Guard support in DCT (API and UI) will be available in the DCT 2026.6.0 release.
-
dataguardInfois returned only when you get a single source config. It is not returned by the source config list endpoint. -
A dSource linked to a CDB is not moved by SnapSync. Non-multitenant and PDB dSources are moved. A PDB dSource moves to the PDB with the same name in the target CDB. If the target CDB has no PDB with that name, the dSource is not moved.
-
When SnapSync moves a PDB dSource to a CDB that is not yet linked, Delphix links that CDB automatically, so a new CDB dSource appears.
-
If a dSource link or
refreshDgRolesfails with an error that a database "already belongs to a different DataGuard group" or "already belongs to an existing DataGuard group", check that every database has a uniqueDB_UNIQUE_NAMEacross all environments, and that the database is not still configured in another Data Guard configuration.