【テクニカル・上級編】実務中級者向け:レコードセットの「GetRows」メソッドによる配列への一括転送と高速処理 – Access VBA解析バイブル

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

境界線を越えるコストを最小化せよ:GetRowsによるデータ転送の極致

業務システムの規模が拡大し、扱うレコード数が数万、数十万の領域に達したとき、多くの開発者は「処理が重い」という壁にぶつかる。その際、多くの者が取る安易な手段は、インデックスの最適化やSQLの書き換え、あるいはハードウェアの増強だ。

しかし、真のアーキテクトは、それらよりも手前にある「VBAエンジンとデータエンジン間の境界線を越える回数」に着目する。

本稿では、Recordsetを1行ずつループさせるという、初学者が陥りがちな「低速なイテレーション」を捨て去り、`GetRows` メソッドを用いてメモリ上にデータを一括展開し、極限のパフォーマンスを引き出す手法について、その設計思想とともに解説する。

1. なぜ `Do Until .EOF` は「遅い」のか

まず、我々が忌避すべきアンチパターンを定義しておこう。

' 【アンチパターン】典型的な逐次処理
Do Until rs.EOF
    ' 1行ごとにVBAとデータエンジン間で通信が発生
    targetArray(i, 0) = rs!Field1.Value
    targetArray(i, 1) = rs!Field2.Value
    i = i + 1
    rs.MoveNext
Loop

このコードが遅い理由は明白だ。`rs.MoveNext` や `rs!Field.Value` を呼び出すたびに、VBAエンジンはデータエンジン(DAO/ADO)に対してプロパティへのアクセスを要求する。この「コンテキストスイッチ(境界を越えるオーバーヘッド)」が、ループの回数分だけ積み重なるのだ。

10万件のレコードがあれば、10万回以上の境界越えが発生する。これは、エンジニアリングの観点から言えば、極めて非効率なリソースの浪費である。

2. `GetRows` によるバッチ転送のメカニズム

これに対する解が、`GetRows` メソッドだ。このメソッドは、現在のカーソル位置から指定した行数を、一気にメモリ上の配列へと「ダンプ」する。

`GetRows` の真髄は、「境界越えの回数を、レコード数ではなく、取得するデータセットの塊(チャンク)数にまで削減できる」点にある。

重要な注意点:次元の逆転

ここで、多くのシニアエンジニアですら一瞬手が止まる罠がある。`GetRows` が返す配列は、一般的な「行・列」の形式ではなく、「列・行」の形式(Column-major order)で生成される。

  • `Array(列インデックス, 行インデックス)`

この仕様を理解していないと、メモリ上の不正アクセスや、論理的なバグを引き起こすことになる。

3. 実装:極限のデータ抽出アーキテクチャ

以下に、実務でそのまま投入可能な、堅牢かつ高速な一括転送の実装例を示す。ここでは、エラーハンドリング、空のレコードセットへの対応、およびメモリ管理を徹底している。

''' <summary>
''' Recordsetの内容を高速に2次元配列へ転送する。
''' </summary>
''' <param name="rs">ソースとなるRecordsetオブジェクト</param>
''' <returns>列・行形式の2次元Variant配列。レコードなしの場合はEmptyを返す。</returns>
Public Function TransferRecordsetToVariantArray(ByRef rs As DAO.Recordset) As Variant
    On Error GoTo ErrorHandler

    ' 1. レコードが存在するか、カーソルが有効かを確認
    If rs Is Nothing Then Exit Function
    If rs.EOF And rs.BOF Then
        TransferRecordsetToVariantArray = Empty
        Exit Function
    End If

    ' 2. GetRowsによる一括転送
    ' 引数を省略すると全件取得となる。
    ' 戻り値は Array(Column, Row) の形式。
    Dim vData As Variant
    vData = rs.GetRows()

    ' 3. 結果を返す
    TransferRecordsetToVariantArray = vData

ExitProcedure:
    Exit Function

ErrorHandler:
    ' ログ出力等の処理をここに実装
    Debug.Print "Error in TransferRecordsetToVariantArray: " & Err.Description
    TransferRecordsetToVariantArray = Empty
    Resume ExitProcedure
End Function

''' <summary>
''' 実践的な使用例
''' </summary>
Public Sub HighSpeedProcessingExample()
    Dim db As DAO.Database
    Dim rs As DAO.Recordset
    Dim dataArray As Variant
    Dim i As Long, j As Long
    Dim rowCount As Long, colCount As Long

    Set db = CurrentDb
    Set rs = db.OpenRecordset("SELECT Field1, Field2, Field3 FROM LargeTable", dbOpenSnapshot)

    ' --- 高速転送の実行 ---
    dataArray = TransferRecordsetToVariantArray(rs)

    ' レコードが存在しない場合の早期リターン
    If IsEmpty(dataArray) Then
        MsgBox "No data found."
        GoTo Cleanup
    End If

    ' --- 配列の次元取得 ---
    ' GetRowsの戻り値は (列, 行) なので、LBound/UBoundの扱いに注意
    colCount = UBound(dataArray, 1) ' 列の最大インデックス
    rowCount = UBound(dataArray, 2) ' 行の最大インデックス

    ' --- メモリ上での高速演算 ---
    ' ここでは、メモリ上でデータを加工するシミュレーションを行う
    ' 境界越えが発生しないため、ループは極めて高速である
    For i = 0 To rowCount
        For j = 0 To colCount
            ' ここでデータの加工を行う
            ' 例: dataArray(j, i) = dataArray(j, i) * 1.1
        Next j
    Next i

    MsgBox "Processing complete. Rows: " & (rowCount + 1)

Cleanup:
    ' --- オブジェクトのライフサイクル管理 ---
    ' 巨大な配列を扱う場合、明示的な解放は必須である。
    ' 特に32bit環境では、メモリの断片化が致命傷になりかねない。
    Erase dataArray
    
    If Not rs Is Nothing Then
        rs.Close
        Set rs = Nothing
    End If
    Set db = Nothing
End Sub

4. アーキテクトの視点:メモリ管理とシステム間連携

このテクニックを実務に投入する際、我々が意識すべきは「速度」だけではない。「リソースの占有時間」だ。

メモリ・フットプリントの制御

`GetRows` は極めて強力だが、全件を一度にメモリに載せる。もし、数百万件のレコードを対象とする場合、VBAのVariant配列はメモリを食いつぶし、`Out of Memory` エラーを招く。
大規模データを扱う場合は、`GetRows(10000)` のように、一定のチャンクサイズ(塊)を指定して、分割して読み込む設計にすべきだ。これは、Windows APIの `VirtualAlloc` 等を用いたメモリ管理の考え方に通ずる、エンジニアリングの基本である。

ロック制御と整合性

`GetRows` でデータを配列に吸い出した瞬間、そのデータは「静的なスナップショット」となる。
Recordsetを `dbOpenSnapshot` で開いていれば、データベースへのロック影響は最小限に抑えられ、読み取り中の他ユーザーへの干渉を防ぐことができる。しかし、配列上のデータを加工した後にDBへ書き戻す際は、必ず「トランザクション」を意識し、書き戻し処理(`Update`)の際にレコードが失われていないか(Optimistic Concurrency Control)を確認する設計が必要だ。

結論

`GetRows` は、単なる便利なメソッドではない。それは、「データとプログラムの境界における摩擦を最小化する」という、計算機科学における重要な最適化手法の具現化である。

「動けばいい」というコードを書くのは、単なるコーダーだ。
「リソースの挙動を予見し、最小のコストで最大の結果を得る」コードを書く。それこそが、我々プロフェッショナルに求められる矜持である。

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