DataDirect JDBC drivers are compliant with the Type 4 architecture, but provide advanced features that define them as Type 5 drivers. Additionally, the drivers consistently support the latest database features and are fully compliant with Java™ SE 8 and JDBC 4.0 functionality.
The DataDirect JDBC Driver for Tanzu Greenplum is available for download from VMware Tanzu Network.
Parent topic: DataDirect JDBC Driver for Tanzu Greenplum
To install the JDBC driver on your client:
-classpath option when executing a Java application.Parent topic: DataDirect JDBC Driver for Tanzu Greenplum
To view the JDBC driver version information:
Change to the directory that contains the downloaded greenplum.jar driver file. For example:
$ cd /opt/Progress/DataDirect/Connect_for_JDBC_51/lib
Execute the data source class to display the version information.
For Linux/Unix systems:
$ java -classpath greenplum.jar com.pivotal.jdbc.GreenplumDriver
[Pivotal][Greenplum JDBC Driver]Driver Version: 5.1.4.000212 (F000427.U000206)
For Windows systems:
java -classpath .;.\greenplum.jar com.pivotal.jdbc.GreenplumDriver
[Pivotal][Greenplum JDBC Driver]Driver Version: 5.1.4.000212 (F000427.U000206)
Parent topic: DataDirect JDBC Driver for Tanzu Greenplum
The JDBC driver is provided in the greenplum.jar file. Use the following data source class and connection URL information with the driver.
| Property | Description |
|---|---|
| Driver File Name | greenplum.jar |
| Data Source Class | com.pivotal.jdbc.GreenplumDriver |
| Connection URL | jdbc:pivotal:greenplum://host:port;DatabaseName=<name> |
| Driver Defaults | FetchTWFSasTime=true MaxLongVarcharSize=8190 MaxNumericPrecision=28 MaxNumericScale=6 PrepareThreshold=0 ResultSetMetadataOptions=1 SupportsCatalogs=true |
Parent topic: DataDirect JDBC Driver for Tanzu Greenplum
The DataDirect JDBC driver version 5.1.4.000270 (F000450.U000214) introduced support for the PrepareThreshold connection property. This property specifies the number of prepared statement executions to be performed before the driver switches to using server-side prepared statements.
The PrepareThreshold default value is 0, always use server-side prepare for prepared statements. This setting preserves the behavior of previous versions of the JDBC driver.
When the PrepareThreshold value is greater than 1, it specifies on which execution of a prepared statement the driver starts using server-side prepared statements.
Note: statement.executeBatch() always uses server-side prepare for prepared statements. This matches the behavior of the PostgreSQL open source JDBC driver.
Refer to PrepareThreshold in the DataDirect documentation for additional information about this connection property.
When the PrepareThreshold value is greater than one and the prepared statement includes parameterized operations, the driver does not send any SQL prepare calls during connection.prepareStatement(). The driver instead sends the query all at once, at execution time. This requires that the driver determine the data types of every column before it sends the query to the server. While the driver can make this determination for many data types, it cannot for the JDBC types that can be mapped to multiple Greenplum data types:
To work around this limitation, set PrepareThreshold to 0 when a prepared statement uses parameterized values with any of the above data types. And use ResultSet.getMetaData() to determine if any of the above types are used in a query in advance of submitting the prepared statement.
Note: GPORCA does not support prepared statements that have parameterized values, and will fall back to using the Postgres Planner.
Parent topic: DataDirect JDBC Driver for Tanzu Greenplum
For more information on working with the Data Direct JDBC driver, see documentation available online at https://www.progress.com/documentation/datadirect-connectors. Titles include:
Parent topic: DataDirect JDBC Driver for Tanzu Greenplum
