Databricks JDBC ドライバー (OSS)
Databricks JDBC ドライバーの最新バージョンである Databricks JDBC ドライバー (OSS) を使用すると、データベース管理システムにアクセスするための業界標準仕様である Java Database Connectivity (JDBC) を介して、 DataGrip、 DBeaver、 SQL Workbench/J などのツールを Databricks に接続できます。
このドライバーはJDBC APIsを実装しており、 OAuth 、クラウド Fetch、 Unity Catalogボリューム取り込みなどのコア機能を提供します。 ネイティブ クエリ モードを実行し、ネイティブ パラメータ化クエリをサポートし、便利なクエリ結果保持機能、つまり Thrift を提供する ステートメント実行APIを使用して実行できます。
この記事では、Databricks JDBC ドライバー (OSS) のインストールと使用に関する情報を提供します。 OSS 以外の Databricks JDBC ドライバーに関する情報については、「Databricks JDBC ドライバー」を参照してください。
必要条件
Databricks JDBC ドライバー (OSS) を使用するには、次の要件を満たす必要があります。
- Java Runtime Environment(JRE)11.0以降。 CI テストは、JRE 11、17、および 21 でサポートされています。
JDK 16 での変更により、JDBC ドライバーで使用される Apache Arrow ライブラリとの互換性の問題が発生したため、JDK 16 以上で JDBC ドライバーを使用すると、ランタイム エラーが発生する可能性があります。 これらのエラーを回避するには、次の JVM コマンドオプションを使用してアプリケーションまたはドライバーを再起動します。
--add-opens=java.base/java.nio=org.apache.arrow.memory.core ALL-UNNAMED
ドライバーをインストールする
Databricks JDBC Driver (OSS) は Maven リポジトリで公開されています。
ドライバをインストールするには、次のいずれかを実行できます。
-
Maven プロジェクトの場合は、プロジェクトの
pom.xml
ファイルに次の依存関係を追加して、指定したバージョンの JDBC ドライバーを自動的にダウンロードするように Maven に指示します。XML<dependency>
<groupId>com.databricks</groupId>
<artifactId>databricks-jdbc</artifactId>
<version>1.0.1-oss</version>
<scope>runtime</scope>
</dependency> -
Gradle プロジェクトの場合は、プロジェクトのビルド ファイルに次の依存関係を追加して、指定したバージョンの JDBC ドライバーを自動的にダウンロードするように Gradle に指示します。
Groovyimplementation 'com.databricks:databricks-jdbc:1.0.1-oss'
他のプロジェクトの種類の依存関係構文を表示し、Databricks JDBC Driver (OSS) の最新バージョン番号を取得するには、 Maven リポジトリを参照してください。