SAP S4HANA JDBC 6.0.1
- Last Updated: May 8, 2026
- 8 minute read
- OpenAccess SDK
- Documentation
README
Progress(R) DataDirect(R)
Progress(R) DataDirect(R) for JDBC(TM) for SAP S/4HANA(TM) Driver
Release 6.0.1
February 2026
***********************************************************************
Copyright (C) 2026 Progress Software Corporation and/or its
subsidiaries or affiliates. All Rights Reserved.
***********************************************************************
CONTENTS
Post-GA Product Announcements
Requirements
Installation Directory
Data Source and Platform Support
Changes since 6.0.1 GA
Changes for 6.0.1 GA
Release 6.0.0 Features
Progress DataDirect Configuration Manager
Notes, Known Problems, and Restrictions
Documentation
Installed Files
Post-GA Product Announcements
The readme files will no longer be updated with product announcements and new
features after the General Availability (GA) of the product. For the latest
updates and enhancements, please refer to the release notes
(https://www.progress.com/datadirect-connectors/whats-new).
Requirements
* A supported Java Virtual Machine (JVM) must be defined on your system path.
* The installer program requires a JVM that is Java SE 11 or higher, including
Oracle JDK, OpenJDK, and IBM SDK (Java) distributions.
* The driver requires a JVM that is Java SE 8 or higher, including Oracle JDK,
OpenJDK, and IBM SDK (Java) distributions.
Installation Directory
The default installation directory for the driver is:
* Windows:
C:\Program Files\Progress\DataDirect\JDBC
* UNIX/Linux:
/opt/Progress/DataDirect/JDBC
Note: For UNIX/Linux, if you do not have access to "/opt", your user's home
directory will take the place of this directory.
Data Source and Platform Support
For the latest data source and platform support information, refer to the
Product Compatibility Guide:
https://docs.progress.com/bundle/datadirect-product-compatibility/resource/
datadirect-product-compatibility.pdf
Changes since 6.0.1 GA
CVE-2022-41853 - Use of Externally-Controlled Input to Select Classes or Code
('Unsafe Reflection')
-----------------------------------------------------------------------------
Several Progress DataDirect JDBC drivers utilized a version of HyperSQL
Database that was vulnerable to remote code execution described in
CVE-2022-41853. All impacted drivers have been patched to fix this
vulnerability. For details on impacted drivers and fixed versions, refer to
the following KB article:
https://community.progress.com/s/article/DataDirect-JDBC-Critical-Security-
Bulletin-November-2022-CVE-2022-41853
Enhancements
------------
* The driver has been enhanced to comply with FIPS standards for data
encryption. As part of this enhancement, the driver was tested with
FIPS 140-3 enabled using a Red Hat OpenJDK 21 on a Red Hat Universal Base
Image 9 instance.
Changed Behavior
----------------
* The connection property SpyAttributes has been updated to exclude the
attribute load=classname, which was previously used to load the driver
specified by the given class name. See SpyAttributes for details.
* The installer program now requires you to install a JRE that is Java SE 11 or
higher before running the installer. In earlier versions, the JRE used by the
installer program was included in the product. However, to avoid potential
security vulnerabilities, the installer program no longer includes a JRE.
Instead, the installer program uses the JRE in your environment to allow for
the most secure version of a JRE to be used.
Note: This change does not affect the JVM requirements for the driver. For the latest
driver requirements, refer to the Product Compatibility Guide:
https://docs.progress.com/bundle/datadirect-product-compatibility/resource/
datadirect-product-compatibility.pdf
Changes for 6.0.1 GA
Enhancements
------------
* The driver has been enhanced to support BW/4HANA and other SAP ODATA V2
services exposed through the SAP Gateway.
* The driver has been enhanced to support CDS views that require parameters.
* The driver has been enhanced to support HTTP Header authentication for use
with the S/4HANA sandbox hosted at https://api.sap.com.
* The driver supports the setting of a maximum size of VARCHAR columns within
the result set metadata with the MaxVarcharSize connection property.
* The driver has been enhanced to support a default value of 100000 and a
maximum value of 1000000 for the connection property WSFetchSize.
* The driver has been enhanced to use proxy server settings defined in the JVM
system properties by default. If no proxy settings are defined in the
connection string or data source, the driver will attempt to use the values
of the http.proxyHost and http.proxyPort JVM system properties to connect to
the database.
Changed Behavior
----------------
* The HostName connection property has been renamed ServerName. To support
existing configurations, HostName will continue to be supported as an alias
for ServerName.
Release 6.0.0 Features
The Progress DataDirect for JDBC for SAP S/4HANA driver supports SQL read-write
access for JDBC applications to S/4HANA. To support SQL access, the driver
creates a relational map of the S/4HANA data model and translates SQL statements
to S/4HANA OData requests. In addition, the driver employs a SQL engine
component that provides support to SQL constructs unavailable in S/4HANA. This
functionality offers a number of advantages, including support for reporting
data and metadata in a form that JDBC applications are ready to use.
* Supports SQL read-write access to S/4HANA.
* Supports all JDBC Core functions.
* Supports the core SQL-92 grammar.
* Supports S/4HANA data types through data type inference.
* Supports Basic authentication.
* Supports SSL data encryption.
* Supports connection to custom business objects and views via custom
services, including custom fields.
* Supports the handling of large result sets with paging and the FetchSize and
WSFetchSize connection properties.
* Includes Interactive SQL for JDBC (JDBCISQL). It is a command-line interface
that supports connecting your driver to a data source, executing SQL
statements, and retrieving results in a terminal. This tool provides a
method to quickly test your drivers in an environment that does not support
GUIs.
* Includes the Progress DataDirect Configuration Manager for quick
configuration and testing of your driver. This tool allows you to:
- Generate and edit connection URLs
- Test connect connection URLs
- Execute SQL commands for testing
- Access connection property descriptions and the full product
documentation
Progress DataDirect Configuration Manager
The driver includes a browser-based configuration tool, the Progress
DataDirect Configuration Manager, that allows you to generate and test
connection URLs that you can use with your application. You can launch
the Configuration Manager by double-clicking on the driver jar file or, from
a command line, you can navigate to the directory containing the driver jar
file; then, execute the following command:
java -jar s4hana.jar
The Configuration Manager will open in your default web browser.
For more information, refer to the user's guide for your driver.
Notes, Known Problems, and Restrictions
The following are notes, known problems, and restrictions with the driver.
Using the driver with IBM SDK Java Edition 8
---------------------------------------------
When using the driver with IBM SDK Java Edition 8, you may
encounter one of the following errors:
* "fatal alert:protocol_version"
* "Error fetching OData2 service metadata, please check your OData2 end-point"
To work around these errors, the driver requires IBM SDK Java 8.0 Service
Refresh 3 Fix Pack 10 and higher with the JVM option
-Dcom.ibm.jsse2.overrideDefaultTLS set to true. This overrides the default TLS
setting and uses TLSv1.2 for a successful connection.
Update and Delete support on services with E-Tag validation
------------------------------------------------------------
The driver does not support update or delete operations on services that
require E-Tag validation. If you execute update or delete operations on a
service requiring E-Tag validation, the driver returns a 428 error.
Services having different relative path not supported in ServiceList
---------------------------------------------------------------------
The driver does not connect to services specified by the ServiceList property
that have a different relative path than the standard, which is
https://<hostname>/sap/opu/odata/sap.
JDBC Methods
--------------
The following notes on JDBC methods apply generally to Progress DataDirect
for JDBC drivers. Additional information on driver support for the JDBC API
can be found in the "JDBC Support" section of the product user's guide.
* The DataDirect for JDBC drivers allow PreparedStatement.setXXX methods and
ResultSet.getXXX methods on Blob/Clob data types, in addition to the
functionality described in the JDBC specification. The supported conversions
typically are the same as those for LONGVARBINARY/LONGVARCHAR, except where
limited by database support.
* When attempting to create an updatable, scroll-sensitive result set for a
query that contains an expression as one of the columns, the driver cannot
satisfy the scroll-sensitive request. The driver downgrades the type of the
result returned to scroll-insensitive.
* The DataDirect for JDBC drivers support retrieval of output parameters from
a stored procedure before all result sets and/or update counts have been
completely processed. When CallableStatement.getXXX is called, result sets
and update counts that have not yet been processed by the application are
discarded to make the output parameter data available. Warnings are
generated when results are discarded.
* The preferred method for executing a stored procedure that generates result
sets and update counts is using CallableStatement.execute(). If multiple
results are generated using executeUpdate, the first update count is
returned. Any result sets prior to the first update count are discarded. If
multiple results are generated using executeQuery, the first result set is
returned. Any update counts prior to the first result set are discarded.
Warnings are generated when result sets or update counts are discarded.
* The ResultSet methods getTimestamp(), getDate(), and getTime() return
references to mutable objects. If the object reference returned from any of
these methods is modified, re-fetching the column using the same method
returns the modified value. The value is only modified in memory; the
database value is not modified.
Documentation
PROGRESS DATADIRECT FOR JDBC FOR SAP S/4HANA DRIVER USER'S GUIDE
-----------------------------------------------------------------
The user's guide is available as an HTML help system on the DataDirect
documentation web page:
https://www.progress.com/documentation/datadirect-connectors
You can also launch the help system by selecting Help from the menu in the
Configuration Manager.
Installed Files
When you extract the contents of the installation download package to your
installer directory, you will notice the following files that are required to
install the driver:
* Windows:
- PROGRESS_DATADIRECT_JDBC_INSTALL.exe
- DriverModules
- PROGRESS_DATADIRECT_JDBC_S4HANA_6.0.1_INSTALL.iam.zip
- PROGRESS_DATADIRECT_JDBC_COMMON_6.0.0_INSTALL.iam.zip
* Non-Windows:
- PROGRESS_DATADIRECT_JDBC_INSTALL.jar
- DriverModules
- PROGRESS_DATADIRECT_JDBC_S4HANA_6.0.1_INSTALL.iam.zip
- PROGRESS_DATADIRECT_JDBC_COMMON_6.0.0_INSTALL.iam.zip
When you install the driver, the installer creates the following directories
and files in the product installation directory in the default installation
directory or in an installation directory you specify, represented by
INSTALL_DIR.
INSTALL_DIR/:
-------------
LicenseTool.jar Product license file manager
ddprocinfo.exe Windows executable to start the Processor
Information
Utility
ddprocinfo UNIX/Linux script to start the Processor Information
Utility
fixes.txt Information on resolved issues for Progress
DataDirect for JDBC drivers
INSTALL_DIR/Examples/Bulk/:
----------------------------
Load From File/bulkLoadFileDemo.java
Java source example for bulk loading from a CSV file
Load From File/load.txt Sample data for the example
Streaming/bulkLoadStreamingDemo.java
Java source example for bulk loading from a result
set
Threaded Streaming/bulkLoadThreadedStreamingDemo.java
Java source example for multi-threaded bulk loading
from a result set
Threaded Streaming/README.txt
Instructions on how to use the thread.properties
file
Threaded Streaming/thread.properties
Properties file for the example
INSTALL_DIR/Examples/JNDI/:
----------------------------
JNDI_FILESYSTEM_Example.java
Example Java(TM) source file
JNDI_LDAP_Example.java Example Java source file
INSTALL_DIR/install/:
----------------------
.psc_dd_inst_reg.xml Support file for the installation logs
logs/*.* Log file generated upon installation
INSTALL_DIR/lib/:
------------------
JDBCDriverLogin.conf Kerberos configuration file used to specify the JAAS
login module
INSTALL_DIR/lib/60/:
--------------------
s4hana.jar Driver and DataSource classes
INSTALL_DIR/NOTICES/:
----------------------
JDBC for SAP S4HANA v6.0 notices.txt
Third party agreement information
INSTALL_DIR/pool manager/:
---------------------------
pool.jar All DataDirect Connection Pool Manager classes
INSTALL_DIR/READMES/:
----------------------
JDBC for SAP S4HANA v6.0 readme.txt
This file
INSTALL_DIR/testforjdbc/:
--------------------------
Config.txt Configuration file for DataDirect Test
ddlogging.properties Logging properties file
testforjdbc.bat Batch file to start DataDirect Test
testforjdbc.sh Shell script to start DataDirect Test
lib/testforjdbc.jar DataDirect Test classes
INSTALL_DIR/jdbcisql/:
-----------------------
jdbcisql.bat Batch file to start JDBC iSQL
jdbcisql.jar Java program to start JDBC iSQL
jdbcisql.sh Shell script to start JDBC iSQL
INSTALL_DIR/uninstall/:
------------------------
.com.zerog.registry.xml Support file for the uninstaller
.psc_dd_uninst_reg.xml Support file for the uninstaller
InstallScript.iap_xml Support file for the uninstaller
installvariables.properties
Support file for the Windows uninstaller
Uninstall_JDBC.exe Windows uninstaller
Uninstall_JDBC.lax Support file for the Windows uninstaller
uninstaller.jar Java uninstaller
s4hana/*.* Support files for the uninstaller
resource/*.* Resource files for the Windows uninstaller
February 2026
================
End of README