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を使用して実行できます。
このページでは、 Databricks JDBCドライバ(バージョン3以降)のインストール方法と使用方法について説明します。 Simba JDBC Driver (Legacy) バージョン 3 未満に関する情報については、 「Simba JDBC Driver (Legacy)」を参照してください。
必要条件
Databricks JDBC ドライバーを使用するには、次の要件を満たす必要があります。
- Java Runtime Environment(JRE)11.0以降。CI テストは、JRE 11、17、および 21 でサポートされています。
Java 8との互換性を必要とするユーザーは、専用のJDK 8ブランチを使用できます。ユーザーは、必要に応じてこのブランチからJARを構築できます。このブランチは定期的にメインブランチと同期されますが、常に最新の状態に保つためにコミュニティの貢献を歓迎します。「 Databricks JDBC ドライバー JDK 8 ブランチ」を参照してください。
ドライバーをインストールする
Databricks JDBC ドライバーは、Maven リポジトリで公開されています。
ドライバーをインストールするには、次のいずれかの操作を行います。
-
Maven プロジェクトの場合は、プロジェクトの
pom.xmlファイルに次の依存関係を追加して、指定したバージョンの JDBC ドライバーを自動的にダウンロードするように Maven に指示します。XML<dependency>
<groupId>com.databricks</groupId>
<artifactId>databricks-jdbc</artifactId>
<version>3.3.1</version>
<scope>runtime</scope>
</dependency> -
Gradle プロジェクトの場合は、プロジェクトのビルド ファイルに次の依存関係を追加して、指定したバージョンの JDBC ドライバーを自動的にダウンロードするように Gradle に指示します。
Groovyimplementation 'com.databricks:databricks-jdbc:3.3.1'
他のプロジェクト タイプの依存関係構文を表示し、Databricks JDBC ドライバーの最新バージョン番号を取得するには、 Maven リポジトリを参照してください。
次のステップ
- 接続 URL を構成する
- 認証プロパティ
- SQL 構成プロパティ
- SSL トラストストアの設定
- ログ記録を有効にする
- ボリューム内のファイルを管理する
- 例: JDBC ドライバーを使用してクエリを実行する
- 例: トランザクションを使用する
- Databricks JDBC Driver を使用してメトリクス ビューのメタデータを操作する