【実務・中級編】ADOのCursorLocationプロパティの罠:ClientとServerの挙動を理解してパフォーマンスを最大化する – Access VBA解析バイブル

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

ADOのCursorLocationプロパティの罠:ClientとServerの挙動を理解してパフォーマンスを最大化する

業務自動化の現場で、Access VBAを用いた大規模なデータ処理に挑む際、多くの開発者が「なぜか動作が重い」「特定のレコードセット操作でエラーが出る」「メモリ不足で落ちる」という壁に突き当たります。

その原因の多くは、SQLの書き方ではなく、ADO(ActiveX Data Objects)のCursorLocationプロパティに対する理解不足にあります。

「とりあえず動くから」と、デフォルト設定や、ネットに転がっているコードを無批判にコピーしていませんか? それは、将来的にシステムの崩壊を招く「設計上の時限爆弾」を抱え込んでいるのと同じです。

本記事では、伝説的なアーキテクトの視点から、`adUseClient` と `adUseServer` の本質的な違いを解剖し、実務で通用する堅牢な設計手法を伝授します。

1. 核心:CursorLocationとは「データの居場所」の決定である

ADOにおけるCursorLocationとは、一言で言えば「レコードセットのポインタ(カーソル)と、取得したデータの実体を、どこに保持するか」を決める設計指針です。

これには大きく分けて2つのモードが存在します。

adUseServer(サーバーサイド・カーソル)

カーソルとデータの管理を、データベースエンジン(サーバー側)に委ねる方式です。

  • 挙動: クライアント(Access)は「現在のレコードはこれです」という指示をサーバーに送り、サーバーがそれに応答します。
  • メリット: クライアント側のメモリ消費を極限まで抑えられる。巨大なテーブルに対しても、必要な分だけをやり取りできる。
  • デメリット: ネットワーク越しに何度も通信(ラウンドトリップ)が発生するため、細かな操作が多いと極端に遅くなる。また、クライアント側での高度な操作(ソートやフィルタリング)に制限がある。

adUseClient(クライアントサイド・カーソル)

データを一度クライアント側のメモリ上にすべて展開し、そこでカーソルを管理する方式です。

  • 挙動: サーバーからデータをドサッと一括で引き抜き、自分の手元(メモリ)で管理します。
  • メリット: メモリ上での操作になるため、`.Filter` や `.Sort` といった操作が爆速になる。また、一度取得すればネットワーク通信を気にせず自由に扱える。
  • デメリット: データ量に比例してクライアントのメモリを消費する。数百万件のデータを不用意に取得すれば、即座に「メモリ不足」でアプリケーションは死ぬ。

2. 実務における「使い分け」の設計思想

プロフェッショナルなエンジニアは、コードを書く前に「データの規模」と「操作の性質」から、どちらのモードを採用すべきかを即断します。

特徴 adUseServer adUseClient
主な用途 大量データのバッチ処理、更新処理 UIへの表示、ユーザーによる絞り込み・並び替え
メモリ負荷 低い(非常に安全) 高い(データ量に依存)
ネットワーク 通信回数が多い(頻繁な往復) 通信は一括(一回で済ませる)
操作の柔軟性 低い(SQLに依存) 高い(Filter/Sortが自由自在)

「大量のレコードを順次更新するなら Server」「ユーザーが画面上でポチポチと条件を変えて検索するなら Client」。これが鉄則です。

3. プロダクションレベルのコード実装例

それでは、これらの概念をどのようにコードに落とし込むべきか。保守性が高く、バグを最小限に抑える実装パターンを示します。

パターンA:UI操作を重視した Client-side 実装

ユーザーが画面上でフィルタリングやソートを行うような、対話的なツールに適したパターンです。

''' <summary>
''' クライアントサイドカーソルを用いた、柔軟な検索用レコードセット取得
''' </summary>
Public Function GetSearchableRecordset(ByVal strSql As String) As ADODB.Recordset
    Dim rs As ADODB.Recordset
    Set rs = New ADODB.Recordset
    
    On Error GoTo ErrorHandler

    ' 【重要】クライアントサイドカーソルを指定
    ' これにより、取得後に rs.Filter や rs.Sort が使用可能になる
    rs.CursorLocation = adUseClient
    
    ' Open時に、レコードセットの型とロックタイプを明示的に指定する
    ' adOpenStatic: 静的カーソル(データ変更を追従させず、メモリ上で自由に扱う)
    ' adLockOptimistic: 楽観的ロック(更新時のみロックをかける)
    rs.Open strSql, CurrentProject.Connection, adOpenStatic, adLockOptimistic
    
    Set GetSearchableRecordset = rs
    Exit Function

ErrorHandler:
    Debug.Print "Error in GetSearchableRecordset: " & Err.Description
    If Not rs Is Nothing Then
        If rs.State = adStateOpen Then rs.Close
    End Set rs = Nothing
    ' 呼び出し元にエラーを伝播させる
    Err.Raise Err.Number, "GetSearchableRecordset", Err.Description
End Function

' --- 使用例 ---
Sub Sample_UI_Operation()
    Dim rs As ADODB.Recordset
    Set rs = GetSearchableRecordset("SELECT * FROM T_Employee")
    
    ' Client-sideなので、SQLを再発行せずにメモリ上でフィルタリングが可能
    rs.Filter = "Department = 'Sales'"
    
    If Not rs.EOF Then
        Debug.Print "Found: " & rs!EmployeeName
    End If
    
    rs.Close
    Set rs = Nothing
End Sub

パターンB:大量データ処理を重視した Server-side 実装

数万件、数十万件のデータをループで回して集計・更新を行うような、バックグラウンド処理に適したパターンです。

''' <summary>
''' サーバーサイドカーソルを用いた、大量データ更新用トランザクション処理
''' </summary>
Public Sub BatchUpdateProcess()
    Dim conn As ADODB.Connection
    Dim rs As ADODB.Recordset
    Dim strSql As String
    
    Set conn = CurrentProject.Connection
    strSql = "SELECT * FROM T_LargeData WHERE Status = 'Unprocessed'"
    
    On Error GoTo ErrorHandler

    ' トランザクション開始(堅牢な設計の基本)
    conn.BeginTrans
    
    Set rs = New ADODB.Recordset
    ' 【重要】デフォルトの adUseServer を意識。
    ' メモリを節約し、サーバー側のカーソルで直接レコードを走査する。
    rs.CursorLocation = adUseServer
    
    ' adOpenForwardOnly: 前方向に進むだけのカーソル(最速・最軽量)
    ' adLockOptimistic: 更新を可能にする
    rs.Open strSql, conn, adOpenForwardOnly, adLockOptimistic
    
    Do While Not rs.EOF
        ' --- ここに重いロジックを記述 ---
        rs!Status = "Processed"
        rs!ProcessedDate = Now()
        
        ' レコードの更新
        rs.Update
        
        rs.MoveNext
    Loop
    
    ' 全ての処理が成功したらコミット
    conn.CommitTrans
    Debug.Print "Batch update completed successfully."

CleanUp:
    If Not rs Is Nothing Then
        If rs.State = adStateOpen Then rs.Close
        Set rs = Nothing
    End If
    Exit Sub

ErrorHandler:
    ' エラーが発生した場合はロールバックして整合性を守る
    If Not conn Is Nothing Then conn.RollbackTrans
    MsgBox "Critical Error during batch process: " & Err.Description, vbCritical
    Resume CleanUp
End Sub

4. アーキテクトからの最終アドバイス

CursorLocationの選択を誤ると、どれほど優れたアルゴリズムを書いても、システムのパフォーマンスは劇的に低下します。設計時に以下のチェックリストを脳内に叩き込んでください。

1. 「そのデータはメモリに乗るか?」

  • Yes $\rightarrow$ `adUseClient` を検討。ユーザー体験(UX)を優先する。
  • No $\rightarrow$ `adUseServer` 一択。システムの安定性を優先する。

2. 「レコードセットに対して、SQL以外で操作(Filter/Sort)を行うか?」

  • Yes $\rightarrow$ `adUseClient` が必要。
  • No $\rightarrow$ `adUseServer` で通信コストを最小化する。

3. 「更新処理の整合性は担保されているか?」

  • 大量更新を行うなら、必ず `BeginTrans` / `CommitTrans` を組み合わせ、`adUseServer` で効率的に回すこと。

「動けばいい」という考えは、エンジニアの成長を止め、プロジェクトを破綻させる。
「なぜそのカーソル位置なのか」を論理的に説明できるコードを書くこと。それが、真のプロフェッショナルへの第一歩である。

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