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

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

この記事では、 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 プロパティを使用するスキーマの名前に設定します。

EnableComplexDatatypeSupport

0

1に設定すると、文字列の代わりにネイティブ Java オブジェクトとしての複合データ型 (ARRAY、STRUCT、MAP) のサポートが有効になります。

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

ログのデフォルトパスを決定するために、ドライバーはこれらのシステムプロパティに設定された値を次の優先順位で使用します。

  1. user.dir
  2. java.io.tmpdir
  3. つまり、現在のディレクトリ .

ログ記録が有効になっているときにコネクタがログファイルを保存するフォルダへの絶対パス (文字列)。 接続 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 アプリケーションを再起動し、サーバーに再接続して設定を適用します。

ボリューム操作のプロパティ​

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

属性

デフォルト値

説明

VolumeOperationAllowedLocalPaths

``

UC ボリューム インジェスト ファイルのダウンロードとアップロードに許可されるローカル パスのコンマ区切りリスト。パスにはサブディレクトリも含まれます。

ボリュームを使用してファイルを管理する​

Databricks は、Unity Catalog ボリュームを使用した一括取り込み機能 (アップロード/ダウンロード/削除) を提供し、ユーザーは CSV ファイルなどのローカルファイルとの間でデータセットを転送できます。Unity Catalogボリュームとはを参照してください。Unity Catalog ボリューム操作を有効にするには、接続プロパティ [ VolumeOperationAllowedLocalPaths ] を、ボリューム操作で許可されるローカル パスのコンマ区切りリストに設定します。

この機能を使用するには、Unity Catalog を有効にする必要があります。同様の機能は、Databricks UI を使用して使用できます。「Unity Catalog ボリュームへのファイルのアップロード」を参照してください。

Unity Catalog インジェスト コマンドは SQL ステートメントです。次の例は、PUT、GET、および REMOVE 操作を示しています。

ローカルファイルのアップロード​

ローカル ファイル /tmp/test.csv を Unity Catalog ボリューム パスに /Volumes/main/default/e2etests/file1.csvとしてアップロードするには、PUT 操作を使用します。

Text
  PUT '/tmp/test.csv' INTO '/Volumes/main/default/e2etests/file1.csv' OVERWRITE

ファイルのダウンロード​

Unity Catalog のボリューム パス /Volumes/main/default/e2etests/file1.csv からローカル ファイル /tmp/test.csvにファイルをダウンロードするには、GET 操作を使用します。

Text
  GET '/Volumes/main/default/e2etests/file1.csv' TO '/tmp/test.csv'

ファイルを削除する​

Unity Catalog ボリューム パスが /Volumes/main/default/e2etests/file1.csvのファイルを削除するには、REMOVE 操作を使用します。

Text
  REMOVE '/Volumes/main/default/e2etests/file1.csv'
に最終更新