![]() ![]() ![]() ![]() |
以下の節では、DB2 用の BEA WebLogic Type 4 JDBC ドライバのコンフィグレーション方法と使用方法について説明します。
DB2 用の BEA WebLogic Type 4 JDBC ドライバ (「DB2 ドライバ」) は次のバージョンをサポートします。
注意 : | このドキュメントでは、DB2 の各バージョンを以下のように表記します。 |
BEA WebLogic Type 4 JDBC DB2 ドライバのドライバ クラスは次のとおりです。
XA : weblogic.jdbcx.db2.DB2DataSource
非 XA : weblogic.jdbc.db2.DB2Driver
WebLogic Server ドメインに JDBC データ ソースをコンフィグレーションする場合に、これらのドライバ クラスを使用します。
DB2 データベースに接続するには、以下の適切な形式の URL を使用します。
表 3-1 では、DB2 ドライバでサポートされる JDBC 接続プロパティを示し、各プロパティについて説明します。WebLogic Server ドメインの JDBC データ ソースのコンフィグレーションでこれらの接続プロパティを使用できます。
注意 : | すべての接続プロパティ名で大文字と小文字は区別されません。たとえば、Password は password と同じです。必須のプロパティかどうかが記載されています。各接続プロパティで示されているデータ型は、JDBC データ ソースのプロパティ値に使用される Java データ型です。 |
プロパティを指定するには、JDBC データ ソースのコンフィグレーションで次の形式を使用します。
|
|||
|
|||
|
|||
|
|||
|
|||
以下に示す DB2 ドライバの接続プロパティを設定すると、アプリケーションのパフォーマンスを向上させることができます。
DatabaseMetaData.getColumns
メソッドは、テーブルに関連付けられたシノニムやエリアスなど、テーブルに関する特性を判別するためによく使用されます。アプリケーションが Linux/UNIX/Windows 上の DB2 v7.1 または v7.2、z/OS 上の DB2、または iSeries 上の DB2 にアクセスしていて、データベース テーブルのシノニムを使用していない場合は、この情報を無視することでパフォーマンスを向上させることができます。Linux/UNIX/Windows 上の DB2 v8.1 および v8.2 にアクセスしている場合は、ドライバは DatabaseMetaData.getColumns()
メソッドに対して常にシノニムを返します。
パフォーマンスを向上させるため、システム カタログ テーブルのビューをデフォルト以外のカタログ スキーマで作成できます。このプロパティが、ビューを含むスキーマの名前に設定されている場合、DB2 ドライバはカタログ テーブルのビューにアクセスできます。デフォルトのカタログ スキーマは、Linux/UNIX/Windows 上の DB2 の場合は SYSCAT、z/OS 上の DB2 の場合は SYSIBM、iSeries 上の DB2 の場合は QSYS2 です。
カタログ メソッドを正しく機能させるには、特定のカタログ テーブルのビューが指定したスキーマに存在している必要があります。必要となるビューは、使用している DB2 データベースによって異なります。指定されたスキーマに存在している必要があるカタログ テーブルのビューの詳細については、「カタログ メソッドに対するデフォルト以外のスキーマの使用」を参照してください。
スクロールインセンシティブな結果セットを使用する場合のパフォーマンスを向上させるため、ドライバは結果セット データをディスクに書き込む代わりに、メモリにキャッシュできます。デフォルトでは、ドライバはインセンシティブな結果セット データを 2 MB までメモリにキャッシュし、残りの結果セット データをディスクに書き込みます。パフォーマンスを向上させるには、ドライバがデータをディスクに書き込む前に使用するメモリの量を増やすか、ドライバがインセンシティブな結果セット データをディスクに書き込めないようにします。最大キャッシュ サイズの設定は 2 GB です。
ドライバがアプリケーション サーバの内部で実行されない場合、または独自のプリペアド ステートメント プールを提供しない別のアプリケーションの内部で実行されるのでない場合は、パフォーマンスを向上させるため、ドライバ独自の内部的なプリペアド ステートメント プールを有効にする必要があります。ドライバの内部的なプリペアド ステートメント プールを有効にすると、ドライバはアプリケーションによって作成された一定数のプリペアド ステートメントをキャッシュします。たとえば、MaxPooledStatements
が 20 に設定されている場合、ドライバはアプリケーションによって作成された最近の 20 個のプリペアド ステートメントをキャッシュします。このプロパティの値に設定された値が、アプリケーションが使用するプリペアド ステートメントの数より大きい場合は、すべてのプリペアド ステートメントがキャッシュされます。
デフォルトでは、ResultSetMetaData.getTableName()
メソッドが呼び出された場合、DB2 ドライバは、結果セット内の各カラムの正しいテーブル名を返すために必要な追加の処理を省略します。このため、getTableName()
メソッドは結果セット内のカラムごとに空の文字列を返す可能性があります。アプリケーションでテーブル名情報が必要ない場合は、この設定によって最適なパフォーマンスが得られます。
ResultSet メタデータを返す方法の詳細については、「ResultSet メタデータのサポート」を参照してください。
挿入または更新する大きなバイナリ オブジェクトが Blob として格納される場合は、バイナリ ストリームを Blob データとして送信すると、パフォーマンスを向上させることができます。その場合、このプロパティは true に設定してください。
アプリケーションで使用される SQL 文に改行文字が含まれていないことがわかっている場合は、改行文字の削除に必要な解析を省略することで、ドライバのパフォーマンスを向上させることができます。その場合は、StripNewlines
プロパティを false に設定してください。
アプリケーションが現在のユーザのみに所有されているテーブルおよびビューにアクセスする必要がある場合は、このプロパティを true に設定することでアプリケーションのパフォーマンスを向上させることができます。このプロパティを true に設定した場合、getTables()
および getColumns()
メソッドを実行すると、ドライバは現在のユーザのみに所有されているテーブルおよびビューを返します。このプロパティを true に設定することは、getTables()
または getColumns()
の呼び出しの schemaPattern
引数として、接続で使用されているユーザ ID を渡すことと同じになります。
AS/400 上で動作する DB2 データベースに接続する場合、locationName プロパティを設定する必要があります。
WRKRDBDIRE
コマンドを実行して、「Relational Database」の値を取得します。,Relational,,Remote,Option,,Database,,Location,,Text,
, ,, , ,,S10B757B,,*LOCAL ,, ,
Properties
オブジェクトを設定します (「DB2 接続プロパティ」を参照)。Driver.connect()
に、パラメータとして次の文字列と Properties オブジェクトを指定します。 jdbc:bea:db2://<Host>:<Port>;LocationName=RelationalDatabaseName
この例では、RelationalDatabaseName
は WRKRDBDIRE
コマンドを実行した結果として取得された Database
の値です。
...
Properties props = new Properties();
props.put("user", user);
props.put("password", password);
...
myDriver = (Driver)Class.forName("weblogic.jdbc.db2.DB2Driver").newInstance();
conn = myDriver.connect("jdbc:bea:db2://10.1.4.1:446;LocationName=S10B757B", props);
stmt = conn.createStatement();
stmt.execute("select * from MYDATABASE.MYTABLE");
rs = stmt.getResultSet();
...
DB2 パッケージは、プログラムの準備中に生成され、SQL 文の実行に使用される DB2 サーバ上の制御構造です。DB2 ドライバは接続時に必要なすべての DB2 パッケージを自動的に作成します。パッケージがすでに存在する場合、ドライバは既存のパッケージを使用して接続を確立します。
注意 : | 接続用に作成する必要のあるパッケージの数やサイズによっては、初期接続に 2、3 分かかる場合があります。以降の接続ではこの遅延は発生しません。 |
デフォルトでは、DB2 ドライバによって作成される DB2 パッケージには 200 の動的セクションが含まれており、NULLID コレクション (またはライブラリ) の中に作成されます。ほとんどの場合、DB2 ドライバが接続時に自動的に作成するため、DB2 パッケージを作成する必要はありません。必要な場合は、次のいずれかの方法で DB2 パッケージを作成できます。
dbping
ユーティリティを使用して、手動で DB2 ドライバにパッケージを作成させる。「dbping を使用して DB2 パッケージを作成する」を参照してください。注意 : | ユーザ ID にデータベースに対する CREATE PACKAGE 特権がなければなりません。ない場合は、データベース管理者が代わりにパッケージを作成する必要があります。 |
注意 : | JDBC データ ソースのコンフィグレーションに示されたユーザ ID はパッケージのオーナーでなければなりません。 |
注意 : | DB2 パッケージを作成する際のユーザ ID には、データベースに対する BINDADD 特権が付与されている必要があります。適切な特権が付与されているかどうか不明な場合は、データベース管理者に問い合わせてください。 |
WebLogic Type 4 JDBC DB2 ドライバで DB2 サーバ上にパッケージを作成するには、WebLogic Server dbping
ユーティリティを使用できます。dbping
ユーティリティは、JDBC ドライバを介したクライアント マシンおよび DBMS 間の接続のテストに使用されます。WebLogic Type 4 JDBC DB2 ドライバは DB2 パッケージがまだ存在しない場合は自動的に作成するため、このユーティリティを実行すると DB2 サーバ上にデフォルトの DB2 パッケージが作成されます。
dbping
ユーティリティを使用した DB2 パッケージの作成の詳細については、「dbping を使用して DB2 パッケージを作成する」を参照してください。
初期接続 URL 内に特定の接続プロパティを設定すると、DB2 パッケージを自動的に作成できます。表 3-2 に、DB2 パッケージを作成する場合に初期接続 URL で使用する接続プロパティを示します。
注意 : | WebLogic Server JDBC データ ソースでは、データ ソースのすべての接続が同じ URL と接続プロパティを使用するため、この方法の使用はお勧めしません。複数の接続を持つ JDBC データ ソースを作成すると、データベース接続が作成されるたびにパッケージが再作成されます。 |
CreateDefaultPackage=TRUE
を使用するとデフォルトの名前のパッケージが作成されます。CreateDefaultPackage=TRUE
を使用して、CollectionId を指定しない場合、NULLID CollectionId が作成されます。
注意 : | Linux/UNIX/Windows 上の DB2 で新しい DB2 パッケージを作成するには、ReplacePackage=true を CreateDefaultPackage=true と一緒に使用する必要があります。DB2 パッケージがすでに存在する場合は、ReplacePackage=true の場合にそのパッケージは置き換えられます。 |
次の URL では、400 の動的セクションを持つ DB2 パッケージが作成されます。DB2 パッケージがすでに存在している場合は、新しく作成したパッケージで置き換えられます。
jdbc:bea:db2://server1:50000;DatabaseName=SAMPLE;
CreateDefaultPackage=TRUE;ReplacePackage=TRUE;DynamicSections=400
次の URL では、400 の動的セクションを持つ DB2 パッケージが作成されます。
jdbc:bea:db2://server1:50000;LocationName=SAMPLE;
CreateDefaultPackage=TRUE;DynamicSections=400
動的セクションは実在する実行可能オブジェクトで、動的 SQL リクエストに応答するために必要なロジックが含まれています。これらのセクションは、ハンドルやプリペアド ステートメント、およびそれに関連付けられた結果セットで使用します。
場合によっては、デフォルトの数 (200) より多くの動的セクションを持つ DB2 パッケージを作成する必要があります。アプリケーションで多数の動的セクションを持つ DB2 パッケージが必要な場合は、次の情報を考慮してください。
PCKCACHE_SZ
を増やして、多数のパッケージを作成できるようにした方がよい場合があります。
表 3-3 に、DB2 ドライバでサポートされるデータ型と、それらが JDBC データ型へどのようにマップされるかを示します。
|
データ型の詳細については、「getTypeInfo」を参照してください。
CatalogSchema
プロパティがデフォルト以外のスキーマに設定されている場合に、カタログ メソッドが適切に機能するためには、表 3-4 に示すカタログ テーブルのビューが、指定されたスキーマに存在している必要があります。必要となるビューは、使用している DB2 データベースによって異なります。
DB2 ドライバでサポートされている SQL エスケープ シーケンスについては、「JDBC の SQL エスケープ シーケンス」を参照してください。
DB2 ドライバでサポートされるアイソレーション レベルを表 3-5 に示します。JDBC アイソレーション レベルは、表に示す適切な DB2 トランザクション アイソレーション レベルにマップされています。デフォルトのアイソレーション レベルは Read Committed
です。
DB2 ドライバは、スクロールインセンシティブな結果セット、および更新可能な結果セットをサポートしています。
注意 : | DB2 ドライバが、要求された結果セットのタイプまたは同時実行性をサポートできない場合は、カーソルを自動的にダウングレードして詳細情報の入った SQLWarning を生成します。 |
DB2 ドライバで JTA を介して分散トランザクションを使用するには、Linux/UNIX/Windows 上の DB2 v8.1 または v8.2 が必要です。
Blob の取得および更新は、DB2 ドライバと以下のデータベースでサポートされます。
Clob の取得および更新は、DB2 ドライバとサポート対象のすべての DB2 データベースでサポートされます。DB2 ドライバは以下の DB2 データベースで、最大 2 GB の Clob をサポートします。
上記以外のサポート対象の DB2 データベースの場合、DB2 ドライバは最大 32KB の Clob の取得および更新をサポートします。
DBClob の取得および更新は、DB2 ドライバと以下のデータベースでサポートされます。
Linux/UNIX/Windows 上の DB2 v8.1 および v8.2、z/OS 上の DB2、および iSeries 上の DB2 において、DB2 ドライバは DB2 のネイティブ バッチ メカニズムを使用します。デフォルトでは、PreparedStatement を使用して実行されるバッチ処理のパラメータ値を設定するのに使用するメソッドは、パラメータが関連付けられるカラムのデータベース データ型に一致する必要があります。
DB2 サーバでは暗黙的なデータ変換を実行しないため、カラムのデータ型に一致しないパラメータ値を指定すると、DB2 サーバはエラーを生成します。たとえば、ストリームまたは配列の長さが 32KB 未満の場合にそのストリームまたはバイト配列を使用して Blob パラメータの値を設定するには、setObject()
メソッドを使用し、対象の JDBC 型を BLOB として指定する必要があります。setBinaryStream()
または setBytes()
メソッドは使用できません。
メソッド タイプの制限を削除するには、BatchPerformanceWorkaround
プロパティを true に設定します。たとえば、setBinaryStream()
または setBytes()
メソッドを使用すると、ストリームや配列の長さに関係なく Blob パラメータの値を設定できます。ただし、パラメータの設定は指定された順序で実行されない場合もあります。
注意 : | Administration Console でデータ ソースを作成する場合、Administration Console では BatchPeformanceWorkaround 接続プロパティが、デフォルトで true に設定されます。 |
注意 : | DB2 用の WebLogic Type 4 JDBC ドライバを使用し、JMS JDBC ストアとして使用されるデータ ソースの場合は、BatchPerformanceWorkaround プロパティを true に設定する必要がある。 |
DB2 ドライバでは、この節で説明するようにパラメータ メタデータを返すことができます。
DB2 ドライバは、以下の DB2 データベースで、あらゆるタイプの SQL 文のパラメータ メタデータを返すことができます。
これ以外にサポートされる DB2 データベースの場合、DB2 ドライバは、以下の形式の Insert 文および Update 文のパラメータ メタデータを返すことができます。
ここで、operator
は SQL 演算子 (=、<、>、<=、>=、または <>) です。
DB2 ドライバは、以下の DB2 データベースで、あらゆるタイプの SQL 文のパラメータ メタデータを返すことができます。
これ以外にサポートされる DB2 データベースの場合、DB2 ドライバは、ANSI SQL 92 エントリレベルの述語 (比較、BETWEEN、IN、LIKE、EXISTS などの述語構文) にパラメータを含んでいる Select 文に対してパラメータ メタデータを返すことができます。詳細な構文については、ANSI SQL リファレンスを参照してください。
以下のいずれかの条件に該当する場合は、Select 文に対してパラメータ メタデータを返すことができます。
以下の Select 文では、パラメータ メタデータを返すことができる例をさらに示しています。
SELECT col1, col2 FROM foo WHERE col1 = ? and col2 > ?
SELECT ... WHERE colname = (SELECT col2 FROM t2
WHERE col3 = ?)
SELECT ... WHERE colname LIKE ?
SELECT ... WHERE colname BETWEEN ? and ?
SELECT ... WHERE colname IN (?, ?, ?)
SELECT ... WHERE EXISTS(SELECT ... FROM T2 WHERE col1 < ?)
GROUP BY、HAVING、または ORDER BY を含む WHERE 句で ANSI SQL 92 エントリレベルの述語を使用する文がサポートされます。次に例を示します。
SELECT * FROM t1 WHERE col = ?ORDER BY 1
SELECT * FROM t1,t2 WHERE t1.col1 = ?
SELECT a, b, c, d FROM T1 AS A, T2 AS B WHERE A.a = ?
and B.b = ?"
アプリケーションでテーブル名情報が必要な場合、DB2 ドライバは Select 文の ResultSet メタデータに含めてテーブル名情報を返すことができます。ResultSetMetaDataOptions
プロパティを 1 に設定した場合、ResultSetMetaData.getTableName()
メソッドが呼び出されたとき、DB2 ドライバは結果セット内の各カラムの正しいテーブル名を決定する追加の処理を実行します。それ以外の場合、getTableName()
メソッドは結果セット内のカラムごとに空の文字列を返す可能性があります。
DB2 ドライバが返すテーブル名情報は、結果セット内のカラムがデータベース テーブル内のカラムにマップされているかどうかによって異なります。結果セット内の各カラムがデータベース テーブル内のカラムにマップされている場合、DB2 ドライバはそのカラムに関連付けられているテーブル名を返します。結果セット内の各カラムがテーブル内のカラムにマップされていない場合 (集約やリテラルなど)、DB2 ドライバは空の文字列を返します。
ResultSet メタデータが返される Select 文には、エリアス、結合、および完全修飾名を含めることができます。以下のクエリは、ResultSetMetaData.getTableName()
メソッドによって Select リスト内の各カラムの正しいテーブル名が返される、Select 文の例です。
SELECT id, name FROM Employee
SELECT E.id, E.name FROM Employee E
SELECT E.id, E.name AS EmployeeName FROM Employee E
SELECT E.id, E.name, I.location, I.phone FROM Employee E,
EmployeeInfo I WHERE E.id = I.id
SELECT id, name, location, phone FROM Employee,
EmployeeInfo WHERE id = empId
SELECT Employee.id, Employee.name, EmployeeInfo.location,
EmployeeInfo.phone FROM Employee, EmployeeInfo
WHERE Employee.id = EmployeeInfo.id
生成されたカラムの場合、ドライバによって返されるテーブル名は空の文字列です。以下のクエリは、生成されたカラム (「upper」という名前のカラム) を含む結果セットを返す Select 文の例です。
SELECT E.id, E.name as EmployeeName, {fn UCASE(E.name)}
AS upper FROM Employee E
DB2 ドライバは、ResultSetMetaData.getSchemaName()
メソッドと ResultSetMetaData.getCatalogName()
メソッドが呼び出された場合、スキーマ名とカタログ名の情報を返すこともできます (ドライバがこの情報を判別できる場合)。たとえば、以下の文の場合、DB2 ドライバはカタログ名として「test」、スキーマ名として「test1」、テーブル名として「foo」を返します。
SELECT * FROM test.test1.foo
テーブル名、スキーマ名、およびカタログ名の情報を返すために必要な追加の処理は、ResultSetMetaData.getTableName()
、ResultSetMetaData.getSchemaName()
、または ResultSetMetaData.getCatalogName()
メソッドが呼び出された場合にのみ実行されます。
DB2 ドライバは、以下のような RowSet インタフェースの JSR 114 実装をサポートします。
JSR 114 の詳細については、 http://www.jcp.org/en/jsr/detail?id=114 を参照してください。
DB2 ドライバは自動生成キーの値の取得をサポートします。DB2 ドライバから返される自動生成キーは、auto-increment カラムの値です。
値を返す方法は、パラメータを含む Insert 文を使用しているかどうかによって異なります。
アプリケーションでは Statement.getGeneratedKeys
メソッドを使用して、生成されたキーの値をドライバから取得します。
サーバ バージョンが DB2 v8 FixPak 11 より前の UNIX、Windows または Linux 上の DB2 UDB に接続する際に、パッチ レベルが同じかそれ以上のドライバ パッチを使用している場合、DB2 サーバにおける欠陥が原因で問題が発生する場合があります。接続の問題がある場合、現在のコンフィグレーションに次のドライバ プロパティを含める必要がある場合があります。
ExtendedOptions=ServerReleaseLevel=SQL08020
ServerReleaseLevel を使用する状況に関するガイダンスとして、次の表を使用してください。
詳細については、IBM の「サポート & ダウンロード」サイトの「DB2 UDB Version 8.1 FixPak 11 (also known as Version 8.2 FixPak 4)」を参照してください。
![]() ![]() ![]() |