Informatica PowerExchange for Netezza (Version 9.1.

0 HotFix2)

User Guide

Informatica PowerExchange for Netezza User Guide Version 9.1.0 HotFix2 September 2011 Copyright (c) 2005-2011 Informatica. All rights reserved. This software and documentation contain proprietary information of Informatica Corporation 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 Corporation. 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 and Informatica Master Data Management are trademarks or registered trademarks of Informatica Corporation 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. This product includes software developed by the Apache Software Foundation (http://www.apache.org/), and other software which is licensed under the Apache License, Version 2.0 (the "License"). You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0. Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. 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 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-2007, 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. 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://www.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-licenseagreement; 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://developer.apple.com/library/mac/#samplecode/HelpHook/Listings/HelpHook_java.html; http://www.jcraft.com/jsch/LICENSE.txt; http:// nanoxml.sourceforge.net/orig/copyright.html; http://www.json.org/license.html; http://forge.ow2.org/projects/javaservice/; http://www.postgresql.org/about/license.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; and http://www.slf4j.org/ license.html.

THESE LIMITATIONS APPLY TO ALL CAUSES OF ACTION.014.670.947.774.523. INCLUDING.584.158.990. 6.org/licenses/bsd-license. 7. Part Number: PWX-NZU-91000-HF2-0001 . EITHER EXPRESSED OR IMPLIED. This product includes software copyright © 2003-2006 Joe WaInes.789.edu/.590. 6.php) and the Artistic License (http://www. MISREPRESENTATION AND OTHER TORTS. either express or implied. This product includes software developed by the Indiana University Extreme! Lab.org/licenses/mitlicense.0).588. NOTICES This Informatica product (the "Software") includes certain drivers (the "DataDirect Drivers") from DataDirect Technologies. INCIDENTAL.307. 6. 6. BREACH OF WARRANTY.016.501. SPECIAL.php ) the Common Public License (http://www.721.096. BREACH OF CONTRACT. STRICT LIABILITY.162. the MIT License (http://www. 7. merchantability.077.opensource. 6. All rights reserved.178.215. the BSD License (http://www. 6. 6.org/license. The information in this software and documentation is subject to change at any time without notice.This product includes software licensed under the Academic Free License (http://www. and 7.php).791 . IN NO EVENT WILL DATADIRECT OR ITS THIRD PARTY SUPPLIERS BE LIABLE TO THE END-USER CUSTOMER FOR ANY DIRECT.044. WHETHER OR NOT INFORMED OF THE POSSIBILITIES OF DAMAGES IN ADVANCE.org/licenses/artistic-license-1.117.842.indiana. THE IMPLIED WARRANTIES OF MERCHANTABILITY. The information provided in this software or documentation may include technical inaccuracies or typographical errors.254.php ). 6. For further information please visit http://www.032.035. WITHOUT LIMITATION. an operating company of Progress Software Corporation ("DataDirect") which are subject to the following terms and conditions: 1.121. 7.270. but not limited to. CONSEQUENTIAL OR OTHER DAMAGES ARISING OUT OF THE USE OF THE ODBC DRIVERS. This product contains runtime modules of IBM DB2 Driver for JDBC and SQLJ (c) Copyright IBM Corporation 2006 All rights reserved.0.S.php).092. 6.850. the Common Development and Distribution License (http://www. Patent Numbers 5.opensource.458. including.471.opensource.643. 2006-2007 XStream Committers. 7.org/licenses/afl-3. 7.373.opensource. 6. international Patents and other Patents Pending.374. 2.496. the implied warranties of noninfringement. DISCLAIMER: Informatica Corporation provides this documentation "as is" without warranty of any kind. THE DATADIRECT DRIVERS ARE PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND.820. or use for a particular purpose.794. the Sun Binary Code License Agreement Supplemental License Terms.640.281. 7.001. FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. 7.895. 7.extreme. 7.0.720.208.246. INCLUDING BUT NOT LIMITED TO.339.226. This Software is protected by U. 6.org/licenses/cpl1.html. 6.codehaus.421.775.422.org/licenses/cddl1.opensource.opensource.029.086.823. 7. 6. NEGLIGENCE. 6. 6. INDIRECT. Informatica Corporation does not warrant that this software or documentation is error free. Permissions and limitations regarding this software are subject to terms available at http://xstream.

. . . . . . . . . . . . . . . . . . . . . . . . . . . iii Informatica Knowledge Base. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 Connecting to a Netezza Database from Windows. . . . . . . . . . . . . . . . . . 2 Configuring PowerExchange for Netezza. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . iii Informatica How-To Library. . . . . . . . . . . 10 Bulk Mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 PowerExchange for Netezza Configuration Overview. . 1 Code Pages. . . . . . . . iv Informatica Global Customer Support. . . . . . . . . . . . . . . . . . 7 Importing Netezza Source Definitions. . . . . . . . . . . . . . . . .Table of Contents Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . iv Chapter 1: PowerExchange for Netezza. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . iv Informatica Multimedia Knowledge Base. . . . . . 2 Prerequisites. . . . . 4 Chapter 3: Netezza Sources and Targets. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 Normal Mode. . . . . . . . . . . . . . . 2 Upgrading PowerExchange for Netezza. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 Session Configuration with a Netezza Target. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 Chapter 2: PowerExchange for Netezza Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . iii Informatica Customer Portal. . . . . . . . . . . . . . . 1 PowerExchange for Netezza Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 Unprojected Columns. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 Data Transfer Modes in Netezza. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . iii Informatica Resources. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7 Netezza Sources and Targets Overview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . iii Informatica Web Site. . . . . . . . . . . . . . . . . . . . . . . . . 12 Target Properties. . . . . . . . . . iii Informatica Documentation. . . . . . . . . . . . . . . . . . . . 8 Importing Netezza Target Definitions. . . . . . . . . . 13 Table of Contents i . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 Registering the Plug-in. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 Connecting to a Netezza Database from UNIX. . . . . . . . . . . . . . . . . . . . . . 10 Session Configuration with a Netezza Source. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12 Null Values and Empty Strings. . . . 7 Source Qualifier Properties. . . . . . 8 Chapter 4: Netezza Sessions and Workflows. . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . 19 Netezza and Transformation Datatypes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16 Netezza Distribution Key. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19 Index. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 Netezza Session Configuration for Optimal Performance. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17 Troubleshooting Netezza Sessions. . . . . . . . . . . . . . . . . . . . . . 15 Update Else Insert. 21 ii Table of Contents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 Netezza Target Data Update. . 13 Target Connection Groups. . . . . . . . . . . . . . . . . . . 14 Multiple Targets Configuration for the Same Target Table. . . . . . . . . . . . . . . . . . . . . . . . . . 17 Appendix A: Datatype Reference. . . . . . . . . . . . . . . . . . . . 15 Update As Insert. . . . . . .Pipeline Partitioning. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Informatica How-To Library As an Informatica customer. newsletters. and guide you through performing specific real-world tasks. You will also find product and partner information. its background. upcoming events. iii . compare features and behaviors. The services area of the site includes important information about technical support. Informatica Product Documentation.com. and implementation services. training and education.com. access to the Informatica customer support case management system (ATLAS). the Informatica How-To Library. The Documentation team updates documentation as needed. We will use your feedback to improve our documentation.informatica.informatica. Informatica Web Site You can access the Informatica corporate web site at http://www. Informatica Resources Informatica Customer Portal As an Informatica customer. This book assumes you have knowledge of Netezza and PowerCenter.com. contact the Informatica Documentation team through email at infa_documentation@informatica. user group information. and access to the Informatica user community.informatica.com. usable documentation. It is written for database administrators and developers who are responsible for extracting data from Netezza and loading data to Netezza. To get the latest documentation for your product. comments. the Informatica Multimedia Knowledge Base. Let us know if we can contact you regarding your comments. you can access the Informatica How-To Library at http://mysupport. you can access the Informatica Customer Portal site at http://mysupport. Informatica Documentation The Informatica Documentation team takes every effort to create accurate. or ideas about this documentation. The site contains product information. navigate to Product Documentation from http://mysupport.Preface The Informatica PowerExchange for Netezza User Guide provides information about extracting data from a Netezza source and loading data into a Netezza target. and sales offices. It includes articles and interactive demonstrations that provide solutions to common problems. The How-To Library is a collection of resources to help you learn more about Informatica products and features.com. If you have questions. the Informatica Knowledge Base.informatica. The site contains information about Informatica.

you can access the Informatica Multimedia Knowledge Base at http://mysupport.informatica. Use the following telephone numbers to contact Informatica Global Customer Support: North America / South America Toll Free Brazil: 0800 891 0202 Mexico: 001 888 209 8853 North America: +1 877 463 2435 Europe / Middle East / Africa Toll Free France: 0805 804632 Germany: 0800 5891281 Italy: 800 915 985 Netherlands: 0800 2300001 Portugal: 800 208 360 Spain: 900 813 166 Switzerland: 0800 463 200 United Kingdom: 0800 023 4632 Asia / Australia Toll Free Australia: 1 800 151 830 New Zealand: 09 9 128 901 Standard Rate India: +91 80 4112 5738 Standard Rate Belgium: +31 30 6022 797 France: +33 1 4138 9226 Germany: +49 1805 702 702 Netherlands: +31 306 022 797 United Kingdom: +44 1628 511445 iv Preface .com. you can access the Informatica Knowledge Base at http://mysupport. or ideas about the Knowledge Base.com.Informatica Knowledge Base As an Informatica customer. comments. You can also find answers to frequently asked questions. If you have questions. Informatica Global Customer Support You can contact a Customer Support Center by telephone or through the Online Support. Online Support requires a user name and password.informatica. or ideas about the Multimedia Knowledge Base.com.informatica. You can request a user name and password at http://mysupport. contact the Informatica Knowledge Base team through email at KB_Feedback@informatica. If you have questions. Use the Knowledge Base to search for documented solutions to known technical issues about Informatica products. contact the Informatica Knowledge Base team through email at KB_Feedback@informatica.com. comments. technical white papers.com. and technical tips. Informatica Multimedia Knowledge Base As an Informatica customer. The Multimedia Knowledge Base is a collection of instructional multimedia files that help you learn about common concepts and guide you through performing specific tasks.

1 PowerExchange for Netezza Overview PowerExchange for Netezza provides bidirectional connectivity between PowerCenter and Netezza to extract and load data. Code Pages When the PowerCenter Integration Service runs in Unicode mode. run the PowerCenter Integration Service in Unicode mode. it encodes Netezza data of the Nchar(m) and NVarchar(m) datatypes in UTF-8. 1 ¨ Code Pages. and storage in a single system. server. Configure a Netezza database connection to read data from and write to Netezza. The Netezza Performance Server integrates database. You can connect to the Netezza Performance Server to read data from Netezza tables and load data to Netezza tables. The Designer uses a relational connector to connect to the Netezza database. You can import Netezza tables as sources and target definitions.CHAPTER 1 PowerExchange for Netezza This chapter includes the following topics: ¨ PowerExchange for Netezza Overview. If the data contains extended ASCII characters or UTF-8 characters. 1 . It encodes Netezza data of the Varchar and Char datatypes in Latin-9.

3 to version 9. register the PowerExchange for Netezza plug-in with the repository.CREATE TABLE .INSERT . 2 PowerExchange for Netezza Configuration Overview This chapter provides information about configuring PowerExchange for Netezza. you do not need to perform configuration steps.TRUNCATE .UPDATE Configuring PowerExchange for Netezza To read or write Netezza data in bulk mode.SELECT . Prerequisites Before you configure PowerExchange for Netezza.0. 2 .LIST .CHAPTER 2 PowerExchange for Netezza Configuration This chapter includes the following topic: ¨ PowerExchange for Netezza Configuration Overview. Upgrading PowerExchange for Netezza You can upgrade PowerExchange for Netezza version 8.1.DELETE . ¨ Verify that the Netezza database user has the following privileges on the database: . complete the following tasks: ¨ Install the client and server components of the Netezza Performance Server. To read or write Netezza data with a relational connection.DROP .1.1.CREATE EXTERNAL TABLE .

Install the Netezza ODBC driver on each PowerCenter Client machine that accesses the Netezza database. Upgrade PowerCenter. After you create the data source. ¨ PowerCenter Client. Use the Informatica Administrator or the pmrep RegisterPlugin command to register the plug-in. Use the Workflow Manager to create a database connection object for the Netezza database. Connecting to a Netezza Database from Windows Install and configure ODBC on the machines where the PowerCenter Integration Service process runs and where you install PowerCenter Client. configure the properties of the data source. Use the Microsoft ODBC Data Source Administrator to configure ODBC connectivity. The plug-in file for PowerExchange for Netezza is pmnetezza. Configure the path and file name for the ODBC log file. You must configure connectivity to the following Informatica components on Windows: ¨ PowerCenter Integration Service. 4. To create the ODBC data source. Create a System DSN if you start the Informatica service with a Local System account logon. use the driver provided by Netezza.xml to the following directory: <PowerCenter Installation Directory>\server\bin\Plugin Note: If you do not have the correct privileges to register the plug-in. Configure the Repository Service to run in exclusive mode. see the database documentation. the installer copies pmnetezza. When you install the Service component. Create an ODBC data source for each Netezza database that you want to access.xml. Install the Netezza ODBC driver on the machine where the PowerCenter Integration Service process runs. PowerExchange for Netezza Configuration Overview 3 . Enter a name for the new ODBC data source. Enter the following command: pmrep upgradeNetezzaToRelational 4. Configuring ODBC Connectivity Use the following procedure as a guideline to configure connectivity. For specific connectivity instructions. 2. 3. Registering the Plug-in To read or write Netezza data in bulk mode. you need to register the plug-in with the repository. Use the Microsoft ODBC Data Source Administrator to configure ODBC connectivity.1. Enter the name of the Netezza schema where you plan to create database objects. To change the Repository Service operating mode. you can use the Administrator tool or the infacmd UpdateRepositoryService command. Use the pmrep UpgradeNetezzaToRelational command to upgrade PowerExchange for Netezza. 2. 5. 3. Enter the IP address/host name and port number for the Netezza server. the repository must be running in exclusive mode. Create a User DSN if you select the This account log in option to start the Informatica service. To register the plug-in. Configure the Repository Service to run in normal mode. contact the user who manages the PowerCenter Repository Service. 1.

Set the variable to the ODBC installation directory. You can use the Microsoft ODBC Data Source Administrator to test the connection to the database. It must also include the Informatica services installation directory (server_dir). Set the variable to the ODBCHOME/bin directory.1 PATH. set the Netezza library folder to <NetezzaInstallationDir>/lib. For example. For 64-bit UNIX platforms. Verify that you can connect to the Netezza database. Set the ODBCHOME. 2. export ODBCHOME Using a C shell: $ setenv ODBCHOME =<Informatica server home>/ODBC6. Use the DataDirect Driver Manager in the DataDirect driver package shipped with the Informatica product to configure the Netezza data source details in the odbc. Set the shared library environment variable based on the operating system. ODBCHOME. set the Netezza library folder 4 Chapter 2: PowerExchange for Netezza Configuration . log in to the machine as a user who can start a service process. Set the shared library environment variable. and PATH environment variables. To test the connection. click Test Connection and enter the connection information for the Netezza schema. To connect to a Netezza database on UNIX: 1.6.ini file. On the Testing tab. To configure connectivity for the integration service process. export NZ_ODBC_INI_PATH Using a C shell: $ setenv NZ_ODBC_INI_PATH $ODBCHOME 3. For example: Using a Bourne shell: $ ODBCHOME=<Informatica server home>/ODBC6.1. Set the variable to point to the directory that contains the odbc. Connecting to a Netezza Database from UNIX Install and configure Netezza ODBC driver on the machine where the PowerCenter Integration Service process runs. The shared library path must contain the ODBC libraries. For 32-bit UNIX platforms. For specific connectivity instructions. Configuring ODBC Connectivity Use the following procedure as a guideline to configure connectivity.ini file is in the $ODBCHOME directory: Using a Bourne shell: NZ_ODBC_INI_PATH=$ODBCHOME.ini file. NZ_ODBC_INI_PATH. if the odbc. see the database documentation. select the Netezza data source and click Configure. For example: Using a Bourne shell: PATH="${PATH}:$ODBCHOME/bin" Using a C shell: $ setenv PATH ${PATH}:$ODBCHOME/bin NZ_ODBC_INI_PATH.

This file exists in $ODBCHOME directory.com Port = 5480 Database = infa Username = admin Password = password Debuglogging = true StripCRLF = false PreFetch = 256 Protocol = 7.0 ReadOnly = false ShowSystemTables = false PowerExchange for Netezza Configuration Overview 5 .so Description = NetezzaSQL ODBC Servername = netezza1. $ cp $ODBCHOME/odbc.ini Add an entry for the Netezza data source under the section [ODBC Data Sources] and configure the data source.to <NetezzaInstallationDir>/lib64. For example: [NZSQL] Driver = /export/home/appsqa/thirdparty/netezza/lib64/libnzodbc. The following table describes the shared library variables for each operating system: Operating System Solaris Linux AIX HP-UX Variable LD_LIBRARY_PATH LD_LIBRARY_PATH LIBPATH SHLIB_PATH For example.odbc.informatica. export LIBPATH ¨ Using a C shell: $ setenv LIBPATH ${LIBPATH}:$HOME/server_dir:$ODBCHOME/lib:<NetezzaInstallationDir>/lib64 4.ini $HOME/.ini file or copy the odbc. use the following syntax for Solaris: ¨ Using a Bourne shell: $ LD_LIBRARY_PATH="${LD_LIBRARY_PATH}:$HOME/server_dir:$ODBCHOME/lib:<NetezzaInstallationDir>/ lib64” export LD_LIBRARY_PATH ¨ Using a C shell: $ setenv LD_LIBRARY_PATH "${LD_LIBRARY_PATH}:$HOME/server_dir:$ODBCHOME/ lib:<NetezzaInstallationDir>/lib64" For HP-UX ¨ Using a Bourne shell: $ SHLIB_PATH=${SHLIB_PATH}:$HOME/server_dir:$ODBCHOME/lib:<NetezzaInstallationDir>/lib64. Edit the existing odbc. export SHLIB_PATH ¨ Using a C shell: $ setenv SHLIB_PATH ${SHLIB_PATH}:$HOME/server_dir:$ODBCHOME/lib:<NetezzaInstallationDir>/lib64 For AIX ¨ Using a Bourne shell: $ LIBPATH=${LIBPATH}:$HOME/server_dir:$ODBCHOME/lib:<NetezzaInstallationDir>/lib64.ini file to the home directory and edit it.

profile file to include the complete set of shell commands.cshrc or . 7.ini file is InstallDir and set it to the ODBC installation directory. Save the file and either log out and log in again.cshrc 6 Chapter 2: PowerExchange for Netezza Configuration .Socket = 16384 DateFormat = 1 TranslationDLL = TranslationName = TranslationOption = NumericAsChar = false For more information about Netezza connectivity. see the Netezza ODBC driver documentation. Verify that the last entry in the odbc. Using a Bourne shell: $ source .profile Using a C shell: $ source . or run the source command. For example: InstallDir=/usr/odbc 6. 5. Edit the .

define them in the Designer. 8 ¨ Importing Netezza Target Definitions. you can choose to preview data in the tables.CHAPTER 3 Netezza Sources and Targets This chapter includes the following topics: ¨ Netezza Sources and Targets Overview. 7 ¨ Source Qualifier Properties. When you import Netezza definitions. You can edit definitions to configure the properties that you did not import from Netezza. Reduces the number of rows the PowerCenter Integration Service queries. Use the following syntax: <table name>. 8 Netezza Sources and Targets Overview Netezza source and target definitions represent metadata for Netezza tables. Source Qualifier Properties You can configure source qualifier properties to sort the number of input ports and to retrieve distinct data from a Netezza source. 7 . If you want to enforce key constraints.”<field name>” <operator> <value> Source Filter The filter condition is case sensitive. Netezza does not enforce key constraints. 7 ¨ Importing Netezza Source Definitions. The following table describes the source qualifier properties: Source Options Select Distinct Description Selects unique values. You can override the values in the session properties. the PowerCenter Integration Service might extract fewer rows than expected. Therefore. the PowerCenter Integration Service establishes relationships within the pipeline based on source and target definitions. Netezza ignores trailing spaces. When you run a session.

click Sources > Import from Database. 5. You can also select all tables within a folder by selecting the folder and clicking Select All. Overrides the default query. Click OK. When you specify the number of sorted ports. 3. Enclose column names in double quotes. The source definition appears in the Source Analyzer. Note: The user must have the appropriate database permissions to view the object. Select the new Netezza data source. Select the Netezza data source used to connect to the target database. Enter a database user name and password to connect to the database. click All. 1. 2. the source definition appears in the Sources node of the active repository folder under the source database name. Optionally. the database sort order must match the session sort order. In the Source Analyzer. click Targets > Import from Database. 8 Chapter 3: Netezza Sources and Targets .Source Options Number of Sorted Ports Description Number of columns used when sorting rows queried from the source. use the search field to limit the number of tables that appear. click the Browse button to open the ODBC Administrator. 7. use the Target Designer to import source metadata with the Netezza relational data source. 1. In the Target Designer. Scroll down through the list of sources to find the source you want to import. If no table names appear. Create the Netezza data source and click OK. You may need to specify the owner name for database objects you want to use as sources. starting from the top of the transformation. Click Connect. The ORDER BY clause includes the number of ports specified. Importing Netezza Target Definitions To create a Netezza target definition. Select the Netezza data source used to connect to the source database. use the Source Analyzer to import source metadata with the Netezza relational data source. Select the relational object or objects you want to import. The SQL query is case sensitive. In the Navigator. If you need to create or modify a Netezza data source. The PowerCenter Integration Service adds an ORDER BY clause to the default query when it reads source rows. 2. Default is 0. SQL Query Importing Netezza Source Definitions To create a Netezza source definition. You can hold down the Shift key to select a block of sources within one folder or hold down the Ctrl key to make non-consecutive selections within a folder. 6. or if the table you want to import does not appear. Use the Select None button to clear all highlighted selections. 4.

click the Browse button to open the ODBC Administrator. Enter the user name and password to connect to the database. 4. If you are not the owner of the table you want to use as a target. Create the Netezza data source and click OK. Importing Netezza Target Definitions 9 . and click Connect. 3. You can hold down the Shift key to select a block of tables. The selected target definitions appear in the Navigator under the Targets node. Select the relational table or tables to import the definitions into the repository. You can also use the Select All and Select None buttons to select or clear all available targets. Drill down through the list of database objects to view the available tables as targets. specify the owner name.If you need to create or modify a Netezza data source. 5. Select the new Netezza data source. or hold down the Ctrl key to make nonconsecutive selections. 6. Click OK.

If 10 . When the PowerCenter Integration Service loads to Netezza. Normal Mode In normal mode. 12 ¨ Netezza Target Data Update. the PowerCenter Integration Service extracts and loads data row by row. An external table's definition is stored within the Netezza database but the data is saved externally in a location that is accessible to the Netezza host or the client system. Run the session in normal mode if you want to use the following features: ¨ Recovery ¨ Real-time sessions ¨ Pushdown optimization ¨ Commit interval ¨ Implicit join based on primary key and foreign key Bulk Mode You can transfer data in Netezza using bulk mode. the PowerCenter Integration Service reads and writes Netezza data through an external table. You can load data from the external table to the target. 11 ¨ Session Configuration with a Netezza Target. 10 ¨ Session Configuration with a Netezza Source. In bulk mode. 15 ¨ Netezza Session Configuration for Optimal Performance. 16 ¨ Troubleshooting Netezza Sessions. it creates an external table in the pipe directory path specified for loading.CHAPTER 4 Netezza Sessions and Workflows This chapter includes the following topics: ¨ Data Transfer Modes in Netezza. Create external tables to structure your loading operation and manipulate data by using Netezza SQL. it creates an external table in the pipe directory path specified for extraction. 17 Data Transfer Modes in Netezza You can transfer data in Netezza using normal and bulk mode. Use bulk mode to increase session performance. When the PowerCenter Integration Service extracts from Netezza.

Session Configuration with a Netezza Source You can configure the session properties for a Netezza source on the Mapping tab. Register the PowerExchange for Netezza plug-in with the repository. and LF characters in the Char or Varchar field.duplicate row handling is configured. Default is |. The PowerCenter Integration Service uses the NullValue internally. Default is blank. The following table describes the session properties that you must configure to extract Netezza source data in bulk mode: Attribute Name Socket Buffer Size Description Set the socket buffer size to 25 to 50 % of the DTM buffer size to increase session performance. The value can be a part of the data for the Netezza source. the PowerCenter Integration Service uses the following directory to create the pipe for the external table: <PowerCenter Installation Directory>/server/bin Pipe Directory Path Required if the machine hosting the PowerCenter Integration Service is on HP-UX and the following directory is on an NFS-mounted directory: <PowerCenter Installation Directory>/server/bin Enter a path that does not use an NFS mount. Configure the session to use a Netezza bulk reader and Netezza bulk writer. Path for the PowerCenter Integration Service to create the pipe for the external table. you need to add an escape character in the source data before extracting. Enter an escape character before the data. configure the session to use a relational reader. Verify that the Netezza database user has the LIST and CREATE EXTERNAL TABLE privileges on the database. NullValue parameter of an external table. To extract data in normal mode. 2. The load summary in the Workflow Monitor does not display load statistics. complete the following steps: 1. The supported escape character is backslash (\). NullValue EscapeCharacter Note: You can view load statistics in the session log. To extract data in bulk mode. CR. Enter a value between 4096 and 2147483648 bytes. configure the session to use a Netezza bulk reader. If the data contains NULL. The session properties for normal mode are the same as that of any other relational source. Maximum value is one character. 3. Session Configuration with a Netezza Source 11 . Escape character of an external table. Default is 8388608 bytes. Delimiter Delimiter separates successive input fields. Configure the session properties as described in the following sections. If you do not specify the path. data is loaded from the external table to a temporary table and then finally to the target. To transfer data in Netezza in bulk mode. Define the properties for each source instance in the session. 4. You might need to test different settings for optimal performance. You can enter any value supported by the Netezza Performance Server.

The delimiter separates successive input fields. Path for the PowerCenter Integration Service to create the pipe for the external table. Default is 8388608 bytes. the PowerCenter Integration Service creates the error log in the following directory on the machine hosting the Netezza Performance Server: /tmp The PowerCenter Integration Service creates a bad file in the error log directory if the data is not valid. Truncate Target Table Option The PowerCenter Integration Service truncates the target before loading. Define the properties for each target instance in the session. You might need to test different settings for optimal performance. If you do not specify the path. For example. The value must not be a part of the input data. Enter a value between 4096 and 2147483648 bytes. you can use the following directory: $PMBadFileDir By default. Error Log Directory Name Error log directory can reside on the machine where the PowerCenter Integration Service runs. the PowerCenter Integration Service truncates the target after loading. Default is disabled. To load data in bulk mode. the PowerCenter Integration Service runs the SQL statement after the table is deleted. Target Table Name Delimiter 12 Chapter 4: Netezza Sessions and Workflows . To load data in normal mode. If you specify an SQL statement in the Pre-SQL property. configure the session to use a relational writer. Default is |. the PowerCenter Integration Service uses the folllowing directory to create the pipe for the external table: <PowerCenter Installation Directory>/server/bin Pipe Directory Path Required if the machine hosting the PowerCenter Integration Service is on HP-UX and the following directory is on an NFS-mounted directory: <PowerCenter Installation Directory>/server/bin Enter a path that does not use an NFS mount. The following table describes the session properties that you must configure to load Netezza target data in bulk mode: Target Property Socket Buffer Size Description Set the socket buffer size to 25 to 50 % of the DTM buffer size to increase session performance. You can override the default target table name. Run the truncate table command. The session properties for normal mode are the same as that of any other relational target. Set the delimiter to any value supported by the Netezza Performance Server. Run the delete command. the PowerCenter Integration Service runs the SQL statement before the table is truncated. configure the session to use a Netezza bulk writer. If you specify an SQL statement in the Pre-SQL property. Note: In normal mode.Session Configuration with a Netezza Target You can configure target properties for a session that writes data to Netezza targets: ¨ Target database connection ¨ Target properties ¨ Update strategy ¨ Multiple targets referring to the same table ¨ Pipeline partitioning Target Properties You can configure the session properties for Netezza targets in the Transformations view on the Mapping tab.

The PowerCenter Integration Service loads empty strings as null values to the target. NullValue parameter of the external table. Default is disabled. Default is blank. When you increase the number of partitions. Default is First Row. it ignores target columns that are not connected in the mapping. When you select this option. Escape character of the external table. ###BOT_TEXT###. If a default value is defined in Netezza for an unconnected column. CRINSTRING NullValue EscapeCharacter Quoted Value Ignore Key Constraints Duplicate Row Handling Mechanism Add Escape Character Null Values and Empty Strings The target may contain null values even if you configure a column in the source definition to be not null. Default is NO. CR. QUOTEDVALUE parameter of the external table. Default is TRUE. Select NO to omit quotes. delimiter. \r. Session Configuration with a Netezza Target 13 . . Default is TRUE. You can enter a non escape CR in Char or Varchar fields. Maximum value is one character. CR. The quoted value is not a part of the data. Ensure that the value of the escape character is entered in the EscapeCharacter attribute. If you enter a control character. CRINSTRING parameter to transfer data containing carriage returns (CR). Unprojected Columns When the PowerCenter Integration Service generates SQL to load to a Netezza target. and LF characters in the Char or Varchar field. Ignores constraints on primary key fields. The special characters include \n. Netezza updates or populates the column with the default value. and LF fields. Pipeline Partitioning You can increase the number of partitions in a pipeline to improve session performance. the PowerCenter Integration Service can create multiple connections to sources and targets and process partitions of sources and target data concurrently. The PowerCenter Integration Service uses the NullValue internally. The PowerCenter Integration Service passes the last duplicate row to the target and discards the rest of the rows. To load the control characters present in the Char and Varchar fields. you must add an escape character for the NULL.Target Property Control Character Description CTRLCHARS parameter of the external table to transfer data containing control characters. Select one of the following values: . and null value character. You can enter control characters for Char and Varchar fields. you need to add an escape character for these fields before loading. Adds an escape character to all the special characters in the data.First Row. the PowerCenter Integration Service can write duplicate rows with the same primary key to the target. The PowerCenter Integration Service ignores this value when the target operation is “update as update” or “update else insert. escape character. The PowerCenter Integration Service passes the first row to the target and rejects the rows that follow with the same primary key. Enter a backslash (\) as the escape character.” Determines how the PowerCenter Integration Service handles duplicate rows.Last Row. Select SINGLE or DOUBLE to enclose the field in single or double quotes. set the CTRLCHARS and CRINSTRING parameters to TRUE in the session properties for the Netezza source. If the data contains NULL.

or round-robin partitioning. you can use database. ¨ You enter different values for the user-defined join across partitions. When the PowerCenter Integration Service writes to Netezza. You cannot perform multiple updates. pass-through. Use the following rules and guidelines when you configure multiple targets in a target connection group to write to the same Netezza target table: Target Load Type Insert Target Options Rules and Guidelines Insert Update as Insert Update as Update Update else Insert Delete Select the Ignore Key Constraints target property for insert targets. ¨ Have the same database connection name. update. If you load in normal mode. the PowerCenter Integration Service rolls back all targets in the target connection group. This means that the Netezza table is more uniformly distributed across Snippet Processing Units (SPU) than other tables. Update Use a maximum of one update table for any target. Delete 14 Chapter 4: Netezza Sessions and Workflows . Netezza targets in the same target connection group must meet the following criteria: ¨ Belong to the same pipeline. When the PowerCenter Integration Service needs to perform a rollback. ¨ To avoid unpredictable session results. and password. key range. use pass-through partitioning. multiple deletes. Target Connection Groups A target connection group is a group of targets that the PowerCenter Integration Service uses to determine commits and loading. ¨ Verify that the session properties for delete and update on the Mapping tab are not enabled for more than one partition. or update and delete simultaneously on a Netezza target. delete. Do not use with delete tables. configure the session properties for insert. ¨ If you run a partitioned session that joins multiple sources. ¨ Belong to the same partition. user name. and duplicate row handling to have the same value for each partition. Use a maximum of one delete table for any target. only one partition shows load statistics. hash. Do not use with update tables.The Netezza Performance Server divides data into data slices. ¨ You enter different values for the source filter across partitions. In a partitioned session that reads data from Netezza. link the first column in the Source Qualifier transformation to a source column that represents data for the Netezza table with the best distribution in Netezza. it commits data in the same transaction for all targets in a target connection group. Rules and Guidelines for Pipeline Partitioning Use the following rules and guidelines when you configure multiple partitions in a Netezza session: ¨ If you load in bulk mode. ¨ If you run a partitioned session with key constraints. each partition reads a different data slice to prevent data duplication except in the following cases: ¨ You enter an SQL override query for a partition.

The row is not inserted.a. 1a1. the PowerCenter Integration Service updates each target row.1a2 1.c. The following table describes how the PowerCenter Integration Service updates the target: Source Data Target Data Updated Target Data Comment 1.1b1.b. use the same rules and guidelines as for target connection groups. 1.a.1c1 is retained.1d1. for example 1 (primary key). Update Else Insert When you configure the session to update else insert rows. a (primary key). No insert is required. The session is configured to consider key constraints. the PowerCenter Integration Service does not insert the source row. 1.1a1 The source primary key is found in the target. the PowerCenter Integration Service updates target rows based on the update options and the duplicate row handling.1a3 1.1c1 1. Netezza Target Data Update 15 .a.d. It updates with the first or last source row matched.1a3 is retained. No insert is required.c.1d1 1. even if they are not in the same target connection group.1b1 1.a. Inserts 1.d. When you configure targets in different partitions or pipelines to write to the same target table. the PowerCenter Integration Service inserts the source row. ¨ If the source primary key value does not exist in the target.b. Netezza Target Data Update In bulk mode. The existing row 1. Update As Insert When you configure the session to update as insert rows. The source primary key is found in the target. the PowerCenter Integration Service uses the following process to update target rows: ¨ If the source key value matches a target key value.1c1 1. based on how you configure duplicate row handling.1a3 Note: In the pair of values. The existing row 1.d.1a3 1.b. The row is not inserted. 1. The source primary key is found in the target.1d1 1.c.1c1 The source primary key is found in the target.a. the first two values are the primary key.a.1b1 Inserts 1.Multiple Targets Configuration for the Same Target Table You can configure multiple targets to write to the same Netezza table. the PowerCenter Integration Service uses the following process to update target rows: ¨ If the source key value matches a target key value.c.

8 1. ¨ Line sequential buffer length. You can increase or decrease the value of commit interval to determine the point at which the PowerCenter Integration Service commits data to the target.8 with 1. No update required.5 3. Since Netezza does not enforce key constraints.2 Target Data 1.7 Retains 3. You can increase or decrease the value of DTM Buffer Size to specify the amount of memory the PowerCenter Integration Service uses as DTM buffer memory. The source primary key is found in the target.5.7. You can improve session performance by ignoring key constraints when writing to Netezza targets. Set the following parameters to increase the session performance: ¨ Default buffer block size. You can improve session performance by avoiding the use of escape characters in a session.2 2.3 1.2. the PowerCenter Integration Service inserts the source row. You can increase or decrease the number of available memory blocks that are used to hold the source and target data in the session. Subsequent target rows with primary key “1” are updated with first source row. The source primary key is not found in the target. 1.2 Comment Updates 1.4 2. 16 Chapter 4: Netezza Sessions and Workflows . Note: In the pair of values. The source primary key is found in the target. Inserts 2.4. The row is inserted.7 3. The target row is updated based on duplicate row handling to use first row.¨ If the source primary key value does not exist in the target. for example 1 (primary key). ¨ Escape characters. ¨ Ignore key constraints. Netezza Session Configuration for Optimal Performance You can increase the performance of PowerExchange for Netezza by setting the properties in the session. ¨ Commit interval. the PowerCenter Integration Service performs additional processing when a session that writes to Netezza requires key constraints.6 Updated Target Data 1.2. Updates 1. ¨ DTM buffer size.6 with 1. and first duplicate row has been updated in the target. Drops 2.4 2. ¨ Socket buffer size. The following table describes how the PowerCenter Integration Service updates the target: Source Data 1. You can configure the socket buffer size to specify the size of the buffers used to extract data from and load data to Netezza. Duplicate row handling is configured to update with first source row. 2. the first value is the primary key. You can improve the session performance by setting the number of bytes the PowerCenter Integration Service reads per line.

Netezza writer sessions can stop responding or terminate unexpectedly. You can configure the distribution key to include up to four columns in a database table.4 on HPUX.000 ¨ DTM buffer size: 28.For example. to kill blocking Netezza sessions. A Netezza Reader session can stop responding if the source contains special characters like delimiter.1. the distribution key is the first column of a table. and NZ_ODBC_INI_PATH are set correctly.4 are used.1. ODBCINI. ¨ The pipe directory path on HP-UX is on an NFS-mounted drive. to obtain optimal performance for 3 million rows and 32 KB row size. Use the Netezza driver 4. Check out for the ones which need directory path specification. LIBPATH.400 ¨ Commit interval: 200. you can try killing the blocking Netezza sessions or disable Netezza ODBC tracing and ODBC tracing. /tmp) in the pipe directory path of the Netezza Writer session property. ¨ The environment variables are set incorrectly. This is a Netezza issue and the reference number is SWS-40577. which comes with client tools. you can greatly increase session performance. ¨ The permissions for the file paths in the session properties are set incorrectly. ¨ Netezza drivers 3.000. For more information.000 ¨ Line sequential buffer length: 202. see the Netezza documentation. By default. Specify a non NFS-mounted drive (for example. Troubleshooting Netezza Sessions 17 .1. Check whether the environment variables PATH. Multi-pipe and multi-partition sessions can stop responding randomly with Netezza drivers 3. If the pipe directory path on HP-UX is on an NFS-mounted drive. Add escape characters in the session to eliminate the delimiters.04 P2 to avoid this issue. Ensure that all the file paths in the session properties set for Netezza reader and writer sessions are correct and have proper permission.2 or 3. When you configure a distribution key to evenly distribute data across available data slices. Troubleshooting Netezza Sessions A Netezza session stops responding with no definite error messages in the logs A Netezza session can stop responding because of the following reasons: ¨ The source data contains special characters like delimiter.280. Netezza uses a distribution key to distribute data for processing. set the following parameters: ¨ Default buffer block size: 1. If the issue persists.1.000 ¨ Socket buffer size: 8388608 bytes ¨ Escape characters: None ¨ Ignore key constraints: Selected Netezza Distribution Key Use a Netezza distribution key to increase session performance with parallel processing.2 or 3. How can I kill blocking Netezza sessions? Use the nzsession utility.

set the parameter debugLogging as true to enable Netezza ODBC tracing and as false to disable Netezza ODBC tracing.Run the following command to view the active Netezza sessions: nzsession show -host <hostname> -u <user> -pw <password> -maxColW <column width> |grep -i "active Run the following command to kill active sessions: -host <hostname> -u <user> -pw <password> -id <session id> [-force] How can I enable or disable Netezza ODBC tracing? In the odbcinst. set the parameter Trace as 1 to enable Netezza ODBC tracing and as 0 to disable Netezza ODBC tracing. 18 Chapter 4: Netezza Sessions and Workflows . How can I enable or disable ODBC tracing? In the odbc.ini file.ini file.

857. When the PowerCenter Integration Service writes to a target.808 through 9. 9999 A. it converts the native datatypes to the comparable transformation datatypes before transforming the data.854. on or off. The following table lists the Netezza datatypes that PowerCenter supports and the corresponding transformation datatypes: Netezza Datatype BigInt Range Transformation Datatype Bigint Range Precision 19.036.600 characters Jan. 0001 A.807 Precision of 19.D. to Dec. 31.D. it converts the transformation datatypes to the comparable native datatypes. 1. scale 0 From 1 through 104.372. yes or no Precision 3. scale of 0 Integer value Precision 1 Bool True or false. scale 0 Double Double 19 . 0 or 1. They appear in all transformations in a mapping.854. When the PowerCenter Integration Service reads source data.APPENDIX A Datatype Reference This appendix includes the following topic: ¨ Netezza and Transformation Datatypes. scale 0 Single character ANSI SQL date String ByteInt Char Date Small Integer String Date/Time Precision 5. (precision to the nanosecond) Precision 15 Precision 15 Float8 Float4 Precision 15 Precision 6.036. Netezza datatypes appear in Netezza definitions in a mapping.372. ¨ Transformation datatypes.223.775. scale 0 From -9.223. which the PowerCenter Integration Service uses to move data across platforms. 19 Netezza and Transformation Datatypes PowerCenter uses the following datatypes in Netezza mappings: ¨ Netezza native datatypes. Set of datatypes that appear in the transformations.775. They are internal datatypes based on ANSI SQL-92 generic datatypes.

9999 A. variable storage length String 20 Appendix A: Datatype Reference . 31. 1. to Dec.600 characters NVarchar(m) String From 1 through 104.857.D. 1. scale from 0 through 28 Real Real Precision of 7. scale 0 From 1 through 104. 31.857. scale 0 Single character Used for storing UTF-8 data BVarchar (length) Non-blank-padded string.600 characters SmallInt Time Precision 5. (precision to the nanosecond) Jan.Netezza Datatype Integer NChar(m) Range Transformation Datatype Integer String Range Precision 10.D. to Dec.D. scale 6 Date/Time Varchar Varchar (length) Non-blank-padded string. decimal). scale of 0 Double-precision floating-point numeric value Precision 5.D. 9999 A. scale 0 hh:mm:ss. (precision to the nanosecond) From 1 through 104. variable storage length Used for storing UTF-8 data Numeric (precision. 0001 A. scale 0 Precision 10. ANSI SQL time Small Integer Date/Time Timestamp Precision 26. 0001 A.857. scale 0 Jan.600 characters Numeric Decimal Precision from 1 through 28 digits. arbitrary precision number Precision must be between 1 and 38 Precision 6.

overview 7 I installation Netezza prerequisites 2 T target connection groups using with Netezza 14 target property socket buffer size 11.INDEX D databases connecting to Netezza (UNIX) 4 connecting to Netezza (Windows) 3 datatypes PowerExchange for Netezza 19 default values Netezza targets 13 null values in Netezza 13 P partitioning Netezza sessions 13 pipe directory path setting 11 setting for HP-UX 11 plug-ins registering for Netezza 3 prerequisites Netezza installation 2 E empty strings in Netezza 13 H HP-UX pipe directory path. setting 11 S socket buffer size target property 11. 12 Source Qualifier Netezza. 12 targets Netezza default values 13 unprojected columns in Netezza 13 using multiple for the same Netezza table 15 K key constraints example 15 M multiple targets for the same Netezza table 15 U update as insert description for Netezza 15 update else insert description for Netezza 15 update strategy example 15 update as insert for Netezza 15 update else insert for Netezza 15 upgrading PowerExchange for Netezza 3 N Netezza connecting from an integration service (Windows) 3 connecting from Informatica clients(Windows) 3 connecting to an Informatica client (UNIX) 4 connecting to an integration service (UNIX) 4 Netezza target connection groups using multiple targets for the same table 14 21 .