The Progress Datadirect for ODBC for SQL Server Wire Protocol User's Guide and Reference
Total Page:16
File Type:pdf, Size:1020Kb
The Progress DataDirect® for ODBC for SQL Server™ Wire Protocol User©s Guide and Reference Release 8.0.2 Copyright © 2020 Progress Software Corporation and/or one of 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/01/22 The Progress DataDirect® for ODBC for SQL Server Wire Protocol: User©s Guide and Reference: Version 8.0.2 3 Copyright 4 The Progress DataDirect® for ODBC for SQL Server Wire Protocol: User©s Guide and Reference: Version 8.0.2 Contents Table of Contents Welcome to the Progress DataDirect for ODBC for SQL Server Wire Protocol: Version 8.0.2.............................................................................11 What©s New in this Release?................................................................................................................12 Driver Requirements.............................................................................................................................14 ODBC Compliance...............................................................................................................................14 Version String Information....................................................................................................................14 getFileVersionString Function....................................................................................................16 Support for Multiple Environments.......................................................................................................16 Support for Windows Environments...........................................................................................16 Support for UNIX and Linux Environments................................................................................18 Data Types............................................................................................................................................23 Unicode Support........................................................................................................................24 Retrieving Data Type Information...............................................................................................25 Contacting Technical Support...............................................................................................................26 Getting Started ............................................................................................29 Configuring and Connecting on Windows.............................................................................................30 Configuring a Data Source........................................................................................................30 Testing the Connection..............................................................................................................30 Configuring and Connecting on UNIX and Linux..................................................................................31 Environment Configuration........................................................................................................31 Test Loading the Driver..............................................................................................................32 Configuring a Data Source in the System Information File........................................................32 Testing the connection...............................................................................................................33 Accessing Data With Third-Party Applications......................................................................................33 Using the Driver...........................................................................................35 Configuring and Connecting to Data Sources......................................................................................36 Configuring the Product on UNIX/Linux.....................................................................................36 Data Source Configuration through a GUI.................................................................................45 Using a Connection String.........................................................................................................72 Using a Logon Dialog Box.........................................................................................................72 Performance Considerations.....................................................................................................74 Using Failover.......................................................................................................................................75 Connection Failover...................................................................................................................76 Extended Connection Failover...................................................................................................77 Select Connection Failover........................................................................................................79 The Progress DataDirect® for ODBC for SQL Server Wire Protocol: User©s Guide and Reference: Version 8.0.2 5 Contents Guidelines for Primary and Alternate Servers...........................................................................80 Using Client Load Balancing .....................................................................................................80 Using Connection Retry.............................................................................................................81 Configuring Failover-Related Options........................................................................................81 Using Security......................................................................................................................................85 Authentication............................................................................................................................85 Data Encryption Across the Network.........................................................................................89 SSL Encryption..........................................................................................................................90 Always Encrypted......................................................................................................................95 Using DataDirect Connection Pooling..................................................................................................99 Creating a Connection Pool.....................................................................................................100 Adding Connections to a Pool..................................................................................................100 Removing Connections from a Pool........................................................................................100 Handling Dead Connections in a Pool.....................................................................................101 Connection Pool Statistics.......................................................................................................102 Summary of Pooling-Related Options.....................................................................................102 Using DataDirect Bulk Load...............................................................................................................103 Bulk Export and Load Methods...............................................................................................104 Exporting Data from a Database.............................................................................................105 Bulk Loading to a Database.....................................................................................................106