® ® IBM DB2 Universal Database Data Movement Utilities Guide and Reference Ve r s i o n 7 SC09-2955-00 ® ® IBM DB2 Universal Database Data Movement Utilities Guide and Reference Ve r s i o n 7 SC09-2955-00 Before using this information and the product it supports, be sure to read the general information under “Appendix F. Notices” on page 287. This document contains proprietary information of IBM. It is provided under a license agreement and is protected by copyright law. The information contained in this publication does not include any product warranties, and any statements provided in this manual should not be interpreted as such. Order publications through your IBM representative or the IBM branch office serving your locality or by calling 1-800-879-2755 in the United States or 1-800-IBM-4YOU in Canada. When you send information to IBM, you grant IBM a nonexclusive right to use or distribute the information in any way it believes appropriate without incurring any obligation to you. © Copyright International Business Machines Corporation 1999, 2000. All rights reserved. US Government Users Restricted Rights – Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp. Contents About This Book ..........v SQLUIMPT-OUT Data Structure .....53 Who Should Use this Book .......v File Type Modifiers (Import) ......55 How this Book is Structured.......vi Character Set and NLS Considerations . 65 Example Import Sessions........65 Chapter 1. Export ..........1 CLP Examples ..........65 Export Overview ...........1 API Examples ..........67 Privileges, Authorities, and Authorization Optimizing Import Performance .....67 Required to Use Export ........2 Restrictions and Limitations.......67 Using Export ............3 Troubleshooting ...........68 Before Using Export.........3 Invoking Export ..........3 Chapter 3. Load ..........69 || Using Export with Identity Columns ....3 Load Overview ...........70 Recreating an Exported Table ......4 | Changes to Previous Load Behavior Exporting Large Objects (LOBs) ......4 || Introduced in Version 6 and Version 7 . 74 || Exporting Data in Parallel........4 Parallelism and Loading ........75 EXPORT Command ..........7 Privileges, Authorities, and Authorization Export API ............10 Required to Use Load .........76 SQLUEXPT-OUT Data Structure .....16 Using Load ............77 File Type Modifiers (Export) ......17 Before Using Load .........77 Delimiter Restrictions ........18 Invoking Load ..........77 Example Export Sessions........19 || Using Load with Identity Columns ....78 CLP Examples ..........19 || Using Load with Generated Columns . 80 API Examples ..........20 Checking for Constraints Violations ....82 Restrictions ............24 Restarting an Interrupted Load Operation . 83 Troubleshooting ...........24 Using the Load Copy Location File ....84 LOADCommand..........86 Chapter 2. Import ..........25 || LOADQUERYCommand.......99 Import Overview ..........26 Load API ............101 Privileges, Authorities, and Authorization Data Structure: SQLULOAD-IN .....110 Required to Use Import ........27 Data Structure: SQLULOAD-OUT ....114 Using Import ...........27 db2LoadQuery - Load Query API ....116 Before Using Import ........27 File Type Modifiers (Load) .......120 Invoking Import .........27 Exception Table ..........134 Using Import in a Client/Server Dump File ............135 Environment ...........28 Load Temporary Files ........135 Using Import with Buffered Inserts ....28 Load Utility Log Records .......136 || Using Import with Identity Columns....29 Character Set and National Language || Using Import with Generated Columns . 30 Support .............136 Recreating an Exported Table ......32 Example Load Sessions ........137 Importing Large Objects (LOBs) .....33 CLP Examples ..........137 Importing User-defined Distinct Types (UDTs) 34 API Examples ..........142 || Table Locking During Import ......34 Pending States After a Load Operation. 148 IMPORTCommand.........35 Optimizing Load Performance .....149 Import API ............42 Restrictions and Limitations ......154 SQLUIMPT-IN Data Structure ......52 Troubleshooting ..........155 © Copyright IBM Corp. 1999, 2000 iii Chapter 4. AutoLoader .......157 Appendix C. Export/Import/Load Utility AutoLoader Overview ........157 File Formats ...........207 Privileges, Authorities, and Authorization Delimited ASCII (DEL) File Format ....207 Required to Use AutoLoader ......158 Sample DEL File .........209 Using AutoLoader .........158 DEL Data Type Descriptions .....210 Before Using AutoLoader ......158 Non-delimited ASCII (ASC) File Format . 213 Invoking AutoLoader .......159 Sample ASC File .........214 Loading into Multiple Database Partitions 159 ASC Data Type Descriptions .....215 AutoLoader Options .........160 PC Version of IXF File Format .....218 Example AutoLoader Session ......167 || PC/IXF Record Types .......220 Migration and Back-level Compatibility . 169 PC/IXF Data Types ........238 AutoLoader Hints and Tips ......170 PC/IXF Data Type Descriptions ....245 Restrictions and Limitations ......172 General Rules Governing PC/IXF File AutoLoader Troubleshooting ......172 Import into Databases .......251 Data Type-Specific Rules Governing Chapter 5. Moving DB2 Data Links PC/IXF File Import into Databases . 252 Manager Data...........175 FORCEIN Option .........256 Using Export to Move DB2 Data Links Differences between PC/IXF and Version Manager Data ...........175 0 System/370 IXF .........264 Using Import to Move DB2 Data Links Worksheet File Format (WSF) ......265 Manager Data ...........179 Using Load to Move DB2 Data Links Appendix D. Warning, Error, and Manager Data ...........179 Completion Messages........267 Chapter 6. Moving Data Between Systems 181 Appendix E. Using the DB2 Library . 269 Moving Data Across Platforms .....181 DB2 PDF files and printed books ....269 PC/IXF File Format ........181 DB2 information .........269 Delimited ASCII (DEL) File Format . 182 Printing the PDF books .......279 WSF File Format .........182 Ordering the printed books .....279 Moving Data Using the db2move Tool . 184 DB2 online documentation .......280 Moving Data With DB2 Connect .....189 Accessing online help .......280 Using the Export and the Import Utilities 189 Viewing information online .....281 Moving Data Between Typed Tables . 190 Using DB2 wizards ........284 Traverse Order..........192 Setting up a document server .....285 Selection During Data Movement . 193 Searching information online .....285 Examples of Moving Data Between Typed Tables.............194 Appendix F. Notices ........287 Using Replication to Move Data .....196 Trademarks ............290 The IBM Replication Tools by Component 197 | Using the Data Warehouse Center to Move Index .............293 || Data..............198 Contacting IBM ..........297 Appendix A. How to Read the Syntax Product information .........297 Diagrams ............201 Appendix B. Differences Between the Import and the Load Utility ......205 iv Data Movement Utilities About This Book This book provides information about, and shows you how to use, the following IBM DB2 Universal Database (UDB) data movement utilities: v The Import and Export utilities move data between a table or view and another database or spreadsheet program; between DB2 databases; and between DB2 databases and host databases using DB2 Connect. The export utility moves data from a database into operating system files; you can then use those files to import or load that data into another database. v The Load utility moves data into tables, extends existing indexes, and generates statistics. Load moves data much faster than the import utility when large amounts of data are involved. Data unloaded using the export utility can be loaded with the load utility. v The AutoLoader utility splits large amounts of data and loads the split data into the different partitions of a partitioned database. v DataPropagator (DPROP) is a component of DB2 Universal Database that allows automatic copying of table updates to other tables in other DB2 relational databases. | v The Data Warehouse Center (DWC) can be used to move data from | operational databases to a warehouse database. Other vendor’s products that move data in and out of databases are also available, but are not discussed in this book. Who Should Use this Book This manual is for database administrators, application programmers, and other DB2 UDB users who perform the following tasks: v Load data into DB2 tables from operating system files v Move data between DB2 databases, and between DB2 and other applications (for example, spreadsheets) v Archive data. It is assumed that you are familiar with DB2 Universal Database, Structured Query Language (SQL), and with the operating system environment in which DB2 UDB is running. For general information about DB2 UDB, see the Administration Guide. For information about SQL, see the SQL Reference. For information about configuring, invoking, and using the DB2 UDB command line processor, see the Command Reference. For information about the DB2 UDB application programming interfaces (APIs), see the Administrative API Reference. For general information about creating applications containing DB2 © Copyright IBM Corp. 1999, 2000 v administrative APIs, see the Application Building Guide. This manual does not contain instructions for installing DB2, which depend on your operating system. Installation information can be found in the appropriate Quick Beginnings book for your operating system. How this Book is Structured