【実務・中級編】初心者向け:Recordsetのループ処理で陥る無限ループとEOF/BOFの正しい判定 – Access VBA解析バイブル

スポンサーリンク
スポンサーリンク

「無限ループの深淵」を回避せよ: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` によるリソース解放。この三位一体が揃って初めて、君のコードは「業務で使えるプロフェッショナルな道具」へと昇華する。

次回の開発から、この規律を魂に刻んで実装に臨んでほしい。以上だ。

タイトルとURLをコピーしました