「無限ループの深淵」を回避せよ:Access VBAにおけるRecordset制御の極意
業務自動化ツールの開発において、最も基本的でありながら、最も致命的なバグを誘発するのが「Recordset(レコードセット)のループ処理」だ。
「プログラムが応答なしになり、Accessがフリーズした」「CPU使用率が100%に張り付き、業務が止まった」――もし君が現場でこのような報告を受けたなら、その原因の9割は、Recordsetのカーソル制御における初歩的な設計ミス、すなわち「無限ループ」にある。
プロフェッショナルとして、単に「動くコード」を書くのは卒業してほしい。我々が目指すべきは、例外的な事態でもシステムを崩壊させない「堅牢なコード」だ。今回は、Recordsetの終端判定(EOF/BOF)の真理と、実務でそのまま使える鉄壁のパターンを伝授する。
1. なぜ「フリーズ」は起きるのか:カーソルの概念を理解せよ
多くの初心者が陥るミスは、`MoveNext` メソッドの書き忘れ、あるいは判定条件のロジックミスだ。
Recordsetを操作するということは、データベース内のレコード群の上を動く「カーソル(ポインタ)」を操ることに他ならない。カーソルは、現在どのレコードを指しているかという「位置」を持っている。
無限ループのメカニズム
例えば、以下のような思考でコードを書いていないだろうか?
> 「レコードがある限り、処理を繰り返す。レコードがなくなったら終了する」
これをコードに落とし込む際、`MoveNext`(カーソルを次に進める指示)を忘れると、カーソルは常に同じレコードを指し続ける。すると、ループの判定条件である「レコードの終端(EOF)に達したか?」というチェックは、永遠に `False` のままとなる。
結果として、プログラムは同じレコードに対して無限に処理を繰り返し続け、メモリを食いつぶし、アプリケーションを死に至らしめるのだ。
2. EOFとBOF:境界線の正体を暴く
Recordsetには、ループ制御の要となる2つのプロパティがある。
- `EOF` (End Of File): カーソルが「最後のレコードの後ろ」に到達した状態。
- `BOF` (Beginning Of File): カーソルが「最初のレコードの前」に到達した状態。
ここで重要なのは、「EOFはレコードそのものを指しているのではなく、レコードの『外側』を指している」という点だ。
正しい判定の定石
ループを回す際、最も安全で標準的なパターンはこれだ:
Do While Not rs.EOF
' 処理を実行
rs.MoveNext
Loop
なぜ `Do Until rs.EOF` ではなく `Do While Not rs.EOF` なのか? 技術的にはどちらも動作するが、プロフェッショナルの世界では「EOFでない間(条件が成立している間)は継続する」という論理構造が明確な `While Not` が好まれる。
3. 【実践】プロダクションレベルの堅牢なコードパターン
では、実際の業務ツールでそのまま使える、エラーハンドリングとリソース解放を組み込んだ「完成形」のコードを示そう。単なるループではなく、「失敗してもシステムを壊さない」設計思想が組み込まれている。
''
' 指定した条件に基づき、在庫データを一括更新する
' @param strCriteria: 抽出条件 (SQLのWHERE句に相当)
''
Public Sub UpdateStockData(ByVal strCriteria As String)
Dim db As DAO.Database
Dim rs As DAO.Recordset
Dim strSql As String
' 1. エラーハンドリングの設定
On Error GoTo ErrorHandler
Set db = CurrentDb
strSql = "SELECT * FROM T_Inventory WHERE " & strCriteria
' 2. Recordsetのオープン
' 動的な更新を行うため、Dynaset形式で開くのが定石
Set rs = db.OpenRecordset(strSql, dbOpenDynaset)
' 3. レコードが存在するかどうかの事前チェック
' EOFとBOFが共にTrueの場合、レコードセットは空である
If rs.EOF And rs.BOF Then
Debug.Print "対象レコードが存在しません。"
GoTo CleanUp
End If
' 4. メインループ:ここが心臓部だ
Do While Not rs.EOF
' --- 更新ロジック開始 ---
rs.Edit
' 例: 在庫数を1つ減らす(ビジネスロジックをここに記述)
rs!StockQuantity = rs!StockQuantity - 1
rs.Update
' --- 更新ロジック終了 ---
' 【最重要】カーソルを次に進める。これを忘れると無限ループの地獄へ。
rs.MoveNext
' 処理の進捗をログに出す(大規模データ用)
' Debug.Print "Processed ID: " & rs!ID
Loop
MsgBox "更新処理が正常に完了しました。", vbInformation
CleanUp:
' 5. リソースの確実な解放(これこそが設計の肝)
' エラーが発生しても、必ずここを通るように設計する
On Error Resume Next ' 解放時のエラーによる二次エラーを防ぐ
If Not rs Is Nothing Then
rs.Close
Set rs = Nothing
End If
If Not db Is Nothing Then
Set db = Nothing
End If
Exit Sub
ErrorHandler:
' 6. エラー情報の詳細出力
MsgBox "致命的なエラーが発生しました。" & vbCrLf & _
"エラー番号: " & Err.Number & vbCrLf & _
"エラー内容: " & Err.Description, vbCritical, "システムエラー"
' エラーが起きても、リソース解放処理へジャンプさせる
Resume CleanUp
End Sub
4. アーキテクトからのアドバイス:さらなる高みへ
このコードをマスターした君に、さらに一段上の設計思想を授けよう。
① リソース解放の「義務」
VBAにおいて、`Recordset.Close` と `Set rs = Nothing` は、単なるマナーではない。「義務」だ。
特に、外部データベース(SQL Server等)と連携している場合、Recordsetを閉じ忘れると、サーバー側に「開いたままのセッション」が残り続け、データベース全体のロックや接続数上限到達を引き起こす。これは、君の作ったツールが「社内インフラを破壊する凶器」になることを意味する。
② 更新(Edit/Update)のタイミング
ループ内で `rs.Edit` と `rs.Update` を使う際、`Update` が完了するまではそのレコードはロックされる可能性がある。ループの処理が重い場合は、トランザクション(`DBEngine.BeginTrans`)の使用を検討せよ。ただし、トランザクションは「失敗したら全て戻す」ためのものであり、無限ループを防ぐためのものではない。
③ 読み取り専用(Snapshot)の活用
もし、データの更新を行わず、単に表示や計算のために回すだけであれば、`dbOpenSnapshot` を使用せよ。`Dynaset` よりも高速で、メモリ消費も抑えられ、意図しないデータの書き換えを防ぐことができる。
結論
Recordsetのループ処理において、`MoveNext` は単なる一行のコードではない。それは「制御の継続」を担保する生命線だ。
`EOF` の判定、`MoveNext` の配置、そして `CleanUp` によるリソース解放。この三位一体が揃って初めて、君のコードは「業務で使えるプロフェッショナルな道具」へと昇華する。
次回の開発から、この規律を魂に刻んで実装に臨んでほしい。以上だ。
