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

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

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

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

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

備考

プレビュー

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

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

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

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

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

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

大規模なクエリ結果を抽出するときに最高のパフォーマンスを実現するには、次の最適化が組み込まれた最新バージョンの ODBC ドライバーを使用します。

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

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

詳細については、『 Databricks ODBCドライバーガイド』のConfiguring Loggingセクションを参照してください。