How do I verify that I've upgraded my Amazon Redshift JDBC or ODBC driver?

Last updated: 2020-06-25

I'm trying to upgrade to the latest JDBC or ODBC driver to connect to my Amazon Redshift cluster. How can I do that and check that I've upgraded all of my drivers?

Short description

It's a best practice to use the latest Amazon Redshift drivers to avoid running into any issues found in the old driver versions. Sometimes, AWS sends an email notifying customers about updating their drivers to the latest released version. A notification email is sent out when there are known issues or meaningful changes made to the latest Amazon Redshift driver.

Note: A driver upgrade only involves changes to the client-side SQL data or application that is trying to connect to Amazon Redshift. Therefore, you do not need to make any changes to your Amazon Redshift cluster.


JDBC upgrades

To upgrade your JDBC driver in Amazon Redshift, perform the following steps:

1.    Verify the current JDBC driver version being used:

SELECT DISTINCT trim(remotehost) remote_host,trim(application_name) jdbc_version,
MAX(recordtime) OVER (PARTITION BY application_name) last_time_loggedin
FROM stl_connection_log
WHERE application_name LIKE '%JDBC%'
AND trim(event) = 'set application_name'

Note: Use the IP address in the output to identify the client machine.

2.    Determine whether you need a 32-bit or 64-bit version.

3.    Download the Amazon Redshift JDBC driver.

4.    Verify whether the driver contains the AWS SDK.

Note: The driver version number is indicated in the driver filename.

For example, RedshiftJDBC42-no-awssdk- indicates that you should use the JDBC 4.2 compatible driver without an AWS SDK, and that the driver version is You can authenticate to Amazon Redshift using IAM credentials and JDBC. If you need the AWS SDK, you must download a JDBC driver that includes AWS SDK for Java, or download the AWS SDK separately.

5.    (Optional) If you are using SQL Workbench/J, select the exiting driver and remove it. Click on the folder icon, providing the download location of the latest driver, and choose OK. Your driver is now updated.

ODBC upgrades

To upgrade your Amazon Redshift ODBC driver, perform the following steps:

1.    Confirm which platform (Windows, MacOS or Linux) that you want to upgrade.

2.    Install and configure the ODBC connection.

3.    Verify the ODBC driver version in use for your platform.

Windows: From the Start menu, navigate to ODBC Data Sources and choose the Drivers tab. Locate the Amazon Redshift ODBC Driver from the list of installed ODBC drivers. The version number is displayed in the Version column. Be sure to choose the ODBC Data Source Administrator that has the same bitness as the client application being used to connect to Amazon Redshift.

MacOS: At the terminal, run the pkgutil --info command.

Linux: Depending on your package manager, run one of the following commands:

yum list | grep AmazonRedshiftODBC


rpm -qa | grep AmazonRedshiftODBC

Gradual driver updates

To gradually update your JDBC or ODBC driver, perform the following steps:

1.    Assign a single SQL client to begin updating the driver. The SQL client restarts upon version rollback.

2.    During off-peak hours, replace the old driver with the new one. If an application explicitly points to an old driver filename, reconfigure the application, and use the new driver for 3-5 days.

3.    If there was no impact caused by the driver change, replace the additional SQL client. Check to see how the new client performs for 3-5 days and whether there was any impact on your Amazon Redshift cluster.

4.    Continue to replace the driver gradually, until all of the SQL clients have been updated to the newer version.

Additional troubleshooting

If you experience any issues during your upgrade, try the following troubleshooting tips: