メインコンテンツまでスキップ

Databricks ODBC ドライバーのドライバー機能設定

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

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

ODBC で初期スキーマを設定する​

ODBCドライバーでは、接続構成としてSchema=<schema-name>を設定することでスキーマを指定できます。これは、USE <schema-name>を実行した場合と同等です。

追跡用のクエリタグ​

備考

プレビュー

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

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

接続にクエリ タグを追加するには、 ODBC接続構成にssp_query_tags問題を含めます。

クエリ タグを、各キーと値がコロンで区切られた、コンマ区切りのキーと値のペアとして定義します (例: ssp_query_tags=team:engineering,env:prod )。

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 のセクションを参照してください。

に最終更新