共用方式為

Databricks JDBC 驅動程式

備註

Databricks JDBC 驅動程式 原始程式碼 可在 Apache 2.0 授權下公開取得。

這反映了 Databricks 對透明度、共同作業和社群驅動開發能力的承諾。 歡迎開發人員、使用者和社群的貢獻。 若要開始使用，請參閱 貢獻指導方針。

Databricks JDBC 驅動程式可讓您透過 Java 資料庫連線 （JDBC） 將 DataGrip、 DBeaver 和 SQL Workbench/J 等工具連線到 Azure Databricks，這是存取資料庫管理系統的業界標準規格。

此驅動程式已實作 JDBC API，並提供核心功能，包括 OAuth、雲端擷取，以及 Unity 目錄磁碟區擷取等功能。 它執行原生查詢模式，支援原生參數化查詢，並且可以使用陳述式執行 API (提供有用的查詢結果保留功能) 或 Thrift 來執行。

備註

在 IBM AIX 作業系統上，不支援 Apache 箭頭結果格式。 由於 Cloud Fetch 依賴 Arrow，因此 AIX 也不支援 Cloud Fetch。 若要避免在 SQL 執行期間發生錯誤，請設定 JDBC 連線內容來停用箭頭： EnableArrow=0

本文提供安裝和使用 Databricks JDBC 驅動程式第 3 版和更新版本的相關資訊。 如需 Databricks JDBC 驅動程式 （Simba） 的相關資訊，低於第 3 版，請參閱 Databricks JDBC 驅動程式 （Simba）。

需求

若要使用 Databricks JDBC 驅動程式，必須符合下列需求：

  • Java Runtime Environment (JRE) 11.0 或更新版本。 JRE 11、17 和 21 支援 CI 測試。

專用的 JDK 8 分支可供需要與 Java 8 相容的使用者使用。 使用者可以視需要從此分支建置 JAR。 該分支會定期與主分支同步，但歡迎社群貢獻以保持更新。 請參閱 Databricks JDBC 驅動程式 JDK 8 分支。

備註

由於 JDK 16 中的變更導致 JDBC 驅動程式所使用的 Apache Arrow 程式庫出現相容性問題，因此將 JDBC 驅動程式與 JDK 16 或更新版本搭配使用時可能會發生執行階段錯誤。 若要避免這些錯誤，請使用下列 JVM 命令選項重新啟動您的應用程式或驅動程式：

--add-opens=java.base/java.nio=org.apache.arrow.memory.core ALL-UNNAMED

安裝驅動程式

Databricks JDBC 驅動程式發佈在 Maven 存放庫中。

若要安裝驅動程式，您可以執行下列任何操作：

  • 針對 Maven 專案，將下列相依性新增至項目的 pom.xml 檔案，以指示 Maven 使用指定的版本自動下載 JDBC 驅動程式：

    <dependency>
  <groupId>com.databricks</groupId>
  <artifactId>databricks-jdbc</artifactId>
  <version>3.0.5</version>
  <scope>runtime</scope>
</dependency>

  • 針對 Gradle 專案，將下列相依性新增至專案的組建檔，以指示 Gradle 使用指定的版本自動下載 JDBC 驅動程式：

    implementation 'com.databricks:databricks-jdbc:3.0.5'

若要檢視其他專案類型的相依性語法，以及取得 Databricks JDBC 驅動程式的最新版本號碼，請參閱 Maven 存放庫。

後續步驟

其他資源

  • Last updated on