18.5.2　受信バッファプール数の指定

受信バッファプールに登録してプールする受信バッファの数を指定できます。この数のことを受信バッファプール数といいます。受信バッファプール数を指定することによってSQL実行時の性能を向上でき，メモリ占有量を軽減できます。

受信バッファプール数は，1〜1,024個の範囲で指定できます。受信バッファプール数を指定すると，同一コネクション内で受信バッファが再利用されます。そのため，セッションIDが異なるStatementでも，同一コネクションであれば受信バッファを再利用できます。受信バッファが，指定した受信バッファプール数よりも多く必要になった場合は，一時的に受信バッファを生成し，DABroker Libraryから実行結果のデータを受信したあとに破棄します。このような一時的に生成した受信バッファは，受信バッファプールには登録されません。

受信バッファプール数を指定した場合の，受信バッファプールの管理の概要を次の図に示します。

図18‒2　受信バッファプールの管理の概要（受信バッファプール数を指定した場合）

受信バッファが生成されるタイミング

受信バッファが生成されるタイミングは，受信バッファプール数を指定しない場合と同じです。詳細については，「18.5.1　受信バッファの管理」を参照してください。

受信バッファを取得または返却するタイミング

受信バッファプールから受信バッファを取得するタイミング，および受信バッファを受信バッファプールに返却するタイミングは，SQLを実行するメソッドによって異なります。

各メソッドの動作は次の三つに分類されます。

表18‒17　メソッドの動作の分類

動作	説明
1	メソッド実行時に受信バッファを受信バッファプールから取得する。メソッド終了後，受信バッファを受信バッファプールに戻す。
2	動作2に分類されるメソッドのうち，最初に実行するメソッドで受信バッファを受信バッファプールから取得する。メソッドが終了しても，受信バッファは受信バッファプールに戻さない。
3	動作2に分類されるメソッドで取得した受信バッファを受信バッファプールに戻す。新たな受信バッファは取得しない。

受信バッファを再利用する際に受信バッファを取得または返却するメソッド，およびメソッドの動作を次の表に示します。動作の列の数字は，上記の表と対応しています。

表18‒18　SQLを実行するメソッド，およびメソッドの動作

クラス	メソッド	動作
Connection	prepareCall(String sql)	1
	prepareCall(String sql, int resultSetType, int resultSetConcurrency)	1
	prepareStatement(String sql)	1
	prepareStatement(String sql, int resultSetType, int resultSetConcurrency)	1
DatabaseMetaData	getProcedures(String catalog, String schemaPattern, String procedureNamePattern)	1
	getProcedureColumns(String catalog, String schemaPattern, String procedureNamePattern, String columnNamePattern)	1
	getTables(String catalog, String schemaPattern, String tableNamePattern, String[] types)	1
	getSchemas()	1
	getTableTypes()	1
	getColumns(String catalog, String schemaPattern, String tableNamePattern, String columnNamePattern)	1
	getColumnPrivileges(String catalog, String schema, String table, String columnNamePattern)	1
	getTablePrivileges(String catalog, String schemaPattern, String tableNamePattern)	1
	getPrimaryKeys(String catalog, String schema, String table)	1
	getIndexInfo(String catalog, String schema, String table, boolean unique, boolean approximate)	1
Statement	executeBatch()	1
	execute(String sql)	1
	executeQuery(String sql)	1
	executeUpdate(String sql)	1
	close()※	3
PreparedStatement	execute()	1
	executeQuery()	1
	executeUpdate()	1
ResultSet	absolute(int row)	2
	afterLast()	2
	first()	2
	next()	2
	close()	3

注※　ResultSet#close()メソッドを実行していない場合だけ使用できます。

〈この項の構成〉

• (1)　受信バッファプール数の指定方法

• (2)　受信バッファプール数の目安