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

Databricks JDBC ドライバー (OSS)

注記

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

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

Databricks JDBC ドライバーの最新バージョンである Databricks JDBC ドライバー (OSS) を使用すると、データベース管理システムにアクセスするための業界標準仕様である 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 ドライバー (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.6-oss</version>
      <scope>runtime</scope>
    </dependency>

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

    Groovy
    implementation 'com.databricks:databricks-jdbc:1.0.6-oss'

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

次のステップ​

追加のリソース​

に最終更新