2.2.2.2. URL 接続プロパティー

以下の表は、Data Virtualization JDBC Driver URL 接続文字列または Data Virtualization JDBC Data Source クラスで使用できるすべての接続プロパティーを示しています。

表2.1 Connection Properties

プロパティー名タイプ説明

ApplicationName

文字列

クライアントアプリケーションの名前。管理者が接続を特定できるようにします。

FetchSize

int

結果セットのサイズです。500.gitops0 の場合はデフォルトのサイズで、デフォルトが使用されることを示します。

partialResultsMode

boolean

部分的な結果モードを有効/無効にします。デフォルト: falsePartial Results Mode セクションを参照してください。

autoCommitTxn

文字列

"autoCommit" が "true" に設定されている場合にのみ該当します。データの整合性を維持するために、実行されたコマンドを Data Virtualization エンジン内でトランザクション的にラップする方法を決定します。

  • ON: 常に分散トランザクションでコマンドをラップします。
  • OFF - 分散トランザクションでコマンドをラップしません。
  • DETECT(デフォルト)- 実行したコマンドが複数のソースにまたがる場合は、分散トランザクションを自動的に使用します。詳細のトランザクション

disableLocalTxn

boolean

"true" の場合は、ローカルトランザクションで autoCommit 設定、commit、および rollback は無視されます。デフォルト: false

user

文字列

ユーザー名

パスワード

文字列

ユーザーの認証情報

ansiQuotedIdentifiers

boolean

SQL の二重引用符で囲んだエントリーの解析動作を設定します。デフォルトは true で、引用符付きのエントリーを識別子として解析します。false に設定すると、有効な文字列リテラルである引用符で囲まれた値が文字列リテラルとして解析されます。

version

integer

VDB のバージョン番号

resultSetCacheMode

boolean

ResultSet キャッシュはオン/オフになっています。デフォルト: false

autoFailover

boolean

true の場合、通信例外後に新しいサーバーインスタンスが自動的に選択されます。デフォルト: false接続をプールからパージできるため、通常は接続を管理する場合には必要ありません。埋め込みモードで true の場合、接続は同じ名前/バージョンの新しい VDB に再接続します。

SHOWPLAN

文字列

(通常は接続プロパティーとして設定されていません)ON、OFF,DEBUG;

  • ON は、クエリー計画と結果を返します。
  • DEBUG はクエリープランナーのデバッグ情報をログに出力し、結果と共に返します。プランとログはどちらも JDBC API エクステンションで利用できます。
  • デフォルトは OFF です。

NoExec

文字列

(通常は接続プロパティーとして設定されていません)は ON、OFF、ON はクエリーの実行を防ぎますが、解析と計画は引き続き発生します。デフォルトは OFF です。

PassthroughAuthentication

boolean

「ローカル」接続にのみ適用されます。このオプションを「true」に設定すると、Data Virtualization は呼び出し元スレッドですでに認証されたセキュリティーコンテキストを検索します。見つかった場合は、そのユーザー認証情報を使用してセッションを作成します。また、データ仮想化は、接続のライフサイクル中に同じユーザーがこの接続を使用していることも確認します。呼び出しスレッドで異なるセキュリティーコンテキストを見つけた場合は、新規ユーザーが Data Virtualization にログインすることができるにも拘らず、接続上のアイデンティティーを切り替えます。

useCallingThread

boolean

「ローカル」接続にのみ適用されます。このオプションが「true」に設定されている場合(デフォルト)、呼び出しスレッドを使用してクエリーを処理します。false の場合、エンジンスレッドが使用されます。

QueryTimeout

integer

デフォルトのクエリータイムアウト(秒単位)。0 でなければなりません。0 はタイムアウトなしであることを示します。Statement.setQueryTimeout で上書きできます。デフォルトは 0 です。

useJDBC4ColumnNameAndLabelSemantics

boolean

JDBC4 で変更され、エイリアスのない列名を ResultSetMetadata 列名として返すようになりました。この前に、列エイリアスを使用して列名が返されていました。このプロパティーを false に設定すると、JDBC3 以前との後方互換性が可能になります。デフォルトは true です。

jaasName

文字列

JAAS 設定名。GSS 認証を設定する場合にのみ適用されます。デフォルトは Data Virtualization です。GSS に必要な設定については、『セキュリティーガイド』を参照してください。

kerberosServicePrincipleName

文字列

Kerberos で認証された原則の名前。GSS 認証を設定する場合にのみ適用されます。GSS に必要な設定については、『セキュリティーガイド』を参照してください。

encryptRequest

boolean

SSL ソケット接続のみに適用されます。  「true」の場合、要求メッセージとすべての関連付けペイロードは、接続暗号ャーを使用して暗号化されます。  デフォルト: false

disableResultSetFetchSize

boolean

場合によっては、ツールによっては、結果の処理に望ましくないフェッチサイズを選択する場合があります。ResultSet.setFetchSize を許可する場合は true に設定します。デフォルト: false

loginTimeout

integer

ログインのタイムアウト(秒単位)。0 でなければなりません。0 は特定のタイムアウトなしを示しますが、他のタイムアウトが適用される可能性があります。接続をほぼ作成できない場合、タイムアウト値は例外が発生します。デフォルトの 0 は、ログインが永久に待機されることを意味するものではありません。通常、アクティブな vdb で、その時点でログインに失敗します。ただし、vdb バージョンを指定するローカル接続は、デフォルトで org.teiid.clientVdbLoadTimeoutMillis まで待機できます。

reportAsViews

boolean

DatabaseMetaData が Data Virtualization ビューを VIEW テーブルタイプとして報告する場合。false の場合、Data Virtualization ビューが TABLE として報告されます。デフォルトは true です。