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

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

この記事は、次の Databricks ODBC ドライバーの記事の情報を補足するものです。

Databricks ODBC ドライバーの Databricks 接続を構成するには、コンピュート リソース設定、認証設定、および次のドライバー機能設定のいずれかを、ODBC データソース名 (DSN) または DSN なしの接続文字列に結合する必要があります。

DSN 接続文字列と DSN なしの接続文字列のどちらを使用するかは、ターゲット アプリ、ツール、クライアント、SDK、または API の要件によって異なります。 DSN と DSN なしの接続文字列の例については、「 Databricks ODBC ドライバーの認証設定」を参照してください。

Datbricks 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でのArrowシリアライズ

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

ログ記録を有効にする

用の ドライバーでログ記録を有効にするには、関連するODBC WindowsODBCDSN の データソース アドミニストレーターで次のフィールドを設定します。

  • [Log Level] フィールドを [FATAL] に設定して、TRACE を介して重大なイベントのみをログに記録し、すべてのドライバー アクティビティをログに記録します。

  • ログ・パス 」フィールドに、ログ・ファイルを保存するフォルダーへのフル・パスを設定します。

  • 最大ファイル数 」フィールドに、保持するログ・ファイルの最大数を設定します。

  • 最大ファイル・サイズ 」フィールドに、各ログ・ファイルの最大サイズ (メガバイト単位) を設定します。

Windows 以外のマシンで ODBC ドライバーのログ記録を有効にするには、関連する DSN または DSN レス接続文字列で次のプロパティを設定します。

  • LogLevel プロパティを 1 から 6 に設定してすべてのドライバー アクティビティをログに記録する重大なイベントのみをログに記録します。

  • LogPath プロパティを、ログ ファイルを保存するフォルダーへの完全なパスに設定します。

  • LogFileCount プロパティーを、保持するログ・ファイルの最大数に設定します。

  • LogFileSize プロパティーを、各ログ・ファイルの最大サイズ (バイト単位) に設定します。

詳細については、 Databricks JDBCドライバー ガイドのセクション Configuring Logging Options on Windows および Configuring Logging Options on a Non-Windows Machine を参照してください。