【テクニカル・上級編】【上級者向け】カスタムフィールドの定義変更がプロジェクトのパフォーマンスに与える影響を定量化する計測ツール – Project VBA解析バイブル

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

数式のエントロピー:Project VBAにおけるカスタムフィールドが計算エンジンに与える負荷の定量化

大規模なプロジェクト管理システムを構築していると、必ずと言っていいほど「ある壁」にぶち当たる。ユーザーからの「プロジェクトを開くのが遅い」「保存に時間がかかる」という、抽象的で、かつ解決の糸口が見えにくい悲鳴だ。

多くのエンジニアは、まずネットワーク帯域やストレージのI/O、あるいは単純なタスク数の増大を疑う。しかし、真のアーキテクトなら、その裏側に潜む「計算エンジンのエントロピー」に目を向けるべきだ。

Microsoft Projectにおけるカスタムフィールド(`Task.Text1`や`Resource.Number1`など)に設定された数式は、一見すると単なる便利な属性に見える。しかし、その実態は、プロジェクトの計算グラフ(Calculation Graph)に新たな依存関係を動的に追加し続ける、潜在的な計算爆弾である。

本稿では、カスタムフィールドの数式がプロジェクトのパフォーマンスに与える影響を、Windows APIを用いた高精度タイマーによって定量化し、ボトルネックを特定するためのベンチマークツールの設計思想とその実装について詳述する。

1. 物理的限界への挑戦:なぜ標準の `Timer` では足りないのか

VBA標準の `Timer` 関数は、秒単位の精度しか持たない。我々が計測すべきは、数千、数万のタスクが絡み合う計算エンジンのスループットであり、ミリ秒、あるいはマイクロ秒単位の差異が、大規模プロジェクトにおける「快適さ」と「システムの崩壊」を分ける。

ここで必要となるのが、Windows APIの `QueryPerformanceCounter` (QPC) だ。これはハードウェアのカウンタに直接アクセスし、極めて高い分解能で経過時間を取得するための手段である。レガシーな環境から最新のWindows 11に至るまで、システムのクロック周波数に依存しない、真に信頼できる計測を実現するために不可欠な技術だ。

2. ボトルネックの正体:計算グラフの複雑性

MS Projectの計算エンジンは、タスク間の依存関係(Predecessors/Successors)をグラフ構造として保持している。カスタムフィールドに数式(Formula)を定義すると、このグラフに「属性値の依存関係」という新たなエッジが追加される。

例えば、`Text1` が `Text2` に依存し、`Text2` が `Duration` に依存している場合、`Duration` が変更されるたびに、エンジンは連鎖的に数式を再評価しなければならない。この再評価のコストは、単なる線形な $O(n)$ ではなく、依存関係の深さと複雑さに比例して指数関数的に増大する可能性がある。

これを計測するには、「数式の有無による計算時間の差分」を、ノイズを排除した状態で抽出する必要がある。

3. 実装:高精度パフォーマンス・ベンチマーク・ツール

以下に、カスタムフィールドの計算負荷を測定するためのコア・モジュールを示す。このコードは、単なる計測器ではない。オブジェクトのライフサイクルを制御し、メモリリークを防ぎ、計測の純度を高めるための設計思想に基づいている。

Option Explicit

' ==============================================================================
' Module: PerformanceProfiler
' Description: Windows APIを用いた高精度計測およびProject計算負荷の定量化
' Author: Chief Architect
' ==============================================================================

' Windows API Declarations for High-Precision Timing
Private Declare PtrSafe Function QueryPerformanceCounter Lib "kernel32" (lpPerformanceCount As Currency) As Long
Private Declare PtrSafe Function QueryPerformanceFrequency Lib "kernel32" (lpFrequency As Currency) As Long

''' <summary>
''' プロジェクトの計算時間を高精度に計測する。
''' </summary>
Public Sub BenchmarkCustomFieldImpact()
    Dim startTicks As Currency
    Dim endTicks As Currency
    Dim freq As Currency
    Dim calcTimeSec As Double
    
    Dim taskCount As Long
    Dim formulaCount As Integer
    Dim i As Integer
    
    ' 高精度タイマーの周波数を取得
    If QueryPerformanceFrequency(freq) = 0 Then
        MsgBox "High-performance counter not supported.", vbCritical
        Exit Sub
    End If

    On Error GoTo ErrorHandler

    ' --- Phase 1: Baseline Measurement (No Recalculation) ---
    ' 計算エンジンを静止させた状態での初期状態を確保
    Debug.Print "--- Starting Benchmark ---"
    
    ' --- Phase 2: Forced Recalculation Measurement ---
    ' 意図的に再計算をトリガーし、その実行時間を計測
    Debug.Print "Measuring Calculation Engine Load..."
    
    QueryPerformanceCounter startTicks
    
    ' MS Projectの計算エンジンを強制稼働させる
    ' Application.Calculate は、全ての依存関係を走査する
    Application.Calculate
    
    QueryPerformanceCounter endTicks
    
    ' 経過時間の算出 (Ticks / Frequency)
    calcTimeSec = (endTicks - startTicks) / freq
    
    ' --- Phase 3: Data Aggregation ---
    taskCount = Application.Tasks.Count
    
    ' カスタムフィールドの数式設定状況を簡易的にスキャン(実装は環境に依存)
    ' ここではデモとして、計算された時間をログ出力する
    PrintResults taskCount, calcTimeSec

CleanUp:
    ' オブジェクトの明示的な解放
    ' VBAのCOMオブジェクトは、スコープを抜ける際に解放されるが、
    ' 大規模なループ内では明示的な Nothing 代入がメモリの断片化を防ぐ
    Set Application = Nothing 
    Exit Sub

ErrorHandler:
    Debug.Print "Critical Error: " & Err.Description
    Resume CleanUp
End Sub

''' <summary>
''' 計測結果を標準出力およびログに記録する。
''' </summary>
Private Sub PrintResults(ByVal tCount As Long, ByVal duration As Double)
    Dim logMsg As String
    logMsg = String(50, "=") & vbCrLf & _
             "Benchmark Report" & vbCrLf & _
             String(50, "=") & vbCrLf & _
             "Total Tasks: " & tCount & vbCrLf & _
             "Calc Duration: " & Format(duration, "0.0000") & " seconds" & vbCrLf & _
             "Throughput: " & Format(tCount / IIf(duration = 0, 1, duration), "0.00") & " tasks/sec" & vbCrLf & _
             String(50, "=")
             
    Debug.Print logMsg
    MsgBox logMsg, vbInformation, "Benchmark Complete"
End Sub

コードの技術的解説

1. `QueryPerformanceCounter` の採用:
`Currency` 型を使用して `Ticks` を受けることで、64ビット環境における精度を担保している。`Timer` 関数では不可能な、マイクロ秒単位の解像度での差分抽出が可能だ。
2. 計算負荷の分離:
`Application.Calculate` を直接叩くことで、ユーザーの操作(UIスレッドの待ち時間)を排除し、純粋に「計算エンジン(バックエンド)の処理時間」のみを抽出している。
3. メモリ管理の規律:
`Set Application = Nothing` を明示している。Project VBAにおいて、大規模なオブジェクトグラフを扱う際、ガベージコレクション(VBAにおける参照カウントの減衰)を待つことは、メモリの断片化を招き、次の計測にノイズを混入させる原因となる。

4. 運用における知見:ボトルネックの特定と回避策

このツールを用いて計測を行った際、もし `tasks/sec`(タスクあたりの処理能力)が、タスク数の増加に伴って非線形に低下しているならば、それはカスタムフィールドの数式が「循環参照に近い複雑な依存関係」を生み出している証拠だ。

対策としてのアーキテクチャ設計

シニアエンジニアとして、以下の3点を設計指針に据えることを推奨する。

  • 数式の平坦化 (Flattening Formulas):

`Text1` が `Text2` を参照し、`Text2` が `Text3` を参照するような多段構成は避けるべきだ。可能な限り、基本属性(Duration, Start, Finish)から直接計算を行う「平坦な数式」を設計せよ。

  • 計算の遅延 (Deferred Calculation):

リアルタイムの計算が不要な属性については、VBAによるバッチ処理(ボタン押下時に一度だけ計算を実行する仕組み)へ移行し、Project標準の自動計算エンジンから切り離す。

  • データ型の最適化:

`Text` 型のフィールドで文字列操作(`Left`, `Mid`, `InStr`)を多用するのは最悪の選択だ。計算コストは文字列操作において極めて高い。数値計算が可能な場合は、`Number` 型のフィールドを優先的に使用せよ。

結言

パフォーマンスの低下は、常に「利便性の代償」として忍び寄る。しかし、その代償がシステムの限界を超える前に、エンジニアは定量的なエビデンスを持って介入しなければならない。

本稿で示した計測手法は、単なるデバッグツールではない。プロジェクトの健全性を維持し、レガシーなシステムを次世代へと繋ぐための、アーキテクトとしての「武器」である。

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