Progress® DataDirect® for ODBC Drivers Reference September 2020 Copyright © 2020 Progress Software Corporation and/or its subsidiaries or affiliates. All rights reserved. These materials and all Progress® software products are copyrighted and all rights are reserved by Progress Software Corporation. The information in these materials is subject to change without notice, and Progress Software Corporation assumes no responsibility for any errors that may appear therein. The references in these materials to specific platforms supported are subject to change. Corticon, DataDirect (and design), DataDirect Cloud, DataDirect Connect, DataDirect Connect64, DataDirect XML Converters, DataDirect XQuery, DataRPM, Defrag This, Deliver More Than Expected, Icenium, Ipswitch, iMacros, Kendo UI, Kinvey, MessageWay, MOVEit, NativeChat, NativeScript, OpenEdge, Powered by Progress, Progress, Progress Software Developers Network, SequeLink, Sitefinity (and Design), Sitefinity, SpeedScript, Stylus Studio, TeamPulse, Telerik, Telerik (and Design), Test Studio, WebSpeed, WhatsConfigured, WhatsConnected, WhatsUp, and WS_FTP are registered trademarks of Progress Software Corporation or one of its affiliates or subsidiaries in the U.S. and/or other countries. Analytics360, AppServer, BusinessEdge, DataDirect Autonomous REST Connector, DataDirect Spy, SupportLink, DevCraft, Fiddler, iMail, JustAssembly, JustDecompile, JustMock, NativeScript Sidekick, OpenAccess, ProDataSet, Progress Results, Progress Software, ProVision, PSE Pro, SmartBrowser, SmartComponent, SmartDataBrowser, SmartDataObjects, SmartDataView, SmartDialog, SmartFolder, SmartFrame, SmartObjects, SmartPanel, SmartQuery, SmartViewer, SmartWindow, and WebClient are trademarks or service marks of Progress Software Corporation and/or its subsidiaries or affiliates in the U.S. and other countries. Java is a registered trademark of Oracle and/or its affiliates. Any other marks contained herein may be trademarks of their respective owners. Updated: 2020/09/08 Progress DataDirect for ODBC Drivers: Reference: Version September 2020 3 Copyright 4 Progress DataDirect for ODBC Drivers: Reference: Version September 2020 Contents Table of Contents Welcome to the Progress DataDirect for ODBC Drivers Reference .........9 Troubleshooting...........................................................................................11 Diagnostic tools....................................................................................................................................11 ODBC trace...............................................................................................................................11 Test loading tool.........................................................................................................................15 ODBC Test.................................................................................................................................16 iODBC Demo and iODBC Test..................................................................................................16 Logging for Java components....................................................................................................16 The example application............................................................................................................19 Other tools.................................................................................................................................20 Error messages....................................................................................................................................20 Troubleshooting....................................................................................................................................21 Setup/connection issues............................................................................................................22 Interoperability issues................................................................................................................23 Performance issues...................................................................................................................24 Code page values........................................................................................25 IANAAppCodePage values ..................................................................................................................25 IBM to IANA code page values.............................................................................................................30 Teradata code page values...................................................................................................................32 ODBC API and scalar functions.................................................................33 API functions........................................................................................................................................33 Scalar functions....................................................................................................................................35 String functions..........................................................................................................................37 Numeric functions......................................................................................................................39 Date and time functions.............................................................................................................40 System functions.......................................................................................................................42 Internationalization, localization, and Unicode.........................................43 Internationalization and Localization....................................................................................................43 Locale........................................................................................................................................44 Language...................................................................................................................................44 Country......................................................................................................................................44 Variant........................................................................................................................................45 Progress DataDirect for ODBC Drivers: Reference: Version September 2020 5 Contents Unicode character encoding.................................................................................................................45 Background................................................................................................................................45 Unicode support in databases...................................................................................................46 Unicode support in ODBC.........................................................................................................46 Unicode and non-Unicode ODBC drivers.............................................................................................47 Function calls.............................................................................................................................47 Data...........................................................................................................................................50 Default Unicode mapping...........................................................................................................51 Driver Manager and Unicode encoding on UNIX/Linux........................................................................52 References.................................................................................................................................53 Character encoding in the odbc.ini and odbcinst.ini files......................................................................53 Designing ODBC Applications for Performance Optimization................55 Using Catalog Functions......................................................................................................................56 Caching Information to Minimize the Use of Catalog Functions................................................56 Avoiding Search Patterns...........................................................................................................57 Using a Dummy Query to Determine Table Characteristics.......................................................57 Retrieving Data.....................................................................................................................................58 Retrieving Long Data.................................................................................................................58 Reducing the Size of Data Retrieved.........................................................................................58 Using Bound Columns...............................................................................................................59 Using SQLExtendedFetch Instead of SQLFetch.......................................................................59 Choosing the Right Data Type...................................................................................................60 Selecting ODBC Functions...................................................................................................................60 Using SQLPrepare/SQLExecute