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フォームであり、フェデレーションに最適です。 |