次の方法で共有


Databricks JDBC ドライバー

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

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

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

このドライバーは JDBC API を実装しており、OAuth、Cloud Fetch、Unity Catalog ボリューム インジェストなどの機能を含むコア機能を提供します。 これはネイティブ クエリ モードを実行し、ネイティブのパラメーター化クエリをサポートし、有益なクエリ結果保持機能を提供する Statement Execution API または Thrift を使用して実行できます。

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

この記事では、Databricks JDBC Driver バージョン 3 以降のインストールと使用について説明します。 Databricks JDBC Driver (Simba) のバージョン 3 より前の詳細については、 Databricks JDBC Driver (Simba) を参照してください。

必要条件

Databricks JDBC Driver を使用するには、次の要件を満たす必要があります。

  • 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 に指示します。

    <dependency>
      <groupId>com.databricks</groupId>
      <artifactId>databricks-jdbc</artifactId>
      <version>3.0.5</version>
      <scope>runtime</scope>
    </dependency>
    
  • Gradle プロジェクトの場合は、次の依存関係をプロジェクトのビルド ファイルに追加して、指定されたバージョンの JDBC ドライバーを自動的にダウンロードするように Gradle に指示します。

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

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

次のステップ

その他のリソース