setMaxRows メソッド (ISQLServerStatement)
任意の SQLServerResultSet オブジェクトが含むことのできる最大行数の制限を、渡された数値に設定します。
構文
public final void setMaxRows(int max)
パラメーター
max
最大行数を示す int です。制限しない場合は 0 です。
例外
解説
setMaxRows メソッドは、java.sql.Statement インターフェイスの setMaxRows メソッドで規定されています。
setMaxRows メソッドは、スクロール可能な動的カーソルには影響しません。大きな結果セットから行が返される可能性がある場合に、返される行数を制限するには、アプリケーションで SELECT TOP N SQL 構文を使用してください。
setMaxRows メソッドが呼び出されると、Microsoft SQL Server JDBC Driver はアプリケーションのクエリの実行時に SET ROWCOUNT SQL ステートメントを実行します。これにより、そのクエリによって返される行の数だけでなく、そのクエリで実行される Transact-SQL ステートメントによって処理される行の最大数も制限されます。アプリケーションで最上位の SQLServerResultSet オブジェクトに対してのみ制限を設定する必要がある場合は、setMaxRows メソッドではなく、SELECT TOP N SQL 構文をクエリで使用してください。
SET ROWCOUNT SQL ステートメントの詳細については、SQL Server オンライン ブックの「SET ROWCOUNT (Transact-SQL)」を参照してください。