Databricks JDBC ドライバー (OSS)

プレビュー

Databricks JDBC Driver (OSS) はパブリック プレビュー段階であり、一般提供 (GA) になるとオープンソースとして利用できるようになります。

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環境 (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 に指示します。

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

  • Gradle プロジェクトの場合、プロジェクトのビルド ファイルに次の依存関係を追加して、指定されたバージョンの JDBC ドライバーを自動的にダウンロードするように Gradle に指示します。

    implementation 'com.databricks:databricks-jdbc:0.9.9-oss'

他のプロジェクト タイプの依存関係構文を表示し、Databricks JDBC ドライバー (OSS) の最新バージョン番号を取得するには、 Maven リポジトリを参照してください。