Progress DataDirect for ODBC for Apache Cassandra User©s Guide and Reference Release 8.0.0 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/10/08 The Progress DataDirect for ODBC for Apache Cassandra™ Driver: User©s Guide and Reference: Version 8.0.0 3 Copyright 4 The Progress DataDirect for ODBC for Apache Cassandra™ Driver: User©s Guide and Reference: Version 8.0.0 Contents Table of Contents Preface..........................................................................................................11 Welcome to the Progress DataDirect for ODBC for Apache Cassandra™ Driver..................................11 What©s New in This Release? ..............................................................................................................12 Conventions Used in This Guide..........................................................................................................13 About the Product Documentation........................................................................................................15 Contacting Technical Support...............................................................................................................16 Getting Started.............................................................................................17 Configuring and Connecting on Windows.............................................................................................18 Setting the Library Path Environment Variable (Windows)........................................................18 Configuring a Data Source........................................................................................................18 Testing the Connection..............................................................................................................19 Configuring and Connecting on UNIX and Linux..................................................................................20 Environment Configuration........................................................................................................20 Test Loading the Driver..............................................................................................................20 Setting the Library Path Environment Variable (UNIX and Linux)..............................................21 Configuring a Data Source in the System Information File........................................................21 Testing the Connection..............................................................................................................22 Accessing Data With Third-Party Applications......................................................................................22 What Is ODBC?............................................................................................23 How Does It Work?...............................................................................................................................24 Why Do Application Developers Need ODBC?....................................................................................24 About the Apache Cassandra Driver.........................................................25 Driver Requirements.............................................................................................................................26 Support for Multiple Environments.......................................................................................................26 Support for Windows Environments...........................................................................................26 Support for UNIX and Linux Environments................................................................................28 ODBC Compliance...............................................................................................................................33 Version String Information....................................................................................................................34 getFileVersionString Function....................................................................................................35 Data Types............................................................................................................................................35 Retrieving Data Type Information...............................................................................................37 Complex Type Normalization................................................................................................................38 Collection Types.........................................................................................................................38 Tuple and User-Defined Types...................................................................................................42 The Progress DataDirect for ODBC for Apache Cassandra™ Driver: User©s Guide and Reference: Version 8.0.0 5 Contents Nested Complex Types..............................................................................................................44 Isolation and Lock Levels Supported....................................................................................................46 Binding Parameter Markers..................................................................................................................46 Supported Features.....................................................................................47 Unicode Support...................................................................................................................................47 Using IP Addresses..............................................................................................................................48 Parameter Metadata Support...............................................................................................................48 Insert and Update Statements...................................................................................................48 Select Statements......................................................................................................................49 SQL Support.........................................................................................................................................50 Number of Connections and Statements Supported............................................................................50 Using the Driver...........................................................................................51 Configuring and Connecting to Data Sources......................................................................................51 Configuring the Product on UNIX/Linux.....................................................................................52 Data Source Configuration Using a GUI....................................................................................61 Using a Connection String.........................................................................................................74 Using a Logon Dialog Box.........................................................................................................75 Performance Considerations................................................................................................................76 Using the SQL Engine Server..............................................................................................................77 Configuring the SQL Engine Server on Windows......................................................................77 Configuring the SQL Engine Server on UNIX/Linux..................................................................80