OpenSearchODBC is a read-only ODBC driver for Windows and Mac for connecting to OpenSearch SQL support.

Build

The driver is compatible with ODBC 3.51.

• Power BI Desktop

You can use the installers generated as part of the most recent release. They are available for download from Artifacts page on OpenSearch.org at the very bottom and from automated CI workflow.

1. Run the .msi installer to install the OpenSearch SQL ODBC Driver.
2. Test connection using ODBC Data Source Administrator.

To use the driver with Tableau:

1. Copy the .tdc file from <driver-install-dir>/resources to <windows-user-dir>/Documents/My Tableau Repository/Datasources.

This will customize the connection from Tableau to OpenSearch, ensuring that the correct forms of queries are used.

iODBC Driver Manager should be installed before installing the OpenSearch SQL ODBC Driver on Mac.

1. Run the .pkg installer to install the OpenSearch SQL ODBC Driver.
2. Configure a Driver and DSN entry for the OpenSearch SQL ODBC Driver, following the instructions here.

To use the driver with Tableau:

1. Copy the .tdc file from <driver-install-dir>/resources to <mac-user-dir>/Documents/My Tableau Repository/Datasources.

This will customize the connection from Tableau to OpenSearch, ensuring that the correct forms of queries are used.

The driver comes in the form of a library file:

• Windows: sqlodbc.dll
• Mac: libsqlodbc.dylib

If using with ODBC compatible BI tools, refer to the tool documentation on configuring a new ODBC driver. In most cases, you will need to make the tool aware of the location of the driver library file and then use it to setup OpenSearch database connections.

A list of options available for configuring driver behaviour is available here.

To setup a connection, the driver uses an ODBC connection string. Connection strings are semicolon-delimited strings specifying the set of options to use for a connection. Typically, a connection string will either:

1. specify a Data Source Name containing a pre-configured set of options (DSN=xxx;User=xxx;Password=xxx;)
2. or configure options explicitly using the string (Host=xxx;Port=xxx;LogLevel=OPENSEARCH_DEBUG;...)

Please refer to the build instructions for detailed build instructions on your platform. If your PC is already setup to build the library, you can simply invoke cmake using

cmake ./src

From the projects root directory, then build the project using Visual Studio (Windows) or make (Mac).

• Visual Studio: Open ./global_make_list.sln
• Make: Run make from the build root.

NOTE: Some tests in ITODBCConnection will fail if a test DSN (Data Source Name) is not configured on your system. Refer to "Running Tests" in the build instructions for more information on configuring this.

Please refer to the documentation for detailed information on installing and configuring OpenSearch.

This project has adopted an Open Source Code of Conduct.

If you discover a potential security issue in this project we ask that you notify AWS/Amazon Security via our vulnerability reporting page. Please do not create a public GitHub issue.

See the LICENSE file for our project's licensing. We will ask you to confirm the licensing of your contribution.

Copyright OpenSearch Contributors. See NOTICE for details.