クライアントインターフェイスガイド > ODBC経由でのTDVサーバーへの接続 > 接続文字列を使用したODBCクライアントの定義 > ODBCドライバー接続文字列のプロパティ
 
ODBCドライバー接続文字列のプロパティ
この表は、ODBC接続文字列で指定できるプロパティの名前を示しています。
ODBCプロパティ
説明
Alternativesecuritycredentials
現在のセッション内のIDの代替セキュリティプロパティ値を指定します。これは、ユーザーがセキュリティプロパティをデータソースに渡すことができるようにするために使用されます。
:同じセッションで複数のリクエストが行われた場合、または複数のIDが同じセッションにアクセスした場合、予期しない結果が生じる可能性があります。
caseSensitive
要求値で大文字と小文字の区別を指定します。値は次のとおりです。
<EMPTY>(デフォルト)-サーバー設定で大文字と小文字が区別されます
TRUE-リクエストでは大文字と小文字が区別されます
FALSE-要求では大文字と小文字が区別されません
commitFailure
コミットが失敗した場合の動作を指定します。可能な値は、rollbackまたはbestEffortです。
commitInterrupt
コミットが中断された場合の動作を指定します。可能な値は、ignore、log、failです。
compensate
修正動作を指定します。有効にすると、トランザクションがロールバックしたときに補正ブロックが実行されます。可能な値:無効または有効。デフォルト値は無効です。
connectTimeout
初期接続のタイムアウト(秒単位)。無限のタイムアウトには0(ゼロ)を使用します。
currentLoggedInUserName
現在のログインユーザー名。
dataSizeLimit
テキスト列の最大データサイズを指定します。
dataSource
すべての接続に使用されるデータソースを指定します。
domain
管理の自律性、権限、または制御の領域を定義する識別文字列を指定します。
driver
ODBCドライバーの絶対パス名。
dsn
ODBCDSN名。
enableFastExec
有効な値はtrueとfalseです。デフォルト値はfalseです。
結果は、クエリが送信されるとすぐに処理されて返されます(ラウンドトリップではなく)。これにより、低遅延クエリのパフォーマンスが向上する可能性があります。
enableFlood
値はtrueまたはfalseです。デフォルト値はTrueです。
trueの場合、サーバーは常にデータを送信し、ネットワークバッファーをいっぱいにします。より大きな結果セットに役立ちます。
enableReconnectOnError
クラスタの再接続動作を指定します。
encrypt
Trueの場合、クライアントはODBCドライバーのSSLポートを使用してTDVサーバーに接続します。
fetchBytes
バッチサイズに基づいてバッチに対してフェッチする行の最大数(バイト単位)。 fetchBytesを非常に大きな数に設定すると、サーバーでメモリ不足エラーが発生する可能性があります。 fetchBytesに設定された値は、クライアントとTDVサーバーで使用されるメモリに影響を与えるため、構成されたヒープサイズに基づいて値を設定する必要があります。このプロパティがゼロに設定されている場合は、デフォルト値が使用されます。
fetchRows
バッチ用にフェッチする行の最大数。このプロパティがゼロに設定されている場合は、デフォルト値が使用されます。
host/server
TDVサーバーのホスト名。
ignoreTrailingSpace
値の末尾のスペースは無視してください。値は次のとおりです。
<EMPTY>(デフォルト)-サーバー設定が使用されます
TRUE-末尾のスペースは無視されません
FALSE-末尾のスペースは無視されません
locale
ユーザーの言語と国を定義する値。 TDVでサポートされているエンコード標準のリストについては、セクションTDVでサポートされているエンコード標準を参照してください。
nometadata
クエリの実行中に結果セットのメタデータが返されるのをブロックします。
paramMode
ストアドプロシージャのOUTパラメータの動作を制御します。
通常-プロシージャメタデータのOUTパラメータをOUTパラメータとして報告します。
return:OUTパラメータを戻り値として報告します。
omit-メタデータからOUTパラメータを省略します。
omitCursors-メタデータから出力カーソルを省略します。
password/pwd
Usernameプロパティで指定するユーザー名のパスワードを指定します。これらの値は、データソース接続に使用されます。
pingInterval
TDVからの結果を待機している間にping要求を送信する前に待機する最大時間(秒単位)。
pingTimeoutWindow
TDVサーバーへのpingが失敗した後、JDBCまたはODBCクライアントがTDVサーバーへの接続を閉じる前に待機する時間の長さ。
このパラメーターの値は、「PingInterval」パラメーター以上である必要があります。 TDVサーバーに送信されたpingが失敗した場合、ODBCまたはJDBCクライアントは引き続きpingをTDVに送信して、ステータスを確認します。 TimeoutWindowの期限が切れた後も、これらのクライアントpingが引き続き失敗する場合、ODBCまたはJDBCクライアントはTDVサーバーへの接続を閉じ、メッセージを送信します。 TimeoutWindowの有効期限が切れていない間、ODBCまたはJDBCクライアント接続は開いたままになり、応答を待機しているTDVサーバーにpingを送信し続けます。このプロパティのデフォルトは0です。これは、設定が使用されていないことを意味します。
port
TDVサーバーのリスニングポート。
registerOutputCursors
true-出力カーソルを出力パラメーターとしてバインドまたは登録します。
false-出力カーソルを出力パラメーターとしてバインドまたは登録しないでください。代わりに、SQLMoreResultsを使用してカーソルにアクセスしてください。
requestTimeout
クエリコマンドおよびその他の要求のタイムアウト
セッションタイムアウト
セッションの非アクティブタイムアウト(秒単位)。無限のタイムアウトの場合はゼロに設定します。
singleLogSize
次のログファイルに保存する最大ログファイルサイズ(Mバイト単位)。
spn
Windowsプラットフォームでのみ有効で、UNIXプラットフォームでは役に立ちません。
Kerberos SPN値。SSO値がKerberosと等しい場合にのみ役立ちます。
sso
Windowsプラットフォームでのみ有効で、UNIXプラットフォームでは役に立ちません。シングルサインオンタイプ: ""/(無効)、KerberosまたはNTLM。
デフォルト値は「」です。これにより、ODBCクライアントアプリケーションは接続するためのユーザーとパスワードの情報を提供します。
sslKeyID
Windowsプライベート証明書のサブジェクト(CN)。これは、次の手順を使用して見つけることができます。
1. certmgr.mscプログラムを実行して、Windows証明書マネージャーを開きます。
2. [個人/証明書]で、プライベート証明書をダブルクリックして[証明書]ダイアログを開きます。
3. [詳細]タブをクリックし、[件名]フィールドを選択します。
sslKeyIDフィールドにサブジェクトCN値を入力します。これは、Windowsに指定する必要がある唯一のパラメーターです。
sslKeyCert
SSL接続の公開鍵証明書を含むPEMファイルの絶対パス。 (オプション)
sslKeyFile
SSL接続用の秘密鍵証明書を含むPEMファイルの絶対パス。この秘密鍵は、SSL KeyCertの公開鍵と一致する必要があります。 (オプション)
sslCACert
PEM形式の信頼できるCA証明書を含むPEMファイル。 (オプション)
プロパティsslCACertおよびsslCAPathは、Windowsでは使用しないでください。これは、Windowsのオペレーティングシステムに独自のトラストストアがあるためです。 Windows TrustStoreに非標準のCA証明書(自己署名証明書の例)を追加することをお勧めします。
sslCAPath
PEM形式の信頼できるCAファイルを含むディレクトリの絶対パス。 Linuxプラットフォームでは、デフォルト値は「/etc/ssl/certs」です。 CAパスディレクトリのCAPEMファイル名は、CAPEMファイル名のハッシュ値と同じである必要があります。 (オプション)
Windowsプラットフォームでは、ODBCドライバーがシステムトラストストアからすべてのCA証明書をロードするため、このパラメーターは使用されないことに注意してください。
stripDuplicates
値はtrueまたはfalseです。デフォルト値はfalseです。
trueの場合、サーバーは後続の行で重複するCHAR/VARCHAR列を検出し、ネットワークを介してデータを再送信しません。
これにより、ネットワーク全体でデータを節約できる可能性があります。
stripTrailingZeros
末尾のゼロを削除して小数の結果値を返すかどうかを決定します。
traceFile
トレースファイルへの絶対パス。
traceFolder
トレースファイルを保存するための絶対ディレクトリ。トレースファイル名は「CsOdbcDebug _」+<DSN名>+「。log」です。デフォルトのフォルダはC:\または$COMPOSITE_HOMEです
traceLevel
有効な値は、off、fatal、error(これがデフォルトです)、debug、warn、info、debug2、およびallです。
クライアント側のログ設定の有効な値は、off、fatal、error(default)、warn、info、debug、all、debug2、stdoutです。
UNIXベースのプラットフォームでは、ログファイルCsOdbcDebug.logは、環境変数COMPOSITE_HOMEで指定されたディレクトリに作成されます。
unsupportedMode
有効な値は、サイレント、警告、または失敗です。デフォルト値はfailです。
サイレントに設定すると、サポートされていないメソッドは何もせずに戻ります。警告に設定すると、JDBCドライバーは警告メッセージをログファイルに記録します。そうでない場合、JDBCドライバーは、サポートされていないメソッドに遭遇したときにSQL_ERRORを返します。
user_tokens
配信用にパッケージ化できる認証値。
user/uid
データソースへの接続のユーザー名を指定します。
validateRemoteCert
trueの場合、TDVクライアントはハンドシェイク検証を開始し、TDV証明書を検証して、パスワードの暗号化に使用します。検証が失敗した場合、接続は確立されません。
false(デフォルト)の場合、接続の確立前に証明書の検証は実行されません。
TDVサーバー証明書は、[スタジオの構成]パネルで設定されたトラストストアのファイルの場所からロードされます。キーストアキーエイリアスは、使用するように構成されている場合に使用されます。詳細については、TDV管理ガイドの「TDV構成パラメータ」を参照してください。
TDV ODBCドライバーは、システム証明書ストアを使用して証明書を検証します。 TDVサーバー証明書をこのクライアントトラストストアに追加する必要があります。そうしないと、検証が失敗します。
validateRemoteHostname
trueの場合、ODBCドライバーは、接続文字列内のホストの値を、ターゲットのTDVサーバーから受信した証明書内のサブジェクトCN(共通名)値と比較します。
ホスト名の検証に失敗した場合、接続は確立されません。 false(デフォルト)の場合、ホスト名の検証は実行されません。
authenticationType
認証タイプがBASIC(ユーザー名/パスワードを使用)またはOAUTH2認証(アクセストークンを使用)のどちらであるかを示します。認証トークンを使用する場合は、OAuth2を選択します。
accessToken
OAuth2認証に使用される認証トークン。トークンは特定の形式で表されます-
<ヘッダー>。<ペイロード>。<署名>。
トークンの各部分はJSON形式です。
アクセストークンは、ID/パスワードの資格情報の代わりに使用され、有効期間と特権が制限されます。
accessTokenType
アクセストークンのタイプ。 JWT(JSON Web Token)は、デフォルトでサポートされている形式です。 JWTトークンは自己完結型のJSONフォームであり、フェデレーションに最適です。