Progress DataDirect for JDBC for Oracle User©s Guide Release 6.0.0 Copyright © 2020 Progress Software Corporation and/or its subsidiaries or affiliates. All rights reserved. These materials and all Progress® software products are copyrighted and all rights are reserved by Progress Software Corporation. The information in these materials is subject to change without notice, and Progress Software Corporation assumes no responsibility for any errors that may appear therein. The references in these materials to specific platforms supported are subject to change. Corticon, DataDirect (and design), DataDirect Cloud, DataDirect Connect, DataDirect Connect64, DataDirect XML Converters, DataDirect XQuery, DataRPM, Defrag This, Deliver More Than Expected, Icenium, Ipswitch, iMacros, Kendo UI, Kinvey, MessageWay, MOVEit, NativeChat, NativeScript, OpenEdge, Powered by Progress, Progress, Progress Software Developers Network, SequeLink, Sitefinity (and Design), Sitefinity, SpeedScript, Stylus Studio, TeamPulse, Telerik, Telerik (and Design), Test Studio, WebSpeed, WhatsConfigured, WhatsConnected, WhatsUp, and WS_FTP are registered trademarks of Progress Software Corporation or one of its affiliates or subsidiaries in the U.S. and/or other countries. Analytics360, AppServer, BusinessEdge, DataDirect Autonomous REST Connector, DataDirect Spy, SupportLink, DevCraft, Fiddler, iMail, JustAssembly, JustDecompile, JustMock, NativeScript Sidekick, OpenAccess, ProDataSet, Progress Results, Progress Software, ProVision, PSE Pro, SmartBrowser, SmartComponent, SmartDataBrowser, SmartDataObjects, SmartDataView, SmartDialog, SmartFolder, SmartFrame, SmartObjects, SmartPanel, SmartQuery, SmartViewer, SmartWindow, and WebClient are trademarks or service marks of Progress Software Corporation and/or its subsidiaries or affiliates in the U.S. and other countries. Java is a registered trademark of Oracle and/or its affiliates. Any other marks contained herein may be trademarks of their respective owners. Updated: 2020/03/05 Progress DataDirect for JDBC for Oracle: User©s Guide: Version 6.0.0 3 Copyright 4 Progress DataDirect for JDBC for Oracle: User©s Guide: Version 6.0.0 Contents Table of Contents Welcome to the Progress DataDirect for JDBC for Oracle Driver...........13 What©s new in this release?..................................................................................................................14 Quick start............................................................................................................................................15 Requirements.......................................................................................................................................16 Data source and driver classes............................................................................................................16 Connection URL...................................................................................................................................16 Version string information.....................................................................................................................17 Connection properties..........................................................................................................................18 Data types............................................................................................................................................18 Using extended data types........................................................................................................19 Using date/time data types........................................................................................................20 Using collection data types........................................................................................................22 getTypeInfo................................................................................................................................24 Contacting Technical Support...............................................................................................................31 Using the driver............................................................................................33 Connecting from an application............................................................................................................34 Data source and driver classes.................................................................................................34 Setting the classpath ................................................................................................................35 Connecting using the DriverManager........................................................................................35 Connecting using data sources.................................................................................................39 Using tnsnames.ora files......................................................................................................................43 Connecting to the database.......................................................................................................44 Configuring the tnsnames.ora file..............................................................................................45 Connecting to Oracle instances running in restricted mode......................................................49 Oracle Connection Manager ................................................................................................................49 Using LDAP..........................................................................................................................................50 Using connection properties.................................................................................................................51 Required properties...................................................................................................................51 Authentication properties...........................................................................................................52 Data encryption properties........................................................................................................54 Failover properties.....................................................................................................................56 Bulk load properties...................................................................................................................58 Data type handling properties....................................................................................................59 Timeout properties.....................................................................................................................61 Statement pooling properties.....................................................................................................62 Client information properties......................................................................................................63 Additional properties..................................................................................................................64 Progress DataDirect for JDBC for Oracle: User©s Guide: Version 6.0.0 5 Contents Performance considerations.................................................................................................................70 Support for Oracle RAC........................................................................................................................72 Authentication.......................................................................................................................................73 Using the AuthenticationMethod property..................................................................................74 Configuring user ID/password authentication............................................................................75 Configuring Kerberos authentication..........................................................................................75 Configuring NTLM authentication..............................................................................................80 Configuring client authentication................................................................................................81 Oracle Wallet SSL authentication..............................................................................................82 Oracle Internet Directory (OID)..................................................................................................83 Reauthentication...................................................................................................................................83 Data encryption....................................................................................................................................83 Configuring SSL Encryption......................................................................................................84 SSL client authentication...........................................................................................................84 SSL server authentication..........................................................................................................85 Implementing Oracle Advanced Security...................................................................................86 Configuring random number generator secure seeding............................................................87 Using Oracle Wallet