Platforms and operating systems that have been deprecated in version 11.0:
CentOS Linux 5.x, 6.x
Oracle Linux (RHCK and UEK) 5.x, 6.x
RHEL 5.x, 6.x
SuSE SLES 11.x
Oracle Solaris SPARC 10 and 11.3
Oracle Solaris x86 10, 11.0, and 11.3
Note: While SharePlex 11.0 only supports installation on Unix and Linux platforms, a version that supports Windows will be provided in the future. As such, the Windows platform is not considered deprecated. In most cases, replication for systems running on Windows is supported through remote replication. Please see Source and Target System Requirements and Data Types for details.
Planned platform deprecation in future releases:
No platforms are anticipated to be deprecated at this time.
This chapter contains the basic system requirements for SharePlex. See also: Source and Target System Requirements and Data Types
Before installing SharePlex, ensure that your system meets the minimum hardware and software requirements.
For TLS connections, SharePlex supports TLS 1.2 or 1.3 only.
NOTE: TLS 1.3 is supported only on the Linux platform.
SharePlex supports IPv4 and IPv6 internet protocols. The following table shows the operating systems for which SharePlex was tested with IPv6.
|
Operating System |
Source |
Target |
SharePlex versions |
On-premises |
Cloud |
|---|---|---|---|---|---|
|
Linux RHEL 7 |
Link-Local IPV6 |
Link-Local IPV6 |
11.0 |
√ |
√ |
|
Linux RHEL 8 |
Link-Local IPV6 |
Link-Local IPV6 |
11.0 |
√ |
√ |
|
HP UA |
Link-Local IPV6 |
Link-Local IPV6 |
11.0 | √ | √ |
|
HP IA |
Link-Local IPV6 |
Link-Local IPV6 |
11.0 | √ | √ |
|
SUN Sparc |
Link-Local IPV6 |
Link-Local IPV6 |
11.0 | √ | √ |
|
SUN Solaris |
Link-Local IPV6 |
Link-Local IPV6 |
11.0 | √ | √ |
|
AIX |
Link-Local IPV6 |
Link-Local IPV6 |
11.0 | √ | √ |
Refer to the following guidelines if the system where you are installing SharePlex is in a configuration where one or more other systems will continue to use an older version of SharePlex. An example is when installing or upgrading SharePlex on a target, but the source will continue to use SharePlex 9.4.x/10.x.
Versions with full interoperability
Note: SharePlex 10.2 and above versions are not interoperable with older versions than 10.2 when using Extended Data Types and TLS 1.3.
The following SharePlex versions are fully interoperable, including the Compare/Repair feature:
To support replication from a higher to a lower version, set the SP_SYS_TARGET_COMPATIBILITY parameter on the source system to the lower SharePlex version. If Capture is running, restart it.
Important: Downgrading from a higher to a lower version of SharePlex is not supported.
|
Notes:
|
To reset SP_OCT_TARGET_COMPATIBILITY:
sp_ctrl> stop capture
In sp_ctrl on the source system, issue the following command:
sp_ctrl>reset param SP_OCT_TARGET_COMPATIBILITY
Restart Capture.
sp_ctrl>start capture
This chapter contains the requirements when capturing from various source databases and replicating to supported target databases.
The following table provides information about the supported source and target database combinations.
| Target databases | Oracle (Source) | PostgreSQL (Source) |
|---|---|---|
| Oracle | √ | √ |
| PostgreSQL | √ | √ |
| SQL Server | √ | √ |
| JMS | √ | X |
| Azure Event Hub | √ | X |
| Hana | √ | X |
| MySQL | √ | X |
| Kafka | √ | √ |
| File Output | √ | X |
| Snowflake | √ | √ |
This chapter contains the requirements when capturing from an Oracle database and replicating to supported target databases.
Prerequisite: At least the minimum level of supplemental logging must be enabled. Some SharePlex features may require PK/UK supplemental logging to be enabled.
This section contains the requirements for an Oracle database as a source when capturing from an Oracle database and replicating to supported target databases.
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 Source and Target Combinations.
SharePlex supports only the 64-bit version of the listed operating systems.
Supported operating systems via native installation:
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.
AIX 7.1, 7.2, and 7.3
CentOS Linux 7.x and 8.x
HP-UX 11.31 Itanium
Oracle Linux (RHCK and UEK) 7.x and 8.x
Oracle Solaris SPARC 11.4
Oracle Solaris x86 11.4
RHEL 7.x and 8.x
SuSE SLES 12.x and 15.x
Supported operating systems via remote replication:
All platforms listed above, plus Windows Server 2016 and 2019, are supported via remote replication.
| Important! SharePlex 11.0 can only be installed on Unix and Linux platforms.
A SharePlex version that can be installed on Windows will be supported in a future version. Customers with database platforms that run on Windows should consult the Installation and Setup for Remote Capture and Run database setup for Oracle remote capture sections from the Installation and Setup Guide for an Oracle Source for the Capture process and the Replicate to a remote target system section from the SharePlex Admin Guide for the Poster process that describe support for remote replication scenarios that may address your particular platform requirements. |
SharePlex supports the Standard and Enterprise Editions of Oracle 12cR1, 12cR2, 18c, and 19c.
Notes:
|
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.
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
|
Notes about open target data type support
Replication of LOB operations generated by dbms_lob are not supported when replicating to non-Oracle targets.
SharePlex does not support the replication of data from Oracle to open targets for the below Extended Data Types:
The following table shows whether specific SharePlex features are supported for replication from Oracle to open targets.
| SharePlex feature | Supported open targets |
|---|---|
| reconcile command (target instantiation) | All |
| compare/compare using and repair/repair using commands | Not supported |
| copy/copy using and append/append using commands | Not supported |
| Hash horizontally partitioned replication | All |
| Column-based horizontally partitioned replication | All |
| Vertically partitioned replication | All |
| Column mapping | All |
| Key definition | All |
| Build configuration with scripts | Not supported |
| Named queues | All |
| Commit Reduction (feature of Post Enhanced Performance) | All |
| Dependency Checking (feature of Post Enhanced Performance) | Not supported |
| Transformation | Not supported |
| Conflict resolution |
PostgreSQL |
| Peer-to-peer replication (bi-directional) | PostgreSQL |
| Consolidated replication (many to one) | All |
| Broadcast replication (one to many) | All |
| High availability replication (active/passive bi-directional) | PostgreSQL |
| Change tracking target (CDC) | Not supported |
| Data encryption | All |
| Data compression | All |
| SSH | All |
| auth_hosts file | All |
| Monitoring scripts | All |
| SNMP monitoring | All |
| Continue posting on error (SP_OPX_CONT_ON_ERR) | All |
| Suspend on out of sync errors (SP_OPX_OUT_OF_SYNC_SUSPEND) | All |
| Reduced key (SP_OPX_REDUCED_KEY) | All |
| Logical Transaction Rollback on out-of-sync transactions | Not supported |
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.
For OLTP, SharePlex supports the following operating systems only:
CentOS Linux 7.x and 8.x
SuSE SLES 12.x and 15.x
HP-UX 11.31 Itanium
SharePlex supports the Standard and Enterprise Editions of Oracle 12cR1, 12cR2, 18c, and 19c for replicating the OLTP compressed data.
SharePlex supports DML operations on tables and sequences, with some conditions. DML can be replicated from an Oracle source to an Oracle or an open 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.
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.
Important: Shareplex does not support OLS policy configuration changes on tables during active replication. Users need to apply these configurations before activating the configuration.
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: ALTER TABLE to ADD COLUMN and ALTER TABLE to DROP COLUMN are supported on Basic, Advanced Row (OLTP) Compression, and HCC compressed Oracle objects for replication to all Oracle and open targets. |
SharePlex does not support:
SharePlex provides limited DDL support for replication from Oracle to open targets. 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 cross platforms.
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:
|
SharePlex supports replication from Oracle to Azure Event Hubs, according to the details below.
SharePlex replicates remotely to the Azure Event Hubs service. Remote replication from the following operating systems is supported:
CentOS Linux 7.x and 8.x
Oracle Linux (RHCK and UEK) 7.x and 8.x
RHEL 7.x, and 8.x
SuSE SLES 12.x and 15.x
Note: SharePlex supports only the 64-bit version of the listed operating systems.
Supported platform as a service: Azure Event Hubs
SharePlex supports DML operations on tables and sequences, with some conditions. DML can be replicated from an Oracle source to an Azure Event Hubs target. For additional information, see Supported Operations and Objects for DML Replication.
SharePlex supports DDL operations on tables and sequences, with some conditions. DDL can be replicated from an Oracle source to an Azure Event Hubs target. For additional information, see Oracle to open target DDL support.
SharePlex supports replication from Oracle to File Output, according to the details below.
Supported operating systems via native installation:
AIX 7.1, 7.2, and 7.3
CentOS Linux 7.x and 8.x
HP-UX 11.31 Itanium
Oracle Linux (RHCK and UEK) 7.x and 8.x
Oracle Solaris SPARC 11.4
Oracle Solaris x86 11.4
RHEL 7.x and 8.x
SuSE SLES 12.x and 15.x
NOTE: SharePlex supports only the 64-bit version of the listed operating systems.
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. |
Only the following data types in a VARRAY are supported by SharePlex when replicating to XML output:
See Conditions of support for the additional conditions of support for the above-mentioned supported 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 |
Conditions of support: See Conditions of support for the conditions of support for the above-mentioned supported data types.
SharePlex supports DML operations on tables and sequences, with some conditions. DML can be replicated from an Oracle source to a File Output target. For additional information, see Supported Operations and Objects for DML Replication.
SharePlex supports DDL operations on tables and sequences, with some conditions. DDL can be replicated from an Oracle source to a File Output target. For additional information, see Oracle to open target DDL support.
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
SharePlex supports the following data types for replication from Oracle to Hana:
| 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) |
Conditions of support: See Conditions of support for the conditions of support for the above-mentioned supported data types.
SharePlex supports DML operations on tables and sequences, with some conditions. DML can be replicated from an Oracle source to a Hana target. For additional information, see Supported Operations and Objects for DML Replication.
SharePlex supports DDL operations on tables and sequences, with some conditions. DDL can be replicated from an Oracle source to a Hana target. For additional information, see Oracle to open target DDL support.
SharePlex supports replication from Oracle to JMS Message Queues, according to the details below.
Native SharePlex installation is supported on the below operating systems:
AIX 7.1 and 7.2
CentOS Linux 7.x and 8.x
HP-UX 11.31 Itanium
Oracle Linux (RHCK and UEK) 7.x and 8.x
Oracle Solaris SPARC 11.4
Oracle Solaris x86 11.4
RHEL 7.x, and 8.x
SuSE SLES 12.x and 15.x
Note: SharePlex supports only the 64-bit version of the listed operating systems.
SharePlex supports DML operations on tables and sequences, with some conditions. DML can be replicated from an Oracle source to a JMS Message Queues target. For additional information, see Supported Operations and Objects for DML Replication.
SharePlex supports DDL operations on tables and sequences, with some conditions. DDL can be replicated from an Oracle source to a JMS Message Queue target. For additional information, see Oracle to open target DDL support.
SharePlex supports replication from Oracle to Kafka, according to the details below.
Supported operating systems via native installation:
CentOS Linux 7.x and 8.x
Oracle Linux (RHCK and UEK) 7.x and 8.x
RHEL 7.x, and 8.x
SuSE SLES 12.x and 15.x
Remote replication from the following operating systems is supported:
CentOS Linux 7.x and 8.x
Oracle Linux (RHCK and UEK) 7.x and 8.x
RHEL 7.x, and 8.x
SuSE SLES 12.x and 15.x
Note: SharePlex supports only the 64-bit version of the listed operating systems.
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
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 DML operations on tables and sequences, with some conditions. DML can be replicated from an Oracle source to a Kafka target. For additional information, see Supported Operations and Objects for DML Replication.
SharePlex supports DDL operations on tables and sequences, with some conditions. DDL can be replicated from an Oracle source to a Kafka target. For additional information, see Oracle to open target DDL support.
SharePlex supports replication from Oracle to MySQL, according to the details below.
Supported operating systems via native installation:
RHEL 7.x and 8.x
Remote replication from the following operating systems is supported:
RHEL 7.x and 8.x
Supported target operating systems via remote replication:
AIX 7.1, 7.2, and 7.3
CentOS Linux 7.x and 8.x
HP-UX 11.31 Itanium
Oracle Linux (RHCK and UEK) 7.x and 8.x
Oracle Solaris SPARC 11.4
Oracle Solaris x86 11.4
RHEL 7.x and 8.x
SuSE SLES 12.x and 15.x
Windows Server 2016 and 2019
Note: SharePlex supports only the 64-bit version of the listed operating systems.
MySQL 5.5, 5.6, 5.7, and 8
ODBC driver requirement: MySQL ODBC Drivers 8.0.26 for Linux
Amazon Web Services
Microsoft Azure
SharePlex supports the following data types for replication from Oracle to MySQL:
| 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) |
See Conditions of support for the additional conditions of support for the above-mentioned supported data types.
SharePlex supports DML operations on tables and sequences, with some conditions. DML can be replicated from an Oracle source to a MySQL target. For additional information, see Supported Operations and Objects for DML Replication.
SharePlex supports DDL operations on tables and sequences, with some conditions. DDL can be replicated from an Oracle source to a MySQL target. For additional information, see Oracle to open target DDL support.
SharePlex supports replication from Oracle to Oracle, according to the details below.
Supported operating systems via native installation:
AIX 7.1, 7.2, and 7.3
CentOS Linux 7.x and 8.x
HP-UX 11.31 Itanium
Oracle Linux (RHCK and UEK) 7.x and 8.x
Oracle Solaris SPARC 11.4
Oracle Solaris x86 11.4
RHEL 7.x and 8.x
SuSE SLES 12.x and 15.x
Remote replication from the following operating systems is supported:
AIX 7.1, 7.2, and 7.3
CentOS Linux 7.x and 8.x
HP-UX 11.31 Itanium
Oracle Linux (RHCK and UEK) 7.x and 8.x
Oracle Solaris SPARC 11.4
Oracle Solaris x86 11.4
RHEL 7.x and 8.x
SuSE SLES 12.x and 15.x
Supported target operating systems via remote replication:
All platforms listed above, plus Windows Server 2016 and 2019, are supported via remote replication.
Note: SharePlex supports only the 64-bit version of the listed operating systems.
SharePlex supports the Standard and Enterprise Editions of Oracle 12cR1, 12cR2, 18c, and 19c.
Notes:
|
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 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.
1. Conditions of support - ANYDATA
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:
2. Conditions of support - LONG and LOB (BLOB, CLOB)
SharePlex supports SecureFiles LOBs as follows:
3. Conditions of support - NCLOB
NCLOBs are not supported by Compare/Repair if the source and target have different character sets.
4. Conditions of support - XMLTYPE
SharePlex supports the replication of XMLTYPE stored as CLOB and BINARY. SharePlex does not support XMLTYPE stored as OBJECT RELATIONAL. Additionally, the following applies:
5. User-defined types
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.
6. General
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.
7. BINARY DOUBLE and BINARY FLOAT
The BINARY DOUBLE and the BINARY FLOAT data types are not supported for the copy command.
8. Extended Data Types
SharePlex provides default and optional DDL support.
|
Note: ALTER TABLE to ADD COLUMN and ALTER TABLE to DROP COLUMN are supported on Basic, Advanced Row (OLTP) Compression, and HCC compressed Oracle objects for replication to all Oracle and open targets. |
SharePlex does not 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 supports DML operations on tables and sequences, with some conditions. DML can be replicated from an Oracle source to an Oracle target. For additional information, see Supported Operations and Objects for DML Replication.
SharePlex supports replication from Oracle to PostgreSQL, according to the details below.
Supported operating systems via native installation:
RHEL 7.x and 8.x
Remote replication from the following operating systems is supported:
RHEL 7.x and 8.x
Supported target operating systems via remote replication:
All platforms listed above, plus Windows Server 2016 and 2019, are supported via remote replication.
Note: SharePlex supports only the 64-bit version of the listed operating systems.
PostgreSQL 9.4, 9.5, 9.6, 10, 13.4, 13.6, and 14.1
ODBC driver requirement: pgsql- 13.x and 14.x
Oracle Cloud Infrastructure
Amazon Web Services
Microsoft Azure
SharePlex supports the following data types for replication from Oracle to PostgreSQL:
| 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) |
| BLOB | BYTEA |
Conditions of support: See Conditions of support for the conditions of support for the above-mentioned supported data types.
SharePlex supports DML operations on tables and sequences, with some conditions. DML can be replicated from an Oracle source to a PostgreSQL target. For additional information, see Supported Operations and Objects for DML Replication.
SharePlex supports DDL operations on tables and sequences, with some conditions. DDL can be replicated from an Oracle source to a PostgreSQL target. For additional information, see Oracle to open target DDL support.
SharePlex supports replication from Oracle to Snowflake, according to the details below.
SharePlex replicates remotely to Snowflake. Remote replication from the following operating systems is supported:
Red Hat Linux version 7.x, 8.x
Note: SharePlex Snowflake supports only the 64-bit version of the listed operating systems.
Snowflake 6.31 Enterprise, Community version
ODBC driver requirement: Snowflake 2.24.2
| Limitations:
The following ODBC driver related limitations are observed while replicating data from Oracle to Snowflake:
|
SharePlex supports the following data types for replication from Oracle to Snowflake:
| Oracle | Snowflake |
|---|---|
| CLOB | TEXT |
| NUMBER | INT, INTEGER, NUMBER |
| CHAR(n) | VARCHAR(n) |
| CLOB | VARCHAR(n) |
| NCHAR | CHAR(n) |
| VARCHAR2(n) | VARCHAR(n) |
| CLOB | VARCHAR(n) |
| NCLOB | TEXT |
| CLOB | VARCHAR(n) |
| LONG | TEXT |
| BLOB | BINARY, VARBINARY |
| RAW(n) | VARBINARY |
| LONGRAW | VARBINARY |
| BINARY_FLOAT | REAL |
| NUMBER | SMALLINT |
| NUMBER | BIGINT |
| NUMBER | NUMERIC, DECIMAL |
| DATE | DATE |
| BINARY_DOUBLE | DOUBLE PRECISION |
| TIMESTAMP | TIMESTAMP |
| TIMESTAMP_TZ | TIMESTAMP_TZ |
Note: It is anticipated that the Snowflake DB's default "HEX" format for binary type will be maintained for Oracle binary to Snowflake binary data type replication. Since source Oracle DB binary data is stored only in "HEX" format, Shareplex does not guarantee data integrity for any other format.
Char(n) data type - In Oracle, Char(n) is a fixed-size data type. If you insert char data with a length less than "n" into the "Char(n)" column, the remaining slots (n - length) are padded with space to occupy the complete "n" memory positions. Snowflake uses VARCHAR(n) for char storage since Snowflake lacks a comparable fixed-length character data type and only saves char data up to its length. Live replication will ensure that char column data is correctly copied. However, if users are manually inserting data into Snowflake for the equivalent of a Char(n) Oracle column, then the user will need to handle padding as well to occupy the full "n" length so that data will be in sync in both the source and target DB.
Binary & Text data types - Snowflake Binary & Text data types have size limitation of 8 MB, so Oracle’s advance Data type replication will be restricted to max 8 MB size limit of equivalent counterpart. Refer table below.
| Oracle Data type | Max Size | Snowflake Data type | Max Size |
|---|---|---|---|
| LONG | 2 GB | TEXT | 8 MB of unicode chars |
| CLOB | 4 GB | TEXT | 8 MB of unicode chars |
| LONGRAW | 2 GB | BINARY or VARBINARY | 8 MB |
| BLOB | 4 GB | BINARY or VARBINARY | 8 MB |
See Conditions of support for the additional conditions of support for the above-mentioned supported data types.
SharePlex supports DML operations on tables, with some conditions. DML can be replicated from an Oracle source to a Snowflake target.
SharePlex supports the following DML operations on tables when replicating data from an Oracle source to the Snowflake target:
Singular and bulk operation - Insert with key(s)/ non key(s)
Singular and bulk operation - Update with key(s)/ non key(s)
Singular and bulk operation - Delete with key(s)/ non key(s)
| Limitations:
The following DML operations related limitations are observed while replicating data from Oracle to Snowflake:
|
For additional information, see Supported Operations and Objects for DML Replication.
SharePlex does not support DDL operations and objects when replicating data from an Oracle source to a Snowflake target.
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.
Supported operating systems via native installation:
RHEL 7.x and 8.x
Remote replication from the following operating systems is supported:
RHEL 7.x and 8.x
Supported target operating systems via remote replication:
All platforms listed above, plus Windows Server 2016 and 2019, are supported via remote replication.
SQL Server 2008, 2008 R2, 2012, 2014, 2016, 2017, and 2019
ODBC driver requirement:
Amazon Web Services
Amazon EC2 (IaaS) Virtual Machine
Microsoft Azure
SharePlex supports the following data types for replication from Oracle to SQL Server:
| 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) |
Conditions of support: See Conditions of support for the conditions of support for the above-mentioned supported data types.
SharePlex supports DML operations on tables and sequences, with some conditions. DML can be replicated from an Oracle source to an SQL Server target. For additional information, see Supported Operations and Objects for DML Replication.
SharePlex supports DDL operations on tables and sequences, with some conditions. DDL can be replicated from an Oracle source to an SQL Server target. For additional information, see Oracle to open target DDL support.
This chapter contains the requirements when capturing from a PostgreSQL database and replicating to supported target databases.
This section contains the requirements for a PostgreSQL database as a source when capturing from a PostgreSQL database and replicating to supported target databases.
The following operating systems are supported for capture from a supported PostgreSQL database and replication to supported target database. For a list of supported source and target databases for PostgreSQL capture, see Supported Source and Target Combinations.
SharePlex supports only the 64-bit version of the listed operating systems.
Supported operating systems via native installation
RHEL 7.x and 8.x
PostgreSQL 13.x and 14.x
ODBC driver requirement: pgsql- 13.x and 14.x
Amazon Web Services:
Amazon EC2 (IaaS) Virtual Machine
Microsoft Azure:
Azure Virtual Machine (IaaS)
The following table shows whether specific SharePlex features are supported for replication from PostgreSQL to Oracle and open targets .
| SharePlex feature | Supported targets |
|---|---|
| reconcile command (target instantiation) | Oracle, PostgreSQL |
| compare/compare using and repair/repair using commands | Not supported |
| copy/copy using and append/append using commands | Not supported |
| Hash horizontally partitioned replication | PostgreSQL |
| Column-based horizontally partitioned replication | PostgreSQL |
| Vertically partitioned replication | PostgreSQL, Oracle |
| Column mapping | PostgreSQL, Oracle, SQL Server, Kafka, Snowflake |
| Key definition | PostgreSQL, Oracle |
| Build configuration with scripts | Not supported |
| Named queues | PostgreSQL, Oracle, SQL Server, Kafka, Snowflake |
| Commit Reduction (feature of Post Enhanced Performance) | PostgreSQL, Oracle, SQL Server, Kafka, Snowflake |
| Dependency Checking (feature of Post Enhanced Performance) | Not supported |
| Transformation | Not supported |
| Conflict resolution |
PostgreSQL, Oracle |
| Peer-to-peer replication (bi-directional) | PostgreSQL, Oracle |
| Consolidated replication (many to one) | PostgreSQL, Oracle, SQL Server, Kafka, Snowflake |
| Broadcast replication (one to many) | PostgreSQL, Oracle, SQL Server, Kafka, Snowflake |
| High availability replication (active/passive bi-directional) | Not supported |
| Change tracking target (CDC) | Not supported |
| Data encryption | Not supported |
| Data compression | Not supported |
| SSH | PostgreSQL, Oracle, SQL Server, Kafka, Snowflake |
| auth_hosts file | Not supported |
| Monitoring scripts | Not supported |
| SNMP monitoring | Not supported |
| Continue posting on error (SP_OPX_CONT_ON_ERR) | PostgreSQL, SQL Server, Kafka, Snowflake |
| Suspend on out of sync errors (SP_OPX_OUT_OF_SYNC_SUSPEND) | PostgreSQL, SQL Server, Kafka, Snowflake |
| Reduced key (SP_OPX_REDUCED_KEY) | PostgreSQL, SQL Server, Kafka, Snowflake |
| Logical Transaction Rollback on out-of-sync transactions | Not supported |
SharePlex supports replication from PostgreSQL to Kafka, according to the details below.
Supported operating systems via native installation:
RHEL 7.x and 8.x
Remote replication from the following operating systems is supported:
RHEL 7.x and 8.x
Note: SharePlex supports only the 64-bit version of the listed operating systems.
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
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 DML operations on tables. DML can be replicated from a PostgreSQL source to an SQL Server target.
SharePlex supports the following DML operations on tables:
The target table must support the column types that are being replicated from the source PostgreSQL table.
SharePlex does not support DDL operations and objects when replicating data from a PostgreSQL source to a Kafka target.
SharePlex supports replication from PostgreSQL to Oracle, according to the details below.
The following operating systems are supported from PostgreSQL to Oracle database. SharePlex supports only the 64-bit version of the listed operating systems.
Native SharePlex installation is supported on the below platforms:
AIX 7.1, 7.2, and 7.3
Oracle Linux (RHCK and UEK) 7.x and 8.x
RHEL Linux 7.x and 8.x
CentOS Linux 7.x
Oracle Solaris SPARC 11.4
CentOS Linux 7.x and 8.x
SuSE SLES 12.x and 15.x
HP-UX 11.31 Itanium
Remote replication from the following operating systems is supported:
AIX 7.1, 7.2, and 7.3
Oracle Linux (RHCK and UEK) 7.x and 8.x
RHEL Linux 7.x and 8.x
CentOS Linux 7.x
Oracle Solaris SPARC 11.4
CentOS Linux 7.x and 8.x
SuSE SLES 12.x and 15.x
HP-UX 11.31 Itanium
Supported target operating systems via remote replication:
All platforms listed above, plus Windows Server 2016 and 2019, are supported via remote replication.
Oracle 19c
Oracle Cloud Infrastructure
Amazon Web Services
Microsoft Azure
Azure Virtual Machine (IaaS)
UTF 8
SharePlex supports the following data types for replication from PostgreSQL to Oracle:
| PostgreSQL | Oracle |
|---|---|
| INT | NUMBER / INT |
| REAL | BINARY_FLOAT / NUMBER |
| SMALLINT | NUMBER |
| BIGINT | NUMBER |
| NUMERIC | NUMBER |
| DOUBLE PRECISION | BINARY_DOUBLE / NUMBER |
| CHAR(1:2000) | CHAR(n) |
| CHAR(2001:) | CLOB |
| CHAR(1:1000) | NCHAR(n) |
| VARCHAR(1:4000) | VARCHAR2(n) |
| VARCHAR(4001:) | CLOB |
| VARCHAR | CLOB |
| VARCHAR(1:2000) | NVARCHAR2(n) |
| TEXT | CLOB / NCLOB |
| DATE | DATE |
| TIMESTAMP(0) | TIMESTAMP(0) |
| TIMESTAMP | TIMESTAMP / TIMESTAMP [(fractional_seconds_precision)] WITH LOCAL TIME ZONE |
| TIMESTAMP with the time zone | TIMESTAMP WITH TIME ZONE |
SharePlex supports the following PostgreSQL data types for replication from PostgreSQL to Oracle when conflict resolution is configured:
VARCHAR
SMALLINT
INT
BIGINT
NUMERIC
DATE
CHAR
TIMESTAMP(0)
TIMESTAMP
TIMESTAMP WITH THE TIME ZONE
SharePlex supports DML operations on tables. DML can be replicated from a PostgreSQL source to an Oracle target.
SharePlex supports the following DML operations on tables:
Singular and bulk operation - Insert
Singular and bulk operation - Update with key(s)/ non key(s)
Singular and bulk operation - Delete with key(s)
Above operations with rollback/savepoint
The target table must support the column types that are being replicated from the source PostgreSQL table.
|
Limitation: In PostgreSQL to Oracle replication, in the source database table and column names are created in lower case by default, and in the target database they are created in upper case. In such a case, if we configure such tables in replication with the source table name in lower case with a double quote and the target table name in upper case with quotes in the configuration file, in the Post process, while creating a query, the table name is used in upper case as specified in the configuration file, but column names are used in lower case by default. Hence, this query fails in execution as the target table contains column names in capital letters. The scenario will work fine if the target table or column name is created in lower case using double quotes in the database and the target table name is specified in small case in the configuration file. |
SharePlex does not support DDL operations and objects when replicating data from a PostgreSQL source to an Oracle target.
SharePlex supports replication from PostgreSQL to PostgreSQL , according to the details below.
Native SharePlex installation is supported on the following platforms:
RHEL 7.x and 8.x
Remote replication from the following operating systems is supported:
RHEL 7.x and 8.x
Supported target operating systems via remote replication:
AIX 7.1, 7.2, and 7.3
CentOS Linux 7.x and 8.x
HP-UX 11.31 Itanium
Oracle Linux (RHCK and UEK) 7.x and 8.x
Oracle Solaris SPARC 11.4
Oracle Solaris x86 11.4
RHEL 7.x and 8.x
SuSE SLES 12.x and 15.x
Windows Server 2016 and 2019
Note: SharePlex supports only the 64-bit version of the listed operating systems.
PostgreSQL 13.x and 14.x
ODBC driver requirement: pgsql- 13.x and 14.x
Amazon EC2 (IaaS) Virtual Machine
Amazon RDS for PostgreSQL
Amazon Aurora
Microsoft Azure:
Azure Virtual Machine (IaaS)
Azure DBaaS
UTF 8
SharePlex PostgreSQL supports the following data types for replication from PostgreSQL to PostgreSQL:
SharePlex supports DML operations on tables. DML can be replicated from a PostgreSQL source to a PostgreSQL target.
SharePlex supports the following DML operations on tables:
The target table must support the column types that are being replicated from the source PostgreSQL table.
SharePlex does not support DDL operations and objects when replicating data from a PostgreSQL source to a PostgreSQL target.
SharePlex supports replication from PostgreSQL to Snowflake, according to the details below.
The following operating systems are supported for capture from a PostgreSQL database and replication to a Snowflake target database. SharePlex Snowflake supports only the 64-bit version of the listed operating systems.
SharePlex replicates remotely to Snowflake. Replication from the following operating systems is supported:
Red Hat Linux version 7.x and 8.x
Snowflake 6.31 Enterprise, Community version
ODBC driver requirement: Snowflake 2.24.2
| Limitations:
The following ODBC driver related limitations are observed while replicating data from PostgreSQL to Snowflake:
|
SharePlex supports the following data types for replication from PostgreSQL to Snowflake:
| PostgreSQL | Snowflake |
|---|---|
| TEXT | TEXT |
| INT | INT,INTEGER,NUMBER |
| CHAR(1:2000) | VARCHAR(n) |
| CHAR(2001:) | VARCHAR(n) |
| CHAR(n) | CHAR(n) |
| VARCHAR(1:4000) | VARCHAR(n) |
| VARCHAR(4001:) | VARCHAR(n) |
| VARCHAR | VARCHAR(n) |
| REAL | REAL |
| SMALLINT | SMALLINT |
| BIGINT | BIGINT |
| NUMERIC (whole number without fraction) | NUMERIC, DECIMAL |
| NUMERIC (fractional number) | FLOAT |
| DATE | DATE |
| DOUBLE PRECISION | DOUBLE PRECISION |
| TIMESTAMP | TIMESTAMP |
| TIMESTAMP_TZ | TIMESTAMP_TZ |
Char(n) data type - In PostgreSQL, Char(n) is a fixed-size data type. If you insert char data with a length less than "n" into the "Char(n)" column, the remaining slots (n - length) are padded with space to occupy the complete "n" memory positions. Snowflake uses VARCHAR(n) for char storage since Snowflake lacks a comparable fixed-length character data type and only saves char data up to its length. Live replication will ensure that char column data is correctly copied. However, if users are manually inserting data into Snowflake for the equivalent of a Char(n) PostgreSQL column, then the user will need to handle padding as well to occupy the full "n" length so that data will be in sync in both the source and target database.
Text data types - Snowflake Text data types have size limitation of 8 MB, so PostgreSQL’s TEXT data type replication will be restricted to max 8 MB size limit of equivalent counterpart. Refer table below.
| PostgreSQL Data type | Max Size | Snowflake Data type | Max Size |
|---|---|---|---|
| TEXT | unlimited | TEXT | 8 MB of unicode chars |
See Conditions of support for the additional conditions of support for the above-mentioned supported data types.
SharePlex supports DML operations on tables, with some conditions. DML can be replicated from an PostgreSQL source to a Snowflake target.
SharePlex supports the following DML operations on tables when replicating data from an PostgreSQL source to the Snowflake target:
Singular and bulk operation - Insert with key(s)/ non key(s)
Singular and bulk operation - Update with key(s)/ non key(s)
Singular and bulk operation - Delete with key(s)/ non key(s)
| Limitations:
The following DML operations related limitations are observed while replicating data from PostgreSQL to Snowflake:
|
For additional information, see Supported Operations and Objects for DML Replication.
SharePlex does not support DDL operations and objects when replicating data from an PostgreSQL source to a Snowflake target.
SharePlex supports replication from PostgreSQL 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.
Supported operating systems via native installation:
RHEL 7.x and 8.x
Remote replication from the following operating systems is supported:
RHEL 7.x and 8.x
Supported target operating systems via remote replication:
All platforms listed above, plus Windows Server 2016 and 2019, are supported via remote replication.
SQL Server 2008, 2008 R2, 2012, 2014, 2016, 2017, and 2019
ODBC driver requirement:
Amazon Web Services
Amazon EC2 (IaaS) Virtual Machine
Microsoft Azure
Azure Virtual Machine (IaaS)
Azure SQL Database
Azure SQL Managed Instance
SharePlex supports the following data types for replication from PostgreSQL to SQL Server:
| PostgreSQL | SQL Server |
|---|---|
| INT | INT |
| REAL | REAL |
| SMALLINT | SMALLINT |
| BIGINT | BIGINT |
| NUMERIC / DECIMAL | NUMERIC / DECIMAL |
| DOUBLE PRECISION | FLOAT |
| CHAR (1:8000) | CHAR(n) |
| CHAR (8001:) | VARCHAR (MAX) |
| CHAR (1:2000) | NCHAR (n) |
| VARCHAR (1:8000) | VARCHAR (n) |
| VARCHAR (8001:) | VARCHAR (MAX) |
| VARCHAR(1:2000) | NVARCHAR (n) |
| VARCHAR | VARCHAR (MAX) / TEXT |
| TEXT | TEXT / NTEXT / VARCHAR(MAX) |
| DATE | DATE |
| TIMESTAMP (p) | DATETIME2 (p) |
| TIMESTAMP | DATETIME2 |
| TIMESTAMP with the time zone | DATETIMEOFFSET |
SharePlex supports DML operations on tables. DML can be replicated from a PostgreSQL source to an SQL Server target.
SharePlex supports the following DML operations on tables:
The target table must support the column types that are being replicated from the source PostgreSQL table.
SharePlex does not support DDL operations and objects when replicating data from a PostgreSQL source to an SQL Server target.
The following is a list of known issues, including those attributed to third-party products, known to exist at the time of release.
| Issue ID | Known Issues | Component/ Feature |
|---|---|---|
| SPSQL-3596 |
An Oracle custom routine does not take priority over a SharePlex prepared routine in PostgreSQL to Oracle bi-directional replication when !DEFAULT is specified/used in the conflict resolution file. Workaround: Change the sequence of routines in the conflict resolution file. Mention the custom routine first, followed by Shareplex Prepared Routine. Example: Instead of !DEFAULT IUD !LeastRecentRecord(col_name) !DEFAULT IUD schemaName.ProcedureName
Use !DEFAULT IUD schemaName.ProcedureName !DEFAULT IUD !LeastRecentRecord(col_name) Note: We are planning to resolve this issue in SharePlex 11.1 version. |
BDR |
| SPSQL-3255 |
Updating conflict resolution fails when SharePlex performs multiple updates using MostRecentRecord and LeastRecentRecord routines. This issue is observed in PostgreSQL to PostgreSQL and PostgreSQL to Oracle bi-directional replication. Note: We are planning to resolve this issue in SharePlex 11.1 version. |
BDR |
| SPSQL-3072 | The SharePlex Post process is generating a warning that the replicated table does not have full lob data and tables are out of sync for SQL Loader with the direct load operation. This issue is observed while replicating data from Oracle to MS SQL. | Open Poster |
| SPSQL-3024 | The vulnerability issue (CVE-2022-1471) is observed in the snakeyaml-1.32.jar SharePlex PostgreSQL library. This issue was found during the WhiteSource scan. Currently, there are no fixes available for this issue as per the National Vulnerability Database. | SharePlex PostgreSQL library |
| SPO-24687 | SharePlex does not replicate data when the table or column name in replication has more than 30 characters. | Open targets |
| SPO-24119 | SharePlex Poster is displaying the ODBC Driver Invalid precision value error when replicating the BLOB data type with the data size of more than 8000 bytes. | SQL Server |
| SPO-22342 | Performance issue is observed while performing the DML operations in bulk. | MySQL |
| SPO-22517 | Performance issue is observed during replication while using partition table over the cloud. | PostgreSQL and MySQL |
| SPO-21993 | While activating a config file with an Oracle SCN number, users are not able to delete a column in a DDL activity. | DDL Drop Column |
| SPO-21339 | The SharePlex Capture process is getting stuck when users change the Oracle compatibility parameter from 11g to 12c. This issue is observed on the 12c 4 node RAC database. | Capture |
| SPO-20843 | Copy job status shows 'Locked' even when competed. | Copy/ Append |
| SPO-20842 | On Oracle 19c processing large n-items can lead to OOS and/or missing commits. | LOBs, VARRAYs, XML |
| SPO-20841 | Post will fail with ORA-14400 performing DML on partitioned table with VARAY residing in an OLTP compressed tablespace. | Partitioned Replication |
| SPO-20733 | Compare will hang and the compare server will exit comparing table that has VARRAY containing UDT type. | Compare |
| SPO-20451 | Compare/Repair using [schema].[table] may not work on AIX7.2 with Oracle19c due to establishing a network connection. | Compare |
| SPO-20205 | Oracle to Kafka supported data format: Kafka replicates the varray column data only in the XML format. Currently, Kafka does not replicate the varray column data in the JSON format. |
Kafka |
| SPO-19048 | Replication of tables with varray columns from an Oracle source to a non-Oracle target can get out of sync because Oracle doesn't include key information on updates. | Post to non-Oracle targets |
| SPO-16453 | The BINARY_FLOAT and BINARY_DOUBLE data types are not supported for the copy command. | Character Sets |
| SPO-15585 | In replication from an Oracle source to a non-Oracle target, SharePlex does not support ALTER TABLE...ADD COLUMN DDL operations when the column name is more than 30-bytes in length. | DDL Replication |
| 107487 | Hybrid Columnar Compression. Activation will not fail if a table with “COMPRESS FOR QUERY LOW” compression is activated. Capture will log a message indicating that “COMPRESS FOR QUERY LOW” is not supported. | Oracle Compression |
| 107471 | If the post process that is writing to JMS is not on the same machine as the source database, and if the two machines are of different endianness, NCHAR data will not be written to JMS correctly. | Post to JMS |
| 92931 | If there is more than one function defined in the index, SharePlex will choose the first. SharePlex cannot support multiple functions. | Function based index |
| 66306 | The reported core file was not generated on systems running Oracle 11g on the SunOS, and Linux operating systems. | General |
| 61713 | On raw device ASM systems, the sp_desvr may get stuck and the process can not be killed even when kill -9 is issued; users must reboot the system to recover from it. | ASM |
| 57939 | If separate SQL statements for partition DDL and index rebuild are run on the source, SharePlex only replicates the partition DDL and leaves target global index unusable. This is because ALTER INDEX is not supported by SharePlex. The recommended work around is that all partition DDLs which mark global indexes as unusable should be run with an appending clause UPDATE GLOBAL INDEXES to the ALTER TABLE SQL statements. The alternative is to manually rebuild the global indexes on target. | Partition DDL |
| 56957 | If the Capture process is behind in reading the Oracle redo or archive logs when the SP_OCT_REPLICATE_ALL_DDL parameter is enabled it will replicate DDLs whose time stamps precede this event. | DDL Replication |
| 55268 | When using horizontal partition replication with DATE data type in the column condition, the DATE needs to follow the SP date string format, 'MMDDSYYYYHH24MISS'. Otherwise, the Read and Compare processes are not able to process it. | Vertical and Horizontal Partitioning |
| 41679 | If you need to copy a materialized view to a table, you should drop the target table before copying. Please be aware that the new target table created by copy will have an additional column named M_ROW$$ which does not exist on the source. The use of append on a materialized view to a table is not supported. | Copy/ Append |
| 35198 |
Avoid replicating NCHAR data types using different character sets such as AL16UTF16 on the source machine and UTF8 on the target due to byte size limitations. Oracle stores NCHAR data with a maximum limit of 2000 bytes. A fixed length NCHAR character set such as AL16UTF16 has a different maximum number of characters than a variable length NCHAR character set such as UTF8. For the fixed length AL16UTF16 character set, each character is stored as 2 bytes; thus, the maximum number of characters is 1000 for NCHAR data. For the variable length UTF8 character set, the maximum number of characters a column can accommodate depends on how many bytes each character requires. If you replicate 1000 3-byte characters from a source machine using the AL16UTF16 character set to a target machine set to UTF8, you will get the following Oracle error message on the target, since it needs 3000 bytes: |
Character Sets |
| 29650 | Users may encounter an out-of-sync condition when an UPDATE occurs on a table that contains a UDT with a VARRAY column, and there is no KEY on the table. This issue is specific to Solaris x86 operating systems. | LOBs, VARRAYs, XML |
| 2242 | Replicating CREATE ROLE (set param SP_OCT_REPLICATE_ALL_DDL 1) is changing the grantee name on the target to the name of the SharePlex Administrator. | DDL Replication |
| N/A | If the customer issues an "ALTER TABLE ... MOVE COMPRESS" DDL command against a table in replication, SharePlex will replicate the DDL to the target by default. After post issues the DDL, if the target table had indexes, they are now unusable and post will subsequently fail trying to apply changes to the table. If post gets an error on the table such as "ORA-01502: index XXX or partition of such index is in unusable state" , the user must rebuild any indexes the table may have before restarting post in order to rectify the situation. | General |
| N/A | If the redo_log or archive_log that SharePlex is currently reading is involved in “rebalancing” due to the removal of a disc group, the Capture process will pause until the rebalance procedure for that file is complete. | ASM |
| N/A |
If you have SharePlex configured to start from a startup script and it returns an error similar to: System call error: sp_cnc (connecting from cdrpx.mcit.med.umich.edu) Bad file number Can't dup2 stderr try adding nohup to your script. The nohup command directs a command (in this case the startup of SharePlex) to continue in the background after the current user (the script) logs out. The syntax is: cd /product_directory/bin nohup ./sp_cop & |
Startup |
| N/A | If the compare command specifies a WHERE clause that includes a column name containing one or more spaces, the spaces are removed in the WHERE clause in the query used in the comparison causing the comparison to fail. | Compare |
| N/A | The !ControlExtendedCharSet prepared conflict resolution routine and the !DEFAULT parameter currently cannot be used for generic conflict resolution. | Conflict Resolution |
| N/A | When using a compound routing map in a placeholder route in the configuration file, do not use spaces between each routing component. For example, sysb@o.orab+sysc@o.oraC is correct because there are no spaces before or after the + symbol. | Partitioned Replication |
| Issue ID | Known Issue | Component/ Feature |
|---|---|---|
| 54799 | RHEL with 11g may encounter issues when producing core files. To work around this issue users will need to change the parameter "core_pattern" in the /proc/sys/kernel/core_pattern file. The following command enables core files: sysctl -w kernel.core_pattern=core. The original setting is: /corefiles/core. In this state, the system looks for a directory named /corefiles, which does not exist, therefore a core file could not be created. | Linux |
| 125639 | There might be an issue when replicating VARRAYs with FLOAT(n) type to a target machine running Oracle 10g, due to the way that Oracle handles Float(n) types. Float is not an Oracle type; it is a SQL-92 type and Oracle is not consistent in the way that it handles the float type. This is a known Oracle bug. See Oracle bug report 4266304. | Oracle |
| 44626 | Users wishing to employ IOTs with overflow need to be running Oracle 11g or higher. This is a known Oracle issue addressed under Oracle Bug 4627859. | Oracle |
| 53701 | There is a known issue with INSERT DIRECT LOAD VALUES (IDLV) in Oracle 11g that prevents the reading or modification of an object after modifying it in parallel. Oracle has provided three (3) solutions for addressing this issue. They can be found in the Oracle update of SR6849411.993 dated 05-07-2008. This issue was fixed by Oracle in 11gR2 | Oracle |
| 59258 | Oracle versions 10.2.0.1 through 11.1.0.6 on AIX 5.3 (64 bit), members of SharePlex Admin group, other than the installation user, cannot run ora_setup or start SharePlex. This is an Oracle issue. Please refer to Oracle Bug# 6800649 and apply Patch 6800649. | Oracle |
| 75179 | Oracle 11gR2 - During a SYNC job, the copy of a new table (without data) failed at “EXP-00011: table does not exist” . The table that failed is a new table without any data. The EXP-00011 is caused by 11gR2 new feature "Deferred Segment Creation" that is controlled by the initialization parameter DEFERRED_SEGMENT_CREATION. The default is ON. To avoid this error, disable the parameter. A tar has been opened with Oracle and Oracle created a note 960216.1 Original Export Raises EXP-11 Table Does Not Exist. | Oracle |
| 92152 | OLTP compression with supplemental logging enabled may corrupt the Oracle Undo block, so Oracle suggests disabling supplemental logging when running OLTP compression. However, SharePlex requires supplemental logging to be enabled, so you may encounter this bug. This affects Oracle versions 11.2.0.2, 11.2.0.1 and 11.1.0.7. See Metalink ID 1191474.1. | Oracle |
| N/A | Sometimes the Post process will hang updating a SecureFile LOB. For more information please refer to Oracle tar SR 3-2898230851: OCILobWrite hangs at the OCI_LAST_PIECE for securefile LOB. | Oracle |
| N/A | There is an Oracle bug that can cause the database to crash when supplemental logging is enabled and transactions involving tables in a compressed tablespace are rolled back. Please refer to Oracle bug 8331063 for more information. | Oracle |
| N/A | A known issue in PL/SQL prevents the SharePlex conflict resolution logic from compiling the PL/SQL for tables whose names are the same as their owners. Oracle has stated that the issue will not be fixed. See Oracle TAR 2577886.996 for more information. This issue does not affect replication; SharePlex supports tables with identical owner and table names. | Oracle |
© 2024 Quest Software Inc. ALL RIGHTS RESERVED. Conditions d’utilisation Confidentialité Cookie Preference Center
