Progress® DataDirect® for ODBC for Oracle™ Wire Protocol Driver 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/07/27 Progress DataDirect for ODBC for Oracle Wire Protocol Driver: User©s Guide and Reference: Version 8.0.2 3 Copyright 4 Progress DataDirect for ODBC for Oracle Wire Protocol Driver: User©s Guide and Reference: Version 8.0.2 Contents Table of Contents Preface..........................................................................................................13 Welcome to the Progress DataDirect for ODBC Oracle Wire Protocol Driver: Version 8.0.2................13 What©s New in this Release?................................................................................................................14 Conventions Used in This Guide..........................................................................................................18 About the Product Documentation........................................................................................................19 Contacting Technical Support...............................................................................................................20 Getting Started.............................................................................................23 Configuring and Connecting on Windows.............................................................................................24 Configuring a Data Source........................................................................................................24 Testing the Connection..............................................................................................................25 Configuring and Connecting on UNIX and Linux .................................................................................25 Environment Configuration........................................................................................................25 Test Loading the Driver..............................................................................................................26 Configuring a Data Source in the System Information File........................................................26 Testing the Connection..............................................................................................................27 Configuring and Connecting on macOS...............................................................................................28 iODBC Driver Manager .............................................................................................................28 Configuring a Data Source .......................................................................................................28 Testing the Connection .............................................................................................................29 Accessing Data With Third-Party Applications......................................................................................30 What Is ODBC?............................................................................................31 How Does It Work?...............................................................................................................................32 Why Do Application Developers Need ODBC?....................................................................................32 About the Oracle Wire Protocol Driver.......................................................33 Driver Requirements.............................................................................................................................34 ODBC Compliance...............................................................................................................................34 Support for Multiple Environments.......................................................................................................35 Support for Windows Environments...........................................................................................35 Support for UNIX and Linux Environments................................................................................37 Support for macOS Environments.............................................................................................42 Version String Information....................................................................................................................43 getFileVersionString Function....................................................................................................45 Data Types............................................................................................................................................45 XMLType....................................................................................................................................46 Progress DataDirect for ODBC for Oracle Wire Protocol Driver: User©s Guide and Reference: Version 8.0.2 5 Contents Retrieving Data Type Information...............................................................................................48 Isolation and Lock Levels Supported....................................................................................................49 Using Parameter Arrays........................................................................................................................49 Supported Features.....................................................................................51 Unicode Support...................................................................................................................................51 Using IP Addresses..............................................................................................................................52 Number of Connections and Statements Supported............................................................................52 Support for Oracle RAC........................................................................................................................52 SQL Support.........................................................................................................................................53 MTS Support........................................................................................................................................53 OS Authentication.................................................................................................................................53 Stored Procedure Results....................................................................................................................53 Support of Materialized Views..............................................................................................................54 Using the Driver...........................................................................................55 Configuring and Connecting to Data Sources......................................................................................56 Configuring the Product on UNIX/Linux.....................................................................................56 Configuring the Product on macOS...........................................................................................65 Data Source Configuration on Windows....................................................................................75 Using a Connection String.......................................................................................................113 Using a Logon Dialog Box.......................................................................................................113 Performance