Exporting Binary Data from IBM DB2 for i to Microsoft SQL Server

Transcription

1 Exporting Binary Data from IBM DB2 for i to Microsoft SQL Server

2 Copyright This document is copyrighted and protected by worldwide copyright laws and treaty provisions. No portion of this documentation may be distributed or reproduced by any means, or in any form, without HiT Software's prior written permission. COPYRIGHT NOTICE: Copyright 2010 HiT Software, Inc., A BackOffice Associates, LLC Company. All Rights Reserved. Disclaimer Information in these HTML documents is subject to change without notice. Although efforts have been made to ensure the accuracy of these documents, HiT Software, Inc. assumes no responsibility for damages incurred directly or indirectly from errors, omissions, and discrepancies between the software and the documents. If you find any problems in the documentation, please report them to HiT Software, Inc. Trademarks HiT Software, DBMoto and Ritmo are registered trademarks or trademarks of HiT Software, Inc. All other marks are used for the benefit of their respective owners and HiT Software, Inc. disclaims any interest in such marks. Contact Information HiT Software, Inc. Tel Fax Electronic mail: info@hitsw.com Web site:

3 Introduction This document describes how to use DBMoto to export data from IBM DB2 for i to Microsoft SQL Server in cases where DB2 data is stored in a binary field, but contains characters that use a different CCSID from the one defined for the database, and therefore a custom CCSID conversion is needed. For example, in a database that is set up with a CCSID for English, but contains binary fields with Chinese characters, a custom approach to character conversion is needed to import the data as Chinese characters into SQL Server. In this case, DBMoto and Ritmo/i offer the ability to read binary data representing Chinese strings and transfer them to a Unicode field on SQL Server with the proper Chinese content. The approach described below works equally well with other double-byte languages such as Japanese. The steps below are divided into three sections: 1. Setting up a source connection to IBM DB2 for i to export the data 2. Setting up a target connection to SQL Server to import the data 3. Setting up the options/schedule for copying the data from IBM DB2 for i to SQL Server 1. Setting up a Source Connection to IBM DB2 DBMoto manages export/import of data, or data replication, by first setting up connections to the origin database (source database) and the destination database (target database). 1. Install DBMoto Run the DBMoto Management Center. 3. Expand the metadata node, 4. Select the Sources folder. 5. From the right mouse button menu, choose Add New Connection. 6. In the Source Connection Wizard, select the database IBM DB2 for i/as400. HiT Software, Inc., A Back Office Associates, LLC Company Copyright

4 The Provider field should display the value HiT Software.NET Driver (Ritmo/i), and the Assembly field automatically displays the value Ritmo_i/lib/Sql400.dll. 7. Click Next to display the Set Connection String screen. HiT Software, Inc., A Back Office Associates, LLC Company Copyright

5 8. In the Data Source field, type the IP address for the IBM I system, User ID, Password and Libraries (optional). 9. Click Test to test the connection to make sure it is set up correctly. 10. Click Next to display the Setup Info screen. 11. For a full snapshot replication of the table (single import of data), do not enter anything in this screen and click Next. If you want to set replications to occur repeatedly based on transactions recorded in the DB2 journal, check the option Use Transactional Replication. See Setting Up Transactional Replications below for more information on what to enter in this screen. 12. Click Next to display the Select Tables screen. HiT Software, Inc., A Back Office Associates, LLC Company Copyright

6 13. Select the table with binary fields and values using a different CCSID. 14. Click Next, then Finish to complete the wizard. 15. In the Management Center, expand the tree in the Metadata Explorer to display the table you added. 16. Select the table and, from the right mouse button menu, choose Table Properties. HiT Software, Inc., A Back Office Associates, LLC Company Copyright

7 17. In the Table Properties dialog, select the field Characters CCSID. 18. In the Values field, click the Ellipsis button ( three dots.) HiT Software, Inc., A Back Office Associates, LLC Company Copyright

8 19. In the Field CCSID Setting dialog, change the CCSID setting for the field that contains the binary data that needs to be imported. In the case of Chinese, you would edit the value and replace it with 935 (the Simplified Chinese code page.) HiT Software, Inc., A Back Office Associates, LLC Company Copyright

9 20. Click OK in the dialog to complete the operation, then click OK in the Table Properties dialog. You can check to see that the character conversion has been performed correctly by viewing the table via the DBMoto Management Center. 21. In the Management Center Metadata Explorer, select the table. 22. From the right mouse button menu, choose Open Table. The table is displayed in the SQL Query tab, You should see the converted content properly as in the Chinese example below. This means the Ritmo/I.Net Data Provider used with DBMoto was able to convert from CCSID to Chinese 935. HiT Software, Inc., A Back Office Associates, LLC Company Copyright

10 2. Setting up a Target Connection to Microsoft SQL Server Now you need to create a target connection to SQL Server because you want to export the table there. 1. In the DBMoto Management Center, expand the metadata node. 2. Select the Targets folder. 3. From the right mouse button menu, choose Add New Connection. 4. In the Target Connection Wizard, select the database Microsoft SQL Server. HiT Software, Inc., A Back Office Associates, LLC Company Copyright

11 5. In the Data Source field, type the IP address for the SQL Server system, User ID and Password. HiT Software, Inc., A Back Office Associates, LLC Company Copyright

12 6. Click Test to test the connection to make sure it is set up correctly. 7. Click Next to display the Setup Info screen. 8. Click Next in the Select Tables and Summary screen. HiT Software, Inc., A Back Office Associates, LLC Company Copyright

13 9. Click Finish to complete the Target Connection wizard. Next you need to create the source table in Microsoft SQL Server. 10. In the Metadata Explorer, expand the Source Connections node to display the table you added for IBM DB2 for i. 11. Drag the table to the SQL Server target connection you just created. The Create Target Table wizard is displayed. HiT Software, Inc., A Back Office Associates, LLC Company Copyright

14 12. Click Next to display the Source Connection screen. HiT Software, Inc., A Back Office Associates, LLC Company Copyright

15 13. Make sure that the IBM/DB2 for i table with binary characters is displayed. 14. Click Next to display the Target Connection screen. 15. Select the connection you created above for Microsoft SQL Server. 16. Supply an appropriate table name. 17. Click Next to display the Define Columns screen. 18. By default the column that will be created in Microsoft SQL Server is a char data type, but you need to change it to nchar (Unicode) to host Chinese data. HiT Software, Inc., A Back Office Associates, LLC Company Copyright

16 19. Click Next to view the SQL script that will be used to create the table. HiT Software, Inc., A Back Office Associates, LLC Company Copyright

17 20. Click Next, then Finish to complete the wizard. 21. If the creation of the table in SQL Server is successful, you will see the following dialog. Click OK to proceed. 22. Select Yes in the dialog below to add the table to the list of target tables in the Metadata Explorer. 23. Expand the Metadata Explorer to view the newly created table. HiT Software, Inc., A Back Office Associates, LLC Company Copyright

18 3.Setting up to copy data from IBM DB2 for i to SQL Server 1. In the Metadata Explorer, drag the table you specified for the IBM DB2 for i source connection to the SQL table you just created to display the Replication wizard. HiT Software, Inc., A Back Office Associates, LLC Company Copyright

19 2. Specify a name to identify the replication. HiT Software, Inc., A Back Office Associates, LLC Company Copyright

20 3. Click Next to display subsequent screens, leaving default values in each one. HiT Software, Inc., A Back Office Associates, LLC Company Copyright

21 4. Click Finish to complete the wizard. HiT Software, Inc., A Back Office Associates, LLC Company Copyright

22 5. Expand the Metadata Explorer to display the contents of the Replications node. You should see the replication you just created. HiT Software, Inc., A Back Office Associates, LLC Company Copyright

23 6. Select the Replication Monitor tab in the panel to the right of the Metadata Explorer. 7. In the Windows Notification area, identify the DBMoto Service Monitor. 8. From the right mouse button menu, choose DBMoto Data Replicator, then Start, then Application. HiT Software, Inc., A Back Office Associates, LLC Company Copyright

24 9. In the Replication Monitor, observe the progress of the replication until it displays 100%. At this point, the data in the table has been copied from IBM DB2 for I to Microsoft SQL Server. 10. In the Metadata Explorer, select the table in SQL Server. 11. From the right mouse button menu, choose Open Table. HiT Software, Inc., A Back Office Associates, LLC Company Copyright

25 12. In the SQL Query tab, check that the data has been copied to the table. HiT Software, Inc., A Back Office Associates, LLC Company Copyright

26 13. You can also use the SQL Server Management Center to verify the data. HiT Software, Inc., A Back Office Associates, LLC Company Copyright