Administration Console オンラインヘルプ

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

概要

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

タスク

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

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

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

属性

表 129-1

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

属性の表示名

説明

値の制約

[名前]

このコンフィグレーションの名前。WebLogic Server では、MBean を使用してコンフィグレーションを実装および保持する。

MBean: weblogic.management. configuration. JDBCDataSourceMBean

属性 : Name

[JNDI 名]

このデータソースのバインド先の JNDI パス。

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

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

MBean: weblogic.management. configuration. JDBCDataSourceMBean

属性 : JNDIName

[プール名]

このデータソースで使用する JDBC 接続プール。

MBean: weblogic.management. configuration. JDBCDataSourceMBean

属性 : JDBCPoolName

詳細オプションの属性

表 129-2

属性の表示名

説明

値の制約

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

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

MBean: `weblogic.management. configuration. JDBCDataSourceMBean`

属性 : `RowPrefetchEnabled`

デフォルト値 : false

有効な値 :

true

false

[Row Prefetch サイズ]

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

MBean: `weblogic.management. configuration. JDBCDataSourceMBean`

属性 : `RowPrefetchSize`

最小値 : 2

最大値 : 65536

デフォルト値 : 48

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

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

MBean: `weblogic.management. configuration. JDBCDataSourceMBean`

属性 : `StreamChunkSize`

単位 : バイト

最小値 : 1

最大値 : 65536

デフォルト値 : 256

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

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

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

デフォルト値 : true

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

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

概要

タスク

関連トピック

属性

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