Progress® DataDirect® for JDBC™ for Apache Cassandra™ User's Guide 6.0.0 Release Copyright © 2018 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, Deliver More Than Expected, Icenium, Kendo UI, NativeScript, OpenEdge, Powered by Progress, Progress, Progress Software Developers Network, Rollbase, SequeLink, Sitefinity (and Design), SpeedScript, Stylus Studio, TeamPulse, Telerik, Telerik (and Design), Test Studio, and WebSpeed 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 Spy, SupportLink, DevCraft, Fiddler, JustAssembly, JustDecompile, JustMock, Kinvey, NativeScript Sidekick, OpenAccess, ProDataSet, Progress Results, Progress Software, ProVision, PSE Pro, Sitefinity, 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. Please refer to the readme applicable to the particular Progress product release for any third-party acknowledgements required to be provided in the documentation associated with the Progress product. Updated: 2018/03/28 Progress® DataDirect® for JDBC™ for Apache Cassandra™: User's Guide: Version 6.0.0 3 Copyright 4 Progress® DataDirect® for JDBC™ for Apache Cassandra™: User's Guide: Version 6.0.0 Contents Table of Contents Chapter 1: Welcome to the Progress DataDirect for JDBC for Apache Cassandra Driver......................................................................................11 What's New in this Release?................................................................................................................12 Requirements........................................................................................................................................13 Driver and Data Source Classes...........................................................................................................13 Version String Information.....................................................................................................................14 Connection Properties..........................................................................................................................14 Complex Type Normalization................................................................................................................15 Collection Types.........................................................................................................................15 Tuple and User-Defined Types...................................................................................................18 Nested Complex Types..............................................................................................................21 Data Types............................................................................................................................................22 getTypeInfo()..............................................................................................................................24 Contacting Technical Support...............................................................................................................32 Chapter 2: Getting started...........................................................................35 Driver and Data Source Classes...........................................................................................................35 Connecting Using the DriverManager...................................................................................................36 Setting the Classpath ................................................................................................................36 Passing the Connection URL.....................................................................................................37 Testing the Connection...............................................................................................................37 Connecting Using Data Sources...........................................................................................................40 How Data Sources Are Implemented.........................................................................................41 Creating Data Sources...............................................................................................................41 Calling a Data Source in an Application.....................................................................................41 Chapter 3: Using the Driver.........................................................................43 Connecting from an Application............................................................................................................44 Driver and Data Source Classes................................................................................................44 Connecting Using the DriverManager........................................................................................44 Connecting Using Data Sources................................................................................................48 Using Connection Properties................................................................................................................50 Required Properties...................................................................................................................50 Mapping Properties....................................................................................................................51 Authentication Properties...........................................................................................................51 Data Encryption Properties........................................................................................................52 Statement Pooling Properties....................................................................................................53 Progress® DataDirect® for JDBC™ for Apache Cassandra™: User's Guide: Version 6.0.0 5 Contents Additional Properties..................................................................................................................54 Performance Considerations................................................................................................................55 Authentication.......................................................................................................................................56 Configuring User ID/Password Authentication...........................................................................56 Configuring the Driver for Kerberos Authentication....................................................................57 Data Encryption....................................................................................................................................64 Configuring SSL Encryption.......................................................................................................64 Configuring SSL Server Authentication......................................................................................65 Configuring SSL Client Authentication.......................................................................................66 Identifiers...............................................................................................................................................67 IP Addresses.........................................................................................................................................67 Parameter Metadata Support................................................................................................................68 Insert and Update Statements...................................................................................................68 Select Statements......................................................................................................................68 Isolation Levels.....................................................................................................................................69 Unicode.................................................................................................................................................69 Error Handling.......................................................................................................................................69 Large Object (LOB) Support.................................................................................................................70 Rowset Support....................................................................................................................................70