【実務・中級編】DAOとADOのトランザクション管理:BeginTransの「入れ子」制限とエラー発生時のロールバック鉄則 – Access VBA解析バイブル

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

トランザクションの罠:DAOとADOにおける「入れ子」の誤解と、データ整合性を守る鉄則

業務アプリケーションの開発において、もっとも恐ろしいのは「プログラムが止まること」ではない。「プログラムは動いているが、データが中途半端に書き換わっていること」だ。

Access VBAを用いた開発現場では、ローカルのACEエンジンを叩くためのDAO (Data Access Objects) と、SQL Serverなどの外部DBへ接続するためのADO (ActiveX Data Objects) が混在することがある。この二つのアーキテクチャにおける「トランザクション管理」の違いを理解していないエンジニアは、必ずといっていいほど「データが壊れる」という地雷を踏むことになる。

本稿では、中級者以上が必ず押さえておくべき、DAO/ADOのトランザクションにおける「入れ子(Nested)の真実」と、プロフェッショナルが実践する「堅牢なエラーハンドリング構造」を伝授する。

1. アーキテクチャの決定的な違い:Workspace vs Connection

まず、彼らが「何を単位として」トランザクションを管理しているのかを理解せよ。ここを履き違えると、設計レベルで破綻する。

DAO:Workspaceによる管理

DAOのトランザクションは、`DBEngine.Workspaces` オブジェクトに紐付いている。
DAOにおける `BeginTrans` は、ワークスペース全体に対して「トランザクション・カウンタ」をインクリメントする動作に近い。つまり、「どこで開始したか」ではなく「そのワークスペースが今、トランザクション状態にあるか」が重要になる。

ADO:Connectionによる管理

対してADOは、個別の `Connection` オブジェクトがトランザクションを保持する。
ADOはより汎用的であり、データベースエンジン(SQL Serverなど)の機能に依存する部分が大きい。接続(Connection)ごとに独立したトランザクション・コンテキストを持つため、DAOに比べればスコープの分離は直感的だ。

2. 「入れ子(Nested)トランザクション」という名の幻想

ここが本稿の核心だ。多くの開発者が、以下のようなコードを書いてしまう。

' --- 典型的な失敗パターン ---
Sub ParentProcess()
    DBEngine.BeginTrans
    Call ChildProcess ' ここでまた BeginTrans が呼ばれる
    DBEngine.CommitTrans
End Sub

Sub ChildProcess()
    DBEngine.BeginTrans
    ' 何らかの処理
    DBEngine.CommitTrans
End Sub

「よし、親が全体を、子が部分を管理している。これで完璧だ」と考えているなら、君の設計は甘い。

DAOにおける挙動の真実

DAOにおいて、`BeginTrans` を2回呼ぶと、内部カウンタは「2」になる。
ここで、`ChildProcess` 内でエラーが発生し、`Rollback` が呼ばれたとしよう。すると、カウンタがいくらであろうと、そのワークスペースで行われた「すべての変更」が即座にロールバックされる。

つまり、DAOにおいて「部分的なロールバック(Savepoint)」という概念は、標準的な実装では存在しない。親の処理が生き残っているつもりでも、子のロールバックが親の未コミットデータをも道連れにするのだ。

ADOにおける挙動

ADOの場合、接続先がSQL Serverなどの場合は `SAVE TRANSACTION` を使った擬似的な入れ子が利用できるが、VBAの標準的な `Connection.BeginTrans` だけでは、入れ子構造は極めて不安定、あるいはエラーの元となる。

結論:トランザクションを「関数(Sub/Function)単位」で入れ子にする設計は、設計ミスである。

3. プロダクション仕様:堅牢なエラーハンドリング・テンプレート

では、どう設計すべきか。
プロフェッショナルは、「トランザクションの境界(Transaction Boundary)は、呼び出し元(上位層)が明確に決定する」という原則に従う。

下位の関数(ロジック層)は、トランザクションを自分で開始してはいけない。単に「実行されるべき処理」に徹し、トランザクションの開始と終了、およびロールバックの責任は、必ず上位の「コントロール層」が持つべきだ。

以下に、実務でそのまま使える、DAOを用いた最高水準のテンプレートを示す。

【実践】堅牢なトランザクション制御コード

Option Compare Database
Option Explicit

' ======================================================================================
' 業務ロジックを制御するコントロール層
' ======================================================================================
Public Sub ExecuteBusinessProcess()
    Dim ws As DAO.Workspace
    Set ws = DBEngine.Workspaces(0)
    
    On Error GoTo Err_Handler

    ' 1. トランザクションの開始(境界の確定)
    ws.BeginTrans
    Debug.Print "Transaction Started."

    ' 2. 下位ロジックの呼び出し
    ' 注意:下位関数内で BeginTrans / CommitTrans を行ってはならない
    Call UpdateInventory(101, -5)
    Call UpdateSalesRecord(101, 5000)

    ' 3. 全ての処理が成功した場合のみコミット
    ws.CommitTrans
    Debug.Print "Transaction Committed Successfully."

Exit_Sub:
    Set ws = Nothing
    Exit Sub

Err_Handler:
    ' 4. エラー発生時の鉄則:即座にロールバック
    ' ここでロールバックすることで、中途半端なデータ更新を完全に破棄する
    If Not ws Is Nothing Then
        ws.Rollback
        Debug.Print "Transaction Rolled Back due to error: " & Err.Description
    End If
    
    ' ユーザーへの通知(実務ではログ出力も併用)
    MsgBox "業務処理中にエラーが発生しました。データは保護されています。" & vbCrLf & _
           "Error: " & Err.Description, vbCritical, "システムエラー"
    
    Resume Exit_Sub
End Sub

' ======================================================================================
' 個別の更新処理を行うロジック層
' ======================================================================================
Private Sub UpdateInventory(ByVal ProductID As Long, ByVal ChangeQty As Integer)
    ' この関数はトランザクションを開始しない。
    ' 呼び出し元がトランザクションを開始していることを前提とする。
    
    Dim db As DAO.Database
    Dim rs As DAO.Recordset
    Dim strSQL As String

    Set db = CurrentDb
    strSQL = "SELECT StockQty FROM T_Inventory WHERE ProductID = " & ProductID
    Set rs = db.OpenRecordset(strSQL, dbOpenDynaset)

    If rs.EOF Then Err.Raise vbObjectError + 513, "UpdateInventory", "商品が見つかりません。"

    rs.Edit
    rs.Fields("StockQty").Value = rs.Fields("StockQty").Value + ChangeQty
    rs.Update
    
    rs.Close
    Set rs = Nothing
End Sub

Private Sub UpdateSalesRecord(ByVal ProductID As Long, ByVal Amount As Long)
    ' 同様に、トランザクション管理は親に任せる
    Dim db As DAO.Database
    Set db = CurrentDb
    
    ' 擬似的なエラー発生テスト(コメントアウトを外すとロールバックが確認できる)
    ' If Amount > 1000 Then Err.Raise vbObjectError + 514, "UpdateSalesRecord", "金額が上限を超えています。"

    db.Execute "INSERT INTO T_Sales (ProductID, SaleAmount, SaleDate) " & _
               "VALUES (" & ProductID & ", " & Amount & ", Now())", dbFailOnError
End Sub

4. アーキテクトからの最終警告

この設計思想を導入するにあたり、以下の3点を肝に銘じておけ。

1. Single Responsibility Principle(単一責任の原則):
「データを更新する関数」に「トランザクションを管理する責任」を持たせるな。それは「業務フローを制御する関数」の仕事だ。
2. dbFailOnError の徹底:
`db.Execute` を使う際は、必ず `dbFailOnError` オプションを指定せよ。これを忘れると、SQLエラーが発生してもVBA側でエラーとして検知できず、トランザクションが「成功した」と誤認してコミットされてしまう。
3. オブジェクトのライフサイクル管理:
`Workspace` や `Recordset` は、エラー発生時であっても確実に `Nothing` を代入して解放せよ。特にトランザクション中にエラーが起きた際、オブジェクトが開きっぱなしになると、データベースがロックされ続け、他のユーザーがシステムを利用できなくなる「デッドロック」を引き起こす原因となる。

完璧なトランザクション管理とは、「成功したときは速やかに、失敗したときは跡形もなく」である。この極限の潔さをコードに宿せ。

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