COMの境界線を越えるな:MS Project VBAにおける「仮想化バッファ」による極限の高速化戦略
MS Projectのオブジェクトモデルを扱っている際、多くのエンジニアが直面する「壁」がある。それは、タスク数やリソース数が数千規模に膨れ上がった瞬間に、処理速度が指数関数的に低下する現象だ。
なぜか? 答えは単純だ。COM(Component Object Model)のオーバーヘッドを軽視しているからだ。
`Task.Text1 = “Value”` と一行書くたびに、VBAの実行環境とMS Projectの本体プロセス間では、メモリ空間を跨ぐコンテキストスイッチが発生している。この「境界線」を跨ぐ回数が、パフォーマンスの決定的なボトルネックとなる。
本稿では、このCOM境界線を極限まで排除し、メモリ上で計算を完結させてから一括反映させる「仮想化バッファ(Virtualized Buffer)」の実装手法について、その設計思想と実装の詳細を解説する。
1. 従来の設計思想における致命的な欠陥
一般的なエンジニアが書くコードは、以下のパターンに陥りがちである。
' --- アンチパターン:COM境界線を頻繁に跨ぐ設計 ---
Sub NaiveApproach()
Dim t As Task
For Each t In ActiveProject.Tasks
If Not t Is Nothing Then
' 読み取りで1回、計算でロジック実行、書き込みで1回、計2回以上の境界跨ぎが発生
t.Text1 = t.Text2 & "_" & t.Text3
End If
Next t
End Sub
このコードは、タスクが10,000件あれば、最低でも20,000回以上のCOMアクセスを発生させる。これは、現代のCPU性能を無駄に浪費する極めて非効率なアーキテクチャだ。我々が目指すべきは、「読み込みは一括、計算は純粋なメモリ上、書き込みは一括」というETL(Extract, Transform, Load)モデルへの転換である。
2. 仮想化バッファ・アーキテクチャの設計
高速化を実現するための戦略は、以下の3フェーズに分割される。
1. Extraction (抽出): Projectオブジェクトから必要なプロパティを、ネイティブなVBA配列(またはUser Defined Typeの配列)へ一括で吸い上げる。
2. Transformation (変換): Projectオブジェクトを一切参照せず、メモリ上の配列のみを用いて計算ロジックを実行する。ここが「仮想化バッファ」の核心部である。
3. Loading (反映): 計算結果を保持した配列を、再度Projectオブジェクトへ一括で書き戻す。
この設計により、COM境界線を跨ぐ回数を $O(N)$ から $O(1)$ に近づけることが可能になる。
3. 実装:極限のパフォーマンスを引き出すコード
以下に、カスタムフィールド(Text1)に複雑な計算結果を反映させるための、プロフェッショナルな実装例を示す。ここでは、精緻な計測のために Windows API を利用し、処理時間をマイクロ秒単位で捕捉する。
Option Explicit
' --- Windows API: 高精度タイマー ---
If VBA7 Then
Declare PtrSafe Function QueryPerformanceCounter Lib "kernel32" (lpPerformanceCounter As Currency) As Long
Declare PtrSafe Function QueryPerformanceFrequency Lib "kernel32" (lpFrequency As Currency) As Long
Else
Declare Function QueryPerformanceCounter Lib "kernel32" (lpPerformanceCounter As Currency) As Long
Declare Function QueryPerformanceFrequency Lib "kernel32" (lpFrequency As Currency) As Long
End If
' --- カスタムデータ構造体 ---
' 必要なプロパティのみを定義し、メモリ消費を最適化する
Private Type TaskBuffer
ID As Long
InputVal1 As String
InputVal2 As String
ResultVal As String
End Type
Sub ExecuteHighSpeedOptimization()
Dim startTime As Currency
Dim endTime As Currency
Dim freq As Currency
' 計測開始
QueryPerformanceFrequency freq
QueryPerformanceCounter startTime
' 1. Extraction Phase
Dim buffer() As TaskBuffer
Call ExtractTaskData(buffer)
' 2. Transformation Phase (Pure Memory Processing)
Call TransformBuffer(buffer)
' 3. Loading Phase
Call LoadBufferToProject(buffer)
' 計測終了
QueryPerformanceCounter endTime
MsgBox "処理完了。実行時間: " & Format((endTime - startTime) / freq, "0.000") & " 秒", vbInformation
End Sub
' --- Phase 1: Extraction ---
' COMオブジェクトへのアクセスを最小限に抑え、メモリへ転送
Private Sub ExtractTaskData(ByRef buffer() As TaskBuffer)
Dim t As Task
Dim i As Long
Dim taskCount As Long
' タスク数を事前に把握
taskCount = ActiveProject.Tasks.Count
ReDim buffer(1 To taskCount)
i = 1
For Each t In ActiveProject.Tasks
If Not t Is Nothing Then
' ここでCOM境界を跨ぐ。ただし、読み取りは一度きり。
With buffer(i)
.ID = t.ID
.InputVal1 = t.Text1
.InputVal2 = t.Text2
End With
i = i + 1
End If
Next t
' 余剰分を切り詰め(メモリの最適化)
If i <= taskCount Then
ReDim Preserve buffer(1 To i - 1)
End If
End Sub
' --- Phase 2: Transformation ---
' 【重要】ここではProjectオブジェクトを一切参照しない。
' 純粋なロジックのみが走り、CPUキャッシュの効率を最大化する。
Private Sub TransformBuffer(ByRef buffer() As TaskBuffer)
Dim i As Long
For i = LBound(buffer) To UBound(buffer)
' 例: 文字列結合と複雑なロジックのシミュレーション
' 実際の業務では、ここに行列演算や複雑な条件分岐を実装する
buffer(i).ResultVal = buffer(i).InputVal1 & " | " & buffer(i).InputVal2 & " | PROCESSED"
Next i
End Sub
' --- Phase 3: Loading ---
' 計算結果をProjectへ書き戻す
Private Sub LoadBufferToProject(ByRef buffer() As TaskBuffer)
Dim i As Long
Dim t As Task
Dim targetID As Long
' 注意: Projectには「一括書き込み」のAPIが存在しないため、
' IDをキーにして、最短のパスで書き戻す。
' 大規模データの場合、Dictionaryオブジェクトを使用してTaskオブジェクトをキャッシュする手法も有効。
For i = LBound(buffer) To UBound(buffer)
' ターゲットとなるタスクを特定
' 本来は、Extract時にTaskオブジェクトの参照を保持しておくのが最速だが、
' メモリ節約のためここではID検索とする。
On Error Resume Next
Set t = ActiveProject.Tasks(buffer(i).ID)
On Error GoTo 0
If Not t Is Nothing Then
t.Text1 = buffer(i).ResultVal
End If
Next i
End Sub
4. アーキテクトの視点:さらなる最適化への知見
上記のコードは、標準的なアプローチよりも遥かに高速だが、極限を求めるならば以下の要素を考慮せよ。
4.1. オブジェクト参照のキャッシュ化
`LoadBufferToProject` において、`ActiveProject.Tasks(id)` を呼び出すのは、依然として $O(N)$ の検索コストを伴う。
Extractフェーズにおいて、`TaskBuffer` 構造体に `Task` オブジェクトそのもの(`Object`型)を格納しておけば、Loadingフェーズでの検索コストをゼロにできる。ただし、これはメモリ消費量を増大させるため、「実行速度 vs メモリ使用量」のトレードオフを慎重に判断せよ。
4.2. メモリリークの防止とライフサイクル管理
VBAにおいて、大規模な配列やオブジェクトを扱う場合、プロシージャ終了時に明示的に `Erase buffer` を実行し、オブジェクト参照を `Set obj = Nothing` で解放することは基本中の基本だ。特に、外部DLLやWindows APIを併用する場合、スタックオーバーフローやメモリ断片化がシステム全体の不安定化を招くリスクがある。
4.3. レガシー環境への配慮
MS Projectのバージョンによっては、`Task` オブジェクトの挙動が微妙に異なる場合がある。特に、カスタムフィールドの定義(`CustomFieldDefinition`)が未定義の状態で `Text1` にアクセスしようとすると、ランタイムエラーが発生する。実装前に、必ず `CustomFieldDefinition` の存在を確認するバリデーション層を設けるのが、堅牢なシステム管理者の作法である。
結論
MS Project VBAにおける真のプロフェッショナルとは、単にコードが書ける者ではない。データの流れ(Data Flow)を制御し、システムのボトルネックがどこにあるかを物理的なレイヤー(メモリ・プロセス・バス)の視点から理解している者を指す。
「仮想化バッファ」の導入は、単なるテクニックではない。それは、レガシーなCOMアーキテクチャという制約の中で、現代的なデータ処理の原則を貫徹するための、エンジニアとしての「意志」である。
