Informatica® Cloud (Version Spring 2017)

Oracle Connector Guide

Informatica Cloud Oracle Connector Guide

Version Spring 2017

April 2017
© Copyright Informatica LLC 2016, 2017

This software and documentation contain proprietary information of Informatica LLC and are provided under a license agreement containing restrictions on use and
disclosure and are also protected by copyright law. Reverse engineering of the software is prohibited. No part of this document may be reproduced or transmitted in any
form, by any means (electronic, photocopying, recording or otherwise) without prior consent of Informatica LLC. This Software may be protected by U.S. and/or
international Patents and other Patents Pending.

Use, duplication, or disclosure of the Software by the U.S. Government is subject to the restrictions set forth in the applicable software license agreement and as
provided in DFARS 227.7202-1(a) and 227.7702-3(a) (1995), DFARS 252.227-7013©(1)(ii) (OCT 1988), FAR 12.212(a) (1995), FAR 52.227-19, or FAR 52.227-14
(ALT III), as applicable.

The information in this product or documentation is subject to change without notice. If you find any problems in this product or documentation, please report them to us
in writing.
Informatica, Informatica Platform, Informatica Data Services, PowerCenter, PowerCenterRT, PowerCenter Connect, PowerCenter Data Analyzer, PowerExchange,
PowerMart, Metadata Manager, Informatica Data Quality, Informatica Data Explorer, Informatica B2B Data Transformation, Informatica B2B Data Exchange Informatica
On Demand, Informatica Identity Resolution, Informatica Application Information Lifecycle Management, Informatica Complex Event Processing, Ultra Messaging,
Informatica Master Data Management, and Live Data Map are trademarks or registered trademarks of Informatica LLC in the United States and in jurisdictions
throughout the world. All other company and product names may be trade names or trademarks of their respective owners.

Portions of this software and/or documentation are subject to copyright held by third parties, including without limitation: Copyright DataDirect Technologies. All rights
reserved. Copyright © Sun Microsystems. All rights reserved. Copyright © RSA Security Inc. All Rights Reserved. Copyright © Ordinal Technology Corp. All rights
reserved. Copyright © Aandacht c.v. All rights reserved. Copyright Genivia, Inc. All rights reserved. Copyright Isomorphic Software. All rights reserved. Copyright © Meta
Integration Technology, Inc. All rights reserved. Copyright © Intalio. All rights reserved. Copyright © Oracle. All rights reserved. Copyright © Adobe Systems
Incorporated. All rights reserved. Copyright © DataArt, Inc. All rights reserved. Copyright © ComponentSource. All rights reserved. Copyright © Microsoft Corporation. All
rights reserved. Copyright © Rogue Wave Software, Inc. All rights reserved. Copyright © Teradata Corporation. All rights reserved. Copyright © Yahoo! Inc. All rights
reserved. Copyright © Glyph & Cog, LLC. All rights reserved. Copyright © Thinkmap, Inc. All rights reserved. Copyright © Clearpace Software Limited. All rights
reserved. Copyright © Information Builders, Inc. All rights reserved. Copyright © OSS Nokalva, Inc. All rights reserved. Copyright Edifecs, Inc. All rights reserved.
Copyright Cleo Communications, Inc. All rights reserved. Copyright © International Organization for Standardization 1986. All rights reserved. Copyright © ej-
technologies GmbH. All rights reserved. Copyright © Jaspersoft Corporation. All rights reserved. Copyright © International Business Machines Corporation. All rights
reserved. Copyright © yWorks GmbH. All rights reserved. Copyright © Lucent Technologies. All rights reserved. Copyright © University of Toronto. All rights reserved.
Copyright © Daniel Veillard. All rights reserved. Copyright © Unicode, Inc. Copyright IBM Corp. All rights reserved. Copyright © MicroQuill Software Publishing, Inc. All
rights reserved. Copyright © PassMark Software Pty Ltd. All rights reserved. Copyright © LogiXML, Inc. All rights reserved. Copyright © 2003-2010 Lorenzi Davide, All
rights reserved. Copyright © Red Hat, Inc. All rights reserved. Copyright © The Board of Trustees of the Leland Stanford Junior University. All rights reserved. Copyright
© EMC Corporation. All rights reserved. Copyright © Flexera Software. All rights reserved. Copyright © Jinfonet Software. All rights reserved. Copyright © Apple Inc. All
rights reserved. Copyright © Telerik Inc. All rights reserved. Copyright © BEA Systems. All rights reserved. Copyright © PDFlib GmbH. All rights reserved. Copyright ©
Orientation in Objects GmbH. All rights reserved. Copyright © Tanuki Software, Ltd. All rights reserved. Copyright © Ricebridge. All rights reserved. Copyright © Sencha,
Inc. All rights reserved. Copyright © Scalable Systems, Inc. All rights reserved. Copyright © jQWidgets. All rights reserved. Copyright © Tableau Software, Inc. All rights
reserved. Copyright© MaxMind, Inc. All Rights Reserved. Copyright © TMate Software s.r.o. All rights reserved. Copyright © MapR Technologies Inc. All rights reserved.
Copyright © Amazon Corporate LLC. All rights reserved. Copyright © Highsoft. All rights reserved. Copyright © Python Software Foundation. All rights reserved.
Copyright © BeOpen.com. All rights reserved. Copyright © CNRI. All rights reserved.

This product includes software developed by the Apache Software Foundation (http://www.apache.org/), and/or other software which is licensed under various versions
of the Apache License (the "License"). You may obtain a copy of these Licenses at http://www.apache.org/licenses/. Unless required by applicable law or agreed to in
writing, software distributed under these Licenses is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
implied. See the Licenses for the specific language governing permissions and limitations under the Licenses.

This product includes software which was developed by Mozilla (http://www.mozilla.org/), software copyright The JBoss Group, LLC, all rights reserved; software
copyright © 1999-2006 by Bruno Lowagie and Paulo Soares and other software which is licensed under various versions of the GNU Lesser General Public License
Agreement, which may be found at http:// www.gnu.org/licenses/lgpl.html. The materials are provided free of charge by Informatica, "as-is", without warranty of any
kind, either express or implied, including but not limited to the implied warranties of merchantability and fitness for a particular purpose.

The product includes ACE(TM) and TAO(TM) software copyrighted by Douglas C. Schmidt and his research group at Washington University, University of California,
Irvine, and Vanderbilt University, Copyright (©) 1993-2006, all rights reserved.

This product includes software developed by the OpenSSL Project for use in the OpenSSL Toolkit (copyright The OpenSSL Project. All Rights Reserved) and
redistribution of this software is subject to terms available at http://www.openssl.org and http://www.openssl.org/source/license.html.

This product includes Curl software which is Copyright 1996-2013, Daniel Stenberg, <[email protected]>. All Rights Reserved. Permissions and limitations regarding this
software are subject to terms available at http://curl.haxx.se/docs/copyright.html. Permission to use, copy, modify, and distribute this software for any purpose with or
without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.

The product includes software copyright 2001-2005 (©) MetaStuff, Ltd. All Rights Reserved. Permissions and limitations regarding this software are subject to terms
available at http://www.dom4j.org/ license.html.

The product includes software copyright © 2004-2007, The Dojo Foundation. All Rights Reserved. Permissions and limitations regarding this software are subject to
terms available at http://dojotoolkit.org/license.

This product includes ICU software which is copyright International Business Machines Corporation and others. All rights reserved. Permissions and limitations
regarding this software are subject to terms available at http://source.icu-project.org/repos/icu/icu/trunk/license.html.

This product includes software copyright © 1996-2006 Per Bothner. All rights reserved. Your right to use such materials is set forth in the license which may be found at
http:// www.gnu.org/software/ kawa/Software-License.html.

This product includes OSSP UUID software which is Copyright © 2002 Ralf S. Engelschall, Copyright © 2002 The OSSP Project Copyright © 2002 Cable & Wireless
Deutschland. Permissions and limitations regarding this software are subject to terms available at http://www.opensource.org/licenses/mit-license.php.

This product includes software developed by Boost (http://www.boost.org/) or under the Boost software license. Permissions and limitations regarding this software are
subject to terms available at http:/ /www.boost.org/LICENSE_1_0.txt.

This product includes software copyright © 1997-2007 University of Cambridge. Permissions and limitations regarding this software are subject to terms available at
http:// www.pcre.org/license.txt.

This product includes software copyright © 2007 The Eclipse Foundation. All Rights Reserved. Permissions and limitations regarding this software are subject to terms
available at http:// www.eclipse.org/org/documents/epl-v10.php and at http://www.eclipse.org/org/documents/edl-v10.php.
This product includes software licensed under the terms at http://www.tcl.tk/software/tcltk/license.html, http://www.bosrup.com/web/overlib/?License, http://
www.stlport.org/doc/ license.html, http://asm.ow2.org/license.html, http://www.cryptix.org/LICENSE.TXT, http://hsqldb.org/web/hsqlLicense.html, http://
httpunit.sourceforge.net/doc/ license.html, http://jung.sourceforge.net/license.txt , http://www.gzip.org/zlib/zlib_license.html, http://www.openldap.org/software/release/
license.html, http://www.libssh2.org, http://slf4j.org/license.html, http://www.sente.ch/software/OpenSourceLicense.html, http://fusesource.com/downloads/license-
agreements/fuse-message-broker-v-5-3- license-agreement; http://antlr.org/license.html; http://aopalliance.sourceforge.net/; http://www.bouncycastle.org/licence.html;
http://www.jgraph.com/jgraphdownload.html; http://www.jcraft.com/jsch/LICENSE.txt; http://jotm.objectweb.org/bsd_license.html; . http://www.w3.org/Consortium/Legal/
2002/copyright-software-20021231; http://www.slf4j.org/license.html; http://nanoxml.sourceforge.net/orig/copyright.html; http://www.json.org/license.html; http://
forge.ow2.org/projects/javaservice/, http://www.postgresql.org/about/licence.html, http://www.sqlite.org/copyright.html, http://www.tcl.tk/software/tcltk/license.html, http://
www.jaxen.org/faq.html, http://www.jdom.org/docs/faq.html, http://www.slf4j.org/license.html; http://www.iodbc.org/dataspace/iodbc/wiki/iODBC/License; http://
www.keplerproject.org/md5/license.html; http://www.toedter.com/en/jcalendar/license.html; http://www.edankert.com/bounce/index.html; http://www.net-snmp.org/about/
license.html; http://www.openmdx.org/#FAQ; http://www.php.net/license/3_01.txt; http://srp.stanford.edu/license.txt; http://www.schneier.com/blowfish.html; http://
www.jmock.org/license.html; http://xsom.java.net; http://benalman.com/about/license/; https://github.com/CreateJS/EaselJS/blob/master/src/easeljs/display/Bitmap.js;
http://www.h2database.com/html/license.html#summary; http://jsoncpp.sourceforge.net/LICENSE; http://jdbc.postgresql.org/license.html; http://
protobuf.googlecode.com/svn/trunk/src/google/protobuf/descriptor.proto; https://github.com/rantav/hector/blob/master/LICENSE; http://web.mit.edu/Kerberos/krb5-
current/doc/mitK5license.html; http://jibx.sourceforge.net/jibx-license.html; https://github.com/lyokato/libgeohash/blob/master/LICENSE; https://github.com/hjiang/jsonxx/
blob/master/LICENSE; https://code.google.com/p/lz4/; https://github.com/jedisct1/libsodium/blob/master/LICENSE; http://one-jar.sourceforge.net/index.php?
page=documents&file=license; https://github.com/EsotericSoftware/kryo/blob/master/license.txt; http://www.scala-lang.org/license.html; https://github.com/tinkerpop/
blueprints/blob/master/LICENSE.txt; http://gee.cs.oswego.edu/dl/classes/EDU/oswego/cs/dl/util/concurrent/intro.html; https://aws.amazon.com/asl/; https://github.com/
twbs/bootstrap/blob/master/LICENSE; https://sourceforge.net/p/xmlunit/code/HEAD/tree/trunk/LICENSE.txt; https://github.com/documentcloud/underscore-contrib/blob/
master/LICENSE, and https://github.com/apache/hbase/blob/master/LICENSE.txt.
This product includes software licensed under the Academic Free License (http://www.opensource.org/licenses/afl-3.0.php), the Common Development and Distribution
License (http://www.opensource.org/licenses/cddl1.php) the Common Public License (http://www.opensource.org/licenses/cpl1.0.php), the Sun Binary Code License
Agreement Supplemental License Terms, the BSD License (http:// www.opensource.org/licenses/bsd-license.php), the new BSD License (http://opensource.org/
licenses/BSD-3-Clause), the MIT License (http://www.opensource.org/licenses/mit-license.php), the Artistic License (http://www.opensource.org/licenses/artistic-
license-1.0) and the Initial Developer’s Public License Version 1.0 (http://www.firebirdsql.org/en/initial-developer-s-public-license-version-1-0/).

This product includes software copyright © 2003-2006 Joe WaInes, 2006-2007 XStream Committers. All rights reserved. Permissions and limitations regarding this
software are subject to terms available at http://xstream.codehaus.org/license.html. This product includes software developed by the Indiana University Extreme! Lab.
For further information please visit http://www.extreme.indiana.edu/.

This product includes software Copyright (c) 2013 Frank Balluffi and Markus Moeller. All rights reserved. Permissions and limitations regarding this software are subject
to terms of the MIT license.

See patents at https://www.informatica.com/legal/patents.html.

DISCLAIMER: Informatica LLC provides this documentation "as is" without warranty of any kind, either express or implied, including, but not limited to, the implied
warranties of noninfringement, merchantability, or use for a particular purpose. Informatica LLC does not warrant that this software or documentation is error free. The
information provided in this software or documentation may include technical inaccuracies or typographical errors. The information in this software and documentation is
subject to change at any time without notice.

NOTICES

This Informatica product (the "Software") includes certain drivers (the "DataDirect Drivers") from DataDirect Technologies, an operating company of Progress Software
Corporation ("DataDirect") which are subject to the following terms and conditions:

1. THE DATADIRECT DRIVERS ARE PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT
LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT.
2. IN NO EVENT WILL DATADIRECT OR ITS THIRD PARTY SUPPLIERS BE LIABLE TO THE END-USER CUSTOMER FOR ANY DIRECT, INDIRECT,
INCIDENTAL, SPECIAL, CONSEQUENTIAL OR OTHER DAMAGES ARISING OUT OF THE USE OF THE ODBC DRIVERS, WHETHER OR NOT
INFORMED OF THE POSSIBILITIES OF DAMAGES IN ADVANCE. THESE LIMITATIONS APPLY TO ALL CAUSES OF ACTION, INCLUDING, WITHOUT
LIMITATION, BREACH OF CONTRACT, BREACH OF WARRANTY, NEGLIGENCE, STRICT LIABILITY, MISREPRESENTATION AND OTHER TORTS.

Publication Date: 2017-03-31

Table of Contents
Preface. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Informatica Resources. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Informatica Documentation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Informatica Cloud Web Site. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Informatica Cloud Communities. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Informatica Cloud Marketplace. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Informatica Cloud Connector Documentation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Informatica Knowledge Base. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Informatica Cloud Trust Site. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Informatica Global Customer Support. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

Chapter 1: Introduction to Oracle Connector. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

Oracle Connector Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Oracle Supported Objects and Task Operations. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Oracle Connector Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

Chapter 2: Oracle Connections. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

Oracle Connections Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Oracle Connection Properties. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Oracle Connection Rules and Guidelines. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

Chapter 3: Data Synchronization Tasks with Oracle Connector. . . . . . . . . . . . . . . . . 13

Oracle Sources in Data Synchronization Tasks. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Oracle Targets in Data Synchronization Tasks. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Oracle Lookups in Data Synchronization Tasks. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Rules and Guidelines for Oracle Sources and Targets. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Data Filters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Simple Data Filters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Advanced Data Filters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Rules and Guidelines for Data Filters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

Chapter 4: Mappings and Mapping Configuration Tasks with Oracle

Connector. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Oracle Sources in Mappings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Key Range Partitioning. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Configuring Key Range Partitioning. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
Oracle Targets in Mappings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Pushdown Optimization. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Full pushdown. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Source Pushdown. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

4 Table of Contents
 Pushdown Optimization Functions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Configuring Pushdown Optimization. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

Chapter 5: Data Replication Tasks. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

Data Replication Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Data Replication Source Properties. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
Data Replication Target Properties. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
Full Load. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
Rules and Guidelines for Oracle Sources and Targets. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

Chapter 6: Troubleshooting. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Troubleshooting Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Troubleshooting an Oracle Connection. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
Troubleshooting a Data Synchronization Task. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
Troubleshooting a Data Replication Task. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

Index. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

Table of Contents 5
Preface
The Informatica Cloud Oracle Connector Guide contains information about how to set up and use Oracle
Connector. The guide explains how you can use Oracle Connector to read data from and write data to Oracle
databases.

Informatica Resources

Informatica Documentation
To get the latest documentation for your product, browse the Informatica Knowledge Base at
https://kb.informatica.com/_layouts/ProductDocumentation/Page/ProductDocumentSearch.aspx.

If you have questions, comments, or ideas about this documentation, contact the Informatica Documentation
team through email at [email protected].

Informatica Cloud Web Site

You can access the Informatica Cloud web site at http://www.informatica.com/cloud. This site contains
information about Informatica Cloud editions and applications.

Informatica Cloud Communities

Use the Informatica Cloud Community to discuss and resolve technical issues in Informatica Cloud. You can
also find technical tips, documentation updates, and answers to frequently asked questions.

Access the Informatica Cloud Community at:

https://network.informatica.com/community/informatica-network/products/cloud-integration

To find resources on using Cloud Application Integration (the Informatica Cloud Real Time service), access
the community at:

https://network.informatica.com/community/informatica-network/products/cloud-integration/cloud-application-
integration/content

Developers can learn more and share tips at the Cloud Developer community:

https://network.informatica.com/community/informatica-network/products/cloud-integration/cloud-developers

Informatica Cloud Marketplace

Visit the Informatica Marketplace to try and buy Informatica Cloud Connectors, Informatica Cloud integration
templates, and Data Quality mapplets:

https://marketplace.informatica.com/community/collections/cloud_integration

6
Informatica Cloud Connector Documentation
You can access documentation for Informatica Cloud Connectors at the Informatica Cloud Community:
https://network.informatica.com/cloud/index.htm

You can also download individual connector guides: https://network.informatica.com/docs/DOC-15333.

Informatica Knowledge Base

Use the Informatica Knowledge Base to search Informatica Network for product resources such as
documentation, how-to articles, best practices, and PAMs.

To access the Knowledge Base, visit https://kb.informatica.com. If you have questions, comments, or ideas
about the Knowledge Base, contact the Informatica Knowledge Base team at
[email protected].

Informatica Cloud Trust Site

You can access the Informatica Cloud trust site at http://trust.informaticacloud.com. This site provides real
time information about Informatica Cloud system availability, current and historical data about system
performance, and details about Informatica Cloud security policies.

Informatica Global Customer Support

You can contact a Customer Support Center by telephone or online.

For online support, click Submit Support Request in the Informatica Cloud application. You can also use
Online Support to log a case. Online Support requires a login. You can request a login at
https://network.informatica.com/welcome.

The telephone numbers for Informatica Global Customer Support are available from the Informatica web site
at https://www.informatica.com/services-and-training/support-services/contact-us.html.

Informatica Resources 7
CHAPTER 1

Introduction to Oracle Connector

This chapter includes the following topics:

• Oracle Connector Overview, 8

• Oracle Supported Objects and Task Operations, 8
• Oracle Connector Example, 9

Oracle Connector Overview

You can use Oracle Connector to connect to Oracle databases from Informatica Cloud. Use Oracle
Connector to read data from or write data to Oracle databases.

You can use Oracle objects as sources and targets in Contact Validation tasks, Data Synchronization tasks,
Data Masking tasks, Data Replication tasks, PowerCenter tasks, Mapping Configuration tasks, and
mappings.

You can create, update, or delete records when you use Oracle Connector to write to Oracle databases.
When you create a Mapping Configuration task, you can use the Oracle bulk API to perform insert
operations.

Note: Oracle Connector does not support BLOB data type.

Oracle Supported Objects and Task Operations

The following table lists the tasks and object types that Oracle Connector supports:

Task Type Source Target Lookup

Contact Validation Yes Yes Yes

Data Masking Yes Yes Yes

Data Replication Yes Yes Yes

Data Synchronization Yes Yes Yes

8
 Task Type Source Target Lookup

Mapping Configuration Yes Yes Yes

PowerCenter Yes Yes Yes

For information about Contact Validation tasks, Data Masking tasks, and PowerCenter tasks, see Deploy.

Note: Do not include NChar and Nvarchar2 columns in Oracle targets. Due to an ODBC driver limitation, the
PowerCenter task truncates the last half of NChar and Nvarchar2 data before writing it to Oracle targets.

Oracle Connector Example

You are an operations analyst who manages the customer support website of your organization. You want to
get the complete statistics and elaborate reports about the support your organization gives to the customers.

You can use Oracle Connector to read data and maintain a database. You can configure a Data
Synchronization task or Mapping Configuration task to read data from Oracle. You can then write the data to
data visualization tools such as Tableau to visually analyze the data.

Oracle Connector Example 9

CHAPTER 2

Oracle Connections
This chapter includes the following topics:

• Oracle Connections Overview, 10

• Oracle Connection Properties, 10
• Oracle Connection Rules and Guidelines, 11

Oracle Connections Overview

Create an Oracle connection to connect to Oracle databases to read and write data. You can use Oracle
connections in Data Synchronization tasks, Contact Validation tasks, Data Replication tasks, Data Masking
tasks, PowerCenter tasks, Mapping Configuration tasks, and mappings.

Oracle Connector supports Oracle 10g, 11g, and 12c versions. You can connect to Oracle 12c databases
that provide Multitenancy and In-Memory features.
Note: You cannot connect to an Oracle 12c database instance if the Secure Agent runs on Windows 32-bit or
Linux 32-bit operating systems.

Oracle Connection Properties

When you create an Oracle connection, you must configure the connection properties.

The following table describes the connection properties:

Connection Property Description

Runtime Environment Runtime environment that contains the Secure Agent used to access Oracle.

User Name User name for the database login. The user name cannot contain a semicolon.

Password Password for the database login. The password cannot contain a semicolon.

Host Name of the machine that hosts the database server.

Port Network port number used to connect to the database server. Default is 1521.

10
 Connection Property Description

Service Name Service name or System ID (SID) that uniquely identifies the Oracle database.
Specify the SID in the following format to connect to Oracle databases: SID:<ORACLE_SID>

Schema Schema used for the Oracle connection.

Code Page The code page of the database server. Select one of the following code pages:
- MS Windows Latin 1. Select for ISO 8859-1 Western European data.
- UTF-8. Select for Unicode data.
- Shift-JIS. Select for double-byte character data.
- ISO 8859-15 Latin 9 (Western European).
- ISO 8859-2 Eastern European.
- ISO 8859-3 Southeast European.
- ISO 8859-5 Cyrillic.
- ISO 8859-9 Latin 5 (Turkish).
- IBM EBCDIC International Latin-1.

You can configure the following Oracle-specific custom properties under the Secure Agent configuration
properties:

Custom Property Description

OdbcDataDirectNonWapi For Data Synchronization tasks, Mapping Configuration tasks, Data

Replication tasks, and mappings that use relational multibyte data, add the
OdbcDataDirectNonWapi property and set the property to 0 to process
Unicode data.
Note: When you set this property to 0, the processing time of single-byte
data might increase.
Enter the following values:
For Type, select DTM.
For Sub-type, select INFO.
For Name, enter OdbcDataDirectNonWapi.
For Value, enter 0.

oracle.use.varchar.for.number For Data Synchronization tasks, Mapping Configuration tasks, Data

Replication tasks, and mappings that have an Oracle source and a
Salesforce target, set the oracle.use.varchar.for.number custom
property if the Oracle source contains many fields with the Number data
type. Values for fields with the Number data type do not load correctly in
Salesforce. Enter the following values:
For Type, select Tomcat.
For Name, enter oracle.use.varchar.for.number.
For Value, enter true.

Oracle Connection Rules and Guidelines

Consider the following rules and guidelines when you create an Oracle connection:

• An Oracle table name can have a maximum of 30 characters.

Oracle Connection Rules and Guidelines 11

 • When you run a task that contains an Oracle database in the Public schema, ensure that the schema
does not contain too many objects. If the schema contains too many objects, the task times out. You can
remove some objects from the Oracle database or move the objects into another database schema.
• When you run a task for an Oracle database target, ensure that the UTF-8 characters do not exceed the
maximum length of the varchar or char fields. Informatica Cloud might truncate UTF-8 characters if they
exceed the maximum length of the varchar or char fields.

12 Chapter 2: Oracle Connections

CHAPTER 3

Data Synchronization Tasks with

Oracle Connector
This chapter includes the following topics:

• Oracle Sources in Data Synchronization Tasks, 13

• Oracle Targets in Data Synchronization Tasks, 14
• Oracle Lookups in Data Synchronization Tasks, 14
• Rules and Guidelines for Oracle Sources and Targets, 14
• Data Filters, 15
• Rules and Guidelines for Data Filters, 15

Oracle Sources in Data Synchronization Tasks

When you configure a Data Synchronization task to use an Oracle source, you can read data from a single
object, multiple related objects, or a saved query. To read data from multiple sources, you must define
relationships based on key columns or create a user-defined join condition. To optimize performance, you
can configure a filter in the Data Filters tab. You can add multiple Oracle objects that have an explicit
relationship defined in Oracle.

You can also create a data filter, where you can select an object, field, operator, and enter a filter value
based on which the Data Synchronization task runs. You can also configure an advanced filter to define a
more complex filter condition, which can include multiple conditions using the AND or OR logical operators.

The following table describes the Oracle source properties:

Property Description

Connection Name of the active source connection.

Source Type Type of the source object available. You can choose from the following source types:
- Single
- Multiple
- Saved query

13
 Property Description

Source Object Name of the source object.

Display source fields in Displays source fields in alphabetical order. By default, fields appear in the order returned by
alphabetical order the source system.

Oracle Targets in Data Synchronization Tasks

You can use a single object as a target in a Data Synchronization task.

The following table describes the Oracle target properties:

Property Description

Connection Name of the active target connection.

Target Object Name of target objects available in the connection.

Truncate Target When you enable the Truncate Target option, the Secure
Agent truncates the table. Default is false.

Enable Target Bulk Load Uses Oracle bulk API to write data in bulk mode to Oracle.
Default is unselected.

Display target fields in alphabetical order Displays target fields in alphabetical order. By default, fields
appear in the order returned by the target system.

Oracle Lookups in Data Synchronization Tasks

When you configure field mappings in a Data Synchronization task, you can create a lookup to an Oracle
object. When you use an Oracle object as a lookup, you do not need to configure specific Oracle properties.

Rules and Guidelines for Oracle Sources and

Targets
Use the following rules and guidelines for Oracle sources and targets:

• You can use database tables, synonyms, or views as sources and targets.
• When you use an Oracle source with a Salesforce target, if the source contains fields with the Number
data type, change the field type to numeric. Values for fields with the Number data type do not load
correctly in Salesforce. You can change the type on the Field Mapping page of the Data Synchronization

14 Chapter 3: Data Synchronization Tasks with Oracle Connector

 Task wizard. If you have many fields with the Number data type, you can add the
oracle.use.varchar.for.number custom property for the Secure Agent.
• When you create a saved query to read data from an Oracle database, you must omit the final semicolon
from the SQL statement.
• You cannot use the select * from <TABLE_NAME> SQL command in a saved query. You must provide the
explicit column list.
• If there is an error row when you run a task to write files to an Oracle target in bulk mode, the Secure
Agent writes the batch that contains the error row in normal mode.

Data Filters
You can create simple or advanced data filters. You can also create a set of data filters for each object
included in a Data Replication or Data Synchronization task. Each set of data filters act independently of the
other sets.

Simple Data Filters

You can create one or more simple data filters. When you create multiple simple data filters, the associated
task creates an AND operator between the filters and loads rows that apply to all simple data filters.

Advanced Data Filters

You can create an advanced data filter to create complex expressions that use AND, OR, or nested
conditions. The expression that you enter becomes the WHERE clause in the query used to retrieve records
from the source.

Rules and Guidelines for Data Filters

Use the following rules and guidelines when you configure data filters:

• If you include UTF-8 characters in a data filter on an Oracle source, the data filter does not work.
• If you create a simple data filter on a date field in an Oracle source, the date field must use the default
Oracle format DD-MON-YY. To create a filter on a date field with a non-default date format, use an
advanced data filter.
For example, to read an Oracle date field that has the date format 'yyyy/mm/dd:hh:mi:ssam', use the
following advanced filter:
“DATE_FIELD” > to_date('1998/05/31:12:00:00AM', 'yyyy/mm/dd:hh:mi:ssam')

Data Filters 15
CHAPTER 4

Mappings and Mapping

Configuration Tasks with Oracle
Connector
This chapter includes the following topics:

• Oracle Sources in Mappings, 16

• Key Range Partitioning, 17
• Oracle Targets in Mappings, 19
• Pushdown Optimization, 19

Oracle Sources in Mappings

To read data from an Oracle database, configure an Oracle object as the Source transformation in a
mapping.

Enable partitioning when you configure the Source transformation in the Mapping Designer to optimize the
performance of the Mapping Configuration task.

Specify the name and description of the Oracle source. Configure the source, query options, and advanced
properties for the source object.

The following table describes the properties that you can configure for an Oracle source:

Property Description

Connection Name of the active source connection.

Source Type Type of the Oracle source object available. You can choose from the following source types:
- Single
- Multiple
- Query
- Parameter

Object Name of the source object for the mapping.

You can specify a custom query for a source object.

16
 Property Description

Filter Configure a simple filter or an advanced filter to remove rows at the source. You can improve efficiency by
filtering early in the data flow.
A simple filter includes a field name, operator, and value. Use an advanced filter to define a more complex
filter condition, which can include multiple conditions using the AND or OR logical operators.

Sort Select the fields and type of sorting to use. To sort data for a parameterized source, you must use a
parameter for the sort options.

Select distinct When you read data from multiple sources, select this option to read only distinct rows.
rows only

The following table describes the advanced properties that you can configure for an Oracle source:

Advanced Property Description

Tracing Level Amount of detail that appears in the log for this transformation. You can choose terse, normal, verbose
initialization, or verbose data. Default is normal.

Pre SQL Pre-SQL command that must be run before reading data from the source.

Post SQL Post-SQL command that must be run after writing data to the target.

Output is Relational source or transformation output that does not change between session runs when the input
deterministic data is consistent between runs.
When you configure this property, the Secure Agent does not stage source data for recovery if
transformations in the pipeline always produce repeatable data.

Output is repeatable Relational source or transformation output that is in the same order between session runs when the
order of the input data is consistent.
When output is deterministic and output is repeatable, the Secure Agent does not stage source data for
recovery.

Key Range Partitioning

You can configure key range partitioning when you use a Mapping Configuration task to read data from
Oracle sources. With key range partitioning, the Secure Agent distributes rows of source data based on the
fields that you define as partition keys. The Secure Agent compares the field value to the range values for
each partition and sends rows to the appropriate partitions.

Use key range partitioning for columns that have an even distribution of data values. Otherwise, the partitions
might have unequal size. For example, a column might have 10 rows between key values 1 and 1000 and the
column might have 999 rows between key values 1001 and 2000. If the mapping includes multiple sources,
use the same number of key ranges for each source.

When you define key range partitioning for a column, the Secure Agent reads the rows that are within the
specified partition range. For example, if you configure two partitions for a column with the ranges as 10
through 20 and 30 through 40, the Secure Agent does not read the rows 20 through 30 because these rows
are not within the specified partition range.

Key Range Partitioning 17

 You can configure a partition key for fields of the following data types:

• String
• Any type of number data type. However, you cannot use decimals in key range values.
• Date/time type. Use the following format: MM/DD/YYYY HH24:MI:SS

You cannot use key range partitions when a mapping includes any of the following transformations:

• Web Services
• XML to Relational

Configuring Key Range Partitioning

Perform the following steps to configure key range partitioning for Oracle sources:

1. In the Source Properties, click the Partitions tab.

2. Select the required partition key from the list.
3. Click Add New Key Range to define the number of partitions and the key ranges based on which the
Secure Agent must partition data.
Use a blank value for the start range to indicate the minimum value. Use a blank value for the end range
to indicate the maximum value.
The following image displays the Partitions tab:

18 Chapter 4: Mappings and Mapping Configuration Tasks with Oracle Connector

Oracle Targets in Mappings
To write data to an Oracle target, configure an Oracle object as the Target transformation in a mapping.
Specify the name and description of the Oracle target. Configure the target and advanced properties for the
target object.

The following table describes the properties that you can configure for an Oracle target:

Property Description

Connection Name of the active Oracle target connection.

Target Type Type of the Oracle target object available. You can choose from the following target types:
- Single
- Parameter

Object You can select an existing object from the list or create a target at run time.

Operation Select the target operation. You can perform the following operations on an Oracle target:
- Insert
- Update
- Upsert
- Delete
- Data Driven

Truncate target When you enable the Truncate Target option, the Secure Agent truncates the table. Default is false.

Enable Target Bulk Uses Oracle bulk API to insert data in bulk mode.
Load When you create a Mapping Configuration task, you can use the Oracle bulk API to perform insert
operations.
Default is unselected.

If you select the Forward Rejected Rows option, the Secure Agent flags the rows for reject and writes them
to the reject file. If you do not select the Forward Rejected Rows option, the Secure Agent drops rejected
rows and writes them to the session log file. The Secure Agent does not write the rejected rows to the reject
file.

Note: If there is an error row when you run a task to write files to an Oracle target in bulk mode, the Secure
Agent writes the batch that contains the error row in normal mode.

Pushdown Optimization
When you read data from an Oracle source, transform the data, and write the data to a target, you can
configure pushdown optimization to push the transformation logic to the source or target database system. If
the source and target databases are the same, you can configure full pushdown optimization for improved
performance.

When the Secure Agent applies pushdown optimization, it pushes transformation logic to a database. The
Secure Agent translates the transformation logic into SQL queries and sends the SQL queries to the
database. The database runs the SQL queries to process the transformations.

Pushdown optimization improves mapping performance when the database can process the transformation
logic faster than the Secure Agent. The Secure Agent also reads less data from the database.

Oracle Targets in Mappings 19

 The amount of transformation logic that the Secure Agent pushes to the database depends on the database,
the transformation logic, and the mapping configuration. The Secure Agent processes all transformation logic
that it cannot push to a database.

When you configure pushdown optimization for the mapping, the Secure Agent analyzes the optimized
mapping from the source to the target or until it reaches a downstream transformation that it cannot push to
the source database. The Secure Agent generates and executes a SELECT statement for each source that
has transformation logic pushed down. Then, it reads the results of this SQL query and processes the
remaining transformations in the mapping.

Note: When you push down transformation logic to the database, ensure that the database has enough
resources to process the queries faster. Otherwise, there could be a performance degradation.

The Secure Agent can push the following transformation logic to an Oracle source or target:

Transformations Supported Pushdown Type

Aggregator Source, Full

Expression Source, Full

Filter Source, Full

Joiner Source, Full

Sorter Source, Full

Union Source, Full

Router Full

Full pushdown
When the Secure Agent applies full pushdown optimization, it pushes all the transformation logic in the
mapping to the target database. You can configure full pushdown in the Advanced Session Properties
section.

Full pushdown optimization is ideal when the source and target are in the same connections. For example, if
a mapping contains an Oracle source and an Oracle target, configure full pushdown optimization to push all
the transformation logic for processing from an Oracle source database to an Oracle target database.

Source Pushdown
When the Secure Agent applies source pushdown, it analyzes the mapping from source to target or until it
reaches a downstream transformation it cannot push to the source database.

The Secure Agent generates and executes a SELECT statement based on the transformation logic for each
transformation it can push to the database. Then, it reads the results of this SQL query and processes the
remaining transformations.

You can configure a mapping to use source pushdown if the source and target reside in different databases.
For example, if a mapping contains an Oarcle source and an Oracle target, you can configure source
pushdown to push some transformation logic for processing to the Oracle source.

20 Chapter 4: Mappings and Mapping Configuration Tasks with Oracle Connector

Pushdown Optimization Functions
The following table summarizes the availability of pushdown functions in an Oracle source or target:

Functions Pushdown Type

ABS() Source, Full

AVG() Source, Full

COS() Source, Full

COUNT() Source, Full

DATE_COMPARE() Source, Full

DECODE() Source, Full

EXP() Source, Full

IIF() Source, Full

IN() Source, Full

ISNULL() Source, Full

LOWER() Source, Full

MAX() Source, Full

MIN() Source, Full

POWER() Source, Full

SIN() Source, Full

SQRT() Source, Full

SUM() Source, Full

TAN() Source, Full

UPPER() Source, Full

Configuring Pushdown Optimization

Perform the following steps to configure pushdown optimization for Oracle sources or targets:

1. In the Schedule tab of the Mapping Configuration task, navigate to the Advanced Session Properties
section.
2. Click Add to add a new session property.
3. From the Session Property Name list, select Pushdown Optimization.

Pushdown Optimization 21
 4. From the Session Property Value list, select the required type of pushdown optimization. The following
image shows the types of pushdown optimization that you can configure:

22 Chapter 4: Mappings and Mapping Configuration Tasks with Oracle Connector

CHAPTER 5

Data Replication Tasks

This chapter includes the following topics:

• Data Replication Overview, 23

• Data Replication Source Properties, 24
• Data Replication Target Properties, 24
• Full Load, 24
• Rules and Guidelines for Oracle Sources and Targets, 25

Data Replication Overview

You can replicate Oracle data to a target by using the Data Replication task. You might replicate data to back
up the data or perform offline reporting. You can replicate data in Oracle objects to databases or flat files.

A Data Replication task can replicate data from one or more Oracle objects. When you configure the task,
you can replicate all available objects through the selected connection, or you can select objects for
replication by including or excluding a set of objects.

You can also exclude rows and columns from the Data Replication task. Associate a schedule with a Data
Replication task to specify when and how often the task runs.

When you replicate Oracle sources, you can replicate all current rows in the Oracle source. The names of
source tables and fields can contain at most 30 characters.

For example, the Data Replication task creates a column name in an Oracle database based on the following
40-character field name:

TenLetters1234567890TenLettersXXXXXXXXXX

The Data Replication task truncates the column name to the first 30 characters:

TenLetters1234567890TenLetters

If the truncation causes duplicate column names, the Data Replication task replaces the last character of the
duplicate column names with sequential numbers. The Data Replication task also replaces the last character
of duplicate table names from the same task.

23
Data Replication Source Properties
When you replicate a source object to a database, the Data Replication task replicates the data to a
database table with the same name as the source object.

The following table describes the Oracle source properties in a Data Replication task:

Property Description

Source Connection Name of the active source connection. Select a source connection or create a new
connection.

Objects to Replicate Source objects that you can replicate. You can choose from the following options to
replicate the objects:
- All Objects
- Include Objects
- Exclude Objects

If an error occurs while Determines the execution or termination of the process when an error occurs.
processing an object

Data Replication Target Properties

When you replicate data to a database target, the Data Replication task truncates the table name in the
target database if the source object name exceeds 30 characters.

The following table describes the Oracle target properties in a Data Replication task:

Property Description

Connection Name of the target connection. Select a target connection or create a new connection.

Target Prefix String that prefixes the source object names to create names for the target objects in the target.
Note: For more information, see "Truncating Table Names" in Deploy.

Load Type Replicates data from Oracle to other applications in full load.

Delete Options Not Applicable.

Commit size Used for the Data Replication task for all the runs. Defines the number of rows to commit. If you do not
specify a value, the Secure Agent uses the default value 10000.

Full Load
For a full load, the Data Replication task replicates the data for all rows of the source objects in the task.
Each time the task runs, the Data Replication task truncates the target database tables or flat file and
performs a full data refresh from the source.

24 Chapter 5: Data Replication Tasks

Rules and Guidelines for Oracle Sources and
Targets
Use the following rules and guidelines for Oracle sources and targets in a Data Replication task:

• You cannot configure multiple Data Replication tasks to replicate the same source object to the same
target object.
For example, you cannot configure two Data Replication tasks to write Salesforce Account data to the
SF_ACCOUNT Oracle database table.
• You can use database tables, synonyms, or views as sources and targets.
• If you configure a Data Replication task to replicate all objects from the Public schema and the schema
contains synonyms, the task might fail. The task fails when the user account for the Oracle connection
does not have the Select privilege on the synonyms in the Public schema. The task also fails if the
synonym names do not begin with a letter or underscore (_).
• If you replicate timestamp data to an Oracle database, the Data Replication task truncates fractional
seconds to the second.
For example, the Data Replication task truncates 12:52:47.58 to 12:52:47.

Rules and Guidelines for Oracle Sources and Targets 25

CHAPTER 6

Troubleshooting
This chapter includes the following topics:

• Troubleshooting Overview, 26
• Troubleshooting an Oracle Connection, 26
• Troubleshooting a Data Synchronization Task, 27
• Troubleshooting a Data Replication Task, 27

Troubleshooting Overview
Use the following sections to troubleshoot errors in Oracle Connector. For a list of common error messages
and possible solutions, see the Informatica Cloud Community article,
"Troubleshooting: Common Error Messages".

Troubleshooting an Oracle Connection

A task that uses an Oracle connection runs slower. However, an Oracle connection runs fast when you use an ODBC
connection for Oracle.
The default array size for Oracle Connector is 60,000 bytes. You might optimize performance of Oracle
Connector by increasing the array size. To increase the array size, you can configure the following
custom configuration properties for the Secure Agent:

• Type: Tomcat, Name: ODBCOptimizeRead, Value: Yes

• Type: Tomcat, Name: OdbcOracleDefaultArraySize, Value: <number of bytes>
For example:

• Type: Tomcat, Name: ODBCOptimizeRead, Value: Yes

• Type: Tomcat, Name: OdbcOracleDefaultArraySize: Value: 70000

Note: The OdbcOracleDefaultArraySize custom configuration property does not optimize performance
for custom SQL queries.

26
Troubleshooting a Data Synchronization Task
"Error Log Table Name Prefix" occurs which specifies table name prefix for a relational error log.
Oracle has a 30 character limit for table names. The task fails if a table name exceeds 30 characters.

Troubleshooting a Data Replication Task

[DataDirect][ODBC Oracle Wire Protocol driver]Fractional truncation. Error in parameter <number>.
The database driver issues a warning message if a Data Replication task replicates all Salesforce
objects and tries to write a null value to a numeric field of an Oracle database.

An error message appears while configuring the target for the Data Replication task.
You cannot configure multiple Data Replication tasks to replicate the same source object to the same
target object.

For example, you cannot configure two Data Replication tasks to write Salesforce Account data to the
SF_ACCOUNT Oracle database table. An error appears when you select the same target connection
and target object that is used by another Data Replication task.

If you replicate specific objects for the source connection, the following error appears: Duplicate data replication task for
<object name> object with a target prefix of <target prefix>.
An error occurs when you run two Data Replication tasks to replicate two objects whose target prefixed
name is the same. You must change the target connection, enter a different target prefix or remove the
object from the task.

To write data from sources with the same name to different target objects in the same target connection,
you must configure different target prefixes.

If you replicate all objects for the source connection, the following error appears: Duplicate Data Replication Task.
An error occurs when you run two Data Replication tasks to replicate the same object from the same
source to the same target with the same target prefix. You must change the target or enter a different
target prefix.

Numeric data is loaded incorrectly when you run a Data Replication Task that writes Oracle data to a flat file.
When a Data Replication task writes Oracle data with the Number data type to a flat file with the scale as
0, the number is rounded with a precision of 15. The Data Replication application converts the Number
data type to Double (15).

To prevent rounding, specify a scale other than 0 for the source data type. When you specify a non-zero
scale, rounding will not occur because the Data Replication application converts the Number data type to
Decimal.

Troubleshooting a Data Synchronization Task 27

Index

C Informatica Cloud web site

URL 6
Cloud Application Integration community Informatica Global Customer Support
URL 6 contact information 7
Cloud Developer community
URL 6
configuring key range
partitioning 18
O
Oracle connections
overview 10

D properties 10
rules and guidelines 11
data filters Oracle Connector
advanced 15 example 9
rules and guidelines 15 overview 8
simple 15 Oracle mapping
Data Replication source properties 16
rules and guidelines 25 target properties 19
target properties 24
overview 23
source properties 24
sources and targets 25
P
Data Replication task Partitioning
full load 24 key range 17
Data Synchronization task pushdown optimization
sources 13 functions 21
targets 14
database sources
rules and guidelines 14
database targets
T
rules and guidelines 14 troubleshooting
Data Replication task 27
Data Synchronization task 27

I Oracle connection 26
overview 26
Informatica Cloud trust site
community article 26 description 7
user guide 8
Informatica Cloud Community
URL 6

28