クライアントインターフェイスガイド > JDBC経由でのTDVサーバーへの接続 > 接続URLを使用したJDBCクライアントの定義 > JDBCドライバー接続URLのプロパティ
 
JDBCドライバー接続のURLプロパティ
この表は、JDBC接続URLで指定できるプロパティの名前を示しています。
NAMEまたはVALUE内の英数字以外の文字は、URLエンコードする必要があります。
JDBCプロパティ名
説明
Alternativesecuritycredentials
現在のセッション内のIDの代替セキュリティプロパティ値を指定します。これは、ユーザーがセキュリティプロパティをデータソースに渡すことができるようにするために使用されます。
:同じセッションで複数のリクエストが行われた場合、または複数のIDが同じセッションにアクセスした場合、予期しない結果が生じる可能性があります。
caseSensitive
要求値で大文字と小文字の区別を指定します。デフォルト(false)では、要求は大文字と小文字を区別しません。
commitFailure
コミットが失敗した場合の動作、可能な値:rollbackまたはbestEffort。
commitInterrupt
コミットが中断された場合の動作を指定します。可能な値は、ignore、log、failです。
compensate
有効にすると、トランザクションがロールバックしたときに補正ブロックが実行されます。可能な値:無効または有効。デフォルト値は無効です。
connectTimeout
初期接続のタイムアウト(秒単位)。無限のタイムアウトには0(ゼロ)を使用します。
convertToLocalTimezone
デフォルト値(false)に設定すると、クライアントは、クライアントのローカルタイムゾーンに変換せずに、公開されたデータソースから直接TIMESTAMP値を受け取ります。データソースの値にTIMESTAMPに関連付けられたタイムゾーンがある場合、その値は保持されます。
trueに設定すると、TIMESTAMP値はクライアントのタイムゾーンに変換されます(以前のリリースのTDVのように)。
disableClustering
デフォルト値(false)に設定すると、クラスター内の個々のTDVインスタンスのシステムテーブルからのデータビューが有効になります。
enableTDVConnectionPool
デフォルトでは、このプロパティの値はfalseに設定されています。 trueに設定すると、ドライバーはTDVサーバーへの接続がプールされる以前の動作に戻ります。
enableTDVTimestamp
ホストサーバーの現在のタイムゾーンまたはDST設定に関係なく、正しい時間値を取得するには、JDBCドライバーでこのプロパティを設定します。このプロパティが有効になっている場合:
ResultSet.getObject()は、タイムスタンプが変更されていないjava.sql.Timestampのカスタム子クラスを返します。
ResultSet.getTime()は、時間(時、分、秒)が変更されていないjava.sql.Timeオブジェクトを返しますが、エポックからの時間は変更されます。
ResultSet.getString()は、変更されていないタイムスタンプテキストを返します。
ResultSet.getTimestamp()は、このプロパティの値に関係なく、タイムスタンプが変更されたjava.sql.Timestampを返します。
<xs:schema> <xs:annotation> <xs:appinfo> <osd:replication> <name>ProductRef</name> <dataSpace>ProductReference</dataSpace> <dataSet>productCatalog</dataSet> <refresh>onCommit</refresh> <table> <path>/root/domain1/tableA</path> <nameInDatabase>PRODUCT_REF_A</nameInDatabase> </table> <table> <path>/root/domain1/tableB</path> <nameInDatabase>PRODUCT_REF_B</nameInDatabase> <element> <path>/retailers</path> <nameInDatabase>PRODUCT_REF_B_RETAILERS</nameInDatabase> </element> </table> </osd:replication> </xs:appinfo> </xs:annotation> ... </xs:schema>
1)このJDBCプロパティは、現在の時刻設定で夏時間(DST)に合わせて時計を自動的に調整できる場合にのみ必要であり、データベースのタイムスタンプはDST移行時刻です(たとえば、2010-03-14 02:00:00から)。 to 2010-03-14 02:59:59)。
2)このJDBCプロパティは、クラスResultSetのgetObject()、getTime()、およびgetString()にのみ影響します。
enableFastExec
値はtrueまたはfalseであり、デフォルト値はfalseです。
結果は、クエリが送信されるとすぐに処理されて返されます(ラウンドトリップではなく)。これにより、低遅延クエリのパフォーマンスが向上する可能性があります。
enableFlood
値はtrueまたはfalseです。デフォルト値はtrueです。
trueの場合、サーバーは常にデータを送信し、ネットワークバッファーをいっぱいにします。より大きな結果セットに役立ちます。
enableReconnectOnError
クラスタの再接続動作を指定します。
encrypt
trueに設定すると、TDVSSL証明書で処理するためにJDBCメッセージをSSLポートに自動的に渡します。 TDVユーザーガイド「Webサービスセキュリティ」を参照してください。
fetchBytes
バッチサイズに基づいてバッチに対してフェッチする行の最大数(バイト単位)。 fetchBytesを非常に大きな数に設定すると、サーバーでメモリ不足エラーが発生する可能性があります。 fetchBytesに設定された値は、JDBCクライアントとTDVサーバーで使用されるメモリに影響を与えるため、構成されたヒープサイズに基づいて値を設定する必要があります。
fetchRows
バッチ用にフェッチする行の最大数。無制限の行数を返すには、ゼロに設定します。
ignoreTrailingSpace
値の末尾のスペースは無視してください。デフォルト:false。
kerberos.krb5.conf
krb5.confファイルへのパス。
locale
ユーザーの言語と国を定義する値。
nometadata
クエリの実行中に結果セットのメタデータが返されるのをブロックします。
paramMode
ストアドプロシージャのOUTパラメータの動作を制御します。
通常-プロシージャメタデータのOUTパラメータをOUTパラメータとして報告します。
return:OUTパラメータを戻り値として報告します。
omit-メタデータからOUTパラメータを省略します。
omitCursors-メタデータから出力カーソルを省略します。
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」です。これは、設定が使用されていないことを意味します。設定されていない場合は、代わりにセッションタイムアウトまたは要求タイムアウトが使用されます。
registerOutputCursors
true-出力カーソルを出力パラメーターとしてバインドまたは登録します。
false-出力カーソルを出力パラメーターとしてバインドまたは登録しないでください。代わりに、SQLMoreResultsまたはStatement.getMoreResults()を使用してカーソルにアクセスします。 プロシージャの呼び出し例を参照してください。
requestTimeout
クエリコマンドおよびその他の要求のタイムアウト。
sessionTimeout
セッションの非アクティブタイムアウト(秒単位)。無限のタイムアウトの場合はゼロに設定します。
sessionToken
クライアント制限付きライセンスでTDVを使用する場合、JDBCURLを使用してクライアント認証のセッショントークン値を設定します。
例:&sessionToken=<VALUE>
singleLogSize
次のログファイルに保存する最大ログファイルサイズ(Mバイト単位)。
stripDuplicates
値はtrueまたはfalseです。デフォルト値はfalseです。
trueの場合、サーバーは後続の行で重複するCHAR/VARCHAR列を検出し、ネットワークを介してデータを再送信しません。
これにより、ネットワーク全体でデータを節約できる可能性があります。
stripTrailingZeros
末尾のゼロを削除して小数の結果値を返すかどうかを決定します。
traceLevel
有効な値は、off、fatal、error(これがデフォルトです)、debug、warn、info、debug、およびallです。
クライアント側のログ設定の有効な値は、off、fatal、error(default)、warn、info、debug、all、stdoutです。
UNIXベースのプラットフォームでは、ログファイルCsOdbcDebug.logは、環境変数COMPOSITE_HOMEで指定されたディレクトリに作成されます。
unsupportedMode
有効な値は、サイレント、警告、または失敗です。デフォルト値はfailです。
サイレントに設定すると、サポートされていないメソッドは何もせずに戻ります。警告に設定すると、JDBCドライバーは警告メッセージをログファイルに記録します。そうでない場合、JDBCドライバーは、サポートされていないメソッドに遭遇したときにSQL_ERRORを返します。 サポートされていないJDBCメソッドを参照してください。
user_tokens
配信用にパッケージ化できる認証値。 URLは、initコマンドでuser_tokensプロパティをサーバーに次の形式で渡すことができます。
"user_tokens=(" NAME "=" VALUE( "、" NAME "=" VALUE)* ")"
validateRemoteCert
False(デフォルト):接続を確立する前に証明書の検証は実行されません。また、デフォルトでは、プレースホルダー証明書がインストールされています。 csjdbc.jarは、クライアントシステムのトラストストアが存在して構成されていない限り、検証にデフォルトのバンドルされたトラストストアを使用します。
True:TDV JDBCクライアントは、パスワード暗号化にTDV証明書を使用して、検証ハンドシェイクを開始します。検証が失敗した場合、接続は確立されません。
TDVサーバー証明書は、Truststore File Location構成パラメーターで指定されたファイルからロードされます。
キーストアキーエイリアスは、構成時に使用されます。
TDV JDBCクライアントドライバは、クライアントシステムのトラストストアプロパティを使用して証明書を検証します。
javax.net.ssl.trustStore
javax.net.ssl.trustStorePassword
javax.net.ssl.trustStoreType
TDVサーバー証明書をこのクライアントのトラストストアに追加する必要があります。そうしないと、検証が失敗します。
プレースホルダーTDV証明書は、クライアントシステムのトラストストアが有効になった後は、クライアントのトラストストアに追加されない限り機能しません。
validateRemoteHostname
False(デフォルト):ホスト名の検証は実行されません。
True:csjdbc.jarは、JDBC URLのホストの値を、ターゲットのTDVサーバーから受信した証明書のサブジェクトCN(共通名)の値と比較します。
ホスト名の検証に失敗した場合、接続は確立されません。
AccessToken
OAuth2認証に使用される認証トークン。トークンは特定の形式で表されます-
<ヘッダー>。<ペイロード>。<署名>。
トークンの各部分はJSON形式です。
アクセストークンは、ID/パスワードの資格情報の代わりに使用され、有効期間と特権が制限されます。
AccessTokenType
AccessTokenのタイプ。 JWT(JSON Web Token)は、デフォルトでサポートされている形式です。 JWTトークンは自己完結型のJSONフォームであり、フェデレーションに最適です。