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

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

「Do Until rs.EOF」を卒業せよ:GetRowsによるメモリ駆動型データ処理の極意

開発現場で、数万件規模のデータを扱うツールを作成している際、処理速度の遅さに頭を抱えたことはないだろうか?

もし君が、レコードセットを `Do Until rs.EOF` で一行ずつループさせ、その中で計算や加工を行っているとしたら……残念ながら、君の設計は「プロフェッショナル」とは呼べない。それは、一歩進むたびに重い扉を開け閉めするような、極めて非効率なI/O(入出力)の塊だからだ。

本稿では、Access VBAにおけるデータ処理のパラダイムを「レコードセット・ドリブン」から「メモリ・ドリブン」へと昇華させるテクニック、`GetRows` メソッドによる配列への一括転送について、その設計思想から実装の落とし穴までを徹底的に解説する。

1. なぜ「一行ずつのループ」は遅いのか

まず、根本的な設計ミスを理解しよう。

Recordsetオブジェクトに対して `MoveNext` を繰り返す行為は、VBAエンジンとデータベースエンジン(ACE/Jet)の間で、「次のレコードをください」という通信(コンテキストスイッチ)を、レコードの数だけ繰り返すことを意味する。

データが数百件程度なら問題はない。しかし、数万件、数十万件となると、この通信オーバーヘッドが累積し、致命的なパフォーマンスの低下を招く。我々アーキテクトが目指すべきは、「通信回数を最小化し、データ本体をまとめてメモリへ引き込む」ことだ。

そのための武器が、`Recordset.GetRows` メソッドである。

2. GetRowsの本質と「次元の罠」

`GetRows` は、レコードセットの内容を一度に `Variant` 型の2次元配列へと流し込むメソッドだ。これにより、以降の演算はすべて高速なメモリ上で行われる。

しかし、ここで多くの開発者が陥る「致命的な罠」がある。それは、返される配列の次元の構成だ。

通常の感覚(行、列)

多くの開発者は、配列を `Array(行番号, 列番号)` という構造でイメージする。

GetRowsの構造(列、行)

しかし、`GetRows` が返す配列は、`Array(列インデックス, 行インデックス)` という、いわば「転置(Transpose)された状態」で格納される。

  • `arr(0, 0)`:1列目の1行目
  • `arr(1, 0)`:2列目の1行目
  • `arr(0, 1)`:1列目の2行目

この仕様を知らずに `arr(row, col)` の感覚でアクセスすれば、実行時エラーか、あるいは「全くデタラメなデータ」を処理することになる。この特性を理解しているかどうかが、初級者と中級者を分かつ境界線だ。

3. 実戦投入可能なプロダクションコード

では、実際に現場で使える、堅牢かつ高速な実装パターンを示そう。
単に `GetRows` を使うだけでなく、空のレコードセットに対するガード、エラーハンドリング、そしてメモリ解放までをパッケージ化した設計だ。

Option Explicit

''' <summary>
''' レコードセットの内容を高速に2次元配列へ格納する。
''' </summary>
''' <param name="rs">対象のRecordsetオブジェクト</param>
''' <returns>2次元配列 (列, 行)。データがない場合はEmptyを返す。</returns>
Public Function FetchDataToVariantArray(ByRef rs As DAO.Recordset) As Variant
    On Error GoTo ErrorHandler

    ' 1. レコードセットの状態チェック
    If rs Is Nothing Then
        FetchDataToVariantArray = Empty
        Exit Function
    End If

    If rs.EOF And rs.BOF Then
        FetchDataToVariantArray = Empty
        Exit Function
    End If

    ' 2. GetRowsによる一括転送
    ' GetRowsは (列, 行) の順で2次元配列を返す特性を持つ
    FetchDataToVariantArray = rs.GetRows()

    Exit Function

ErrorHandler:
    ' 現場では、エラーが発生した際に「何が原因か」を即座に特定できるよう、
    ' エラーログ出力や詳細なメッセージングを組み込むこと。
    Debug.Print "Error in FetchDataToVariantArray: " & Err.Description
    FetchDataToVariantArray = Empty
End Function

''' <summary>
''' 業務ロジックのメインルーチン例
''' </summary>
Public Sub ProcessLargeData()
    Dim db As DAO.Database
    Dim rs As DAO.Recordset
    Dim dataArr As Variant
    Dim rowCount As Long
    Dim colCount As Long
    Dim i As Long, j As Long
    
    Set db = CurrentDb
    
    ' 高速化のためのSQL(必要なフィールドのみに絞るのが鉄則)
    Set rs = db.OpenRecordset("SELECT ID, CustomerName, Amount FROM T_SalesData", dbOpenSnapshot)
    
    ' --- 高速転送フェーズ ---
    dataArr = FetchDataToVariantArray(rs)
    
    ' レコードセットは速やかに閉じる(メモリとロックの解放)
    rs.Close
    Set rs = Nothing
    
    ' --- メモリ上での演算フェーズ ---
    If IsEmpty(dataArr) Then
        MsgBox "処理対象データがありません。", vbInformation
        GoTo CleanUp
    End If

    ' GetRowsの配列構造から要素数を取得
    ' LBound(dataArr, 1) は列の開始、LBound(dataArr, 2) は行の開始
    ' UBound(dataArr, 1) は列の最大、UBound(dataArr, 2) は行の最大
    colCount = UBound(dataArr, 1) 
    rowCount = UBound(dataArr, 2)

    Debug.Print "データ取得完了: " & (rowCount + 1) & " 件"

    ' 配列のループ処理(列、行の順にアクセスすることでキャッシュ効率を高める設計も検討すべきだが、
    ' VBAの配列アクセスにおいては、まず正しいインデックス指定が最優先である)
    For i = 0 To rowCount ' 行のループ
        ' ここで複雑な計算や加工を行う。DBへのアクセスは一切発生しない。
        ' 例: Amount (2列目) の集計など
        ' dataArr(2, i) -> 2列目(Amount)のi行目
        
        ' ログ出力の例
        ' Debug.Print "ID: " & dataArr(0, i) & " | Name: " & dataArr(1, i)
    Next i

    MsgBox "処理が正常に完了しました。", vbInformation

CleanUp:
    Set rs = Nothing
    Set db = Nothing
End Sub

4. アーキテクトとしての設計指針

このテクニックを導入する際、以下の3点を設計原則として守ってほしい。

① 「最小限の列」をSELECTせよ

`GetRows` は強力だが、メモリを大量に消費する。`SELECT *` を使うのは、プロフェッショナルとしては論外だ。業務に必要な最小限のフィールドのみをSQLで指定し、メモリへの転送量をコントロールせよ。

② ライフサイクルを管理せよ

`GetRows` でデータをメモリにコピーした直後、`Recordset` オブジェクトは速やかに `Close` し、`Nothing` を代入せよ。レコードセットを保持し続けることは、データベースのロック(排他制御)を不必要に長く維持することに繋がり、他のユーザーの業務を阻害するリスクとなる。

③ メモリ限界を見極めよ

`GetRows` は全件をメモリに乗せる。もし対象データが数百万件に及び、PCの物理メモリを超えるような場合、`GetRows` は `Out of Memory` エラーで即死する。その場合は、`GetRows` の引数に取得件数を指定するか(例:`rs.GetRows(10000)`)、あるいは「一定件数ごとに小分けにして処理する」というバッチ処理的な設計への切り替えが必要だ。

結びに

「動けばいい」というコードは、誰でも書ける。しかし、大量のデータを前にしてもなお、静かに、かつ高速に動作するツールを作るには、オブジェクトの挙動とメモリの仕組みに対する深い洞察が不可欠だ。

`GetRows` を使いこなし、レコードセットとの通信を最小限に抑える。この一歩が、君の作るシステムの品質を、単なる「ツール」から「プロフェッショナルなソリューション」へと変えるのだ。

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