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

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

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

こんにちは。今日もコードと格闘しているあなた、素晴らしいですね。

Access VBAで「マクロの記録」から一歩踏み出し、ADO(ActiveX Data Objects)を使ってデータベースを操作しようとしている。その挑戦自体が、あなたが「単なる操作者」から「エンジニア」へと進化しようとしている証拠です。

しかし、ADOを使い始めた多くの人が、ある「見えない壁」にぶつかります。
「なぜか動作が重い」「大量のデータを扱うとメモリ不足になる」「接続を切った瞬間にデータが消えた」……。

これらのトラブルの多くは、コードの書き方のミスではなく、「CursorLocation(カーソルロケーション)」というプロパティの理解不足、つまり「データがメモリのどこに居座っているか」を知らないことに起因しています。

今日は、このプロパティが持つ「Client」と「Server」という2つの世界の違いを、アーキテクチャの視点から解き明かしていきましょう。ここをマスターすれば、あなたの作るシステムは劇的に軽く、そして強固なものになりますよ。

1. 「カーソル」とは何か? — データの「しおり」をイメージしよう

技術的な詳細に入る前に、まず「カーソル」という概念を整理しましょう。

データベースから1万件のレコードを取得したとき、プログラムは「今、何件目のデータを読んでいるのか」を知る必要があります。この「今、ここを読んでいますよ」という現在位置を示す「しおり」のような役割を果たすのが「カーソル」です。

そして、`CursorLocation` プロパティとは、「その『しおり』を、サーバー側(データベース側)で管理するか、クライアント側(あなたのPC側)で管理するか」を決める司令塔なのです。

2. 「Server側」と「Client側」:2つの世界の正体

ここからが本題です。`adUseServer` と `adUseClient`、それぞれの挙動を徹底比較します。

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

「しおりは、図書館の司書(サーバー)が持っている」状態です。

  • 挙動: あなた(クライアント)が「次のレコードを見せて」と頼むたびに、ネットワーク越しにサーバーへ問い合わせに行きます。
  • メリット:
  • あなたのPC(メモリ)には、今見ているレコード分くらいの最小限のデータしか流れてきません。そのため、数百万件という膨大なデータを扱う際も、クライアント側のメモリを圧迫しません。
  • デメリット:
  • 「次のレコード」「前のレコード」へ移動するたびに通信が発生するため、ネットワークが遅いと動作がモッサリします。
  • レコードセットに対して「並べ替え(Sort)」や「フィルタリング(Filter)」をクライアント側で行う機能が制限されます。

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

「しおりは、手元のノート(あなたのPC)にコピーして持っている」状態です。

  • 挙動: 接続した瞬間に、条件に一致するデータをまるごとあなたのPCのメモリにダウンロードします。
  • メリット:
  • 一度ダウンロードしてしまえば、メモリ内での操作になるため、並べ替えやフィルタリングが爆速です。
  • 「Disconnected Recordset(切断されたレコードセット)」という、接続を切ってもデータを保持し続ける高度な使い方が可能になります。
  • デメリット:
  • 大量のデータを取得しようとすると、あなたのPCのメモリを猛烈に消費します。最悪の場合、Accessが「メモリ不足」で強制終了します。

3. 【実践】コードで見る挙動の違い

では、実際にどのように使い分けるのか、VBAのコードで見てみましょう。

Option Explicit

' 参照設定: Microsoft ActiveX Data Objects x.x Library が必要です
Sub CompareCursorLocations()
    Dim cn As ADODB.Connection
    Dim rs As ADODB.Recordset
    Dim strSql As String
    
    ' 接続文字列(環境に合わせて書き換えてください)
    Dim strConn As String
    strConn = "Provider=Microsoft.ACE.OLEDB.12.0;Data Source=C:\YourPath\YourDatabase.accdb;"
    
    strSql = "SELECT * FROM LargeTable" ' 大量データが入っている想定のテーブル

    ' --- パターンA: Server-side Cursor (メモリ節約重視) ---
    Set cn = New ADODB.Connection
    cn.Open strConn
    
    Set rs = New ADODB.Recordset
    ' Serverサイドを指定
    rs.CursorLocation = adUseServer 
    
    rs.Open strSql, cn, adOpenStatic, adLockReadOnly
    
    Debug.Print "--- Server-side Mode ---"
    Debug.Print "Record Count: " & rs.RecordCount
    ' サーバー側で管理しているため、移動のたびに通信が発生する可能性がある
    If Not rs.EOF Then Debug.Print "First Record ID: " & rs!ID
    
    rs.Close
    cn.Close
    Set rs = Nothing
    Set cn = Nothing


    ' --- パターンB: Client-side Cursor (操作スピード・機能重視) ---
    Set cn = New ADODB.Connection
    cn.Open strConn
    
    Set rs = New ADODB.Recordset
    ' Clientサイドを指定。これが実務での「お作法」になることが多い
    rs.CursorLocation = adUseClient 
    
    rs.Open strSql, cn, adOpenStatic, adLockOptimistic
    
    Debug.Print "--- Client-side Mode ---"
    Debug.Print "Record Count: " & rs.RecordCount
    
    ' クライアント側にデータが全展開されているため、高速にソートやフィルタができる
    rs.Sort = "ID DESC" 
    If Not rs.EOF Then Debug.Print "Top Record ID (Sorted): " & rs!ID
    
    rs.Close
    cn.Close
    Set rs = Nothing
    Set cn = Nothing
End Sub

4. アーキテクトからのアドバイス:どう使い分けるべきか?

「結局、どっちを使えばいいの?」という問いへの答えは、「扱うデータの性質」によって決まります。

## `adUseClient` を選ぶべきケース(推奨されることが多い)

実務のAccessアプリケーションにおいて、多くの場合はこちらが適しています。

  • UI(画面)との連動: 画面上のコンボボックスやリストボックスにデータを表示し、ユーザーが自由に並べ替えたり検索したりさせたい場合。
  • データの加工: 取得したデータをメモリ上で一旦加工してから、別の処理に回したい場合。
  • 切断運用: データを取得した後にデータベース接続を切り、オフライン状態で処理を行いたい場合。

## `adUseServer` を選ぶべきケース

  • 超巨大データの読み取り: 数百万件のログデータなど、メモリに載せること自体が物理的に不可能な場合。
  • サーバー負荷の軽減: クライアント側のスペックが極端に低く、メモリ消費を最小限に抑えなければならない特殊な環境。

5. まとめ:ここをクリアすれば、基本はバッチリです

今回のポイントを整理しましょう。

1. `adUseServer` は「サーバーに任せる」。メモリには優しいが、通信のオーバーヘッドと機能制限がある。
2. `adUseClient` は「手元に持ってくる」。操作は爆速だが、メモリを大量に消費する。
3. 設計の肝は、「メモリ容量」と「ユーザー体験(スピード)」のトレードオフを見極めること。

「とりあえず動くコード」を書く段階から、「なぜこの設定なのか」を説明できる段階へ。この意識の差が、数ヶ月後のメンテナンス時や、システムが重くなった時のあなたの助けになります。

もし、大量のデータを扱っていてAccessが落ちるようになったら、まずはこの `CursorLocation` を疑ってみてくださいね。

一歩ずつ、着実に。あなたのエンジニアとしての歩みを応援しています!

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