# amazon-redshift-odbc-driver

**Repository Path**: mirrors_aws/amazon-redshift-odbc-driver

## Basic Information

- **Project Name**: amazon-redshift-odbc-driver
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2022-07-19
- **Last Updated**: 2026-03-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## Redshift ODBC Driver

The Amazon ODBC Driver for Redshift database connectivity through the standard ODBC application program interfaces (APIs). The Driver provides access to Redshift from any C/C++ application.

The driver has many Redshift specific features such as,

* IAM authentication
* IDP authentication
* Redshift specific datatypes support
* External schema support as part of SQLTables() and SQLColumns() ODBC API

Amazon Redshift provides 64-bit ODBC drivers for Linux, macOSX and Windows operating systems. 


## Download Driver
You can download the latest release of Redshift ODBC drivers from AWS Redshift documentation links below:

Windows: https://docs.aws.amazon.com/redshift/latest/mgmt/odbc20-install-win.html

Linux: https://docs.aws.amazon.com/redshift/latest/mgmt/odbc20-install-linux.html

macOSX: https://docs.aws.amazon.com/redshift/latest/mgmt/odbc20-install-mac.html

## Build Driver
Amazon Redshift recommends downloading and using the prebuilt driver installer from [AWS Redshift documentation](https://docs.aws.amazon.com/redshift/latest/mgmt/odbc20-install-win.html) for the best experience.

If you choose to build from source, please note that the Redshift ODBC driver does not include pre-built binaries or complementary build script for building driver dependencies.
Building Redshift ODBC driver from source requires pre-built binaries for following dependencies (last tested versions shown):
* OpenSSL 1.1.1x latest version (requires OpenSSL Premium support)
* AWS SDK for CPP (1.11.763)
* C-ares (1.34.5)
* GoogleTest (1.17.0)
* Curl (Linux only)

### Prerequisites
#### Common:
* https://git-lfs.com/ (for correctly cloning this repository)
* CMake >= 3.20

#### Linux:
* gcc

#### Windows:
* Wix 6.0.2
* Build Tools for Visual Studio

### Build Steps
<u>For Building on Windows:</u>
1. Ensure Cmake (3.20+), Wix 3.14 and Build Tools for Visual Studio 2022 are installed on your Machine and added to system PATH.
2. Build above mentioned platform specific dependencies and keep their pre-built binaries in a specific directory. This directory path is later required for `dependencies-install-dir` option while building the driver.
3. Cd to cloned `amazon-redshift-odbc-driver` package home and build the driver using following command:
> .\build64.bat --dependencies-install-dir=absolute-path-to-dependencies-installation-directory

Optionally you can also provide the desired driver version number in the build command. It outputs the installer MSI under `amazon-redshift-odbc-driver\src\odbc\rsodbc\install\` directory. You can find the built `rsodbc64.dll` in `cmake-build/install/lib/` directory.

<u>For building on Linux and macOSX:</u>
1. Build above mentioned platform specific dependencies and keep their pre-built binaries in a specific directory.
2. Export `RS_MULTI_DEPS_DIRS` or `RS_DEPS_DIRS` to dependencies directory. You may alternatively set them in`exports_basic.sh` or use  --dependencies-install-dir in the build script. For more details, refer `BUILD.CMAKE.md`.
3. Cd to cloned `amazon-redshift-odbc-driver` package home and build the driver using following command:
> build64.sh --version=major.minor.patch.svn 

e.g. build64.sh --version=2.1.12.0 --create-package=yes --public-dir=/path/to/where/package/will/be/stored --build-type=Release

It builds `librsodbc64.so` and `librsodbc64.dylib` file under `cmake-build/install/` directory. The installers (rpm or pkg) will be stored in the specified `public-dir`.

### Installation and Configuration of Driver

Driver Name: Amazon Redshift ODBC Driver (x64)

Default Installation Directory:
* Windows: `C:\Program Files\Amazon Redshift ODBC Driver x64\`
* Linux: `/opt/amazon/redshiftodbcx64/`
* macOSX: `/opt/amazon/redshiftodbcx64/`

See [Amazon Redshift ODBC Driver Installation and Configuration Guide](https://docs.aws.amazon.com/redshift/latest/mgmt/odbc20-install.html) for more information.

## Report Bugs

See [CONTRIBUTING](CONTRIBUTING.md#Reporting-Bugs/Feature-Requests) for more information.

## Contributing Code Development

See [CONTRIBUTING](CONTRIBUTING.md#Contributing-via-Pull-Requests) for more information.

## Changelog Generation
An entry in the changelog is generated upon release using `gitchangelog <https://github.com/vaab/gitchangelog>`.
Please use the configuration file, ``.gitchangelog.rc`` when generating the changelog.
	 
## Security

See [CONTRIBUTING](CONTRIBUTING.md#security-issue-notifications) for more information.

## License

This project is licensed under the Apache-2.0 License.