Administration Console オンラインヘルプ

[JDBC データソース] --> [コンフィグレーション]

概要

[JDBC データソース｜コンフィグレーション] タブでは、選択したデータソースの属性を指定します。アプリケーションは、JNDI (Java Naming and Directory Interface) ツリー上のデータソースをルックアップし、接続プールからデータベース接続を取得してから、接続を要求します。そのデータソースに関連付けられている接続プールが、アプリケーションに接続を提供します。

タスク

JDBC データソースの作成とコンフィグレーション

JDBC データソースのクローンの作成

サーバまたはクラスタへの JDBC データソースのデプロイメント

属性

表 136-1

属性の表示名	説明	値の制約
[名前]	この JDBC データソースの名前。この名前は、Administration Console およびコンフィグレーションファイル (`config.xml`) で JDBC データソースを示すのに使われる。接続を要求するアプリケーションは、データソースをルックアップする場合、この名前ではなく、JNDI 名を使用する。 MBean: `weblogic.management. configuration. JDBCTxDataSourceMBean` 属性 : `Name`
[JNDI 名]	このトランザクションデータソースのバインド先の JNDI パス。 JNDI パスをルックアップするアプリケーションは、このデータソースに対応する `javax.sql.DataSource` インスタンスを取得する。注意: JDBC を複数の JNDI 名にバインドしている場合のデフォルトの区切り文字はセミコロン ( ; )。セミコロンを JNDI 名の一部として使用する場合には、`config.xml` ファイルにあるデータソースの `JNDINameSeparator` プロパティで、別の文字を区切り文字として指定すること (例 : `JNDINameSeparator=".."`)。 MBean: `weblogic.management. configuration. JDBCTxDataSourceMBean` 属性 : `JNDIName`

属性の表示名

説明

値の制約

[名前]

この JDBC データソースの名前。この名前は、Administration Console およびコンフィグレーションファイル (config.xml) で JDBC データソースを示すのに使われる。接続を要求するアプリケーションは、データソースをルックアップする場合、この名前ではなく、JNDI 名を使用する。

MBean: weblogic.management. configuration. JDBCTxDataSourceMBean

属性 : Name

[JNDI 名]

このトランザクションデータソースのバインド先の JNDI パス。

JNDI パスをルックアップするアプリケーションは、このデータソースに対応する javax.sql.DataSource インスタンスを取得する。

注意: JDBC を複数の JNDI 名にバインドしている場合のデフォルトの区切り文字はセミコロン ( ; )。セミコロンを JNDI 名の一部として使用する場合には、config.xml ファイルにあるデータソースの JNDINameSeparator プロパティで、別の文字を区切り文字として指定すること (例 : JNDINameSeparator="..")。

MBean: weblogic.management. configuration. JDBCTxDataSourceMBean

属性 : JNDIName

詳細オプションの属性

表 136-2

属性の表示名

説明

値の制約

[行のプリフェッチを有効化]

各 ResultSet について、クライアントと WebLogic Server の間での行のプリフェッチを制御する。外部クライアントが JDBC を使用して WebLogic Server 経由でデータベースにアクセスするとき、行のプリフェッチは、1 回のサーバアクセスでサーバからクライアントに複数の行を取り出すのでパフォーマンスが向上する。クライアントと WebLogic Server が同一の JVM 内にある場合は、WebLogic Server はこの設定を無視し、行のプリフェッチを使用しない。

MBean: `weblogic.management. configuration. JDBCTxDataSourceMBean`

属性 : `RowPrefetchEnabled`

デフォルト値 : false

有効な値 :

true

false

[Row Prefetch サイズ]

クライアント用にプリフェッチする結果セットの行数。最適値はクエリの詳細によって異なる。一般に、この数を増やすと、特定の値に達するまでパフォーマンスが向上する。その値に達すると、それ以上数を増やしてもパフォーマンスはそれほど向上しない。100 行以上でパフォーマンスが向上することはめったにない。ほとんどの状況では、デフォルト値で十分なはずである。

MBean: `weblogic.management. configuration. JDBCTxDataSourceMBean`

属性 : `RowPrefetchSize`

最小値 : 2

最大値 : 65536

デフォルト値 : 48

[ストリームチャンクサイズ]

ストリームデータ型のデータチャンクサイズ。`getBinaryStream()` の呼び出し結果などのストリームデータ型は、必要に応じて WebLogic Server からクライアントに StreamChunkSize サイズのチャンクで取得される。

MBean: `weblogic.management. configuration. JDBCTxDataSourceMBean`

属性 : `StreamChunkSize`

単位 : バイト

最小値 : 1

最大値 : 65536

デフォルト値 : 256

[グローバルトランザクションを受け付ける]

データソースがグローバルトランザクションに参加するかどうかを指定する。参加する場合、データソースは `config.xml` ファイル内でトランザクションデータソースとして作成される。

データソースの作成時に、このオプションを選択する (デフォルトでは選択済み)。データソースの作成後に、この設定を変更することはできない。

デフォルト値 : true

[非 XA ドライバ用に 2 フェーズコミットをエミュレート]

true に設定すると、非 XA JDBC ドライバで、JTA を使用した分散トランザクションへの参加をエミュレートできる。

このオプションは、トランザクションに参加するリソースが JDBC 接続のみであり、XA 対応の JDBC ドライバが存在しない場合に使用する。トランザクションに参加するリソースが複数存在し、それらの JDBC ドライバの 1 つが XA リソースをエミュレートする場合、ヒューリスティックエラーが発生するおそれがある。2 フェーズコミットのエミュレーションを参照。

データソースが XA 接続プールに関連付けられているか、または分散トランザクションに参加しているリソースが 1 つのみの場合、この設定は無視される。

注意: このオプションは、[グローバルトランザクションを受け付ける] が選択されている場合のみ有効。

MBean: `weblogic.management. configuration. JDBCTxDataSourceMBean`

属性 : `EnableTwoPhaseCommit`

デフォルト値 : false

有効な値 :

true

false

属性の表示名	説明	値の制約
[行のプリフェッチを有効化]	各 ResultSet について、クライアントと WebLogic Server の間での行のプリフェッチを制御する。外部クライアントが JDBC を使用して WebLogic Server 経由でデータベースにアクセスするとき、行のプリフェッチは、1 回のサーバアクセスでサーバからクライアントに複数の行を取り出すのでパフォーマンスが向上する。クライアントと WebLogic Server が同一の JVM 内にある場合は、WebLogic Server はこの設定を無視し、行のプリフェッチを使用しない。 MBean: `weblogic.management. configuration. JDBCTxDataSourceMBean` 属性 : `RowPrefetchEnabled`	デフォルト値 : false 有効な値 : true false
[Row Prefetch サイズ]	クライアント用にプリフェッチする結果セットの行数。最適値はクエリの詳細によって異なる。一般に、この数を増やすと、特定の値に達するまでパフォーマンスが向上する。その値に達すると、それ以上数を増やしてもパフォーマンスはそれほど向上しない。100 行以上でパフォーマンスが向上することはめったにない。ほとんどの状況では、デフォルト値で十分なはずである。 MBean: `weblogic.management. configuration. JDBCTxDataSourceMBean` 属性 : `RowPrefetchSize`	最小値 : 2 最大値 : 65536 デフォルト値 : 48
[ストリームチャンクサイズ]	ストリームデータ型のデータチャンクサイズ。`getBinaryStream()` の呼び出し結果などのストリームデータ型は、必要に応じて WebLogic Server からクライアントに StreamChunkSize サイズのチャンクで取得される。 MBean: `weblogic.management. configuration. JDBCTxDataSourceMBean` 属性 : `StreamChunkSize`	単位 : バイト最小値 : 1 最大値 : 65536 デフォルト値 : 256
[グローバルトランザクションを受け付ける]	データソースがグローバルトランザクションに参加するかどうかを指定する。参加する場合、データソースは `config.xml` ファイル内でトランザクションデータソースとして作成される。データソースの作成時に、このオプションを選択する (デフォルトでは選択済み)。データソースの作成後に、この設定を変更することはできない。	デフォルト値 : true
[非 XA ドライバ用に 2 フェーズコミットをエミュレート]	true に設定すると、非 XA JDBC ドライバで、JTA を使用した分散トランザクションへの参加をエミュレートできる。このオプションは、トランザクションに参加するリソースが JDBC 接続のみであり、XA 対応の JDBC ドライバが存在しない場合に使用する。トランザクションに参加するリソースが複数存在し、それらの JDBC ドライバの 1 つが XA リソースをエミュレートする場合、ヒューリスティックエラーが発生するおそれがある。2 フェーズコミットのエミュレーションを参照。データソースが XA 接続プールに関連付けられているか、または分散トランザクションに参加しているリソースが 1 つのみの場合、この設定は無視される。注意: このオプションは、[グローバルトランザクションを受け付ける] が選択されている場合のみ有効。 MBean: `weblogic.management. configuration. JDBCTxDataSourceMBean` 属性 : `EnableTwoPhaseCommit`	デフォルト値 : false 有効な値 : true false

[JDBC データ ソース] --> [コンフィグレーション]

概要

タスク

関連トピック

属性

[JDBC データソース] --> [コンフィグレーション]