注
Databricks JDBC Driver (OSS) ソース コード は、 Apache 2.0 ライセンスで公開されています。
これは、透明性、コラボレーション、コミュニティ主導の開発の力に対する Databricks のコミットメントを反映しています。 開発者、ユーザー、コミュニティからの投稿は大歓迎です。 開始するには、 投稿ガイドラインを参照してください。
Databricks JDBC ドライバーの最新バージョンである Databricks JDBC Driver (OSS) を使用すると、データベース管理システムにアクセスするための業界標準仕様である Java Database Connectivity (JDBC) を使用して、 DataGrip、 DBeaver、 SQL Workbench/J などのツールを Azure Databricks に接続できます。
このドライバーは JDBC API を実装しており、OAuth、Cloud Fetch、Unity Catalog ボリューム インジェストなどの機能を含むコア機能を提供します。 これはネイティブ クエリ モードを実行し、ネイティブのパラメーター化クエリをサポートし、有益なクエリ結果保持機能を提供する Statement Execution API または Thrift を使用して実行できます。
この記事では、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 ドライバー (OSS) は Maven Repository で公開されています。
ドライバーをインストールするには、以下のいずれかの操作を行います。
Maven プロジェクトの場合は、次の依存関係をプロジェクトの
pom.xml
ファイルに追加して、指定したバージョンの JDBC ドライバーを自動的にダウンロードするように Maven に指示します。<dependency> <groupId>com.databricks</groupId> <artifactId>databricks-jdbc</artifactId> <version>1.0.6-oss</version> <scope>runtime</scope> </dependency>
Gradle プロジェクトの場合は、次の依存関係をプロジェクトのビルド ファイルに追加して、指定されたバージョンの JDBC ドライバーを自動的にダウンロードするように Gradle に指示します。
implementation 'com.databricks:databricks-jdbc:1.0.6-oss'
他の種類のプロジェクトで使用する依存関係構文と、Databricks JDBC ドライバー (OSS) の最新バージョン番号を確認する方法については、Maven リポジトリの説明を参照してください。
次のステップ
- 接続 URL を構成する
- 認証とプロキシの構成プロパティ
- SQL 構成プロパティ
- SSL 信頼ストアの構成
- ログを有効にする
- ボリューム内のファイルを管理する
- 例: JDBC Driver (OSS) を使用してクエリを実行する
その他のリソース
- StreamSets に接続する
- Syncsort に接続する
- MicroStrategy に接続する