JDBCのsetFetchSize()メソッドとsetMaxRows()メソッドの違いと使い方を解説

JDBCで大量のデータを扱う際、パフォーマンスやメモリ使用量を制御するために重要となるのが、setFetchSize(int)メソッドとsetMaxRows(int)メソッドです。この2つのメソッドは名前が似ていますが、役割と影響範囲がまったく異なります。本記事では、それぞれの使い方と違いをわかりやすく解説します。

setFetchSize(int)メソッドとは

setFetchSize(int)メソッドは、ResultSetがさらに行を必要とするときに、データベースから一度に読み込む行数を定義します。つまり、このメソッドはデータベース側がResultSetのデータをどのように返すかに影響を与えます。

例えば、fetchSizeに100を設定した場合、JDBCドライバーは100行ずつまとめてデータを取得するため、ネットワーク通信の回数を減らし、パフォーマンス向上が期待できます。

Statement stmt = conn.createStatement();
stmt.setFetchSize(100);
ResultSet rs = stmt.executeQuery("SELECT * FROM employees");

なお、fetchSizeの実際の挙動は使用するJDBCドライバーやデータベースに依存します。例えばMySQLでは、デフォルトでは全行を一度に取得するため、ストリーミング取得を行いたい場合はInteger.MIN_VALUEを指定するなどの特別な対応が必要です。

setMaxRows(int)メソッドとは

一方、setMaxRows(int)メソッドは、ResultSetが同時に保持できる最大行数を指定します。このメソッドはクライアント側のJDBCオブジェクトに影響を与える点が特徴です。

例えば、setMaxRows(50)と設定した場合、クエリ結果が何万件あっても、ResultSetには最大50行までしか格納されません。これは、表示件数を制限したい場合や、テスト目的で少量のデータだけを取得したい場合に便利です。

Statement stmt = conn.createStatement();
stmt.setMaxRows(50);
ResultSet rs = stmt.executeQuery("SELECT * FROM orders");
// 最大50行のみ取得される

両者の違いのまとめ

使い分けのポイント

大量のデータを効率的に処理したい場合はsetFetchSize()を、取得する行数そのものを制限したい場合はsetMaxRows()を使用するのが基本です。両者は排他的なものではなく、組み合わせて使うことも可能です。

適切にこれらのメソッドを使い分けることで、JDBCアプリケーションのパフォーマンスと安定性を大幅に向上させることができます。