8.6.73 setFetchSize(int rows)
(1) 機能
ResultSetオブジェクトを検索する際のフェッチサイズ(フェッチする行数)を設定します。
(2) 形式
public synchronized void setFetchSize(int rows) throws SQLException
(3) 引数
- int rows:
-
フェッチする行数を0〜65,535の範囲で指定します。
0を指定した場合は,システムプロパティ,ユーザプロパティ,または接続用のURLのプロパティのadb_clt_fetch_sizeの値を基に検索が実施されます。
このメソッドを実行しない場合,Statementオブジェクトに指定した行数値を基に検索が実施されます。Statementオブジェクトに行数値を指定していない,またはStatementオブジェクトから生成したResultSetオブジェクトではない場合は,プロパティのadb_clt_fetch_sizeの値を基に検索が実施されます。
(4) 戻り値
なし。
(5) 発生する例外
次に示す場合にSQLExceptionが投入されます。
-
このResultSetオブジェクトがクローズされている場合
このResultSetオブジェクトを生成したStatementオブジェクトがクローズされたことによって,ResultSetオブジェクトがクローズされた場合も含みます。
-
このResultSetオブジェクトを生成したStatementオブジェクトを作成したConnectionがクローズされている場合
-
トランザクションの決着によってResultSetオブジェクトが無効になった場合
-
rowsに0〜65,535以外の値を指定した場合
-
rowsに指定した値が,最大格納行数(このResultSetオブジェクトを生成したStatementオブジェクトのsetMaxRowsメソッドの設定値)よりも大きい場合
-
rowsに指定した値が,最大格納行数(このResultSetオブジェクトを生成したStatementオブジェクトのsetMaxLargeRowsメソッドの設定値)よりも大きい場合
(6) 留意事項
留意事項については,「8.4.37 setFetchSize(int rows)」の「(6) 留意事項」を参照してください。