サポートされている接続プロパティ

この記事では、 Databricks JDBC ドライバー (OSS) でサポートされている接続プロパティについて説明します。

認証とプロキシのプロパティ

次の接続プロパティは、 Databricks JDBC ドライバー (OSS) でサポートされています。プロパティは大文字と小文字を区別しません。

属性	デフォルト値	説明
AsyncExecPollInterval	200	非同期クエリ実行ステータスの各ポーリング間の時間 (ミリ秒単位)。非同期とは、Spark に対するクエリの実行に使用される RPC 呼び出しが非同期であるという事実を指します。これは、JDBC 非同期操作がサポートされているという意味ではありません。
Auth_Flow	0	ドライバー接続の OAuth2 認証フロー。このプロパティは、 AuthMech が [ 11] の場合に必要です。
Auth_JWT_Key_File	null	JWT 認証用の秘密鍵ファイル (PEM 形式) へのパス。
Auth_JWT_Alg	RS256	秘密鍵 JWT 認証のアルゴリズム。サポートされているアルゴリズムは、RSA:RS256、RS384、RS512、PS256、PS384、PS512、およびEC:ES256、ES384、ES512です。
Auth_JWT_Key_Passphrase	null	暗号化された秘密キーを復号化するためのパスフレーズ。
Auth_KID	null	JWT 認証に必要なキー識別子 (KID)。これは、秘密鍵 JWT を使用する場合に必須です。
AuthMech	必須	認証メカニズム ( 3 はメカニズムが Databricks 個人用アクセス トークンであることを指定し、 11 はメカニズムが 2.0 トークンであること OAuth 指定します。 各メカニズムには、追加のプロパティが必要です。「ドライバーの認証」を参照してください。
CFProxyAuth	0	1に設定すると、ドライバーはプロキシ認証ユーザーとパスワード (CFProxyUID と CFProxyPwdで表されます) を使用します。
CFProxyHost	null	また、 に UseCFProxy が設定されている場合に使用するプロキシ ホストの名前を表す文字列 1。
CFProxyPort	null	また、 UseCFProxy が 1に設定されている場合に使用するプロキシ ポートの数を表す整数。
CFProxyUID	null	CFProxyAuth と UseCFProxy も 1に設定されている場合にプロキシ認証に使用するユーザー名を表す文字列。
CFProxyPwd	null	CFProxyAuth と UseCFProxy も 1に設定されている場合にプロキシ認証に使用するパスワードを表す文字列。
ConnCatalog または catalog	SPARK	使用するデフォルト・カタログの名前。
ConnSchema または schema	default	使用するデフォルトのスキーマの名前。これを指定するには、URL の URL の <schema> を使用するスキーマの名前に置き換えるか、 ConnSchema プロパティを使用するスキーマの名前に設定します。
GoogleServiceAccount	null	Google サービス アカウントを使用した認証を有効にします。
GoogleCredentialsFile	null	Google サービス アカウント認証用の JSON キー ファイルへのパス。
EnableOIDCDiscovery	1	1に設定すると、OpenID Connect 検出 URL が使用されます。
OIDCDiscoveryEndpoint	null	OIDC 設定を取得するための OpenID Connect 検出 URL。
Auth_RefreshToken	null	新しいアクセス トークンを取得するために使用される OAuth2 更新トークン。
OAuth2ConnAuthAuthorizeEndpoint	null	OAuth2 フローで使用される認証エンドポイント URL。
OAuth2ConnAuthTokenEndpoint	null	OAuth2 フローのトークンエンドポイント URL。
ProxyAuth	0	1に設定すると、ドライバーはプロキシ認証ユーザーとパスワード (ProxyUID と ProxyPwdで表されます) を使用します。
ProxyHost	null	また、 に UseProxy が設定されている場合に使用するプロキシ ホストの名前を表す文字列 1。
ProxyPort	null	また、 UseProxy が 1に設定されている場合に使用するプロキシ ポートの数を表す整数。
ProxyPwd	null	ProxyAuth と UseProxy も 1に設定されている場合にプロキシ認証に使用するパスワードを表す文字列。
ProxyUID	null	ProxyAuth と UseProxy も 1に設定されている場合にプロキシ認証に使用するユーザー名を表す文字列。
SSL	1	コネクタが SSL 対応ソケットを介して Spark サーバーと通信するかどうか。
UseProxy	0	1に設定すると、ドライバーは指定されたプロキシ設定 (ProxyAuth、ProxyHost、ProxyPort、ProxyPwd、ProxyUIDなど) を使用します。
UseSystemProxy	0	1に設定すると、ドライバーはシステム レベルで設定されたプロキシ設定を使用します。接続 URL に追加のプロキシ プロパティが設定されている場合、これらの追加のプロキシ プロパティは、システム レベルで設定されているプロキシ プロパティを上書きします。
UseCFProxy	0	1に設定すると、ドライバーはクラウド フェッチ プロキシ設定が提供されている場合はそれを使用し、そうでない場合は通常のプロキシを使用します。
UseJWTAssertion	false	クライアントシークレット認証が制限されているM2Mユースケースで、プライベートキーJWT認証を有効にします。
UserAgentEntry	browser	HTTP 要求に含める User-Agent エントリ。この値は次の形式です。 [ProductName]/[ProductVersion] [Comment]
UseThriftClient	1	JDBC ドライバーが Thrift クライアントとステートメント実行APIsのどちらを使用するか .

SQL 構成プロパティ

次の SQL 構成プロパティは、 Databricks JDBC ドライバー (OSS) でサポートされています。これらについては、「 構成パラメーター」でも説明されています。プロパティは大文字と小文字を区別しません。

属性	デフォルト値	説明
ansi_mode	TRUE	特定の関数とキャストルールに対して厳密な ANSI SQL 動作を有効にするかどうか。
enable_photon	TRUE	Photonベクトル化クエリエンジンを有効にするかどうか。
legacy_time_parser_policy	EXCEPTION	日付とタイムスタンプの解析と書式設定に使用されるメソッド。有効な値は、 EXCEPTION、 LEGACY、および CORRECTEDです。
max_file_partition_bytes	128m	ファイルベースのソースから読み取るときに 1 つのパーティションにパックする最大バイト数。この設定は任意の正の整数にすることができ、オプションで b (バイト)、 k 、 kb (1024 バイト) などのメジャーを含めることができます。
read_only_external_metastore	false	外部メタストアを読み取り専用として扱うかどうかを制御します。
statement_timeout	172800	SQL ステートメントのタイムアウトを 0 秒から 172800 秒の間で設定します。
timezone	UTC	ローカルタイムゾーンを設定します。area/city形式の地域 ID (America/Los_Angeles など)、または (+|-)HH、(+|-)HH 形式のゾーン オフセット または (+|-)HH:mm(例: -08、+01:00、-13:33:33)。また、 UTC は +00:00 のエイリアスとしてサポートされています
use_cached_result	true	Databricks SQL が可能な限り結果をキャッシュして再利用するかどうか。

ログ記録のプロパティ

次のログ プロパティは、 Databricks JDBC ドライバー (OSS) でサポートされています。プロパティは大文字と小文字を区別しません。

属性	デフォルト値	説明
LogLevel	OFF	ロギング・レベル (0 から 6 までの値): 0: すべてのログ記録を無効にします。 1: FATAL レベルでログ記録を有効にすると、コネクタが中止される原因となる非常に重大なエラー イベントがログに記録されます。 2: ERROR レベルでログ記録を有効にすると、コネクタの実行を続行できる可能性のあるエラー イベントがログに記録されます。 3: WARNING レベルでログ記録を有効にし、アクションが実行されない場合にエラーになる可能性のあるイベントをログに記録します。 4: INFO レベルでログ記録を有効にし、コネクタの進行状況を説明する一般情報をログに記録します。 5: DEBUG レベルでログ記録を有効にし、コネクタのデバッグに役立つ詳細情報をログに記録します。 6: TRACE レベルでログ記録を有効にし、すべてのコネクタ アクティビティをログに記録します。 このプロパティを使用して、コネクタでのログ記録を有効または無効にしたり、ログ ファイルに含まれる詳細の量を指定したりします。
LogPath	ログのデフォルトパスを決定するために、ドライバーはこれらのシステムプロパティに設定された値を次の優先順位で使用します。 user.dir java.io.tmpdir つまり、現在のディレクトリ .	ログ記録が有効になっているときにコネクタがログファイルを保存するフォルダへの絶対パス (文字列)。接続 URL がすべての JDBC アプリケーションと互換性があることを確認するには、別のバックスラッシュを入力して、ファイルパスのバックスラッシュ (\) をエスケープします。 LogPath値が無効な場合、コネクタはログに記録された情報を標準出力ストリーム (System.out) に送信します。
LogFileSize	上限なし	許容される最大ログ・ファイル・サイズ (MB 単位)
LogFileCount	上限なし	許可されるログ・ファイルの最大数

ログ記録の有効化と構成

JDBC ドライバは、 Simple Logging Facade for Java (SLF4J) および java.util.logging (JUL) フレームワークをサポートしています。ドライバーは、デフォルトで JUL ロギングフレームワークを使用します。

JDBC ドライバーのログ記録を有効にして構成するには、次のようにします。

1. 使用するロギングフレームワークを有効にします。

   • SLF4J ロギングの場合は、システムプロパティーを -Dcom.databricks.jdbc.loggerImpl=SLF4JLOGGER に設定し、SLF4J バインディング実装 (SLF4J バージョン 2.0.13 以上と互換性あり) と対応する構成ファイルをクラスパスに含めます。
   • JUL ロギングの場合は、システム・プロパティーを -Dcom.databricks.jdbc.loggerImpl=JDKLOGGERに設定します。これがデフォルトです。

2. 接続文字列の LogLevel プロパティを、ログ ファイルに含める情報レベルに設定します。

3. 接続文字列の LogPath プロパティを、ログ ファイルを保存するフォルダーへのフル パスに設定します。

   たとえば、次の接続 URL はロギング レベル 6 を有効にし、ログ ファイルを C に保存します フォルダ：

   jdbc: databricks://localhost:11000;LogLevel=6;LogPath=C:\\temp

4. JDBC アプリケーションを再起動し、サーバーに再接続して設定を適用します。

その他の機能プロパティ

次のプロパティを使用すると、 Databricks JDBC ドライバー (OSS) の機能が有効になります。プロパティは大文字と小文字を区別しません。

属性	デフォルト値	説明
EnableComplexDatatypeSupport	0	1に設定すると、文字列の代わりにネイティブ Java オブジェクトとしての複合データ型 (ARRAY、STRUCT、MAP) のサポートが有効になります。
EnableTelemetry	0	1に設定すると、テレメトリが有効になります。「テレメトリ」を参照してください。
VolumeOperationAllowedLocalPaths	``	UC ボリューム インジェスト ファイルのダウンロードとアップロードに許可されるローカル パスのコンマ区切りリスト。パスにはサブディレクトリも含まれます。ボリュームを使用したファイルの管理を参照してください。
UCIngestionRetriableHttpCode	408,502,503,504	Unity Catalog ボリューム インジェストの再試行可能な HTTP コードのコンマ区切りリスト。
UCIngestionRetryTimeout	15	Unity Catalog ボリューム インジェスト HTTP 要求の再試行タイムアウト (分単位)。

テレメトリー

テレメトリーにより、Databricks は以下を収集することで、デバッグを効率化し、タイムリーなトラブルシューティングを提供できます。

• クライアント環境の詳細 (ドライバーのバージョン、ランタイム、OS の詳細)
• JDBC 接続設定 (PII データは除く)
• 操作のレイテンシ測定
• 実行結果の形式(インラインJSON、Arrowなど)
• 操作の種類 (実行クエリ、メタデータ クエリ、ボリューム操作)
• エラー分類データ
• 再試行回数

注記

Databricks は厳格なプライバシー基準を維持しており、クエリコンテンツ、結果、または個人を特定できる情報(PII)が収集されないようにしています。