{"id":46199341,"url":"https://github.com/databricks/databricks-jdbc","last_synced_at":"2026-04-01T18:32:30.161Z","repository":{"id":300281291,"uuid":"655599960","full_name":"databricks/databricks-jdbc","owner":"databricks","description":"JDBC for Databricks SQL","archived":false,"fork":false,"pushed_at":"2026-03-27T14:16:13.000Z","size":147002,"stargazers_count":34,"open_issues_count":48,"forks_count":36,"subscribers_count":6,"default_branch":"main","last_synced_at":"2026-03-27T17:45:55.144Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://docs.databricks.com/aws/en/integrations/jdbc-oss/","language":"Java","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/databricks.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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,"notice":"NOTICE","maintainers":null,"copyright":null,"agents":null,"dco":"DCO","cla":null}},"created_at":"2023-06-19T08:21:22.000Z","updated_at":"2026-03-27T10:34:07.000Z","dependencies_parsed_at":"2025-07-25T10:18:25.029Z","dependency_job_id":"167a5e77-37d3-41e3-85b1-61644d94e91a","html_url":"https://github.com/databricks/databricks-jdbc","commit_stats":null,"previous_names":["databricks/databricks-jdbc"],"tags_count":34,"template":false,"template_full_name":null,"purl":"pkg:github/databricks/databricks-jdbc","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/databricks%2Fdatabricks-jdbc","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/databricks%2Fdatabricks-jdbc/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/databricks%2Fdatabricks-jdbc/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/databricks%2Fdatabricks-jdbc/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/databricks","download_url":"https://codeload.github.com/databricks/databricks-jdbc/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/databricks%2Fdatabricks-jdbc/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31290883,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-01T13:12:26.723Z","status":"ssl_error","status_checked_at":"2026-04-01T13:12:25.102Z","response_time":53,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":[],"created_at":"2026-03-03T04:33:43.290Z","updated_at":"2026-04-01T18:32:30.155Z","avatar_url":"https://github.com/databricks.png","language":"Java","readme":"# Databricks JDBC Driver\n\nThe Databricks JDBC driver implements the JDBC interface providing connectivity to a Databricks SQL warehouse.\nPlease refer to [Databricks documentation](https://docs.databricks.com/aws/en/integrations/jdbc-oss/) for more\ninformation.\n\n[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)\n\n## Prerequisites\n\nDatabricks JDBC is compatible with Java 11 and higher. CI testing runs on Java versions 11, 17, and 21.\n\n## Installation\n\n### Maven\n\nAdd the following dependency to your `pom.xml`:\n\n```xml\n\u003cdependency\u003e\n  \u003cgroupId\u003ecom.databricks\u003c/groupId\u003e\n  \u003cartifactId\u003edatabricks-jdbc\u003c/artifactId\u003e\n  \u003cversion\u003e3.3.1\u003c/version\u003e\n\u003c/dependency\u003e\n```\n\n### Build from Source\n\nThis is a multi-module Maven project:\n\n| Module | Artifact | Description |\n|--------|----------|-------------|\n| `jdbc-core` | `databricks-jdbc-core` | Core driver code |\n| `assembly-uber` | `databricks-jdbc` | Uber jar with all dependencies bundled |\n| `assembly-thin` | `databricks-jdbc-thin` | Thin jar (dependencies not bundled) |\n| `test-assembly-uber` | `test-databricks-jdbc-uber` | Packaging tests for the uber jar |\n| `test-assembly-thin` | `test-databricks-jdbc-thin` | Packaging tests for the thin jar |\n\n1. Clone the repository\n2. Build the driver jar (equivalent to `mvn clean package -DskipTests` in a single-module project):\n   ```bash\n   mvn -pl jdbc-core,assembly-uber,assembly-thin clean package -DskipTests -Ddependency-check.skip=true\n   ```\n3. The uber jar is generated at `assembly-uber/target/databricks-jdbc-\u003cversion\u003e.jar`\n4. To run unit tests and generate a coverage report (equivalent to `mvn clean test` in a single-module project):\n   ```bash\n   mvn -pl jdbc-core clean test jacoco:report -Dgroups='!Jvm17PlusAndArrowToNioReflectionDisabled' -Ddependency-check.skip=true\n   ```\n   The test coverage report is generated in `jdbc-core/target/site/jacoco/index.html`\n\n## Usage\n\n### Connection String\n\n```\njdbc:databricks://\u003chost\u003e:\u003cport\u003e;transportMode=http;ssl=1;AuthMech=3;httpPath=\u003cpath\u003e;UID=token;PWD=\u003ctoken\u003e\n```\n\n### Authentication\n\nThe JDBC driver supports the following authentication methods:\n\n#### Personal Access Token (PAT)\n\nUse `AuthMech=3` for personal access token authentication:\n\n```\nAuthMech=3;UID=token;PWD=\u003cyour_token\u003e\n```\n\n#### OAuth2 Authentication\n\nUse `AuthMech=11` for OAuth2-based authentication. Several OAuth flows are supported:\n\n##### Token Passthrough\n\nDirect use of an existing OAuth token:\n\n```\nAuthMech=11;Auth_Flow=0;Auth_AccessToken=\u003cyour_access_token\u003e\n```\n\n##### OAuth Client Credentials (Machine-to-Machine)\n\nConfigure standard OAuth client credentials flow:\n\n```\nAuthMech=11;Auth_Flow=1;OAuth2ClientId=\u003cclient_id\u003e;OAuth2Secret=\u003cclient_secret\u003e\n```\n\nOptional parameters:\n- `AzureTenantId`: Azure tenant ID for Azure Databricks (default: null). If enabled, the driver will include refreshed\nAzure Active Directory (AAD) Service Principal OAuth tokens with every request.\n\n##### Browser-Based OAuth\n\nInteractive browser-based OAuth flow with PKCE:\n\n```\nAuthMech=11;Auth_Flow=2\n```\n\nOptional parameters:\n- `OAuth2ClientId` - Client ID for OAuth2 (default: databricks-cli)\n- `OAuth2RedirectUrlPort` - Ports for redirect URL (default: 8020)\n- `EnableOIDCDiscovery` - Enable OIDC discovery (default: 1)\n- `OAuthDiscoveryURL` - OIDC discovery endpoint (default: /oidc/.well-known/oauth-authorization-server)\n- `EnableSQLValidationForIsValid` - Enable SQL query based validation in `isValid()` connection checks (default: 0)\n\n### Logging\n\nThe driver supports logging configuration via JDBC URL parameters or system properties. For detailed configuration options, see [Logging Documentation](./docs/LOGGING.md).\n\n## Running Tests\n\nBasic test execution:\n\n```bash\nmvn test\n```\n\n**Note**: Due to a change in JDK 16 that introduced a compatibility issue with the Apache Arrow library used by the JDBC\ndriver, runtime errors may occur when using the JDBC driver with JDK 16 or later. To avoid these errors, restart your\napplication or driver with the following JVM command option:\n\n```\n--add-opens=java.base/java.nio=org.apache.arrow.memory.core ALL-UNNAMED\n```\n\nFor more detailed information about integration tests and fake services, see [Testing Documentation](./docs/TESTING.md).\n\n## Documentation\n\nFor more information, see the following resources:\n- [Integration Tests Guide](./docs/TESTING.md)\n- [Logging Configuration](./docs/LOGGING.md)\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdatabricks%2Fdatabricks-jdbc","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdatabricks%2Fdatabricks-jdbc","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdatabricks%2Fdatabricks-jdbc/lists"}