This chapter contains the requirements when capturing from an Oracle source database and replicating to a supported target database.
Prerequisite: At least the minimum level of supplemental logging must be enabled. Some SharePlex features may require PK/UK supplemental logging to be enabled.
SharePlex supports replication from Oracle to Oracle, according to the details below.
The following operating systems are supported for capture from a supported Oracle database and replication to an Oracle target database. For a list of supported source and target databases for Oracle capture, see Supported Oracle Source and Target Versions.
SharePlex supports only the 64-bit version of the listed operating systems.
Note: SharePlex supports the following operating systems and only where the version matches the Oracle certified platforms. For example, Oracle 19c supports Linux 7 and later, therefore installation of SharePlex on a system with Oracle 19c is supported only on Linux 7 and later.
Note: SharePlex supports remote replication for the Solaris 11.3 platform when the database is running on Solaris 11.3 and SharePlex is on a Linux platform.
Oracle Cloud Infrastructure
Amazon Web Services
Microsoft Azure
Azure Virtual Machine (IaaS)
1. Conditions of support - ExaCC
Issues on Oracle Exadata Cloud@Customer will be tested against Oracle Exadata Cloud Service for reproduction purposes.
2. Conditions of support - Amazon RDS for Oracle
Please see Supported Oracle Source and Target Versions for additional clarification on version compatibility.
SharePlex supports the Standard and Enterprise Editions of Oracle 11gR2, 12cR1, 12cR2, 18c, and 19c.
Notes:
SharePlex supports the following Oracle data types for replication to Oracle targets. See the Conditions of support for additional information.
Note: SharePlex supports columns that are defined as INVISIBLE.
Replication of ANYDATA is supported, except when it contains a UDT or the storage is defined as SecureFile LOB with compression. SecureFile LOB without compression is supported. Only the following data types within ANYDATA are supported by SharePlex:
SharePlex supports SecureFiles LOBs as follows:
NCLOBs are not supported by Compare/Repair if the source and target have different character sets.
SharePlex supports the replication of XMLTYPE stored as CLOB and BINARY. SharePlex does not support XMLTYPE stored as OBJECT RELATIONAL. Additionally, the following applies:
SharePlex does not support abstract data types and VARRAYs in a configuration where the SharePlex conflict resolution feature is performed.
NOTE: SharePlex replicates tables with the UDT fields in the base type ONLY. In case of columns containing multiple subtypes, replication is applicable only for base type fields.
If the precision or size of the target data type is not large enough for the data being replicated, the data may be truncated or rounded by the database when applied.
SharePlex supports replication from Oracle to PostgreSQL, according to the details below.
The following operating systems are supported for PostgreSQL Server database. SharePlex supports only the 64-bit version of the listed operating systems.
Native SharePlex installation is supported on the below platforms:
Replication can be supported on the below platforms using Remote Post from Linux:
Windows Server 2008, 2008 R2, 2012, 2012 R2, 2016, and 2019
Oracle Cloud Infrastructure
Amazon Web Services
Microsoft Azure
PostgreSQL 9.4, 9.5, 9.6, 10, 13.4, and 14.0
ODBC driver requirement: pgsql-14
How to Read the Supported Data Types Table/Grid
This section contains information about the supported data types grid that can be read vertically and horizontally to understand how SharePlex supports replication between an Oracle source and the various Open Target targets (non-Oracle targets) that SharePlex supports.
Rows spanning Column 1 and Column 2: Shows the default data type mapping (native Oracle data type to native target data type) that SharePlex uses when replicating Oracle ALTER TABLE...ADD COLUMN DDL operations. Post uses the specified native target data type in the column definition of the command on the target. The default mapping is what was tested and is supported.
| Oracle | PostgreSQL |
|---|---|
| BINARY_DOUBLE | DOUBLE PRECISION |
| BINARY_FLOAT | REAL |
| CHAR (n) | CHAR (n) |
| CHAR (n CHAR) | CHAR (n) |
| CLOB | TEXT |
| DATE | DATE |
| LONG | TEXT |
| NCHAR (n) | CHAR (n) |
| NCLOB | TEXT |
| NUMBER | NUMERIC |
| NUMBER (p,0:) | NUMERIC (p,s) |
| NUMBER (p,s) | NUMERIC |
| NVARCHAR2 (n) | VARCHAR (n) |
| TIMESTAMP (7:9) | TIMESTAMP (6) |
| TIMESTAMP (p) | TIMESTAMP (p) |
| TIMESTAMP (7:9) WITH TIME ZONE | TIMESTAMP (6) WITH TIME ZONE |
| TIMESTAMP (p) WITH TIME ZONE | TIMESTAMP (p) WITH TIME ZONE |
| TIMESTAMP (7:9) WITH LOCAL TIME ZONE | TIMESTAMP (6) |
| TIMESTAMP (p) WITH LOCAL TIME ZONE | TIMESTAMP (p) |
| VARCHAR2 (n) | VARCHAR (n) |
| VARCHAR2 (n CHAR) | VARCHAR (n) |
See Supported Data Types: Oracle to Oracle for additional conditions of support for Oracle source data types.
SharePlex supports replication from Oracle to SQL Server, according to the details below.
The following operating systems are supported for SQL Server database. SharePlex supports only the 64-bit version of the listed operating systems.
Native SharePlex installation is supported on the below platforms:
Replication can be supported on the below platforms using Remote Post from Linux:
Windows Server 2008, 2008 R2, 2012, 2012 R2, 2016, and 2019
Amazon Web Services
Amazon EC2 (IaaS) Virtual Machine
Microsoft Azure
SQL Server 2008, 2008 R2, 2012, 2014, 2016, 2017, and 2019.
ODBC driver requirement:
NOTES:
| Oracle | SQL Server |
|---|---|
| ANYDATA | VARIENT |
| BINARY_DOUBLE | FLOAT (53) |
| BINARY_FLOAT | FLOAT (24) |
| BLOB | VARBINARY (MAX) |
| CHAR (n) | CHAR (n) |
| CHAR (n CHAR) | CHAR (n) |
| CLOB | VARCHAR (MAX) |
| DATE | DATETIME2 (7) |
| LONG | VARCHAR (MAX) |
| LONGRAW | VARBINARY (MAX) |
| NCHAR (n) | NCHAR (n) |
| NCLOB | NVARCHAR (MAX) |
| NUMBER | FLOAT (53) |
| NUMBER (p,0:) | NUMERIC (p,s) |
| NUMBER (p,s) | FLOAT (53) |
| NVARCHAR2 (n) | NVARCHAR (n) |
| RAW (n) | VARBINARY (n) |
| TIMESTAMP (8:9) | DATETIME2 (7) |
| TIMESTAMP (p) | DATETIME2 (p) |
| TIMESTAMP (8:9) WITH TIME ZONE | DATETIMEOFFSET (7) |
| TIMESTAMP (p) WITH TIME ZONE | DATETIMEOFFSET (p) |
| VARCHAR2 (n) | VARCHAR (n) |
| VARCHAR2 (n CHAR) | VARCHAR (n) |
Note: To understand how to read the above grid/table, see How to read the supported data types table/grid.
See Supported Data Types: Oracle to Oracle for additional conditions of support for Oracle source data types.
SharePlex supports replication from Oracle to MySQL, according to the details below.
The following operating systems are supported for MySQL Server database. SharePlex supports only the 64-bit version of the listed operating systems.
Native SharePlex installation is supported on the below platforms:
Replication can be supported on the below platforms using Remote Post from Linux:
Windows Server 2008, 2008 R2, 2012, 2012 R2, 2016, and 2019
Amazon Web Services
Microsoft Azure
MySQL 5.5, 5.6, 5.7, and 8
ODBC driver requirement: MySQL ODBC Drivers 8.0.26 for Linux
| Oracle | MySQL |
|---|---|
| BINARY_DOUBLE 1 | DOUBLE |
| BINARY_FLOAT | DOUBLE |
| BLOB | LONGBLOB |
| CHAR (n) | CHAR (n) |
| CLOB | LONGTEXT |
| DATE | DATETIME (0) |
| LONG | LONGTEXT |
| LONGRAW | LONGBLOB |
| NUMBER | DOUBLE |
| NUMBER (p,0:) | NUMERIC (p,s) |
| NUMBER (p,s) | DOUBLE |
| RAW (n) | VARBINARY (n) |
| TIMESTAMP (7:9) 2 | DATETIME (6) |
| TIMESTAMP (p) 2 | DATETIME (p) |
| VARCHAR2 (n) | VARCHAR (n) |
Note: To understand how to read the above grid/table, see How to read the supported data types table/grid.
See Supported Data Types: Oracle to Oracle for additional conditions of support for Oracle source data types.
SharePlex for Hana is in limited support effective February 1, 2022. SharePlex supports replication from Oracle to HANA, according to the details below.
SAP HANA 1.0 SPS 11
| Oracle | HANA |
|---|---|
| BINARY_DOUBLE | DOUBLE |
| BINARY_FLOAT | DOUBLE |
| BLOB | BLOB |
| CHAR (n) | CHAR (n) |
| CLOB | CLOB |
| DATE | TIMESTAMP |
| LONG | CLOB |
| LONGRAW | BLOB |
| NCHAR (n) | NCHAR (n) |
| NCLOB | NCLOB |
| NUMBER | DECIMAL |
| NUMBER (p,0:) | DECIMAL (p,s) |
| NUMBER (p,s) | DECIMAL |
| NVARCHAR2 (n) | NVARCHAR (n) |
| RAW (n) | VARBINARY (n) |
| TIMESTAMP (p) | TIMESTAMP |
| VARCHAR2 (n) | VARCHAR (n) |
Note: To understand how to read the above grid/table, see How to read the supported data types table/grid.
See Supported Oracle Source and Target Versions for additional conditions of support for Oracle source data types.
SharePlex supports replication from Oracle to Kafka, according to the details below.
Apache Kafka 0.8.x, 0.9.x, 0.10.x, 0.11.x, 1.0.x, 1.1.x, 2.0.x, 2.1.0, 2.3.1, 2.5.0, and 3.0
Linux: When replicating data to the Kafka (Apache and Confluent) target, target SharePlex should be installed only on the Linux platform.
We test and reproduce issues against:
Apache Kafka
Confluent Kafka
Note: If you would like to use a different vendor who provides their own Kafka distribution or provides a Kafka-compliant interface, you are welcome to do so. From a support perspective, our support and development teams will share any Kafka broker errors that SharePlex receives and also ensure SharePlex itself is working properly to capture data, the target configuration formats in SharePlex are correct, and the SharePlex poster is posting or attempting to post according to the Kafka versions under support. If there are SharePlex issues with Kafka support that can be reproduced on Apache Kafka or otherwise demonstrated to be definitely associated with SharePlex, our team will address those as standard Kafka issues.
SharePlex supports replication from Oracle to Azure Event Hubs, according to the details below.
Supported message queue: Azure Event Hubs
SharePlex supports replication from Oracle to JMS Message Queues, according to the details below.
Supported JMS Message Queues
SharePlex supports replication from Oracle to File Output, according to the details below.
This mapping applies to all targets that receive messages as XML:
| Oracle | XML |
|---|---|
| BINARY_DOUBLE | decimal |
| BINARY_FLOAT | decimal |
| BLOB | base64Binary |
| CHAR | string |
| CLOB | string |
| DATE | dateTime |
| INTERVAL DAY TO SECOND | dayTimeDuration |
| INTERVAL YEAR TO MONTH | yearMonthDuration |
| LONG | string |
| NCHAR | string |
| NCLOB | string |
| NUMBER | decimal |
| NVARCHAR2 | string |
| RAW | base64Binary |
| ROWID | string |
| TIMESTAMP | dateTime |
| TIMESTAMP WITH LOCAL TIME ZONE | dateTimeStamp |
| TIMESTAMP WITH TIME ZONE | dateTimeStamp |
| VARCHAR2 | string |
| VARRAY | Post maps the data types in the source VARRAY to the appropriate XML data types. Only certain data types in a VARRAY are supported. See the conditions of support. |
Note: To understand how to read the above grid/table, see How to read the supported data types table/grid.
Only the following data types in a VARRAY are supported by SharePlex when replicating to XML output:
See Supported Oracle Source and Target Versions for additional conditions of support for Oracle source data types.
This mapping applies to all targets that receive messages as JSON:
| Oracle | JSON |
|---|---|
| BINARY_DOUBLE | Number |
| BINARY_FLOAT | Number |
| BLOB | String containing base64 encoded data |
| CHAR | String |
| CLOB | String |
| DATE | String containing date |
| INTERVAL DAY TO SECOND | String containing interval |
| INTERVAL YEAR TO MONTH | String containing interval |
| LONG | String |
| NCHAR | String |
| NCLOB | String |
| NUMBER | Number |
| NVARCHAR2 | String |
| RAW | String containing hex encoded data |
| ROWID | String |
| TIMESTAMP | String containing timestamp |
| TIMESTAMP WITH LOCAL TIME ZONE | String containing timestamp |
| TIMESTAMP WITH TIME ZONE | String containing timestamp |
| VARCHAR2 | String |
Note: To understand how to read the above grid/table, see How to read the supported data types table/grid.
See Supported Data Types: Oracle to Oracle for additional conditions of support for Oracle source data types.
Replication of LOB operations generated by dbms_lob are not supported when replicating to non-Oracle targets.
SharePlex supports DML operations on tables and sequences, with some conditions. DML can be replicated from an Oracle source to an Oracle target or an Open Target target.
Note: Replication to targets with a different character set is supported, with limitations. When posting to Open Target databases, XML files and JMS, SharePlex supports only UNICODE and US7ASCII on the target, but conversion can be performed by an Oracle client installed on the target system. For full details, see the Preinstallation Checklist in the SharePlex Installation and Setup Guide for an Oracle Source.
SharePlex supports the following DML operations on tables:
Direct-path loads (SQL*Loader) (INSERT AND FULL ROLLBACK).
Note: Replication of partial rollbacks of DLOADs is not supported.
The target table must support the column types that are being replicated from the source Oracle table.
SharePlex supports the following table types for DML operations:
|
Supported table type* |
Conditions of Support |
|---|---|
|
Regular Oracle tables |
None |
|
Index-organized tables |
SharePlex does not support:
|
|
Partitioned tables |
None |
|
Views |
None |
|
Materialized views |
SharePlex does not support replication from a materialized view to a materialized view. SharePlex can replicate the underlying table of a materialized view to a regular target table. |
SharePlex does not support the following table types:
*SharePlex does not support the following for any table type:
SharePlex supports DML operations on secured or compressed objects as described in the following table. See "Conditions of support" following this table for additional information.
| Secured/Compressed Object | Can be replicated to: | |
|---|---|---|
| DML on tables encrypted by Oracle Obfuscation Toolkit | All target types | |
|
DML on tables with Transparent Data Encryption (TDE)1 |
All target types | |
|
DML on Oracle Label Security (OLS)2 |
All target types | |
|
DML on compressed objects: Basic, Advanced Row (OLTP) Compression, HCC3 |
All target types | |
|
Direct Load (DLOAD) on compressed objects: Basic, Advanced Row (OLTP) Compression, HCC3 |
All target types |
1. Conditions of support - TDE
SharePlex supports Tablespace Encryption and Column Encryption, both source and target.
The SharePlex copy/append command does not support TDE.
TDE is not supported for sources on RDS.
SharePlex only supports the AES and DES encryption algorithms.
2. Conditions of support - OLS
By default, SharePlex cannot process rows that are protected by OLS (Oracle Label Security) because users granted DBA privileges (like SharePlex) do not have enough privileges to access those rows. However, if privilege is granted from the OLSSYS user, SharePlex can support OLS. SharePlex was tested under the following OLS configuration:
Note: If the OLS policy data label column is defined as hidden, the data in that column cannot be replicated by SharePlex.
3. Conditions of support - compression
For HCC compression: SharePlex does not support query low compression. Supported types of compression are query high, archive low and archive high.
For Advanced Row (OLTP) Compression: Under certain conditions, Oracle does not provide enough information in the redo log for SharePlex to replicate a DML operation on a OLTP compressed object. Testing of OLTP compressed objects is advised.
SharePlex provides default and optional DDL support.
Note: Support for DDL on compressed Oracle objects is limited to the following:
SharePlex does not support:
This section outlines both default and optional DDL support.
SharePlex supplies default and optional DDL replication for objects whose names are listed in the configuration file explicitly or by wildcard. See "Conditions of support" following this table for additional information.
For details about the controlling parameter, see the SharePlex Reference Guide.
| Supported object | Supported DDL Operation |
Enabled by default? |
Controlling parameter |
|---|---|---|---|
|
Table and IOT (when they exist in the source at the time of configuration activation) |
Truncate Alter to add, drop, modify columns Alter to add, modify, drop, split, coalesce, move, truncate, exchange partition or subpartition1 Drop Table |
Yes |
SP_OCT_REPLICATE_DDL=3 |
|
Table and IOT |
Create Create as Select2 |
Yes |
SP_OCT_AUTOADD_ENABLE=1 |
| Table | Alter Table Rename | Yes | SP_OCT_DDL_UPDATE_CONFIG=1 |
| Index |
Create Alter Drop |
Yes |
SP_OCT_AUTOADD_ENABLE=1 |
|
Materialized View3 |
Create Drop |
No |
SP_OCT_AUTOADD_ENABLE=1 and SP_OCT_AUTOADD_MVIEW=1 and SP_SYS_TARGET_COMPATIBILITY=8.6.2 or higher |
|
Sequences4 |
Create, Drop |
No |
SP_OCT_AUTOADD_ENABLE=1 and SP_OCT_AUTOADD_SEQ=1 and SP_SYS_TARGET_COMPATIBILITY=8.6.3 or higher |
|
Trigger |
Create, Drop |
No |
SP_OCT_REPLICATE_TRIGGER=1 |
|
Synonym |
Create, Drop |
No |
SP_OCT_REPLICATE_SYNONYM=1 |
| Grant5 | Create, Drop |
No |
SP_OCT_REPLICATE_GRANT=1 |
For CREATE MATERIALIZED VIEW the following applies:
To replicate sequences, the supplemental logging of primary and unique keys must be enabled at the database level, or you must enable supplemental logging for primary keys on the sys.seq$ table.
Amazon RDS restricts DBA users from issuing the GRANT command. Because SharePlex runs as the DBA user, SharePlex cannot replicate GRANT to or from an RDS database.
SharePlex provides expanded DDL support for Oracle objects that are not listed in the configuration file. SharePlex replicates the DDL statements for these objects, but does not maintain synchronization of the objects through DML replication. Expanded DDL replication is optional and is enabled with the following parameter setting:
SP_OCT_REPLICATE_ALL_DDL=1
Note: Expanded DDL replication supports not only tables and sequences but also a wide range of other objects such as procedures, functions, users, and views, which are not part of replication. Some of these objects may have underlying objects that are in replication. In those cases, Expanded DDL replication applies to the underlying objects in replication, as well as to the object that is not in replication.
See "Table Notes" following this table for additional information.
| Supported object | Supported Operation |
|---|---|
| Table and IOT | Create table |
| Create table as select | |
| Alter table add column | |
| Alter table drop column | |
| Drop table | |
| Truncate | |
| Comment on table | |
| Comment on columns | |
| Associate Statistics | |
| Disassociate Statistics | |
| Cluster | Create cluster |
| Crop cluster | |
| Sequence | Create |
| Drop | |
| Alter | |
|
Partition/ Subpartition |
Add |
| Split | |
| Merge | |
| Drop | |
| Modify | |
| Coalesce | |
| Exchange | |
| Move | |
| Truncate | |
| Rename | |
| Set | |
| Index | Create |
| Alter | |
| Drop | |
| View | Create |
| Alter | |
| Drop | |
| Comment on view | |
| Synonym | Create |
| Drop | |
| Directory1 | Create |
| Drop | |
| User-defined type | Create type |
| Alter type | |
| Drop type | |
| Create type body | |
| Drop type body | |
| Stored procedure | Create |
| Alter | |
| Drop | |
| Stored function | Create |
| Alter | |
| Drop | |
| Package | Create package |
| Create package body | |
| Alter package | |
| Alter package body | |
| Drop package | |
| Drop package body | |
| User | Create user |
| Alter user | |
| Drop user | |
| Grant1 | |
| Revoke | |
| Role | Create role |
| Alter role | |
| Drop role | |
| Grant1 | |
| Revoke |
Table Notes:
Amazon RDS restricts DBA users from issuing certain commands on an Amazon RDS database instance. Because SharePlex runs as the DBA user, SharePlex cannot replicate the following commands to or from an RDS database:
SharePlex provides limited DDL support for replication from Oracle to Open Target. The involved objects must be listed in the active configuration file explicitly or with a wildcard. There is no optional DDL support for replication from Oracle to Open Target.
The default Oracle to Open Target configuration is represented by the following parameter setting:
SP_OCT_REPLICATE_DDL=3
See "Table Notes" following this table for additional information.
| Supported object | Supported Operation |
|---|---|
| Table and IOT | Truncate1 |
| Alter table add column2 | |
| Alter table drop column |
Table Notes:
TRUNCATE TABLE is not supported from Oracle compressed objects to Open Target targets.
The default mappings of Oracle data types to their Open Target counterpart for replicated ALTER TABLE ADD COLUMN DDL is shown in Supported Operating Systems for Oracle . When SharePlex adds the column, it defines it with the default data type. This mapping applies to the entire configuration (not per table).
This is a list of commonly used Oracle features which SharePlex does not replicate and are not listed elsewhere in this document. Since both Oracle and SharePlex continually change and improve, this list of exclusions cannot be considered complete. Unless an item is stated here as being supported, assume that SharePlex does not replicate it.
| Object/operation/feature | Not supported |
|---|---|
| Oracle operations | Operations that do not appear in the redo logs. This includes any DML or DDL not in the redo logs, and also PL/SQL packages which do not write results to the redo logs, for example, dbms_shared_pool.keep and related packages. |
|
dbms_scheduler.create_job |
This object is not supported. |
| Flashback |
SharePlex does not support the Oracle Flashback Table feature. If the SP_REPLICATE_ALL_DDL parameter is enabled (value of 1), SharePlex may try to replicate the flashback DDL, which will return an error. To perform Flashback Table on a table that is in replication, use the following procedures
|
The following table shows whether specific SharePlex features are supported for replication from Oracle to Open Target targets.
| SharePlex feature | Supported for Open Target | Not Supported for Open Target |
|---|---|---|
| reconcile command (target instantiation) | X | |
| compare/compare using and repair/repair using commands | X | |
| copy/copy using and append/append using commands | X | |
| Hash horizontally partitioned replication | X | |
| Column-based horizontally partitioned replication | X | |
| Vertically partitioned replication | X | |
| Column mapping | X | |
| Key definition | X | |
| Build configuration with scripts | X | |
| Named queues | X | |
| Commit Reduction (feature of Post Enhanced Performance) | X | |
| Dependency Checking (feature of Post Enhanced Performance) | X | |
| Transformation | X | |
| Conflict resolution | X | |
| Peer-to-peer replication (bi-directional) | X | |
| Consolidated replication (many to one) | X | |
| Broadcast replication (one to many) | X | |
| High availability replication (active/passive bi-directional) | X | |
| Change tracking target (CDC) | X | |
| Data encryption | X | |
| Data compression | X | |
| SSH | X | |
| auth_hosts file | X | |
| Monitoring scripts | X | |
| SNMP monitoring | X | |
| Continue posting on error (SP_OPX_CONT_ON_ERR) | X | |
| Suspend on out of sync errors (SP_OPX_OUT_OF_SYNC_SUSPEND) | X | |
| Reduced key (SP_OPX_REDUCED_KEY) | X | |
| Logical Transaction Rollback on out-of-sync transactions | X |
This chapter contains the requirements when capturing OLTP compressed data from an Oracle source database and replicating it to a supported target database.
The following operating systems are supported for capture from a supported Oracle database and replication to a supported target database.
SharePlex supports only the 64-bit version of the listed operating systems.
NOTE: For OLTP, SharePlex supports the following operating systems only.
Note: OLTP patch for the Windows operating system is not available from Oracle. Oracle has planned to release it in July 2021.
SharePlex supports Oracle 19c database version for replicating the OLTP compressed data.
© 2024 Quest Software Inc. ALL RIGHTS RESERVED. 使用条款 隐私 Cookie Preference Center
