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

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

レコードセットの「壁」を突破せよ:GetRowsメソッドで極める高速データ処理の極意

こんにちは。現場の設計から実装、そしてパフォーマンスチューニングまで、数々の「動かないコード」を「爆速のシステム」へと昇華させてきたアーキテクトです。

あなたが今、Access VBAで「レコードセットを1行ずつループさせて処理する」というコードを書いていたとしたら……。
おめでとうございます。あなたは今、「プロフェッショナルへの入り口」に立っています。

しかし、同時に一つだけ、残酷な真実を伝えておかなければなりません。
その「1行ずつ回す」という書き方、データ件数が数千、数万と増えた瞬間に、あなたのアプリケーションは「止まっているのか動いているのか分からないほど重い」ものへと変貌します。

今日は、その「重さ」の正体を暴き、一瞬で処理を終わらせるための魔法のメソッド、`GetRows`について、その本質を魂を込めて解説します。ここをクリアすれば、あなたのVBAは「マクロの延長」から「真の業務アプリケーション」へと進化します。

1. なぜ「MoveNext」は遅いのか? — 現場のボトルネック

まず、多くの人が書く「標準的なコード」を見てみましょう。

' --- 典型的な(しかし、大量データには不向きな)書き方 ---
Do Until rs.EOF
    ' 1行ずつ取り出して、何か処理をする
    Debug.Print rs!UserName
    rs.MoveNext ' ← ここが「重い」!
Loop

一見、何も問題なさそうに見えますよね? でも、なぜこれが遅いのか。
それは、`rs.MoveNext` を実行するたびに、VBAからデータベースエンジン(DAOやADO)に対して、「次のデータをください!」という通信(リクエスト)が発生しているからです。

例えるなら、「スーパーへ買い物に行くのに、卵を1個買うたびに、一度家に帰って、またスーパーへ行く」ようなものです。
卵が100個あれば、100回往復することになります。これが「オーバーヘッド」と呼ばれる、目に見えない時間の浪費の正体です。

2. 救世主 `GetRows`:一括転送の概念

ここで登場するのが `GetRows` メソッドです。
このメソッドの役割は、「レコードセットにある全データを、一気にメモリ上の配列へ放り込む」ことです。

「スーパーへ行くなら、カートいっぱいにまとめて買えばいいじゃないか」
……そう思ったあなた、正解です。その直感こそが、エンジニアとしてのセンスです。

`GetRows` を使えば、データベースへの通信は「たった一度」で済みます。あとは、パソコンの超高速なメモリ(配列)の上で計算を行うだけ。この差は、データ量が増えれば増えるほど、天と地ほどの開きになります。

3. 【最重要】GetRowsが仕掛ける「最大の罠」

さて、ここからが本題です。`GetRows` は強力ですが、初心者が必ずと言っていいほど陥る「罠」があります。

それは、「生成される配列の構造(次元)が、私たちの直感とは逆である」ということです。

普通の感覚だと、配列は `Array(行, 列)`、つまり `(レコード番号, フィールド番号)` の順で作られると思いませんか?
しかし、`GetRows` が作る配列は、`Array(列, 行)`、つまり `(フィールド番号, レコード番号)` なのです。

構造のイメージ図

例えば、`ID` と `Name` という2つのフィールドを持つレコードセットを `GetRows` した場合:

【あなたの直感】

ID (0) Name (1)
Row 0 1 Tanaka
Row 1 2 Sato

【GetRowsの実態(ここが重要!)】

Row 0 Row 1
Col 0 (ID) 1 2
Col 1 (Name) Tanaka Sato

「列(フィールド)」が外側の次元(1次元目)になり、「行(レコード)」が内側の次元(2次元目)になります。
この構造を知らずに `myArray(i, j)` とアクセスしようとすると、必ずエラー(インデックスが範囲外です)にぶち当たります。

4. 実践:GetRowsによる高速データ処理の実装例

では、この罠を回避しつつ、正しく高速処理を行うコードを書いてみましょう。
今回は「顧客テーブルからデータを一括取得し、メモリ上で加工する」というシナリオです。

Sub HighSpeedDataProcessing()
    Dim db As DAO.Database
    Dim rs As DAO.Recordset
    Dim varData As Variant ' 配列を受け取るためのVariant型
    Dim rowCount As Long
    Dim colCount As Long
    Dim i As Long, j As Long
    
    Set db = CurrentDb
    Set rs = db.OpenRecordset("SELECT ID, UserName, Score FROM T_Customer", dbOpenSnapshot)
    
    ' 1. データが存在するかチェック
    If rs.EOF Then
        MsgBox "データがありません。"
        rs.Close
        Exit Sub
    End If
    
    ' 2. 【極意】GetRowsで全データを一括して配列へ格納
    ' ここでデータベースとの通信は終了。あとはメモリの中だけで完結する。
    varData = rs.GetRows
    
    ' レコードセットをすぐに閉じて、メモリを解放する(重要!)
    rs.Close
    Set rs = Nothing
    
    ' 3. 配列のサイズ(範囲)を取得
    ' LBound/UBoundを使って、配列の「行」と「列」を正確に把握する
    ' GetRowsの特性上、1次元目がフィールド(列)、2次元目がレコード(行)
    colCount = UBound(varData, 1) ' フィールドの最大インデックス
    rowCount = UBound(varData, 2) ' レコードの最大インデックス
    
    Debug.Print "--- 高速処理開始 ---"
    
    ' 4. 配列をループ処理
    ' 注意:varData(列, 行) の順序でアクセスすること!
    For i = 0 To rowCount ' 行のループ
        ' フィールドごとに値を参照
        Dim id As Long:    id = varData(0, i)     ' 0番目のフィールド: ID
        Dim name As String: name = varData(1, i)  ' 1番目のフィールド: UserName
        Dim score As Integer: score = varData(2, i) ' 2番目のフィールド: Score
        
        ' メモリ上での演算(例:スコアが80点以上ならVIP扱い)
        If score >= 80 Then
            Debug.Print "VIP: " & name & " (ID: " & id & ")"
        Else
            Debug.Print "Regular: " & name
        End If
    Next i
    
    Debug.Print "--- 高速処理終了 ---"
    
    Set db = Nothing
End Sub

コードのポイント解説

1. `varData = rs.GetRows`: ここが心臓部です。一瞬でデータがメモリにコピーされます。
2. `rs.Close` のタイミング: `GetRows` で配列にコピーした直後に、レコードセットを閉じてしまいましょう。データベースとの接続を早めに切り離すのが、プロの作法です。
3. `UBound(varData, 1)` と `UBound(varData, 2)`:

  • `1` は「列(フィールド)」の数。
  • `2` は「行(レコード)」の数。

この使い分けが、配列の迷宮から抜け出す鍵です。
4. `varData(フィールドIndex, 行Index)`: ループ内でのアクセス順序に注目してください。これが `GetRows` のルールです。

5. 陥りやすいエラーと回避策

① 「インデックスが範囲外です」エラー

これは、ほぼ100% 「(行, 列) の順で書いている」 ことが原因です。
`varData(i, j)` と書いていないか、今一度確認してください。

② 「メモリ不足」エラー

`GetRows` は全データをメモリに載せます。もし数百万件という膨大なデータを一度に `GetRows` しようとすると、パソコンのメモリを食いつぶしてクラッシュします。

  • 対策: `SELECT` 文の `WHERE` 句で、処理対象をある程度絞り込んでから `GetRows` を使うのが鉄則です。

③ レコードの更新(Update)ができない

`GetRows` で取得した配列は、あくまで「データのコピー」です。
配列の中身を書き換えても、元のテーブルの値は変わりません。

  • 使い分け:
  • 「読み込み・計算・表示」 $\rightarrow$ `GetRows`(爆速)
  • 「データの書き換え・削除」 $\rightarrow$ 通常の `Recordset.Edit`(確実)

まとめ:思考を「カーソル」から「メモリ」へ

これまでのあなたは、レコードセットという「カーソル(指差し棒)」を使って、1行ずつデータを指差して確認するスタイルでした。
これからは、「データを一気にメモリという広大なキャンバスに広げ、その上で一気に処理を完結させる」スタイルを手に入れてください。

この `GetRows` という武器を使いこなせれば、あなたの作るAccessアプリケーションのパフォーマンスは、劇的に、そして劇的に変わります。

「動けばいい」のフェーズを卒業し、「速くて美しい」コードを書くエンジニアへ。
一歩ずつ、着実に進んでいきましょう。応援していますよ。

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