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