Databricks JDBC ドライバー (Simba) のドライバー機能設定

注記

このページは、バージョン 3 未満の Databricks JDBC ドライバーバージョンに適用されます。Databricks JDBC ドライバーバージョン 3 以上については、「Databricks JDBC ドライバー」を参照してください。

このページでは、 Databricks JDBC ドライバーの特別な高度なドライバー機能設定を構成する方法について説明します。

Databricks JDBC ドライバーには、次の特殊で高度なドライバー機能設定が用意されています。

JDBC での ANSI SQL-92 クエリのサポート

従来の Spark JDBC ドライバーは、ANSI SQL-92 方言の SQL クエリを受け入れ、それをサーバーに送信する前に Databricks SQL に変換します。

アプリケーションが Databricks SQL を直接生成するか、Databricks 固有の非 ANSI SQL-92 構文を使用する場合は、接続構成でUseNativeQuery=1を設定します。この設定により、SQL クエリが変換されずにそのまま Databricks に渡されます。

デフォルトのカタログとスキーマを指定するには、JDBC接続URLにConnCatalog=<catalog-name>;ConnSchema=<schema-name>を追加します。

備考

プレビュー

この機能はプライベートプレビュー段階です。アクセスをリクエストするには、アカウントチームにお問い合わせください。

追跡と分析の目的で、 SQLクエリに key-value タグを添付します。クエリタグは、クエリの識別と分析のためにsystem.query.historyテーブルに表示されます。

接続にクエリタグを追加するには、 JDBC接続 URL にssp_query_tagsパラメーターを含めます。

jdbc:databricks://<server-hostname>:443;httpPath=<http-path>;ssp_query_tags=key1:value1,key2:value2

クエリタグを、コンマで区切られたキーと値のペアとして定義します。各キーと値はコロンで区切られます。たとえば、 key1:value1,key2:value2 。

大規模なクエリー結果を抽出するときに最高のパフォーマンスを実現するには、以下の最適化が含まれている最新バージョンのJDBCドライバーを使用してください。

JDBC ドライバーバージョン 2.6.16 以降では、 Apache Arrow を使用した最適化されたクエリ結果のシリアル化形式がサポートされています。

JDBC ドライバーでのログ記録を有効にするには、 LogLevelプロパティを1 (重大なイベントのみ) から6 (すべてのドライバーアクティビティ) までの値に設定します。LogPathプロパティを、ログファイルを保存するフォルダーの完全パスに設定します。

詳細については、『 Databricks JDBC Driver Guide』のConfiguring Loggingセクションを参照してください。