Progress DataDirect for JDBC for SQL Server 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/01/22 Progress DataDirect for JDBC for SQL Server: User©s Guide: Version 6.0.0 3 Copyright 4 Progress DataDirect for JDBC for SQL Server: User©s Guide: Version 6.0.0 Contents Table of Contents Welcome to the Progress DataDirect for JDBC for SQL Server: Version 6.0.0...........................................................................................................13 What©s new in this release?..................................................................................................................14 Data source and driver classes............................................................................................................15 Connection URL...................................................................................................................................15 Requirements.......................................................................................................................................16 Version string information.....................................................................................................................16 Connection properties..........................................................................................................................17 Data types............................................................................................................................................17 getTypeInfo................................................................................................................................19 Contacting Technical Support...............................................................................................................32 Getting started.............................................................................................35 Data source and driver classes............................................................................................................35 Setting the Classpath ..........................................................................................................................36 Connecting using the DriverManager...................................................................................................36 Passing the connection URL......................................................................................................36 Testing the connection...............................................................................................................37 Connecting using data sources............................................................................................................40 How data sources are implemented..........................................................................................40 Creating data sources................................................................................................................41 Calling a data source in an application......................................................................................42 Testing a data source connection..............................................................................................42 Using the driver............................................................................................47 Required permissions for Java SE with the standard Security Manager enabled................................48 Permissions for establishing connections..................................................................................49 Granting access to Java properties...........................................................................................49 Granting access to temporary files............................................................................................49 Permissions for bulk load from a CSV file..................................................................................50 Connecting from an application............................................................................................................50 Data source and driver classes.................................................................................................50 Setting the Classpath ................................................................................................................50 Connecting using the DriverManager........................................................................................51 Connecting using data sources.................................................................................................54 Using connection properties.................................................................................................................59 Required properties...................................................................................................................59 Progress DataDirect for JDBC for SQL Server: User©s Guide: Version 6.0.0 5 Contents Authentication properties...........................................................................................................59 Data encryption properties........................................................................................................60 Failover properties.....................................................................................................................61 Bulk load properties...................................................................................................................63 Data type handling properties....................................................................................................64 Timeout properties.....................................................................................................................66 Statement pooling properties.....................................................................................................67 Client information properties......................................................................................................68 Always Encrypted properties.....................................................................................................69 Additional properties..................................................................................................................71 Performance considerations.................................................................................................................75 Connecting to named instances...........................................................................................................77 Azure Synapse Analytics and Analytics Platform System....................................................................77 Authentication.......................................................................................................................................79 Configuring user ID/password authentication............................................................................79 Configuring Azure Active Directory authentication....................................................................80 Configuring the driver for Kerberos authentication....................................................................81 Configuring NTLM authentication..............................................................................................86 Data encryption....................................................................................................................................87 Using SSL with Microsoft SQL Server.......................................................................................87