Informatica® Cloud (Version Fall 2016)

Microsoft SQL Server Connector Guide

Informatica Cloud Microsoft SQL Server Connector Guide

Version Fall 2016January 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 (c) 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, <daniel@haxx.se>. 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-04-14

Table of Contents

Preface. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

Informatica Resources. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

Informatica Documentation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

Informatica Cloud Web Site. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

Informatica Cloud Communities. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

Informatica Cloud Connector Documentation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

Informatica Knowledge Base. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

Informatica Cloud Trust Site. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

Informatica Global Customer Support. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

Chapter 1: Introduction to Microsoft SQL Server Connector. . . . . . . . . . . . . . . . . . . . . 8Microsoft SQL Server Connector Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

Microsoft SQL Server Supported Objects and Task Operations. . . . . . . . . . . . . . . . . . . . . . . . . 9

Chapter 2: Microsoft SQL Server Connections . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10Microsoft SQL Server Connections Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

Microsoft SQL Server Connection Properties. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

Chapter 3: Data Synchronization Tasks with Microsoft SQL Server Connector. . 13Microsoft SQL Server Sources in Data Synchronization Task. . . . . . . . . . . . . . . . . . . . . . . . . 13

Microsoft SQL Server Targets in Data Synchronization Tasks. . . . . . . . . . . . . . . . . . . . . . . . . 14

Microsoft SQL Server Lookup in Data Synchronization Tasks. . . . . . . . . . . . . . . . . . . . . . . . . 14

Data Synchronization Tasks Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15

Chapter 4: Mappings and Mapping Configuration Tasks with Microsoft SQL Server Connector. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18Microsoft SQL Server Sources in Mapping. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

Key Range Partitioning. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19

Configuring Key Range Partitioning. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

Microsoft SQL Server Targets in Mapping. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

Microsoft SQL Server Mapping Task Example. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21

Pushdown Optimization. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23

Full Pushdown. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

Source Pushdown. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

Pushdown Optimization Functions. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

Configuring Pushdown Optimization. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

Chapter 5: Data Replication Tasks with Microsoft SQL Server Connector. . . . . . . 26Data Replication Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

Rules and Guidelines for Configuring Data Replication Tasks. . . . . . . . . . . . . . . . . . . . . . . . . 26

4 Table of Contents

Data Replication Sources Properties. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

Data Replication Target Properties. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

Chapter 6: Data Type Reference. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28Data Type Reference Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

Microsoft SQL Server and Transformation Data Types. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

Index. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

Table of Contents 5

PrefaceThe Informatica Cloud Microsoft SQL Server Connector Guide contains information about how to set up and use Microsoft SQL Server Connector. The guide explains how business users can use Microsoft SQL Server Connector to read data from and write data to Microsoft SQL Server databases.

Informatica Resources

Informatica DocumentationTo 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 infa_documentation@informatica.com.

Informatica Cloud Web SiteYou 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 CommunitiesUse 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 Connector DocumentationYou 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.

6

Informatica Knowledge BaseUse 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 KB_Feedback@informatica.com.

Informatica Cloud Trust SiteYou 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 SupportYou 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

C H A P T E R 1

Introduction to Microsoft SQL Server Connector

This chapter includes the following topics:

• Microsoft SQL Server Connector Overview, 8

• Microsoft SQL Server Supported Objects and Task Operations, 9

Microsoft SQL Server Connector OverviewYou can use Microsoft SQL Server Connector to connect to Microsoft SQL Server databases from Informatica Cloud. Use Microsoft SQL Server connector to read data from or write data to Microsoft SQL Server databases. You can use Microsoft SQL Server connections to connect to Microsoft SQL Server databases version 2000, 2005, 2008, 2012, 2014, and 2016.

You can use a Microsoft SQL Server connection to connect to Microsoft Azure SQL databases. You can also connect to audit-enabled Azure SQL databases and pre-V12 Azure SQL databases. You can connect to Azure SQL databases from Secure Agents deployed on Azure virtual machines. You can use Microsoft SQL Server objects as sources and targets for Contact Validation tasks,, Data Synchronization, Data Masking tasks, Data Replication tasks, PowerCenter tasks,and Mapping Configuration tasks. You can create, update, or delete records when you use Microsoft SQL Server Connector to write to Microsoft SQL Server databases.

Note: You cannot connect to Microsoft SQL Server instance if the Secure Agent runs on Windows 32-bit or Linux 32-bit operating systems.

8

Microsoft SQL Server Supported Objects and Task Operations

The following table lists the tasks and object types that Microsoft SQL Server Connector supports:

Task Type Source Target Lookup

Contact Validation Yes Yes Yes

Data Replication Yes Yes Yes

Data Synchronization Yes Yes Yes

PowerCenter Yes Yes Yes

Mapping Configuration Yes Yes Yes

For information about Contact Validation tasks, Data Masking tasks, and PowerCenter tasks, see Informatica Cloud User Guide..

Microsoft SQL Server Supported Objects and Task Operations 9

C H A P T E R 2

Microsoft SQL Server Connections

This chapter includes the following topics:

• Microsoft SQL Server Connections Overview, 10

• Microsoft SQL Server Connection Properties, 10

Microsoft SQL Server Connections OverviewCreate a Microsoft SQL Server connection to connect to Microsoft SQL Server so that the Secure Agent can read data from and write data to Microsoft SQL Server. You can use a Microsoft SQL Server connection to connect to Microsoft Azure SQL databases.

You create a Microsoft SQL Server connection on the Connections page. Use the connection when you create a , Data Synchronization, and Mapping Configuration tasks.

Note: When you enable SSL encryption, you cannot connect to a Microsoft SQL Server instance if the Secure Agent runs on Windows 32-bit or Linux 32-bit operating systems.

Microsoft SQL Server Connection PropertiesWhen you set up a Microsoft SQL Server connection, you must configure the connection properties.

The following table describes the Microsoft SQL Server connection properties:

Connection Property

Description

Runtime Environment

The name of the runtime environment where you want to run the tasks.

SQL Server Version Microsoft SQL Server database version.

10

Connection Property

Description

Authentication Mode Authentication method to access Microsoft SQL Server. Select one of the following methods:- Windows Authentication. Use Microsoft Windows authentication to access Microsoft SQL Server.

This option is available when you access Informatica Cloud using Microsoft Windows. When you choose this option, you do not need to enter credentials to access Microsoft SQL Server.

- SQL Server. Enter your Microsoft SQL Server user name and password to access Microsoft SQL Server.

User Name User name for the database login. Does not apply if you use Windows authentication mode to access Microsoft SQL Server. The user name cannot contain a semicolon.Specify the username in the following format to connect to Microsoft Azure SQL databases: username@host

Password Password for the database login. Does not apply if you use Windows authentication mode to access Microsoft SQL Server. The password cannot contain a semicolon.

Host Name of the machine hosting the database server.Specify the fully qualified host name to connect to Microsoft Azure SQL databases.

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

Instance Name Instance name of the Microsoft SQL Server database.

Database Name Database name for the Microsoft SQL Server target. Database name is case sensitive if the database is case sensitive. Maximum length is 100 characters.Database names can include alphanumeric and underscore characters.

Schema Schema used for the target 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.

Encryption Method The method that the Secure Agent uses to encrypt the data sent between the driver and the database server. You can use the encryption method to connect to Microsoft Azure SQL Databases.

Crypto Protocol Version

Cryptographic protocols to use when you enable SSL encryption.

Validate Server Certificate

When set to True, Secure Agent validates the certificate that is sent by the database server.If you specify the HostNameInCertificate parameter, Secure Agent also validates the host name in the certificate.When set to false, the Secure Agent does not validate the certificate that is sent by the database server.

Trust Store The location and name of the trust store file. The trust store file contains a list of Certificate Authorities (CAs) that the driver uses for SSL server authentication.

Microsoft SQL Server Connection Properties 11

Connection Property

Description

Trust Store Password

The password to access the contents of the trust store file.

Host Name in Certificate

Host name of the machine that hosts the secure database. If you specify a host name, the Secure Agent validates the host name included in the connection with the host name in the SSL certificate.

12 Chapter 2: Microsoft SQL Server Connections

C H A P T E R 3

Data Synchronization Tasks with Microsoft SQL Server Connector

This chapter includes the following topics:

• Microsoft SQL Server Sources in Data Synchronization Task, 13

• Microsoft SQL Server Targets in Data Synchronization Tasks, 14

• Microsoft SQL Server Lookup in Data Synchronization Tasks, 14

• Data Synchronization Tasks Example, 15

Microsoft SQL Server Sources in Data Synchronization Task

When you configure a Data Synchronization task to use a Microsoft SQL Server 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 where you can select an object, field, operator, and enter a filter value based on which the Data Synchronization task runs. You cannot include UTF-8 characters in a data filter on a Microsoft SQL Server source.

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 Microsoft SQL Server 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 alphabetical order

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

Microsoft SQL Server Targets in Data Synchronization Tasks

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

The following table describes the Microsoft SQL Server target properties:

Property Description

Connection Name of the active target connection.

Target Object Name of target objects available in the connection. Select an existing object from the list or create a new object at the run time.

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

Enable Target Bulk Load Uses Microsoft SQL Server bulk API to write data in bulk mode to Microsoft SQL Server.

Display target fields in alphabetical order

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

Microsoft SQL Server Lookup in Data Synchronization Tasks

When you configure field mappings in a data synchronization task, you can create a lookup to a Microsoft SQL Server object. When you use a Microsoft SQL Server object as a lookup, you do not need to configure specific Microsoft SQL Server properties.

14 Chapter 3: Data Synchronization Tasks with Microsoft SQL Server Connector

Data Synchronization Tasks ExampleTo perform the insert operation where you can read data from a Microsoft SQL Server Source and can write data to the Microsoft SQL Server target. Perform the following steps:

Note: You need to create a Microsoft SQL Server connection before configuring the Data Synchronization task.

1. Click Task Wizards in the Informatica Cloud home page.

2. Select Data Synchronization from the menu.

The Data Synchronization Tasks tab appears.

3. Click New to create a Data Synchronization task.

The Definition tab appears.The following image shows the Definition tab:

4. Specify the task name and provide a description.

5. Select Insert as the task operation.

6. Click Next.

The Source tab appears.The following image shows the Source tab:

7. Select the source connection required for the task.

8. Select the source type for the task.

9. Select the source object for the task.

10. Click Next.

The Target tab appears.

Data Synchronization Tasks Example 15

The following image shows the Target tab:

11. Select the target connection required for the task.

12. Select the target object for the task.

13. Set the value of the truncate target.

14. Click Next.

The Data Filters tab appears in which by default, it process all the rows .

15. Click Next.

The Field Mapping tab appears where you can map source fields to target fields accordingly.The following image shows the Field Mapping tab:

16. Click Next.

The Schedule tab appears where you can schedule the task for each requirement and save.

16 Chapter 3: Data Synchronization Tasks with Microsoft SQL Server Connector

The following image shows the Schedule page:

17. Click save and run the task if you do not want to schedule the task.

After you run the task, the Monitor Log page appears where you can monitor the status of Data Synchronization tasks.

Data Synchronization Tasks Example 17

C H A P T E R 4

Mappings and Mapping Configuration Tasks with Microsoft SQL Server Connector

This chapter includes the following topics:

• Microsoft SQL Server Sources in Mapping, 18

• Key Range Partitioning, 19

• Microsoft SQL Server Targets in Mapping, 20

• Microsoft SQL Server Mapping Task Example, 21

• Pushdown Optimization, 23

Microsoft SQL Server Sources in MappingTo read data from a Microsoft SQL Server database, configure a Microsoft SQL Server 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 Microsoft SQL Server source. Configure the source, query options and advanced properties for the source object.

The following table describes the source properties that you can configure for a Microsoft SQL Server source:

Property Description

Connection Name of the active Microsoft SQL Server source connection.

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

Object Name of the Microsoft SQL Server source object.

18

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.When you configure partitioning, separate multiple filter conditions with parentheses ().

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 rows

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

The following table describes the advanced source properties that you can configure for a Microsoft SQL Server source:

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 Deterministic

Relational source or transformation output that does not change between session runs when the input 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 PartitioningYou can configure key range partitioning when you use a Mapping Configuration task to read data from Microsoft SQL Server sources. With key range partitioning, the Secure Agent distributes rows of source data based on the field 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

Key Range Partitioning 19

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.

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 PartitioningPerform the following steps to configure key range partitioning for Microsoft SQL Server 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:

Microsoft SQL Server Targets in MappingTo write data to a Microsoft SQL Server database, configure a Microsoft SQL Server object as the Target transformation in a mapping.

Specify the name and description of the Microsoft SQL Server target. Configure the target and advanced properties for the target object.

20 Chapter 4: Mappings and Mapping Configuration Tasks with Microsoft SQL Server Connector

The following table describes the target properties that you can configure for a Microsoft SQL Server target:

Property Description

Connection Name of the active Microsoft SQL Server target connection.

Target Type Type of the Microsoft SQL Server target object available. You can choose from the following source types:- Single- Parameter

Target Object Name of the Microsoft SQL Server target object based on target type selected.Specify the target file or target object that you want to create at run time. You can also select an existing object from the list.

Operation Select the target operation. You can perform the following operations on a Microsoft SQL Server target:- Insert- Update- Upsert- Delete- Data Driven

Truncate target When you enable the Truncate Target option, the Secure Agent truncates the table before running the task. Default is not selected.

Enable Target Bulk Load

Uses Microsoft SQL Server bulk API to insert data in bulk mode.When you create a Mapping Configuration task, you can use the Microsoft SQL Server bulk API to perform insert operation.

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.

Microsoft SQL Server Mapping Task ExampleTo perform the insert operation from Microsoft SQL Server source to a flat file target perform the following steps:

1. Click Design in the Informatica Cloud home page.

2. Select Mappings from the menu.

The Mappings tab appears.

3. Click New to create a Mapping.

Microsoft SQL Server Mapping Task Example 21

4. Select the Source from the selection panel and configure the source properties. The following image shows details of the Source Properties page:

5. Select the target from the selection panel and configure the target properties. The following image shows details of the Target Properties page:

22 Chapter 4: Mappings and Mapping Configuration Tasks with Microsoft SQL Server Connector

In the target object, you can create a target file or target object at run time. You can also select an existing object from the list. The following image shows details of the Target Object page:

6. Map the source and target.

7. Click save and run the mapping.

After you run the task, the Monitor Log page appears where you can monitor the status of Mapping tasks.

Pushdown OptimizationWhen you read data from a Microsoft SQL Server 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.

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.

Pushdown Optimization 23

The Secure Agent can push the following transformation logic to a Microsoft SQL Server 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 PushdownWhen 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 a Microsoft SQL Server source and a Microsoft SQL Server target, configure full pushdown optimization to push all the transformation logic for processing from a Microsoft SQL Server source database to a Microsoft SQL Server target database.

Source PushdownWhen 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 a Microsoft SQL Server source and an Oracle target, you can configure source pushdown to push some transformation logic for processing to the Microsoft SQL Server source.

Pushdown Optimization FunctionsThe following table summarizes the availability of pushdown functions in a Microsoft SQL Server source or target:

Functions Pushdown Type

ABS() Source, Full

AVG() Source, Full

24 Chapter 4: Mappings and Mapping Configuration Tasks with Microsoft SQL Server Connector

Functions Pushdown Type

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 OptimizationPerform the following steps to configure pushdown optimization for Microsoft SQL Server 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.

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:

Pushdown Optimization 25

C H A P T E R 5

Data Replication Tasks with Microsoft SQL Server Connector

This chapter includes the following topics:

• Data Replication Overview, 26

• Rules and Guidelines for Configuring Data Replication Tasks, 26

• Data Replication Sources Properties, 27

• Data Replication Target Properties, 27

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

A Data Replication task can replicate data from one or more Microsoft SQL Server 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.

Note: The length of source tables and column names can contain at most 64 characters.

Rules and Guidelines for Configuring Data Replication Tasks

Use the following rules and guidelines for configuring Data Replication tasks:

The maximum number of characters that a Data Replication task can write to each row in a Microsoft SQL Server 2000 target is 8060. If a Data Replication task tries to write more than the maximum amount of characters to a row, the task fails with the following error: WRT_8229 Database errors occurred: FnName: Execute -- [Microsoft][ODBC SQL Server Driver][SQL Server]Cannot create a row of size <row size> which is greater than the allowable maximum of 8060. FnName: Execute -- [Microsoft][ODBC SQL Server Driver][SQL Server]The statement has been terminated.

26

Data Replication Sources PropertiesWhen 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 Microsoft SQL Server 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 processing an object

Determines the execution or termination of the process when an error occurs.

Data Replication Target PropertiesWhen you replicate data to a database target, the Data Replication task truncates the table name in the target database when the source object name exceeds 64 characters.

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

Property Description

Connection Name of the target connection. Select a target connection or create a 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 the Informatica Cloud User Guide.

Enable Target Bulk Load

Uses Microsoft SQL Server bulk API.When you replicate data from Salesforce to Microsoft SQL Server in bulk mode, the task fails. This issue occurs if you change the datatype, precision, or scale of a Salesforce field and re-run the task.

Load Type Replicates full load of data from Microsoft SQL Server to other applications.

Delete Options This property is not applicable for Microsoft SQL Server Connector.

You can also configure the commit size, which defines the number of rows to commit. If you do not specify a value, the Secure Agent uses the default value. The default value is 10000.

Data Replication Sources Properties 27

C H A P T E R 6

Data Type ReferenceThis chapter includes the following topics:

• Data Type Reference Overview, 28

• Microsoft SQL Server and Transformation Data Types, 28

Data Type Reference OverviewInformatica Cloud uses the following data types in mappings, Data Synchronization tasks, and Mapping Configuration tasks with Microsoft SQL Server:Microsoft SQL Server native data types

Microsoft SQL Server data types appear in the source and target transformations when you choose to edit metadata for the fields.

Transformation data types

Set of data types that appear in the transformations. They are internal data types based on ANSI SQL-92 generic data types, which the Secure Agent uses to move data across platforms. Transformation data types appear in all transformations in a mapping.

When Informatica Cloud reads source data, it converts the native data types to the comparable transformation data types before transforming the data. When Informatica Cloud writes to a target, it converts the transformation data types to the comparable native data types.

Microsoft SQL Server and Transformation Data Types

The following table lists the Microsoft SQL Server data types that Informatica Cloud supports and the corresponding transformation data types:

Microsoft SQL Server Data Type Transformation Data Type Description

Binary SQL_BINARY Precision 100, scale 0

Money SQL_NUMERIC Precision 19, scale 4

28

Microsoft SQL Server Data Type Transformation Data Type Description

Bigint SQL_BIGINT Precision 8, scale 0

Nvarchar(100) SQL_WVARCHAR Precision 100, scale 0

Decimal(18,4) SQL_NUMERIC Precision 8, scale 0

Varchar(100) SQL_VARCHAR Precision 100, scale 0

Bit SQL_INTEGER Precision 4, scale 0

Datetime SQL_TIMESTAMP Precision 23, scale 3

Smalldatetime SQL_TIMESTAMP Precision 16, scale -4

Real SQL_DOUBLE Precision 8, scale 0

Int SQL_INTEGER Precision 4, scale 0

Char(100) SQL_CHAR Precision 100, scale 0

Float SQL_DOUBLE Precision 8, scale 0

SmallInt SQL_INTEGER Precision 4, scale 0

SmallMoney SQL_NUMERIC Precision 10, scale 4

VarBinary(100) SQL_BINARY Precision 100, scale 0

Nchar(100) SQL_WCHAR Precision 100, scale 0

TinyInt SQL_INTEGER Precision 4, scale 0

Microsoft SQL Server and Transformation Data Types 29

Index

CCloud Application Integration community

URL 6Cloud Developer community

URL 6connections

SQL Server 10

Ddata replication

overview 26source properties 27target properties 27

data synchronization Microsoft SQL Server targets 14example 15Microsoft SQL Server sources 13

data type reference overview 28

Ffunctions

pushdown optimization 24

IInformatica Cloud Community

URL 6Informatica Cloud web site

URL 6Informatica Global Customer Support

contact information 7

Mmappings

example 21Microsoft SQL Server sources 18Microsoft SQL Server targets 20

Microsoft SQL Server data types 28

Microsoft SQL Server connections overview 10

Microsoft SQL Server connector overview 8

Ppushdown optimization

functions 24pushdown optimization method

full pushdown 24source pushdown 24

SSQL Server

connection properties 10

Ttrust site

description 7

30