WebLogic Type 4 JDBC ドライバガイド

Sybase ドライバ

以下の節では、BEA WebLogic Type 4 JDBC Sybase ドライバのコンフィグレーション方法と使用方法について説明します。

データベースバージョンのサポート

Sybase 用の BEA WebLogic Type 4 JDBC ドライバ (「Sybase ドライバ」) は次のデータベースバージョンをサポートします。

Sybase Adaptive Server 11.5 および 11.9
Sybase Adaptive Server Enterprise 12.0、12.5、および 12.5.1

注意 : XA 接続は Sybase Adaptive Server Enterprise 12.0 以降のバージョンでのみサポートされます。XA 接続は Sybase Adaptive Server 11.5 および 11.9 ではサポートされません。

ドライバクラス

BEA WebLogic Type 4 JDBC Sybase ドライバのドライバクラスは次のとおりです。

XA : weblogic.jdbcx.sybase.SybaseDataSource

非 XA : weblogic.jdbc.sybase.SybaseDriver

WebLogic Server ドメインに JDBC データソースをコンフィグレーションする場合に、これらのドライバクラスを使用します。

Sybase URL

Sybase データベースに接続するには、次の形式の URL を使用します。

jdbc:bea:sybase://dbserver:port

Sybase 接続プロパティ

表 7-1 に、Sybase ドライバでサポートされる JDBC 接続プロパティを示し、各プロパティについて説明します。WebLogic Server ドメインの JDBC データソースのコンフィグレーションでこれらの接続プロパティを使用できます。プロパティを指定するには、JDBC データソースのコンフィグレーションで次の形式を使用します。

property=value

注意 : すべての接続文字列プロパティ名で、大文字と小文字は区別されません。たとえば、Password は password と同じです。

表 7-1 Sybase の接続プロパティ

プロパティ	説明
BatchPerformanceWorkaround 省略可能	true または false。バッチ処理の実行に使用されるメソッドを決定する。true に設定すると、ネイティブの Sybase バッチメカニズムが使用される。 false に設定すると、JDBC 3.0 に準拠したバッチメカニズムが使用される。ほとんどの場合、ネイティブな Sybase バッチ機能を使用するとパフォーマンスはかなり向上するが、ドライバが常にバッチの更新件数を返せるとは限らない。デフォルトは false。「バッチ挿入とバッチ更新」を参照。
CodePageOverride 省略可能	ドライバが文字データの変換に使用するコードページを指定する。指定したコードページによって、デフォルトのデータベースコードページがオーバーライドされる。データベースとやり取り (取得および書き込み) するすべての文字データは、指定したコードページを使用して変換される。値としては、使用している Java 仮想マシンでサポートされている有効なコードページの名前 (たとえば CodePageOverride=CP950) を含む文字列を指定する必要がある。
ConnectionRetryCount 省略可能	データベースサーバへの正常な接続を確立できるまでに、ドライバで接続を再試行する回数。有効な値は、0 または正の整数。デフォルトは 0。
ConnectionRetryDelay 省略可能	ConnectionRetryCount が正の整数に設定されている場合に、ドライバがデータベースサーバへの接続を再試行する前に待機する秒数。デフォルトは 3。
DatabaseName 省略可能	接続先のデータベースの名前。
InsensitiveResultSetBufferSize 省略可能	-1、0、または x。ドライバがインセンシティブな結果セットデータのキャッシュに使用するメモリの量を指定する。以下のいずれかの値を指定する必要がある。 -1 に設定すると、ドライバはすべてのインセンシティブな結果セットデータをメモリにキャッシュする。結果セットのサイズが利用できるメモリ容量を超えると、OutOfMemoryException 例外が生成される。結果セットデータをディスクに書き込む必要がないため、データがより効率的に処理される。 0 に設定すると、ドライバは 2GB を限度としてすべてのインセンシティブな結果セットデータをメモリにキャッシュする。結果セットのサイズが利用できるメモリ容量を超えると、結果セットがディスクにページングされる。結果セットデータがディスクに書き込まれる可能性があるため、ディスクに正しく書き込むためにデータの再フォーマットが必要になることがある。 x (正の整数) に設定すると、インセンシティブな結果セットデータのキャッシュに使用するメモリバッファのサイズ (KB 単位) を指定したことになり、ドライバはすべての結果セットデータをメモリにキャッシュする。結果セットのサイズがバッファサイズを超えると、結果セットがディスクにページングされる。結果セットデータがディスクに書き込まれる可能性があるため、ディスクに正しく書き込むためにデータの再フォーマットが必要になることがある。バッファサイズとして 2 の累乗を指定すると、メモリの使用がより効率的になる。デフォルトは 2048 (KB)。
LoginTimeout 省略可能	データベース接続の作成の試行を待機する最大時間 (秒単位)。値 `0` は、デフォルトのシステムタイムアウトがある場合はそのタイムアウトを使用し、それ以外の場合はタイムアウトがないことを指定する。
Password	Sybase データベースに接続する場合に使用するパスワード。大文字と小文字を区別する。パスワードは、データベースでセキュリティが有効化されている場合にのみ必要となる。その場合は、システム管理者に連絡してパスワードを取得する。
PortNumber	Sybase データベースへの接続をリスンするプライマリデータベースサーバの TCP ポート。デフォルトはオペレーティングシステムによって異なる。
PrepareMethod 省略可能	StoredProc、StoredProclfParam、または Direct。サーバに Prepared Statement 用のストアドプロシージャを作成するかどうかを指定する。 StoredProc に設定すると、文が準備されるときにストアドプロシージャが作成され、Prepared Statement が実行されるときにストアドプロシージャが実行される。 StoredProcIfParam に設定すると、Prepared Statement に 1 つまたは複数のパラメータマーカが含まれる場合にのみストアドプロシージャが作成される。この場合も、文が準備されるとストアドプロシージャが作成され、Prepared Statement が実行されるとストアドプロシージャが実行される。Prepared Statement にパラメータマーカが含まれない場合、ストアドプロシージャは作成されず、Prepared Statement が直接実行される。 Direct に設定すると、Prepared Statement 用のストアドプロシージャは作成されず、Prepared Statement が直接実行される。パラメータメタデータが要求された場合は、ストアドプロシージャが作成されることがある。デフォルトは StoredProclfParam。アプリケーションが Prepared Statement を複数回実行する場合は、このプロパティを StoredProc または StoredProclfParam に設定するとパフォーマンスが向上する。これは、いったん作成されたストアドプロシージャは、単一の SQL 文よりも高速に実行できるため。一方、Prepared Statement を 1 回しか実行しない、または 1 回も実行しない場合はパフォーマンスが低下するおそれがある。これは、ストアドプロシージャを作成する際のサーバへの負荷が、単一の SQL 文を実行する負荷よりも大きいため。アプリケーションが Prepared Statement を複数回実行することがない場合は、このプロパティを Direct に設定することが望ましい。
SelectMethod 省略可能	Direct または Cursor。SQL Server ドライバが、Select 文でデータベースカーソルを要求するかどうかを判定するためのヒント。ドライバが要求されたメソッドを常に満たせるとは限らないので、ドライバのパフォーマンスと動作は、ヒントとして定義されるこのプロパティによって影響を受ける。 Direct - ドライバが Direct メソッドを使用すると、データベースサーバはクエリに応答するときに、ドライバへの 1 つの応答ですべての結果セットを送信する。サーバサイドのデータベースカーソルは作成されない。通常、応答はドライバによってキャッシュされない。このメソッドでは、ドライバはクエリの応答をすべて処理してからでないと、次のクエリを送信できない。同じ接続で別の文を使うなどしてクエリがもう 1 つ送信された場合、ドライバは 2 番目のクエリを送信する前に最初のクエリの応答をキャッシュする。通常、Cursor メソッドよりも Direct メソッドのほうがパフォーマンスが良い。 Cursor - ドライバが Cursor メソッドを使用すると、サーバサイドのデータベースカーソルが要求される。この行は、転送専用の結果セットを返すときにサーバからブロック単位で取得する。JDBC Statement メソッドの setFetchSize を使用すると、各リクエストで取得する行数を制御できる。パフォーマンステストの結果から、Cursor メソッドを使用した場合、setFetchSize の値がパフォーマンスに大きく影響することがわかっている。setFetchSize の値を決定するための簡単なルールはない。setFetchSize の値を変えて実験して、アプリケーションのパフォーマンスが最高になる値を見つけだすことが望ましい。Cursor メソッドは、大量のデータが得られるクエリ、特に複数の結果セットを開く場合に効果的である。デフォルトは Direct。
ServerName	プライマリデータベースサーバの IP アドレスまたはサーバ名 (ネットワークが名前付きのサーバをサポートしている場合) を指定する。たとえば、122.23.15.12 または SybaseServer のように指定する。
User	Sybase データベースに接続する場合に使用するユーザ名。大文字と小文字は区別されない。ユーザ名は、データベースでセキュリティが有効化されている場合にのみ必要となる。その場合は、システム管理者に連絡してユーザ名を取得する。

プロパティ

説明

BatchPerformanceWorkaround

省略可能

true または false。バッチ処理の実行に使用されるメソッドを決定する。true に設定すると、ネイティブの Sybase バッチメカニズムが使用される。

false に設定すると、JDBC 3.0 に準拠したバッチメカニズムが使用される。ほとんどの場合、ネイティブな Sybase バッチ機能を使用するとパフォーマンスはかなり向上するが、ドライバが常にバッチの更新件数を返せるとは限らない。

デフォルトは false。

「バッチ挿入とバッチ更新」を参照。

CodePageOverride

省略可能

ドライバが文字データの変換に使用するコードページを指定する。指定したコードページによって、デフォルトのデータベースコードページがオーバーライドされる。データベースとやり取り (取得および書き込み) するすべての文字データは、指定したコードページを使用して変換される。値としては、使用している Java 仮想マシンでサポートされている有効なコードページの名前 (たとえば CodePageOverride=CP950) を含む文字列を指定する必要がある。

ConnectionRetryCount

省略可能

データベースサーバへの正常な接続を確立できるまでに、ドライバで接続を再試行する回数。有効な値は、0 または正の整数。

デフォルトは 0。

ConnectionRetryDelay

省略可能

ConnectionRetryCount が正の整数に設定されている場合に、ドライバがデータベースサーバへの接続を再試行する前に待機する秒数。

デフォルトは 3。

DatabaseName

省略可能

接続先のデータベースの名前。

InsensitiveResultSetBufferSize

省略可能

-1、0、または x。ドライバがインセンシティブな結果セットデータのキャッシュに使用するメモリの量を指定する。以下のいずれかの値を指定する必要がある。

-1 に設定すると、ドライバはすべてのインセンシティブな結果セットデータをメモリにキャッシュする。結果セットのサイズが利用できるメモリ容量を超えると、OutOfMemoryException 例外が生成される。結果セットデータをディスクに書き込む必要がないため、データがより効率的に処理される。

0 に設定すると、ドライバは 2GB を限度としてすべてのインセンシティブな結果セットデータをメモリにキャッシュする。結果セットのサイズが利用できるメモリ容量を超えると、結果セットがディスクにページングされる。結果セットデータがディスクに書き込まれる可能性があるため、ディスクに正しく書き込むためにデータの再フォーマットが必要になることがある。

x (正の整数) に設定すると、インセンシティブな結果セットデータのキャッシュに使用するメモリバッファのサイズ (KB 単位) を指定したことになり、ドライバはすべての結果セットデータをメモリにキャッシュする。結果セットのサイズがバッファサイズを超えると、結果セットがディスクにページングされる。結果セットデータがディスクに書き込まれる可能性があるため、ディスクに正しく書き込むためにデータの再フォーマットが必要になることがある。バッファサイズとして 2 の累乗を指定すると、メモリの使用がより効率的になる。

デフォルトは 2048 (KB)。

LoginTimeout

省略可能

データベース接続の作成の試行を待機する最大時間 (秒単位)。値 0 は、デフォルトのシステムタイムアウトがある場合はそのタイムアウトを使用し、それ以外の場合はタイムアウトがないことを指定する。

Password

Sybase データベースに接続する場合に使用するパスワード。大文字と小文字を区別する。パスワードは、データベースでセキュリティが有効化されている場合にのみ必要となる。その場合は、システム管理者に連絡してパスワードを取得する。

PortNumber

Sybase データベースへの接続をリスンするプライマリデータベースサーバの TCP ポート。

デフォルトはオペレーティングシステムによって異なる。

PrepareMethod

省略可能

StoredProc、StoredProclfParam、または Direct。サーバに Prepared Statement 用のストアドプロシージャを作成するかどうかを指定する。

StoredProc に設定すると、文が準備されるときにストアドプロシージャが作成され、Prepared Statement が実行されるときにストアドプロシージャが実行される。

StoredProcIfParam に設定すると、Prepared Statement に 1 つまたは複数のパラメータマーカが含まれる場合にのみストアドプロシージャが作成される。この場合も、文が準備されるとストアドプロシージャが作成され、Prepared Statement が実行されるとストアドプロシージャが実行される。Prepared Statement にパラメータマーカが含まれない場合、ストアドプロシージャは作成されず、Prepared Statement が直接実行される。

Direct に設定すると、Prepared Statement 用のストアドプロシージャは作成されず、Prepared Statement が直接実行される。パラメータメタデータが要求された場合は、ストアドプロシージャが作成されることがある。

デフォルトは StoredProclfParam。

アプリケーションが Prepared Statement を複数回実行する場合は、このプロパティを StoredProc または StoredProclfParam に設定するとパフォーマンスが向上する。これは、いったん作成されたストアドプロシージャは、単一の SQL 文よりも高速に実行できるため。一方、Prepared Statement を 1 回しか実行しない、または 1 回も実行しない場合はパフォーマンスが低下するおそれがある。これは、ストアドプロシージャを作成する際のサーバへの負荷が、単一の SQL 文を実行する負荷よりも大きいため。アプリケーションが Prepared Statement を複数回実行することがない場合は、このプロパティを Direct に設定することが望ましい。

SelectMethod

省略可能

Direct または Cursor。SQL Server ドライバが、Select 文でデータベースカーソルを要求するかどうかを判定するためのヒント。ドライバが要求されたメソッドを常に満たせるとは限らないので、ドライバのパフォーマンスと動作は、ヒントとして定義されるこのプロパティによって影響を受ける。

Direct - ドライバが Direct メソッドを使用すると、データベースサーバはクエリに応答するときに、ドライバへの 1 つの応答ですべての結果セットを送信する。サーバサイドのデータベースカーソルは作成されない。通常、応答はドライバによってキャッシュされない。このメソッドでは、ドライバはクエリの応答をすべて処理してからでないと、次のクエリを送信できない。同じ接続で別の文を使うなどしてクエリがもう 1 つ送信された場合、ドライバは 2 番目のクエリを送信する前に最初のクエリの応答をキャッシュする。通常、Cursor メソッドよりも Direct メソッドのほうがパフォーマンスが良い。

Cursor - ドライバが Cursor メソッドを使用すると、サーバサイドのデータベースカーソルが要求される。この行は、転送専用の結果セットを返すときにサーバからブロック単位で取得する。JDBC Statement メソッドの setFetchSize を使用すると、各リクエストで取得する行数を制御できる。パフォーマンステストの結果から、Cursor メソッドを使用した場合、setFetchSize の値がパフォーマンスに大きく影響することがわかっている。setFetchSize の値を決定するための簡単なルールはない。setFetchSize の値を変えて実験して、アプリケーションのパフォーマンスが最高になる値を見つけだすことが望ましい。Cursor メソッドは、大量のデータが得られるクエリ、特に複数の結果セットを開く場合に効果的である。

デフォルトは Direct。

ServerName

プライマリデータベースサーバの IP アドレスまたはサーバ名 (ネットワークが名前付きのサーバをサポートしている場合) を指定する。たとえば、122.23.15.12 または SybaseServer のように指定する。

User

Sybase データベースに接続する場合に使用するユーザ名。大文字と小文字は区別されない。ユーザ名は、データベースでセキュリティが有効化されている場合にのみ必要となる。その場合は、システム管理者に連絡してユーザ名を取得する。

データ型

表 7-2 では、Sybase ドライバでサポートされるデータ型と、それらが JDBC データ型へどのようにマップされるかを示します。

表 7-2 Sybase データ型

Sybase データベース	Sybase のデータ型	JDBC のデータ型
Sybase 11.5 以降	binary	BINARY
	bit	BIT
	char	CHAR
	datetime	TIMESTAMP
	decimal	DECIMAL
	float	FLOAT
	image	LONGVARBINARY
	int	INTEGER
	money	DECIMAL
	nchar	CHAR
	numeric	NUMERIC
	nvarchar	VARCHAR
	real	REAL
	smalldatetime	TIMESTAMP
	smallint	SMALLINT
	smallmoney	DECIMAL
	sysname	VARCHAR
	text	LONGVARCHAR
	timestamp	VARBINARY
	tinyint	TINYINT
	varbinary	VARBINARY
	varchar	VARCHAR
Sybase 12.5 および 12.5.1 のみ	date	DATE
	time	TIME
	unichar	CHAR
	univarchar	VARCHAR

注意 : ADAPTIVE SERVER 12.5 および 12.5.1 を使用する場合、Sybase ドライバは character および binary のカラムでの XNL (extended new limits) をサポートします。長さが 255 を超えるカラムがサポートされます。character および binary のカラムにおける XNL の詳細については、Sybase のマニュアルを参照してください。

データ型の詳細については、「getTypeInfo」を参照してください。

SQL エスケープシーケンス

Sybase ドライバでサポートされている SQL エスケープシーケンスについては、「JDBC の SQL エスケープシーケンス」を参照してください。

アイソレーションレベル

Sybase ドライバは、トランザクションアイソレーションレベルとして Read Committed、Read Uncommitted、Repeatable Read、および Serializable をサポートしています。デフォルトは Read Committed です。

スクロール可能なカーソルの使用

Sybase ドライバは、ID カラムを持つテーブルから結果セットが返される場合にのみ、スクロールセンシティブな結果セットをサポートします。Sybase ドライバでも、スクロールインセンシティブな結果セット、および更新可能な結果セットをサポートしています。

注意 : Sybase ドライバが、要求された結果セットのタイプまたは同時実行性をサポートできない場合は、カーソルを自動的にダウングレードして詳細情報の入った SQLWarning を生成します。

Large Object (LOB) のサポート

Sybase では Blob または Clob データ型は定義されていませんが、Sybase ドライバによって、Blob および Clob 用に設計された JDBC メソッドを使用して長いデータの LONGVARBINARY および LONGVARCHAR データを取得および更新できます。これらのメソッドを使用して長いデータを Blob または Clob として更新すると、更新は Blob または Clob オブジェクト内のデータのローカルコピーに対して行われます。

Blob および Clob 用の JDBC メソッドを使用して長いデータを取得および更新すると、Blob および Clob を操作した場合と同じメリットが得られます。たとえば Blob および Clob を使用した場合、

データにランダムアクセスできる。
特定の文字列から始まるデータを取得するなど、データのパターン検索が可能になる。

Blob および Clob を使用した場合のこうしたメリットを得るには、データをキャッシュする必要があります。データをキャッシュするので、特に一度にデータの逐次読み出しを行う場合に、パフォーマンスが低下します。長いデータのサイズが使用可能なメモリよりも大きいと、パフォーマンスが著しく低下することがあります。

バッチ挿入とバッチ更新

Sybase ドライバは次のバッチメカニズムを提供します。

ドライバ内のコードを使用してバッチ処理を実行する、JDBC 3.0 に準拠したメカニズム。これは、Sybase ドライバが使用するデフォルトのメカニズムです。
Sybase のネイティブのバッチ機能を使用するメカニズム。特に、パフォーマンスの負荷が大きいネットワークの往復に関しては、このメカニズムの方が標準のメカニズムより高速になる可能性があります。バッチを実行してエラーが発生した場合、ドライバはバッチ内でエラーを引き起こした文を判別できません。また、バッチの中にストアドプロシージャを呼び出した文やトリガを実行した文が含まれる場合、各バッチ文またはパラメータセットに対する複数の更新件数が生成されます。

Sybase のネイティブのバッチメカニズムを使用するには、BatchPerformanceWorkaround 接続プロパティを true に設定します。接続プロパティの指定の詳細については、「Sybase 接続プロパティ」を参照してください。

パラメータメタデータのサポート

Sybase ドライバは、あらゆるタイプの SQL 文のパラメータメタデータを返すことができます。

自動生成キーのサポート

Sybase ドライバは自動生成キーの値の取得をサポートします。Sybase ドライバから返される自動生成キーは、identity カラムの値です。

自動生成キーの値を取得する方法は、使用する Insert 文にパラメータが含まれるかどうかによって異なります。

パラメータを含まない Insert 文を使用する場合、Sybase ドライバは次の形式の Statement.execute および Statement.executeUpdate メソッドをサポートする。これらのメソッドは、ドライバに自動生成キーの値を返すよう通知するためのものです。

Statement.execute (String sql, int autoGeneratedKeys)
Statement.executeUpdate (String sql, int autoGeneratedKeys)

パラメータを含む Insert 文を使用する場合、Sybase ドライバは次の形式の Connection.prepareStatement メソッドをサポートする。このメソッドは、ドライバに自動生成キーの値を返すよう通知するためのものです。

Connection.prepareStatement (String sql, int autoGeneratedKeys)

アプリケーションでは Statement.getGeneratedKeys() メソッドを使用して、生成されたキーの値をドライバから取得します。

Sybase の JTA のサポート

グローバルトランザクションで Sybase XA ドライバを使用するには、グローバルトランザクションをサポートするように Sybase サーバを設定しておく必要があります。『WebLogic JTA プログラマーズガイド』の「XA をサポートするための Sybase サーバの設定」を参照してください。

Sybase ドライバ

データベース バージョンのサポート

ドライバ クラス

Sybase URL

Sybase 接続プロパティ

データ型

SQL エスケープ シーケンス

アイソレーション レベル

スクロール可能なカーソルの使用

Large Object (LOB) のサポート

バッチ挿入とバッチ更新

パラメータ メタデータのサポート

自動生成キーのサポート

Sybase の JTA のサポート

データベースバージョンのサポート

ドライバクラス

SQL エスケープシーケンス

アイソレーションレベル

パラメータメタデータのサポート