メインコンテンツまでスキップ

Databricks JDBC ドライバー

注記

Databricks JDBC ドライバーのソース コードは、 Apache 2.0 ライセンスの下で公開されています。

これは、透明性、コラボレーション、コミュニティ主導の開発の力に対する Databricks のコミットメントを反映しています。開発者、ユーザー、コミュニティからの貢献を歓迎します。開始するには、 コントリビューションガイドラインを参照してください。

Databricks JDBC ドライバーを使用すると、データベース管理システムにアクセスするための業界標準仕様である Java Database Connectivity (JDBC) を介して、 DataGrip 、 DBeaver 、 SQL Workbench/Jなどのツールを Databricks に接続できます。

このドライバーはJDBC APIを実装しており、 OAuth 、クラウド Fetch、 Unity Catalogボリューム取り込みなどのコア機能を提供します。 ネイティブ クエリ モードを実行し、ネイティブ パラメータ化クエリをサポートし、便利なクエリ結果保持機能、つまり Thrift を提供する ステートメント実行APIを使用して実行できます。

注記

IBM AIX オペレーティング・システムでは、Apache 矢印結果形式はサポートされません。クラウド Fetch は Arrow に依存しているため、クラウド Fetch も AIX ではサポートされていません。 SQL実行中のエラーを回避するには、JDBC接続プロパティを設定してArrowを無効にします。 EnableArrow=0

この記事では、 Databricks JDBCドライバー バージョン 3 以降のインストールと使用に関する情報を提供します。 バージョン 3 より前のDatabricks JDBC Driver (Simba) については、 Databricks JDBC Driver (Simba) 」を参照してください。

必要条件​

Databricks JDBC ドライバーを使用するには、次の要件を満たす必要があります。

  • Java Runtime Environment(JRE)11.0以降。CI テストは、JRE 11、17、および 21 でサポートされています。

Java 8との互換性を必要とするユーザーは、専用のJDK 8ブランチを使用できます。ユーザーは、必要に応じてこのブランチからJARを構築できます。このブランチは定期的にメインブランチと同期されますが、常に最新の状態に保つためにコミュニティの貢献を歓迎します。「 Databricks JDBC ドライバー JDK 8 ブランチ」を参照してください。

注記

JDK 16 での変更により、JDBC ドライバーで使用される Apache Arrow ライブラリとの互換性の問題が発生したため、JDK 16 以上で JDBC ドライバーを使用すると、ランタイム エラーが発生する可能性があります。これらのエラーを回避するには、次の JVM コマンドオプションを使用してアプリケーションまたはドライバーを再起動します。

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

ドライバーをインストールする​

Databricks JDBC ドライバーは、Maven リポジトリで公開されています。

ドライバーをインストールするには、次のいずれかの操作を行います。

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

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

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

    Groovy
    implementation 'com.databricks:databricks-jdbc:3.0.1'

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

次のステップ​

追加のリソース​

に最終更新