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