Chat now with support
Chat with Support

SharePlex 9.0.1 - Preinstallation Checklist

View this document in PDF format

You can download, view and save this document in Adobe PDF format. Click Download this document in the upper right-hand corner of this page. This action downloads the entire publication.

 

System Requirements

Contents

Overview

This chapter contains the following:

  • SharePlex-supported platforms and database types and versions
  • SharePlex-supported data types, database objects, and database operations
  • Supported SharePlex features, per database type

Basic system requirements

Before installing SharePlex, ensure that your system meets the minimum hardware and software requirements.

  • SharePlex processes are all 64-bit and can exceed 4 GB.
  • Per process memory of greater than or equal to 256 MB is required.
  • See the Preinstallation Checklist in the SharePlex Installation Guide for additional system and/or database requirements.

Internet protocol

SharePlex supports both IPv4 and IPv6 internet protocol. The following table shows the platforms for which SharePlex was tested with IPv6.

Platform

Source

Target

SharePlex Source
and Target versions

On-premise/Cloud

Linux RHEL

Link-Local IPV6

Link-Local IPV6

9.0 - 9.0

On-premise

Linux RHEL

Link-Local IPV6

Link-Local IPV6

8.6.5 - 9.0

On-premise

Linux RHEL

Link-Local IPV6

Link-Local IPV6

9.0 - 8.6

On-premise

Linux Suse

Link-Local IPV6

Link-Local IPV6

9.0 - 9.0

On-premise

Windows

Link-Local IPV6

Link-Local IPV6

9.0 - 9.0

On-premise

Windows

Link-Local IPV6

Link-Local IPV6

9.0 - 8.6.4

On-premise

HP UA

Link-Local IPV6

Link-Local IPV6

9.0 - 9.0

On-premise

HP IA

Link-Local IPV6

Link-Local IPV6

9.0 - 9.0

On-premise

SUN Sprac

Link-Local IPV6

Link-Local IPV6

9.0 - 9.0

On-premise

SUN Solaris

Link-Local IPV6

Link-Local IPV6

9.0 - 9.0

On-premise

AIX

Link-Local IPV6

Link-Local IPV6

9.0 - 9.0

On-premise

Linux RHEL

Public IPV6

Public IPV6

9.0 - 9.0

Cloud

Windows

Public IPV6

Public IPV6

9.0 - 9.0

Cloud

Interoperability between versions

Refer to the following guidelines if the system where you are installing the current version of SharePlex is in a configuration where one or more other systems will continue to use an older version. An example would be where you are installing or upgrading SharePlex on a target, but the source will continue to use SharePlex 8.5 or earlier.

Versions with full interoperability

The following SharePlex versions are fully interoperable, including the Compare/Repair feature:

8.0.x

8.5.x

8.6.x

9.0.x

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:

  • The older version of the SP_SYS_TARGET_COMPATIBILITY parameter, SP_OCT_TARGET_COMPATIBILITY, has been deprecated in version 9.0. If your source SharePlex is currently replicating to a lower SharePlex version on the target and you have SP_OCT_TARGET_COMPATIBILITY set to the lower version, SharePlex will continue to use that value after you upgrade to version 9.0.
  • If you upgrade the target to the current release at a future time, issue a reset for SP_OCT_TARGET_COMPATIBILITY on the source system to remove it from the SharePlex environment. Going forward, SharePlex will use the setting of the new SP_SYS_TARGET_COMPATIBILITY parameter, which defaults to the current version.

To reset SP_OCT_TARGET_COMPATIBILITY

  1. Stop Capture.

    sp_ctrl>stop capture

  2. In sp_ctrl on the source system, issue the following command:

    sp_ctrl> reset param SP_OCT_TARGET_COMPATIBILITY

  3. Restart Capture.

    sp_ctrl> start capture

Supported data stores

Data Store Type of Support Version Driver version
Apache Kafka target .08 and later

N/A

Note: A Kafka target is supported on Red Hat Linux version 6.0 or later.

Flat file - SQL output target N/A N/A
Flat file - XML output target N/A N/A
JMS - ActiveMQ target 5.8 N/A
JMS - IBM MQ target 7.x and 8.x N/A

Microsoft SQL Server

source and target

2012

2014

2016

Note: Supported as a source only on Windows 2012 R2.

Microsoft SQL Server ODBC Driver

Do not use the Microsoft SQL Server Native Client. SharePlex will return an error during setup if the correct driver is not used. To tell the difference between the two:

  • The Microsoft SQL Server ODBC Driver has versions such as 06.02.9200.
  • The Microsoft SQL Server Native Client has versions such as 11.00.3513.
MySQL target 5.6 and later ODBC driver version 5.3.2 or later.
Oracle Database (64-bit only)

source and target

10g R1 and R2

11g R1 and R2

12cR1 and R2

N/A
PostgreSQL*

(Symfoware Server, EDB Postgres Advanced Server, others)

target 9.4 and later*

Use the driver version that is recommended by the vendor of the PostgreSQL implementation that you are using.

SAP Adaptive Server Enterprise (ASE) target 15.7 N/A
SAP HANA target 1.0 SPS 11 Rev111 HDBODBC or HDBODBC32 driver provided with the HANA database installation.
Teradata target 15.00.03.05 Teradata ODBC driver version 15.10.00.01 or later

* SharePlex supports all implementations of the PostgreSQL open source object-relational database system.

Cloud support

The following shows the configurations that SharePlex supports when either the source or target, or both, are cloud-based databases.

Source To Target
Oracle on EC2 Linux

Oracle on AWS EC2 Linux

   
Oracle on Azure Linux

Oracle on Azure Linux

   
Oracle on on-premise Linux
  • Oracle on AWS RDS
  • Oracle on AWS EC2
  • PostgreSQL (Community) on Azure Linux
  • PostgreSQL (Community) on AWS EC2

  • PostgreSQL (Community) on AWS RDS

  • EDB Postgres Advanced Server on AWS EC2
  • EDB Postgres Advanced Server on Azure Linux
  • Fujitsu Symfoware Server on AWS EC2
  • Fujitsu Symfoware Server on Azure Linux
  • MySQL on AWS EC2
  • MySQL on AWS RDS
  • MySQL on Azure Linux
  • Aurora on AWS RDS
  • SQL Server on AWS EC2
  • SQL Server on AWS RDS
  • SQL Server on Azure Windows (IaaS)
  • SQL Server on Azure Windows (PaaS)
   
SQL Server on on-premise Windows
  • SQL Server on Azure Windows
  • SQL Server on EC2 Windows

System Requirements — Oracle

This section contains information about SharePlex support for capture from an Oracle source database and replication to supported targets.

Basic requirements

  • SQL*Plus must be installed for any source or target Oracle Database.
  • (Linux and Unix) Quest recommends setting the hard-limit of the system file descriptors to a minimum of 1024 or higher, as the system permits.
  • A source Oracle database must have at least the minimum level of supplemental logging enabled. Some datatype or operational support may require PK/UK supplemental logging to be enabled.

Supported platforms

This section shows the SharePlex support for replication from source Oracle database-platform combinations to target database-platform combinations, both Oracle and Open Target.

NoteS:

  • Unless specified, Oracle, RAC, and ASM are supported for the same version.
  • SharePlex supports only 64-bit Oracle Database.

Supported platforms — Oracle source to Oracle target

Important: See also Cloud support for cloud-hosted targets.

Platform Oracle source or target  
 

10g*

10gR2*

11g*

11gR2*

12cR1*

12cR2*

AIX 5.3 Yes Yes Yes Yes No No
AIX 6.1 NA Yes Yes Yes Yes No
AIX 7.1 NA NA NA Yes Yes No
CentOS 5.10 (x64) NA Yes Yes Yes Yes No
CentOS 6.5 (x64) NA Yes Yes Yes Yes No
Debian Release 8 (Jesse and Wheezy)*** No No Yes Yes Yes No

HP-UX 11.31 (11i v3)

(PA-RISC)

Yes Yes Yes Yes NA No

HP-UX 11.31 (11i v3)

(Itanium)

Yes Yes Yes Yes Yes No
Oracle Solaris 9 Yes Yes Yes NA NA No
Oracle Solaris 10 (SPARC) Yes Yes Yes Yes Yes No
Oracle Solaris 10 (x64) Yes Yes NA Yes Yes No
Oracle Solaris 11 (SPARC) NA NA Yes Yes Yes No
Oracle Solaris 11 (x64) NA NA Yes Yes Yes No
Oracle Linux 4 (x64) Yes Yes Yes Yes NA No
Oracle Linux 5 (x64) NA Yes Yes Yes Yes No
Oracle Linux 6 (x64) NA NA NA Yes Yes Yes
Oracle Linux 7 (x64) NA NA NA Yes Yes Yes
Oracle Linux 5 on Exadata 2, 3, 4 (x64) NA NA NA Yes Yes No
Oracle Linux 5.5 on Exadata 3, 4 (x64) NA NA NA Yes Yes No
Oracle Linux 6.6 on Exadata 5 (x64) NA NA NA Yes Yes No
RHEL 4 (x64) Yes Yes Yes Yes NA NA
RHEL 5 (x64) NA Yes Yes Yes Yes No
RHEL 6 (x64) NA NA NA Yes Yes Yes
RHEL 7 (x64) NA NA NA Yes Yes Yes
SuSE SLES9 (x64) Yes Yes NA NA NA NA
SuSE SLES10 (x64) NA Yes Yes Yes NA NA
SuSE SLES11 (x64) NA Yes Yes Yes Yes No
SuSE SLES12 (x64)** NA NA NA Yes Yes Yes
Windows Server 2003 (x64) NA Yes Yes Yes NA NA
Windows Server 2008 (x64) NA Yes Yes Yes Yes No
Windows Server 2012 NA Yes Yes Yes Yes Yes
Windows Server 2012R2 NA Yes Yes Yes Yes Yes

NA: Not applicable: not supported by the database type or version.

X: Not yet tested.

* SharePlex only supports 64-bit Oracle Database. Linux running Oracle 11g must be running on Oracle 11.1.0.6.0+ or you must apply the one-off provided for Oracle Bug 6598432.

** At the time of this writing, Oracle’s published documentation did not indicate support of SuSE SLES12. Basic testing of SharePlex has been done on SuSE SLES12. Quest will provide best effort support but cannot resolve specific Oracle issues on this platform until Oracle adds official support.

*** Oracle does not officially support Debian Linux.

Supported platforms — Oracle source to Open Target

Important: See also Cloud support for cloud-hosted targets.

Platform*     Can post to target on this platform (Yes/No)  
  MySQL

SAP ASE

SQL Server

PostgreSQL**

SAP HANA Teradata

JMS

Kafka

File

AIX 6.1 NA NA NA NA NA NA Yes No Yes
AIX 7.1 NA NA NA NA NA NA Yes No Yes
CentOS 5.10 (x64) NA Yes NA NA NA NA Yes Yes Yes
CentOS 6.5 (x64) NA Yes NA Yes NA NA Yes Yes Yes
Debian Release 8 (Jesse and Wheezy) NA Yes NA Yes NA NA Yes Yes Yes

HP-UX 11.31 (11i v3)

(PA-RISC)

NA No NA NA NA NA No No No

HP-UX 11.31 (11i v3)

(Itanium)

NA No NA NA NA NA No No No
Oracle Solaris 9 NA NA NA NA NA NA NA NA NA
Oracle Solaris 10 (SPARC) NA NA NA NA NA NA Yes No Yes
Oracle Solaris 10 (x64) NA NA NA NA NA NA Yes No Yes
Oracle Solaris 11 (SPARC) NA NA NA NA NA NA Yes No Yes
Oracle Solaris 11 (x64) NA NA NA NA NA NA Yes No Yes
Oracle Linux 4 (x64) No NA NA No NA NA Yes Yes Yes
Oracle Linux 5 (x64) No NA NA No NA NA Yes Yes Yes
Oracle Linux 6 (x64) No NA NA No NA NA Yes Yes Yes
Oracle Linux 7 (x64) No NA NA NA NA NA Yes Yes Yes
Oracle Linux 5 on Exadata 2, 3, 4 (x64) No NA NA No NA NA Yes Yes Yes
Oracle Linux 5.5 on Exadata 3, 4 (x64) No NA NA No NA NA Yes Yes Yes
Oracle Linux 6.6 on Exadata 5 (x64) No NA NA No NA NA Yes Yes Yes
RHEL 4 (x64) Yes Yes NA NA NA NA Yes Yes Yes
RHEL 5 (x64) Yes Yes NA NA NA NA Yes Yes Yes
RHEL 6 (x64) Yes Yes NA Yes NA NA Yes Yes Yes
RHEL 7 (x64) Yes Yes NA Yes NA NA Yes Yes Yes
SuSE SLES9 (x64) Yes Yes NA NA Yes NA NA Yes NA
SuSE SLES10 (x64) Yes Yes NA NA Yes Yes (SP3) Yes Yes Yes
SuSE SLES11 (x64) Yes Yes NA Yes Yes Yes (SP1) Yes Yes Yes
SuSE SLES12 (x64)** Yes Yes NA NA Yes NA Yes Yes Yes
Windows 2003 (x64) NA NA Yes NA NA NA Yes No Yes
Windows 2008 (x64) NA NA Yes No NA NA Yes No Yes
Windows Server 2012 NA NA Yes No NA NA Yes No Yes
Windows Server 2012R2 NA NA Yes No NA NA Yes No Yes

* If a platform is not supported by a target type, it is not supported by SharePlex for that target type. For example, only R2 of Windows 2008 is supported by EDB Postgres Advanced Server, and therefore only by SharePlex.

** SharePlex supports all implementations of the PostgreSQL open source object-relational database system.For more information, see Basic system requirements.

Supported data types — Oracle to Oracle

SharePlex supports the following Oracle data types for replication to Oracle targets. See the Conditions of suppport for additional information.

  • ANYDATA 1
  • B-FILE
  • BINARY DOUBLE
  • BINARY FLOAT
  • BLOB 2
  • CHAR
  • CLOB 2
  • DATE
  • INTERVAL
  • LONG RAW
  • LONG 2
  • NCHAR
  • NCLOB 3
  • NUMBER
  • NVARCHAR2
  • RAW
  • ROWID
  • SDO_GEOMETRY
  • TIMESTAMP
  • TIMESTAMP WITH LOCAL TIME ZONE
  • TIMESTAMP WITH TIME ZONE
  • UDT (User Defined Type)
  • VARCHAR
  • VARCHAR2
  • VARRAY collectors 4
  • XMLTYPE 5

Conditions of suppport

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 datatypes within ANYDATA are supported by SharePlex:

    • CHAR
    • DATE
    • NUMBER
    • RAW
    • VARCHAR
    • VARCHAR2
    • TIMESTAMP
  • A datatype within an ANYDATA type must be in-row (inside the column data). Oracle encapsulates the ANYDATA type as an in-row securefile LOB. If the encapsulated data is longer than the length allowed for an in-row LOB, that data appears as out-of-row LOB data. SharePlex assumes that the encapsulated data always appears as in-row LOB.

2. Conditions of support - LONG and LOB (BLOB, CLOB)

  • Any table that contains a LOB or LONG should have a primary key or unique key defined on it. If a table does not have a key, SharePlex builds its own key from all of the columns except LONGs or LOBs. If a LOB or LONG is the only difference between two rows that otherwise satisfy the Post WHERE clause, SharePlex cannot guarantee that the correct row will be updated.
  • Replication of SecureFile LOBs (compressed high or medium, or uncompressed) is supported as follows:

    • Not supported if the storage specification includes encryption, and/or deduplication.
    • Logging must be enabled.
    • Replication to non-Oracle databases is supported except if the storage specification includes any level of compression, encryption, and/or deduplication. Logging must be enabled.

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 - VARRAYS

Only the following data types in a VARRAY are supported by SharePlex when replicating to XML output:

  • BINARY_FLOAT
  • VARCHAR2
  • BINARY_DOUBLE
  • NUMBER
  • TIMESTAMP (This is converted to a DATE data type without microseconds in XML output)
  • DATE
  • UDT (only if it contains one of the data types in this list)

5. 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:

  • XMLTYPE stored as BINARY is not supported when storage is defined as SecureFile LOB with compression. SecureFile LOB without compression is supported.
  • Binary XMLTypes are not supported by Compare/Repair when source and target character sets are different and require character set conversion.
  • Compare/Repair does not support comparison of XMLTYPE when source and target have different storage clauses. Compare/Repair only supports compare/repair when source and target are both stored as BINARY or both are stored as CLOB.

6. Conditions of support - general

  • When replicating DML operations to an Open Target database, SharePlex queries the target database to determine the target column definition before posting the data.

  • If the precision or size of the target datatype is not large enough for the data being replicated, the data may be truncated or rounded by the database when applied.

Supported data types — Oracle to Open Target

This section shows the following:

  • The Oracle data types that SharePlex replicates to each supported Open Target target.
  • The default mapping of those Oracle data types to their corresponding data types in the given target, for the purpose of establishing column definitions for replicated ADD COLUMN operations.

NOTES about open Target Data type support: 

  • For replicated DML, SharePlex queries the target database to determine the appropriate data type to use.
  • If the precision or size of the target datatype is not large enough for the data being replicated, the data may be truncated or rounded by the database when applied.
  • To view the DDL operations that SharePlex supports per database, see Supported Oracle DDL operations

Oracle to HANA supported data types

Oracle Data Type Default mapping to HANA Data Type for DDL operations
BINARY_DOUBLE double
BINARY_FLOAT double
BLOB blob
CHAR char
CLOB clob
DATE date
LONG clob
LONGRAW blob
NCHAR nchar
NCLOB nclob
NUMBER decimal
NVARCHAR nvarchar
RAW varbinary
TIMESTAMP timestamp
VARCHAR/VARCHAR2 varchar

Conditions of support

  1. If the precision or size of the target datatype is not large enough for the data being replicated, the data may be truncated or rounded by the database when applied.
  2. See Supported data types — Oracle to Oracle for additional conditions of support for Oracle source data types.

Oracle to MySQL supported data types

Oracle Data Type Default mapping to MySQL Data Type for DDL operations
BINARY_DOUBLE2 double
BINARY_FLOAT double
BLOB longblob
CHAR char
CLOB longtext
DATE datetime
LONG text
LONGRAW blob
NUMBER numeric
RAW varbinary
TIMESTAMP1 datetime
VARCHAR(2) varchar

Conditions of support

  1. If the MySQL target database is earlier than version 5.6.4, the fractional seconds will be truncated. Earlier versions did not support fractional seconds.
  2. Because Oracle and MySQL handle this data type differently, there may be a very small difference in precision between the value of the source and the value of the target row. You may see the difference when viewing the data from SQL*Plus or other utility, but SharePlex will not report this difference as an out-of-sync condition.
  3. See Supported data types — Oracle to Oracle for additional conditions of support for Oracle source data types.

Oracle to PostgreSQL supported data types

Oracle Data Type Default mapping to PostgreSQL Data Type for DDL operations
BINARY_DOUBLE double precision
BINARY_FLOAT 1 double precision
CHAR char
CLOB text
DATE date
LONG text
NCHAR char
NCLOB text
NUMBER numeric
NVARCHAR varchar
TIMESTAMP timestamp
VARCHAR(2) varchar

Conditions of support

  1. The Oracle BINARY_FLOAT and PostgreSQL double precision data types have different precision. Make certain the source and target lengths are compatible. Numbers of 18801973500000000000 or larger can result in out-of-sync errors.
  2. See Supported data types — Oracle to Oracle for additional conditions of support for Oracle source data types.

Oracle to SAP ASE supported data types

Oracle Data Type Mapped to SAP ASE Data Type
BINARY_DOUBLE float
BINARY_FLOAT float
BLOB image
CHAR char
CLOB text
DATE datetime
LONG text
LONGRAW image
NUMBER numeric
RAW varbinary
VARCHAR(2) varchar

Conditions of support

See Supported data types — Oracle to Oracle for additional conditions of support for Oracle source data types.

Oracle to SQL Server supported data types

Oracle Data Type Default mapping to SQL Server Data Type for DDL operations
ANYDATA sql_variant
BINARY_DOUBLE float
BINARY_FLOAT float
BLOB image
CHAR char
CLOB text
DATE datetime2
LONG text
LONGRAW image
NCHAR nchar
NCLOB ntext
NUMBER numeric
NVARCHAR nvarchar
RAW varbinary
TIMESTAMP WITH TIME ZONE datetimeoffset
TIMESTAMP datetime2
VARCHAR(2) varchar

Conditions of support

See Supported data types — Oracle to Oracle for additional conditions of support for Oracle source data types.

Oracle to Sybase supported data types

Oracle Data Type Default mapping to Sybase Data Type for DDL operations
BINARY_DOUBLE float
BINARY_FLOAT float
BLOB image
CHAR char
CLOB text
DATE datetime
LONG text
LONGRAW image
NUMBER numeric
RAW varbinary
VARCHAR(2) varchar

Conditions of support

See Supported data types — Oracle to Oracle for additional conditions of support for Oracle source data types.

Oracle to Teradata supported data types

Oracle Data Type Default mapping to Teradata Data Type for DDL operations
CHAR char
DATE timestamp
NUMBER number
VARCHAR/VARCHAR2 varchar

Conditions of support

See Supported data types — Oracle to Oracle for additional conditions of support for Oracle source data types.

Oracle to XML supported data types

This mapping applies to all targets that receive messages as XML:

  • File in XML format
  • JMS
  • Kafka
Oracle Data Type Default mapping to XML Data Type for DDL operations
BLOB base64Binary
CHAR string
CLOB string
DATE dateTime
BINARY_FLOAT decimal
BINARY_DOUBLE decimal
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 TIME ZONE dateTimeStamp
TIMESTAMP WITH LOCAL TIME ZONE dateTimeStamp
VARCHAR2 string
VARRAY 1 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.

Conditions of support

  1. Only the following data types in a VARRAY are supported by SharePlex when replicating to XML output:

    • BINARY_FLOAT
    • VARCHAR2
    • BINARY_DOUBLE
    • NUMBER
    • TIMESTAMP (This is converted to a DATE data type without microseconds in XML output)
    • DATE
    • UDT (only if it contains one of the data types in this list)
  2. See Supported data types — Oracle to Oracle for additional conditions of support for Oracle source data types.

Supported Oracle DML operations and objects

SharePlex supports DML replication from the following Oracle objects:

  • Any table can be replicated to an Oracle or non-Oracle target if the target supports all of the column types that are being replicated. This includes:

    • index-organized tables
    • partitioned tables
    • views
    • materialized views.
  • Oracle sequences can be replicated from Oracle to Oracle. Replication of sequences is not supported to a non-Oracle target. Important! 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.
  • 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 Database section of the Preinstallation Checklist.

Notes:

  • SharePlex only replicates DML changes that are made to Oracle source objects that are listed in the configuration file.
  • SharePlex replicates changes to those objects only when they appear in Oracle redo log files.

The following table summarizes SharePlex DML support.

DML support Supported for  

INSERT, UPDATE, DELETE, COMMIT, ROLLBACK on tables

All target types  
Direct-path loads (SQL*Loader) (INSERT AND FULL ROLLBACK) All target types  
DML on tables encrypted by Oracle Obfuscation Toolkit All target types  

DML on tables with TDE encryption1

All target types except Oracle 10g and 11gR1  

DML on Oracle Label Security (OLS)2

All target types  

DML on compressed objects: Basic, OLTP, HCC3

All target types  

Direct Load (DLOAD) on compressed objects: Basic, OLTP, HCC3

All target types  

1. Conditions of support - TDE

  • SharePlex supports Tablespace Encryption and Column Encryption for Oracle 11g R2 and later versions, both source and target.
  • The SharePlex copy/append command does not support TDE.

2. Conditions of support - OLS

By default, SharePlex cannot process rows that are protected by OLS 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:

  • The SharePlex user was granted full privilege to the objects in replication.
  • Test tables with OLS security were created.
  • Data was replicated using INSERT/UPDATE/DELETE/ROLLBACK/TRUNCATE, and ALTER TABLE to add and drop columns.

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

Under certain conditions, Oracle does not provide enough information in the redo log for SharePlex to replicate a DML operation on a compressed object.

Supported Oracle DDL operations

SharePlex provides default and optional DDL support.

Notes:

  • SharePlex supports DDL on compressed objects only for Oracle 11gR2 and later source databases.
  • ALTER TABLE to ADD COLUMN and ALTER TABLE to DROP COLUMN are supported on compressed source objects (Basic, OLTP, HCC) for all Oracle and Open Target targets.

  • All other DDL on compressed source objects is supported ONLY for Oracle 11g and later targets.
  • Any object or operation not listed in one of the tables in this section is not supported for that feature.

Default DDL support for objects in replication

This section shows the default DDL support for objects that are included in the active replication configuration either explicitly or with a wildcard.

Oracle-to-Oracle default DDL support

The default Oracle-to-Oracle DDL configuration is controlled by the following parameter settings:

SP_OCT_REPLICATE_DDL=3 and

SP_OCT_AUTOADD_ENABLE=1 and

SP_OCT_REPLICATE_ALL_DDL=0

Supported object Supported Operation
Table and IOT Create table1
Create table as select1, 4
Drop table1
Create index1
Drop index1
Truncate2
Alter table add column2
Alter table drop column 2
Comment on table2
Comment on columns2
Associate Statistics2
Disassociate Statistics2

Partition/

Subpartition2, 3

Add
Split
Merge
Drop
Modify
Coalesce
Exchange
Move
Truncate
Rename
Set
Index1 Create
Alter
Drop

Conditions of support

1. Enabled by default through SP_OCT_AUTOADD_ENABLE=1. Auto-Add automatically adds an object to replication if the name satisfies a wildcard in the active replication configuration.

2. Enabled by default through SP_OCT_REPLICATE_DDL=3. This is the default DDL support for objects that are listed in the active configuration.

3. The full default DDL support applies to user-named interval partitions/subpartitions. For system-named (system generated) interval partitions/subpartitions, SharePlex supports only ALTER TABLE to DROP and TRUNCATE the system-named partitions. If the database is earlier than Oracle 12.2, to enable support for DROP and TRUNCATE of system-named partitions, set the SP_OCT_TRUNC_PARTITION_BY_ID parameter to 1, and ensure that both source and target are updated to SharePlex version 8.6.4 or later. This is not required for Oracle 12.2 or later and any setting is ignored.

Note: SharePlex does not support TRUNCATE of a system-generated sub-partition if the sub-partition is empty, and Post stops with error SP-OPO01002. To configure Post to ignore this error, set the SP_OPO_CONT_ON_ERR parameter to 1 and add error number SP-OPO01002 to the top of the oramsglist file, before you restart Post.

4. For CREATE TABLE AS SELECT, SharePlex supports the following datatypes: LONG, DATE, RAW, LONG RAW, ROWID, LONG VARCHAR, CHAR, CLOB, BLOB, CFILE, BFILE, TIMESTAMP, INTERVAL YEAR TO MONTH, INTERVAL DAY TO SECOND and ANYDATA.

Oracle-to-Open Target default DDL support

This section shows the default DDL support for Oracle objects when replicated to an Open Target, when the objects are included in the active replication configuration either explicitly or with a wildcard.

SharePlex only supports replication of TRUNCATE TABLE and ALTER TABLE to ADD COLUMN or DROP COLUMN to an Open Target database, file, or message container. No other DDL is supported to Open Target.

The default Oracle to Open Target configuration is controlled by the following parameters:

SP_OCT_REPLICATE_DDL=3 and

SP_OCT_AUTOADD_ENABLE=1 and

SP_OCT_REPLICATE_ALL_DDL=0

Supported object Supported Operation
Table and IOT Truncate1
Alter table add column2
Alter table drop column

1. Conditions of support - TRUNCATE TABLE

TRUNCATE TABLE is not supported from Oracle compressed objects to Open Target targets.

2. Conditions of support - data type mappings

The default mappings of Oracle data types to their Open Target counterpart for replicated ALTER TABLE ADD COLUMN DDL is shown in Supported data types — Oracle to Oracle. When SharePlex adds the column, it defines it with the default data type. This mapping applies to the entire configuration (not per table).

Note: These mappings are only used to establish column definitions for replicated ADD COLUMN operations. For replicated DML, SharePlex queries the target database to determine the appropriate data type to use.

  • To view the default datatype mapping, use the target command with the show datatype option in sp_ctrl.
  • To modify a mapping, use the target command with the set datatype option. SharePlex does not validate the accuracy of a custom mapping and Quest cannot be held responsible for any inaccuracies resulting from custom mappings. For syntax, use the help command in sp_ctrl or see the target command in the SharePlex Reference Guide.

Optional DDL support for objects in replication

Valid only for Oracle-to_Oracle replication

You can enable the replication of the following DDL with parameter settings when it is issued on objects that are in the configuration file.

DDL command Parameter
CREATE / DROP TRIGGER SP_OCT_REPLICATE_TRIGGER=1
CREATE / DROP SYNONYM SP_OCT_REPLICATE_SYNONYM=1
GRANT SP_OCT_REPLICATE_GRANT=1

Optional Auto-Add support for objects in replication

Valid only for Oracle-to_Oracle replication

Optional Auto-Add support enables newly created materialized views and sequences to be added to replication automatically if the name of the object satisfies a wildcard in the active configuration file. It is configured as follows:

Materialized Views:

SP_OCT_AUTOADD_ENABLE=1 and

SP_OCT_AUTOADD_MV=1 and

SP_SYS_TARGET_COMPATIBILITY=8.6.2 or higher

Sequences:

SP_OCT_AUTOADD_ENABLE=1 and

SP_OCT_AUTOADD_SEQ=1 and

SP_SYS_TARGET_COMPATIBILITY=8.6.3 or higher

Notes:

  • Not supported for Open Target.
  • For CREATE MATERIALIZED VIEW, SharePlex supports the following datatypes: LONG, DATE, RAW, LONG RAW, ROWID, LONG VARCHAR, CHAR, CLOB, BLOB, CFILE, BFILE, TIMESTAMP, INTERVAL YEAR TO MONTH, INTERVAL DAY TO SECOND and ANYDATA. SharePlex does not support ALTER MATERIALIZE VIEW.
  • SharePlex does not replicate materialized views to materialized views. SharePlex converts a CREATE MATERIALIZED VIEW to a CREATE TABLE, applies the CREATE TABLE to the target, and then replicates the DML that populates the view.
  • 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.

Expanded DDL support for objects not in replication

DDL support for objects not listed in the configuration file is valid only for Oracle-to-Oracle replication. SharePlex replicates the DDL statements, but does not replicate any data change operations made to the objects because they are not part of active replication. The expanded DDL configuration is controlled by the following parameter setting:

SP_OCT_REPLICATE_ALL_DDL=1

NoteS: 

  • Any object or operation not listed is not supported.
  • 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.
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
Directory 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
Grant
Revoke
Role Create role
Alter role
Drop role
Grant
Revoke

Non-supported items for Oracle Database

This is a list of commonly used Oracle components that SharePlex does not replicate. Since both Oracle and SharePlex continually change and improve, this list of exclusions cannot be considered complete. Unless explicitly stated that an item is supported, you should assume that SharePlex does not replicate it.

Object/operation/feature Not supported
Tables and Objects Replication of nested tables
Replication of clustered tables

Replication of Index-Organized Tables with any of the following:

  • LOB columns
  • VARRAY columns
Replication from a Non-IOT to an IOT table

Replication from materialized views to materialized views. (However, SharePlex replicates the underlying table of a materialized view to a target table.)

Replication of Identity columns

DDL operations ANALYZE TABLE and ANALYZE INDEX
DDL operation performed by a SharePlex Oracle user, if SP_OCT_REPLICATE_ALL_DDL is set to 1
DDL to ALTER TABLE ADD OVERFLOW to an IOT in replication
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.
Replication of partial rollbacks of DLOADs
Rows changed by 'UPDATE WITH CASE' syntax
SharePlex transformation and conflict resolution LONG and LONG_RAW datatypes in a configuration where transformation or conflict resolution are performed
Abstract datatypes and VARRAYs in a configuration where conflict resolution is performed
SharePlex horizontal partitioning SharePlex horizontal partitioning of index-organized tables
dbms_lob operations to non-Oracle targets Replication of LOB operations generated by dbms_lob are not supported when replicating to non-Oracle targets.

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 to work around this issue:

  1. Remove source objects from replication
  2. Perform the flashback
  3. Add or change objects in an active configuration
Other Replication of rows in which data exceeds 319 KB in size, excluding LOB and LONG columns

Supported SharePlex featues — Oracle to Open Target

The following table shows whether specific SharePlex features are supported for 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 (except Teradata)  
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
Self Service Tools
Knowledge Base
Notifications & Alerts
Product Support
Software Downloads
Technical Documentation
User Forums
Video Tutorials
Contact Us
Licensing Assistance
Technical Support
View All
Related Documents