{"id":19542756,"url":"https://github.com/opensearch-project/sql-odbc","last_synced_at":"2025-04-26T17:31:30.893Z","repository":{"id":66349512,"uuid":"574735451","full_name":"opensearch-project/sql-odbc","owner":"opensearch-project","description":"OpenSearchODBC is a read-only ODBC driver for Windows and Mac for connecting to OpenSearch SQL support.","archived":false,"fork":false,"pushed_at":"2025-04-10T17:40:26.000Z","size":17498,"stargazers_count":8,"open_issues_count":38,"forks_count":19,"subscribers_count":12,"default_branch":"main","last_synced_at":"2025-04-10T18:09:21.392Z","etag":null,"topics":["odbc","opensearch","opensearch-plugins","sql"],"latest_commit_sha":null,"homepage":"","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/opensearch-project.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2022-12-06T00:45:20.000Z","updated_at":"2025-04-10T16:49:20.000Z","dependencies_parsed_at":"2025-04-01T18:40:26.112Z","dependency_job_id":null,"html_url":"https://github.com/opensearch-project/sql-odbc","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/opensearch-project%2Fsql-odbc","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/opensearch-project%2Fsql-odbc/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/opensearch-project%2Fsql-odbc/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/opensearch-project%2Fsql-odbc/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/opensearch-project","download_url":"https://codeload.github.com/opensearch-project/sql-odbc/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251025819,"owners_count":21524866,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["odbc","opensearch","opensearch-plugins","sql"],"created_at":"2024-11-11T03:15:53.989Z","updated_at":"2025-04-26T17:31:28.849Z","avatar_url":"https://github.com/opensearch-project.png","language":"C++","readme":"# OpenSearch ODBC Driver\n\nOpenSearchODBC is a read-only ODBC driver for Windows and Mac for connecting to OpenSearch SQL support.\n\n### ODBC Driver\n\n|       |                                                 |\n| ----- | ----------------------------------------------- |\n| Build | [![ODBC CI][odbc-build-badge]][odbc-build-link] |\n\n[odbc-build-badge]: https://github.com/opensearch-project/sql/actions/workflows/sql-odbc-main.yml/badge.svg\n[odbc-build-link]: https://github.com/opensearch-project/sql/actions/workflows/sql-odbc-main.yml\n\n## Specifications\n\nThe driver is compatible with ODBC 3.51.\n\n## Supported Versions\n\n\n  | Operating System  | Version                           | Supported Bitness |\n  | ----------------- |-----------------------------------| ----------------- |\n  |  Windows          |  Windows 10, Windows 11           | 32-bit, 64-bit    |\n  |  MacOS            |  Catalina 10.15.4, Mojave 10.14.6 | 64-bit            |\n\n## BI Tool Connectors\n\n* [Power BI Desktop](bi-connectors/PowerBIConnector/README.md)\n\n## Download and Installation the Driver\n\nYou can use the installers generated as part of the most recent release.\nThey are available for download from [Artifacts page](https://opensearch.org/artifacts) on OpenSearch.org at the very bottom and from [automated CI workflow](https://github.com/opensearch-project/sql-odbc/actions/workflows/sql-odbc-main.yml).\n\n### Windows\n\n1. Run the `.msi` installer to install the OpenSearch SQL ODBC Driver.\n2. [Test connection](docs/user/windows_configure_dsn.md) using ODBC Data Source Administrator.\n\nTo use the driver with Tableau:\n1. Copy the `.tdc` file from `\u003cdriver-install-dir\u003e/resources` to `\u003cwindows-user-dir\u003e/Documents/My Tableau Repository/Datasources`.\n\nThis will customize the connection from Tableau to OpenSearch, ensuring that the correct forms of queries are used. \n\n### Mac\n\n[iODBC Driver Manager](http://www.iodbc.org/dataspace/doc/iodbc/wiki/iodbcWiki/WelcomeVisitors) should be installed before installing the OpenSearch SQL ODBC Driver on Mac.\n\n1. Run the `.pkg` installer to install the OpenSearch SQL ODBC Driver.\n2. Configure a Driver and DSN entry for the OpenSearch SQL ODBC Driver, following the instructions [here](docs/user/mac_configure_dsn.md).\n\nTo use the driver with Tableau:\n1. Copy the `.tdc` file from `\u003cdriver-install-dir\u003e/resources` to `\u003cmac-user-dir\u003e/Documents/My Tableau Repository/Datasources`.\n\nThis will customize the connection from Tableau to OpenSearch, ensuring that the correct forms of queries are used.\n\n## Using the Driver\n\nThe driver comes in the form of a library file:\n* Windows: `sqlodbc.dll`\n* Mac: `libsqlodbc.dylib`\n\nIf 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.\n\n### Connection Strings and Configuring the Driver\n\nA list of options available for configuring driver behaviour is available [here](docs/user/configuration_options.md).\n\nTo 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:\n\n1. specify a Data Source Name containing a pre-configured set of options (`DSN=xxx;User=xxx;Password=xxx;`)\n2. or configure options explicitly using the string (`Host=xxx;Port=xxx;LogLevel=OPENSEARCH_DEBUG;...`)\n\n## Building from source\n\n### Building\n\nPlease refer to the [build instructions](docs/dev/BUILD_INSTRUCTIONS.md) for detailed build instructions on your platform.\nIf your PC is already setup to build the library, you can simply invoke cmake using\n\n\u003e cmake ./src\n\nFrom the projects root directory, then build the project using Visual Studio (Windows) or make (Mac). \n\n* Visual Studio: Open **./global_make_list.sln**\n* Make: Run `make` from the build root.\n\n### Testing\n\n**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](docs/dev/BUILD_INSTRUCTIONS.md) for more information on configuring this.\n\n## Documentation\n\nPlease refer to the [documentation](https://opensearch.org/docs/latest/) for detailed information on installing and configuring OpenSearch.\n\n## Code of Conduct\n\nThis project has adopted an [Open Source Code of Conduct](CODE_OF_CONDUCT.md).\n\n## Security issue notifications\n\nIf you discover a potential security issue in this project, notify OpenSearch Security directly by emailing security@opensearch.org. To prevent any additional risk caused by the potential issue, do **not** create a public GitHub issue.\n\n## Licensing\n\nSee the [LICENSE](LICENSE.txt) file for our project's licensing. We will ask you to confirm the licensing of your contribution.\n\n## Copyright\n\nCopyright OpenSearch Contributors. See [NOTICE](NOTICE) for details.\n\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopensearch-project%2Fsql-odbc","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fopensearch-project%2Fsql-odbc","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopensearch-project%2Fsql-odbc/lists"}