Databricks ODBC ドライバーのドライバー機能設定
この記事では、 Databricks ODBC ドライバーの特別なドライバー機能と高度なドライバー機能設定を構成する方法について説明します。
Databricks ODBC ドライバーには、次の特殊で高度なドライバー機能設定が用意されています。
ODBC で初期スキーマを設定する
ODBCドライバーでは、接続構成としてSchema=<schema-name>を設定することでスキーマを指定できます。これは、USE <schema-name>を実行した場合と同等です。
ODBC での ANSI SQL-92 クエリのサポート
ODBCドライバーは、ANSI SQL-92言語のSQLクエリーを許可しており、クエリーをDatabricks SQL言語に変換します。ただし、アプリケーションがDatabricks SQLを直接生成する場合、またはアプリケーションがDatabricksに固有の非ANSI SQL-92標準SQL構文を使用する場合、Databricksでは接続構成としてUseNativeQuery=1を設定することをお勧めしています。この設定を使用すると、ドライバーはSQLクエリーをそのままDatabricksに渡します。
ODBC で大きなクエリ結果を抽出する
大規模なクエリー結果を抽出するときに最高のパフォーマンスを実現するには、以下の最適化が含まれている最新バージョンのODBCドライバーを使用してください。
ODBC での矢印のシリアル化
ODBC ドライバー バージョン 2.6.15 以降では、 Apache Arrow を使用した最適化されたクエリ結果のシリアル化形式がサポートされています。
ログ記録を有効にする
のODBC ドライバーでログを有効にするには、関連するWindows ODBCDSN の データソース アドミニストレーターで次のフィールドを設定します。
- [ログレベル ]フィールドを FATAL から設定し、 TRACE を介して重大なイベントのみをログに記録し、すべてのドライバーアクティビティをログに記録します。
- [Log Path ] フィールドを、ログファイルを保存するフォルダへのフルパスに設定します。
- 「 最大ファイル数 」フィールドに、保持するログファイルの最大数を設定します。
- [最大ファイルサイズ ] フィールドを各ログファイルの最大サイズ (メガバイト単位) に設定します。
Windows 以外のマシンの ODBC ドライバーでログ記録を有効にするには、関連する DSN または DSN なしの接続文字列で次のプロパティを設定します。
LogLevelプロパティを1から設定して、重大なイベントのみをログに記録し、6からすべてのドライバー アクティビティをログに記録します。LogPathプロパティを、ログ ファイルを保存するフォルダーへの完全なパスに設定します。LogFileCountプロパティを、保持するログ・ファイルの最大数に設定します。LogFileSizeプロパティを各ログ ファイルの最大サイズ (バイト単位) に設定します。
詳細については、『 Databricks JDBC Driver Guide』の Configuring Logging Options on Windows と Configuring Logging Options on a Non-Windows Machine のセクションを参照してください。