datadirect connect® series for odbc user's guide ·...

DataDirect Connect Series forODBC

User's Guide

Release 7.1.6

Notices

For details, see the following topics:

Copyright

Copyright 2016 Progress Software Corporation and/or one of its subsidiaries oraffiliates. All rights reserved.These materials and all Progress software products are copyrighted and all rights are reservedby Progress Software Corporation. The information in these materials is subject to change withoutnotice, and Progress Software Corporation assumes no responsibility for any errors that mayappear therein. The references in these materials to specific platforms supported are subject tochange.

3DataDirect Connect Series for ODBC: User's Guide: Version 7.1.6

Business Making Progress, Corticon, DataDirect (and design), DataDirect Cloud, DataDirectConnect, DataDirect Connect64, DataDirect XML Converters, DataDirect XQuery, Deliver MoreThan Expected, Icenium, Kendo UI, Making Software Work Together, NativeScript, OpenEdge,Powered by Progress, Progress, Progress Software Business Making Progress, Progress SoftwareDevelopers Network, Rollbase, RulesCloud, RulesWorld, SequeLink, Sitefinity (and Design),SpeedScript, Stylus Studio, TeamPulse, Telerik, Telerik (and Design), Test Studio, and WebSpeedare registered trademarks of Progress Software Corporation or one of its affiliates or subsidiariesin the U.S. and/or other countries. AccelEvent, AppsAlive, AppServer, BravePoint, BusinessEdge,DataDirect Spy, DataDirect SupportLink, Future Proof, High Performance Integration, OpenAccess,ProDataSet, Progress Arcade, Progress Profiles, Progress Results, Progress RFID, ProgressSoftware, ProVision, PSE Pro, SectorAlliance, Sitefinity, SmartBrowser, SmartComponent,SmartDataBrowser, SmartDataObjects, SmartDataView, SmartDialog, SmartFolder, SmartFrame,SmartObjects, SmartPanel, SmartQuery, SmartViewer, SmartWindow, WebClient, and Who MakesProgress are trademarks or service marks of Progress Software Corporation and/or its subsidiariesor affiliates in the U.S. and other countries. Java is a registered trademark of Oracle and/or itsaffiliates. Any other marks contained herein may be trademarks of their respective owners.

Please refer to the readme applicable to the particular Progress product release for any third-partyacknowledgements required to be provided in the documentation associated with the Progressproduct.

DataDirect Connect Series for ODBC: User's Guide: Version 7.1.64

Notices

Table of Contents

Preface...........................................................................................................41About this Book......................................................................................................................................41Product Platforms..................................................................................................................................42Product Matrix........................................................................................................................................43What's new in this release?...................................................................................................................44Using this Book......................................................................................................................................54Conventions Used in This Guide...........................................................................................................55

Typographical Conventions.........................................................................................................56Environment-Specific Information...............................................................................................57

About the Product Documentation.........................................................................................................57About the Documentation Library...............................................................................................57

HTML Version..................................................................................................................59PDF Version.....................................................................................................................60

Contacting Technical Support................................................................................................................61

Part I: Getting Started...................................................................................63

Chapter 1: Quick Start Connect...........................................................65Configuring and Connecting on Windows...................................................................................66

Setting the Library Path Environment Variable (Salesforce Driver on Windows).............66Configuring a Data Source...............................................................................................66Testing the Connection.....................................................................................................67

Configuring and Connecting on UNIX and Linux........................................................................67Environment Configuration...............................................................................................67Test Loading the Driver....................................................................................................68Setting the Library Path Environment Variable (Salesforce Driver on UNIX/Linux).........68Configuring a Data Source...............................................................................................69Testing the Connection.....................................................................................................70

Using the Performance Wizard...................................................................................................70Starting the Wizard...........................................................................................................71Tuning Performance Using the Wizard............................................................................71

Chapter 2: General Information on Using Connect Drivers..............73What Is ODBC?..........................................................................................................................74

How Does It Work?..........................................................................................................74Why Do Application Developers Need ODBC?...............................................................75

About the Product.......................................................................................................................75


Support for Multiple Environments...................................................................................75Environment-Specific Information...............................................................................................75

For Windows Users..........................................................................................................7632-Bit Drivers.........................................................................................................7664-Bit Drivers.........................................................................................................77Setup of the Drivers...............................................................................................78Driver Names........................................................................................................78

For UNIX and Linux Users...............................................................................................7832-Bit Drivers.........................................................................................................7864-Bit Drivers.........................................................................................................81AIX.........................................................................................................................84HP-UX 11 aCC......................................................................................................84Linux......................................................................................................................84Oracle Solaris........................................................................................................84Setup of the Environment and the Drivers............................................................85Driver Names........................................................................................................85

Using IP Addresses....................................................................................................................85Binding Parameter Markers........................................................................................................87Driver Threading Information......................................................................................................87Version String Information...........................................................................................................88

getFileVersionString Function..........................................................................................90Retrieving Data Type Information...............................................................................................90Persisting a Result Set as an XML Data File..............................................................................91

Using the Windows XML Persistence Demo Tool............................................................92Using the UNIX/Linux XML Persistence Demo Tool........................................................93

Translators..................................................................................................................................93

Chapter 3: Advanced Features............................................................95Using Failover.............................................................................................................................95

Connection Failover.........................................................................................................96Extended Connection Failover.........................................................................................98Select Connection Failover..............................................................................................99Guidelines for Primary and Alternate Servers................................................................101Using Client Load Balancing .........................................................................................101Using Connection Retry.................................................................................................102Summary of Failover-Related Options...........................................................................103

A Connection String Example.............................................................................104An odbc.ini File Example.....................................................................................105

Using Client Information............................................................................................................105How Databases Store Client Information.......................................................................106Storing Client Information...............................................................................................106

Using Security...........................................................................................................................107Authentication................................................................................................................107

Kerberos Authentication......................................................................................108


NTLM Authentication...........................................................................................109Data Encryption Across the Network.............................................................................109SSL Encryption..............................................................................................................110

Certificates..........................................................................................................110SSL Server Authentication..................................................................................111SSL Client Authentication...................................................................................111Designating an OpenSSL Library........................................................................112

Summary of Security-Related Options...........................................................................112Using DataDirect Connection Pooling......................................................................................113

Creating a Connection Pool...........................................................................................114Adding Connections to a Pool........................................................................................114Removing Connections from a Pool..............................................................................115Handling Dead Connections in a Pool...........................................................................115Connection Pool Statistics.............................................................................................116Summary of Pooling-Related Options............................................................................116

Using DataDirect Bulk Load......................................................................................................117Bulk Export and Load Methods......................................................................................118Exporting Data from a Database....................................................................................119Bulk Loading to a Database...........................................................................................120The Bulk Load Configuration File...................................................................................122

Bulk Load Configuration File Schema.................................................................122Verification of the Bulk Load Configuration File..................................................123

Sample Applications.......................................................................................................124Determining the Bulk Load Protocol..............................................................................124Character Set Conversions............................................................................................124External Overflow Files..................................................................................................125Using Bulk Load for Batch Inserts..................................................................................125Using Bulk Load for Single Inserts/Updates/Deletes (Salesforce Driver)......................125Summary of Bulk Load Related Options........................................................................126

Chapter 4: Configuring the Product on UNIX/Linux........................127Environment Variables..............................................................................................................127

Library Search Path.......................................................................................................128ODBCINI........................................................................................................................128ODBCINST.....................................................................................................................129DD_INSTALLDIR...........................................................................................................129

The Test Loading Tool...............................................................................................................130Data Source Configuration........................................................................................................130

Configuration Through the Administrator.......................................................................131Drivers.................................................................................................................132Tracing................................................................................................................133

Configuration Through the System Information (odbc.ini) File.......................................133Sample Default odbc.ini File...............................................................................134Translators..........................................................................................................147


The demoodbc Application.......................................................................................................148The example Application...........................................................................................................148DSN-less Connections..............................................................................................................148

Sample odbcinst.ini File.................................................................................................149File Data Sources.....................................................................................................................152UTF-16 Applications on UNIX and Linux..................................................................................153

Part II: Drivers for 32-Bit and 64-Bit Platforms........................................155

Chapter 5: The DB2 Wire Protocol Driver.........................................157Driver Requirements.................................................................................................................158Binding......................................................................................................................................158

Creating DB2 Packages Using List Files.......................................................................159Creating DB2 Packages Manually.................................................................................160

Configuring and Connecting to Data Sources..........................................................................160Data Source Configuration in the UNIX/Linux odbc.ini File...........................................161Data Source Configuration through a GUI.....................................................................161Using a Connection String.............................................................................................177Using a Logon Dialog Box.............................................................................................178

Connection Option Descriptions for DB2..................................................................................179Accounting Info..............................................................................................................182Add to Create Table.......................................................................................................183Alternate ID....................................................................................................................183Alternate Servers...........................................................................................................184Application Name...........................................................................................................185Application Using Threads.............................................................................................185Authentication Method...................................................................................................186Batch Size......................................................................................................................187Bulk Binary Threshold....................................................................................................187Bulk Character Threshold..............................................................................................188Catalog Schema.............................................................................................................189Character Set for CCSID 65535....................................................................................189Client Host Name...........................................................................................................190Client User.....................................................................................................................191Collection.......................................................................................................................192Concurrent Access Resolution.......................................................................................192Connection Pooling........................................................................................................193Connection Reset...........................................................................................................194Connection Retry Count.................................................................................................195Connection Retry Delay.................................................................................................195Crypto Protocol Version.................................................................................................196CryptoLibName..............................................................................................................197Current Function Path....................................................................................................198


Data Source Name.........................................................................................................199Database Name.............................................................................................................199Default Isolation Level....................................................................................................200Description.....................................................................................................................201Dynamic Sections..........................................................................................................202Encryption Method.........................................................................................................202Failover Granularity........................................................................................................203Failover Mode................................................................................................................204Failover Preconnect.......................................................................................................204Fetch Time Stamp With Time Zone as Timestamp .......................................................205Field Delimiter................................................................................................................206Grant Execute to [check box].........................................................................................206Grant Execute to [field]...................................................................................................207GSS Client Library.........................................................................................................207Host Name In Certificate................................................................................................208IANAAppCodePage.......................................................................................................209Ip Address......................................................................................................................210Key Password................................................................................................................210Keystore.........................................................................................................................211Keystore Password........................................................................................................212Load Balance Timeout...................................................................................................212Load Balancing..............................................................................................................213Location Name...............................................................................................................214Login Timeout................................................................................................................214Min Long Varchar Size...................................................................................................215Max Pool Size................................................................................................................216Min Pool Size.................................................................................................................216Package Collection........................................................................................................217Package Name Prefix....................................................................................................218Package Owner..............................................................................................................219Password.......................................................................................................................219Program ID.....................................................................................................................220Query Timeout...............................................................................................................221Record Delimiter............................................................................................................222Report Codepage Conversion Errors.............................................................................222SSLLibName..................................................................................................................223TCP Keep Alive..............................................................................................................224Tcp Port..........................................................................................................................225Truststore.......................................................................................................................226Truststore Password......................................................................................................226Use Current Schema for Catalog Functions..................................................................227User Name.....................................................................................................................227Validate Server Certificate..............................................................................................228Varchar Threshold..........................................................................................................229With Hold Cursors..........................................................................................................229


XML Describe Type........................................................................................................230Enable Bulk Load...........................................................................................................231

Performance Considerations....................................................................................................231IBM to IANA Code Page Values...............................................................................................232Data Types................................................................................................................................233

Using the XML Data Type..............................................................................................234Unicode Support.......................................................................................................................234Advanced Features...................................................................................................................234

Failover..........................................................................................................................235Security..........................................................................................................................235

Authentication......................................................................................................235Connection Pooling........................................................................................................236DataDirect Bulk Load.....................................................................................................236

Cursor Stability Isolation Level..................................................................................................236XQuery Expressions.................................................................................................................237Stored Procedure Support........................................................................................................237Unexpected Characters............................................................................................................237Support for DB2 pureScale.......................................................................................................238Persisting a Result Set as an XML Data File............................................................................238Isolation and Lock Levels Supported........................................................................................238SQL Support.............................................................................................................................238ODBC Conformance Level.......................................................................................................239Number of Connections and Statements Supported................................................................239Using Arrays of Parameters......................................................................................................239

Chapter 6: The Informix Wire Protocol Driver..................................241Driver Requirements.................................................................................................................242Configuring and Connecting to Data Sources..........................................................................242

Data Source Configuration in the UNIX/Linux odbc.ini File...........................................242Data Source Configuration through a GUI.....................................................................243Using a Connection String.............................................................................................246Using a Logon Dialog Box.............................................................................................247

Connection Option Descriptions...............................................................................................248Alternate Servers...........................................................................................................249Application Using Threads.............................................................................................249Cancel Detect Interval....................................................................................................250Connection Retry Count.................................................................................................251Connection Retry Delay.................................................................................................251Database Name.............................................................................................................252Data Source Name.........................................................................................................253Description.....................................................................................................................253Host Name.....................................................................................................................254IANAAppCodePage ......................................................................................................254Load Balancing..............................................................................................................255


Password.......................................................................................................................256Port Number...................................................................................................................256Server Name..................................................................................................................257Trim Blank From Index ..................................................................................................257Use Delimited Identifier..................................................................................................258User Name.....................................................................................................................258

Performance Considerations....................................................................................................259Data Types................................................................................................................................259Advanced Features...................................................................................................................261MTS Support.............................................................................................................................261Persisting a Result Set as an XML Data File............................................................................261Isolation and Lock Levels Supported........................................................................................262SQL Support.............................................................................................................................262ODBC Conformance Level.......................................................................................................262Number of Connections and Statements Supported................................................................262

Chapter 7: The MySQL Wire Protocol Driver....................................263Driver Requirements.................................................................................................................264Configuring and Connecting to Data Sources..........................................................................264


Connection Options Descriptions..............................................................................................273Alternate Servers...........................................................................................................275Application Using Threads.............................................................................................276Connection Pooling........................................................................................................276Connection Reset...........................................................................................................277Connection Retry Count.................................................................................................278Connection Retry Delay.................................................................................................278Crypto Protocol Version.................................................................................................279CryptoLibName..............................................................................................................280Data Source name.........................................................................................................281Database Name.............................................................................................................281Default Buffer Size for Long/LOB Columns (in Kb)........................................................282Description.....................................................................................................................283Enable SQLDescribeParam...........................................................................................283Encryption Method.........................................................................................................284Failover Granularity........................................................................................................284Failover Mode................................................................................................................285Failover Preconnect.......................................................................................................286Host Name.....................................................................................................................286Host Name In Certificate................................................................................................287IANAAppCodePage.......................................................................................................288


Interactive Client............................................................................................................289Key Password................................................................................................................289Keystore.........................................................................................................................290Keystore Password........................................................................................................291Load Balance Timeout...................................................................................................291Load Balancing..............................................................................................................292Login Timeout................................................................................................................293Max Pool Size................................................................................................................293Min Pool Size.................................................................................................................294Password.......................................................................................................................295Port Number...................................................................................................................295Query Timeout...............................................................................................................296Report Codepage Conversion Errors.............................................................................297SSLLibName..................................................................................................................297TCP Keep Alive..............................................................................................................298Treat Binary Data as Character Data.............................................................................299Truststore.......................................................................................................................300Truststore Password......................................................................................................301User Name.....................................................................................................................301Validate Server Certificate..............................................................................................302

Performance Considerations....................................................................................................302Data Types................................................................................................................................303Unicode Support.......................................................................................................................305Advanced Features...................................................................................................................305

Failover..........................................................................................................................306Security..........................................................................................................................306Connection Pooling........................................................................................................306

Persisting a Result Set as an XML Data File............................................................................306Isolation and Lock Levels Supported........................................................................................306SQL Support.............................................................................................................................306ODBC Conformance Level.......................................................................................................306Number of Connections and Statements Supported................................................................307

Chapter 8: The Oracle Wire Protocol Driver.....................................309Driver Requirements.................................................................................................................310Configuring and Connecting to Data Sources..........................................................................310


Connection Option Descriptions for Oracle Wire Protocol .......................................................329Accounting Info..............................................................................................................333Action.............................................................................................................................334Alternate Servers...........................................................................................................334


Application Name...........................................................................................................335Application Using Threads.............................................................................................336Array Size.......................................................................................................................336Authentication Method...................................................................................................337Batch Size......................................................................................................................338Bulk Binary Threshold....................................................................................................338Bulk Character Threshold..............................................................................................339Bulk Options...................................................................................................................340Cached Cursor Limit......................................................................................................340Cached Description Limit...............................................................................................341Catalog Functions Include Synonyms............................................................................342Catalog Options.............................................................................................................342Client Host Name...........................................................................................................343Client ID.........................................................................................................................344Client User.....................................................................................................................344Connection Pooling........................................................................................................345Connection Reset...........................................................................................................346Connection Retry Count.................................................................................................347Connection Retry Delay.................................................................................................347Crypto Protocol Version.................................................................................................348CryptoLibName..............................................................................................................349Data Integrity Level........................................................................................................350Data Integrity Types.......................................................................................................351Data Source Name.........................................................................................................351Default Buffer Size for Long/LOB Columns (in Kb)........................................................352Describe at Prepare.......................................................................................................353Description.....................................................................................................................353Edition Name..................................................................................................................354Enable Bulk Load...........................................................................................................354Enable N-CHAR Support...............................................................................................355Enable Scrollable Cursors..............................................................................................356Enable Server Result Cache..........................................................................................356Enable SQLDescribeParam...........................................................................................357Enable Static Cursors for Long Data.............................................................................358Enable Timestamp with Timezone.................................................................................358Encryption Level.............................................................................................................359Encryption Method.........................................................................................................360Encryption Types............................................................................................................361Failover Granularity........................................................................................................362Failover Mode................................................................................................................363Failover Preconnect.......................................................................................................363Fetch TSWTZ as Timestamp.........................................................................................364Field Delimiter................................................................................................................365GSS Client Library.........................................................................................................365Host................................................................................................................................366


Host Name In Certificate................................................................................................367IANAAppCodePage.......................................................................................................367Initialization String..........................................................................................................368Key Password................................................................................................................369Key Store.......................................................................................................................369Key Store Password.......................................................................................................370Load Balance Timeout...................................................................................................371Load Balancing..............................................................................................................371Local Timezone Offset...................................................................................................372Lock Timeout..................................................................................................................373Login Timeout................................................................................................................373Max Pool Size................................................................................................................374Min Pool Size.................................................................................................................375Module...........................................................................................................................376Password.......................................................................................................................376Port Number...................................................................................................................377PRNGSeedFile...............................................................................................................378PRNGSeedSource ........................................................................................................379Procedure Returns Results............................................................................................380Program ID.....................................................................................................................381Query Timeout...............................................................................................................381Record Delimiter............................................................................................................382Report Codepage Conversion Errors.............................................................................383Report Recycle Bin........................................................................................................383Server Name..................................................................................................................384Server Process Type......................................................................................................385Service Name.................................................................................................................385SID.................................................................................................................................386SSLLibName..................................................................................................................387TCP Keep Alive..............................................................................................................388Timestamp Escape Mapping..........................................................................................389TNSNames File..............................................................................................................389Truststore.......................................................................................................................390Truststore Password......................................................................................................391Use Current Schema for SQLProcedures......................................................................392User Name.....................................................................................................................392Validate Server Certificate..............................................................................................393Wire Protocol Mode........................................................................................................393

Performance Considerations....................................................................................................394Data Types................................................................................................................................397

XMLType........................................................................................................................399Examples.......................................................................................................................399

Unicode Support.......................................................................................................................400Advanced Features...................................................................................................................400

Failover..........................................................................................................................401


Client Information...........................................................................................................401Security..........................................................................................................................401

Authentication......................................................................................................401Encryption and Data Integrity..............................................................................402

Connection Pooling........................................................................................................402DataDirect Bulk Load.....................................................................................................402

Limitations...........................................................................................................403MTS Support.............................................................................................................................403OS Authentication.....................................................................................................................403Support for Oracle RAC............................................................................................................403Support of Materialized Views..................................................................................................404Stored Procedure Results.........................................................................................................404Unexpected Characters............................................................................................................404Persisting a Result Set as an XML Data File............................................................................405Isolation and Lock Levels Supported........................................................................................406SQL Support.............................................................................................................................406ODBC Conformance Level.......................................................................................................406Number of Connections and Statements Supported................................................................406Using Parameter Arrays............................................................................................................407

Chapter 9: The PostgreSQL Wire Protocol Driver ..........................409Driver Requirements.................................................................................................................410Configuring and Connecting to Data Sources..........................................................................410


Connection Option Descriptions for PostgreSQL Wire Protocol...............................................419Alternate Servers...........................................................................................................422Application Using Threads.............................................................................................423Authentication Method...................................................................................................423Connection Pooling........................................................................................................424Connection Reset...........................................................................................................425Connection Retry Count.................................................................................................425Connection Retry Delay.................................................................................................426Crypto Protocol Version.................................................................................................427CryptoLibName..............................................................................................................428Data Source Name.........................................................................................................429Database Name.............................................................................................................429Description.....................................................................................................................430Enable Keyset Cursors..................................................................................................430Enable SQLDescribeParam...........................................................................................431Encryption Method.........................................................................................................431Extended Column MetaData..........................................................................................432


Failover Granularity........................................................................................................433Failover Mode................................................................................................................434Failover Preconnect.......................................................................................................435Fetch Ref Cursors..........................................................................................................435Fetch TSWTZ as Timestamp.........................................................................................436Fetch TWFS as Time.....................................................................................................437GSS Client Library.........................................................................................................437Host Name.....................................................................................................................438Host Name In Certificate................................................................................................439IANAAppCodePage.......................................................................................................440Initialization String..........................................................................................................440Key Password................................................................................................................441Key Store.......................................................................................................................442Key Store Password.......................................................................................................442Keyset Cursor Options...................................................................................................443Load Balance Timeout...................................................................................................444Load Balancing..............................................................................................................444Login Timeout................................................................................................................445Max Char Size................................................................................................................446Max Long Varchar Size..................................................................................................446Max Pool Size................................................................................................................447Max Varchar Size...........................................................................................................447Min Pool Size.................................................................................................................448Password.......................................................................................................................449Port Number...................................................................................................................449Query Timeout...............................................................................................................450Report Codepage Conversion Errors.............................................................................450Service Principal Name..................................................................................................451SSLLibName..................................................................................................................452TCP Keep Alive..............................................................................................................453Transaction Error Behavior............................................................................................453Trust Store......................................................................................................................454Trust Store Password.....................................................................................................455Unbounded Numeric Precision .....................................................................................455Unbounded Numeric Scale............................................................................................456User Name.....................................................................................................................457Validate Server Certificate..............................................................................................457XML Describe Type........................................................................................................458

Performance Considerations....................................................................................................458Data Types................................................................................................................................459

Using the XML Data Type..............................................................................................461Unicode Support.......................................................................................................................461Advanced Features...................................................................................................................461



Connection Pooling........................................................................................................461Stored Procedure Results.........................................................................................................462Persisting a Result Set as an XML Data File............................................................................463Isolation and Lock Levels Supported........................................................................................463SQL Support.............................................................................................................................463ODBC Conformance Level.......................................................................................................463Number of Connections and Statements Supported................................................................464Using Arrays of Parameters......................................................................................................464

Chapter 10: The Progress OpenEdge Wire Protocol Driver...........465Driver Requirements.................................................................................................................466Configuring and Connecting to Data Sources..........................................................................466

Data Source Configuration in the UNIX odbc.ini File.....................................................466Data Source Configuration through a GUI.....................................................................466Using a Connection String.............................................................................................472Using a Logon Dialog Box.............................................................................................472

Connection Option Descriptions for OpenEdge Wire Protocol.................................................473Alternate Servers...........................................................................................................475Connection Retry Count.................................................................................................475Connection Retry Delay.................................................................................................476Crypto Protocol Version.................................................................................................477CryptoLibName..............................................................................................................477Data Source Name.........................................................................................................479Database Name.............................................................................................................479Default Isolation Level....................................................................................................480Description.....................................................................................................................480Enable Timestamp with Timezone.................................................................................481Encryption Method.........................................................................................................481Failover Granularity........................................................................................................482Failover Mode................................................................................................................483Failover Preconnect.......................................................................................................484Fetch Array Size.............................................................................................................484Host Name.....................................................................................................................485HostName In Certificate.................................................................................................486IANAAppCodePage.......................................................................................................486Load Balancing..............................................................................................................487Login Timeout................................................................................................................488Password.......................................................................................................................489Port Number...................................................................................................................489Query Timeout...............................................................................................................490SSLLibName..................................................................................................................490TCP Keep Alive..............................................................................................................492Truststore.......................................................................................................................492Truststore Password......................................................................................................493


Use Wide Character Types............................................................................................493User ID...........................................................................................................................494Validate Server Certificate..............................................................................................494

Performance Considerations....................................................................................................495Data Types................................................................................................................................496Unicode Support.......................................................................................................................497Advanced Features...................................................................................................................497


Isolation and Lock Levels Supported........................................................................................498SQL Grammar Support.............................................................................................................498ODBC Conformance Level.......................................................................................................498Number of Connections and Statements Supported................................................................498

Chapter 11: The SQL Server Wire Protocol Driver...........................499Driver Requirements.................................................................................................................500Configuring and Connecting to Data Sources..........................................................................500


Connection Option Descriptions for SQL Server Wire Protocol................................................514Alternate Servers...........................................................................................................517Always Report Trigger Results.......................................................................................518AnsiNPW........................................................................................................................519Application Name...........................................................................................................519Application Using Threads.............................................................................................520Authentication Method...................................................................................................520Batch Size .....................................................................................................................521Bulk Binary Threshold....................................................................................................522Bulk Character Threshold..............................................................................................522Bulk Load Threshold......................................................................................................523Bulk Options...................................................................................................................524Connection Pooling........................................................................................................525Connection Reset...........................................................................................................526Connection Retry Count.................................................................................................526Connection Retry Delay.................................................................................................527Crypto Protocol Version.................................................................................................528CryptoLibName..............................................................................................................529Data Source Name.........................................................................................................530Database........................................................................................................................530Description.....................................................................................................................531Domain...........................................................................................................................531Enable Bulk Load...........................................................................................................532


Enable Quoted Identifiers...............................................................................................533Encryption Method.........................................................................................................533Failover Granularity........................................................................................................534Failover Mode................................................................................................................535Failover Preconnect.......................................................................................................536Fetch TSWTZ as Timestamp.........................................................................................536Fetch TWFS as Time.....................................................................................................537Field Delimiter................................................................................................................538GSS Client Library.........................................................................................................538Host Name.....................................................................................................................539Host Name In Certificate................................................................................................540IANAAppCodePage.......................................................................................................541Initialization String..........................................................................................................542Language.......................................................................................................................542Load Balance Timeout...................................................................................................543Load Balancing..............................................................................................................544Login Timeout................................................................................................................544Max Pool Size................................................................................................................545Min Pool Size.................................................................................................................546Packet Size....................................................................................................................546Password.......................................................................................................................547Port Number...................................................................................................................548PRNGSeedFile...............................................................................................................548PRNGSeedSource ........................................................................................................550Query Timeout...............................................................................................................551Record Delimiter............................................................................................................551Report Codepage Conversion Errors.............................................................................552SSLLibName..................................................................................................................553TCP Keep Alive..............................................................................................................554Trust Store......................................................................................................................554Trust Store Password.....................................................................................................555Use Snapshot Transactions...........................................................................................556User Name.....................................................................................................................557Validate Server Certificate..............................................................................................557Workstation ID................................................................................................................558XML Describe Type........................................................................................................558

Performance Considerations....................................................................................................559Data Types................................................................................................................................560Unicode Support.......................................................................................................................562

Using the XML Data Type..............................................................................................562Advanced Features...................................................................................................................562


Authentication......................................................................................................563Connection Pooling........................................................................................................564


DataDirect Bulk Load.....................................................................................................564Persisting a Result Set as an XML Data File............................................................................564Isolation and Lock Levels Supported........................................................................................565

Using The Snapshot Isolation Level..............................................................................565SQL Support.............................................................................................................................565ODBC Conformance Level.......................................................................................................565Number of Connections and Statements Supported................................................................566Using Arrays of Parameters......................................................................................................566

Chapter 12: The Sybase Wire Protocol Driver.................................567Driver Requirements.................................................................................................................568Configuring and Connecting to Data Sources..........................................................................568


Connection Option Descriptions for Sybase Wire Protocol......................................................584Alternate Servers...........................................................................................................587Application Name...........................................................................................................588Application Using Threads.............................................................................................589Authentication Method...................................................................................................589Batch Size......................................................................................................................590Bulk Binary Threshold....................................................................................................591Bulk Character Threshold..............................................................................................591Charset...........................................................................................................................592Connection Cache Size..................................................................................................593Connection Pooling........................................................................................................593Connection Reset...........................................................................................................594Connection Retry Count.................................................................................................595Connection Retry Delay.................................................................................................595Crypto Protocol Version.................................................................................................596CryptoLibName..............................................................................................................597Cursor Positioning for Raiserror.....................................................................................598Data Source Name.........................................................................................................599Database List.................................................................................................................599Database Name.............................................................................................................600Description.....................................................................................................................600Default Buffer Size for Long/LOB Columns (in Kb)........................................................601Distributed Transaction Model.......................................................................................601Enable Bulk Load...........................................................................................................602Enable Describe Parameter...........................................................................................603Enable Quoted Identifiers...............................................................................................603Encryption Method.........................................................................................................604Failover Granularity........................................................................................................604


Failover Mode................................................................................................................605Failover Preconnect.......................................................................................................606Fetch Array Size.............................................

datadirect connect® series for odbc user's guide ·...

Documents