「なぜ動かないのか」の正体を暴け。ADOのErrorsコレクションで手に入れる、プロフェッショナルなエラーハンドリング
「エラーが発生しました。詳細はErr.Descriptionを確認してください」
……もしあなたが、開発中のAccessツールでそんなログ出力しかしていないとしたら、少しだけ立ち止まってほしい。
現場でシステムが止まったとき、ユーザーから「エラーが出ました」と報告を受けて、真っ先に確認するのは何だろうか? 多くの人は `Err.Description` を見る。しかし、SQL Serverなどの外部データベースを相手にしているとき、その一行の情報だけでは「なぜ失敗したのか」の真実に辿り着けないことが多々ある。
「一意制約違反(重複)なのか?」「データ型が合わないのか?」「ネットワークが瞬断したのか?」
これらを特定するには、VBAの標準的な `Err` オブジェクトだけでは力不足なのだ。今日は、Access VBAを一段上のレベルへ引き上げるための極意――ADOの `Errors` コレクションを駆使した、詳細なエラーログ生成術を伝授しよう。
ここをマスターすれば、あなたは「原因不明」という言葉に怯える必要がなくなる。
1. アーキテクチャの理解:DAOとADOの決定的な違い
まず、混乱しやすい「DAO」と「ADO」の違いを整理しておこう。ここを曖昧にすると、コードの書き方だけでなく、設計の根底が揺らいでしまう。
DAO (Data Access Objects)
- 領域: Accessのローカルテーブル、またはリンクテーブルの操作に特化。
- 性質: 「Access内部の住人」のための道具。高速で、Accessの機能(インデックスやリレーション)を最大限に活かせる。
- エラー: エラー情報はシンプル。Accessエンジンが「何が起きたか」を教えてくれる。
ADO (ActiveX Data Objects)
- 領域: SQL Server, Oracle, MySQLなどの「外部の王様」を操作するための道具。
- 性質: 「外部の世界への外交官」。ネットワーク越しに、高度なSQL文を投げ込み、遠く離れたサーバーと対話する。
- エラー: ここが重要だ。ADOは、サーバー側から返ってくる詳細なエラーメッセージを「コレクション(集合体)」として受け取ることができる。
つまり、SQL Server側で「主キーが重複しているぞ!」と怒られたとき、その怒りの詳細(エラー番号やSQLState)を詳しく受け取れるのは、ADOの特権なのだ。
2. 「Errorsコレクション」がなぜ最強の武器なのか?
通常のVBAエラーハンドリングでは、`Err.Number` や `Err.Description` を見る。しかし、ADOを使用して外部DBと通信しているとき、エラーは単一の出来事ではない。
例えば、「トランザクション中にネットワークが切れ、その結果としてSQL実行に失敗した」場合、エラーは連鎖する。
ADOの `Connection.Errors` コレクションには、以下のような情報が格納されている:
1. Number: ADO固有のエラー番号
2. Description: エラーの説明
3. SQLState: ANSI標準のSQL状態コード(例: `23000` は制約違反)
4. NativeError: SQL Serverが吐き出した「真の」エラー番号
この `NativeError` と `SQLState` こそが、保守性を劇的に高める鍵だ。これがあれば、Googleで検索した瞬間に解決策に辿り着ける。
3. 実践:詳細エラーログ生成ツールの実装
それでは、実際に現場で使えるコードを見ていこう。
単にエラーを表示するだけでなく、「トランザクションを安全にロールバックし、詳細な情報をログに書き出す」という、実務レベルの構成にしている。
実装のテンプレート
Option Compare Database
Option Explicit
' ======================================================================
' モジュール名: modDatabaseOperations
' 概要: ADOを使用したトランザクション処理と詳細エラーログ出力
' ======================================================================
Public Sub ExecuteComplexTransaction()
Dim cn As ADODB.Connection
Dim cmd As ADODB.Command
Dim strConn As String
' 接続文字列(環境に合わせて書き換えてください)
strConn = "Provider=SQLNCLI11;Server=YOUR_SERVER;Database=YOUR_DB;Trusted_Connection=yes;"
Set cn = New ADODB.Connection
On Error GoTo ErrorHandler ' エラーハンドリングの開始
' 1. 接続を開く
cn.Open strConn
' 2. トランザクションの開始(ここがプロの作法)
' トランザクションを開始することで、途中でエラーが起きても「中途半端なデータ」を防げる
cn.BeginTrans
Debug.Print "Transaction Started..."
' 3. SQLの実行(例:データの挿入)
' ここではわざとエラーが起きそうなSQLを想定
Set cmd = New ADODB.Command
With cmd
.ActiveConnection = cn
.CommandText = "INSERT INTO SalesData (SaleDate, Amount) VALUES ('2023-10-27', 'InvalidAmount')"
' ↑ 'InvalidAmount' は数値型カラムに入れるとエラーになる例
.Execute
End With
' 4. 全て成功したら確定(コミット)
cn.CommitTrans
Debug.Print "Transaction Committed Successfully."
CleanUp:
' 後片付け
If Not cn Is Nothing Then
If cn.State = adStateOpen Then cn.Close
End If
Set cn = Nothing
Exit Sub
ErrorHandler:
' 5. エラー発生時の処理
' トランザクション中のエラーなら、必ずロールバック(巻き戻し)を行う
If Not cn Is Nothing Then
If cn.State = adStateOpen Then
cn.RollbackTrans
Debug.Print "Transaction Rolled Back."
End If
End If
' 6. 詳細なエラーログを生成(ここが本題!)
Call LogDetailedErrors(cn)
' ユーザーへの通知(開発中はMsgBox、運用時はログファイル等へ)
MsgBox "致命的なエラーが発生しました。管理者へ連絡してください。", vbCritical, "システムエラー"
Resume CleanUp
End Sub
''' <summary>
''' ADOのErrorsコレクションを走査し、詳細な情報を出力する
''' </summary>
Private Sub LogDetailedErrors(ByRef cn As ADODB.Connection)
Dim errObj As ADODB.Error
Dim logMsg As String
logMsg = "--- [Error Log Start] ---" & vbCrLf
' ADOのConnectionオブジェクトが持つErrorsコレクションをループで回す
' これにより、SQL Serverから返された「真のエラー」を全て捕捉できる
If cn.Errors.Count > 0 Then
For Each errObj In cn.Errors
logMsg = logMsg & "Description: " & errObj.Description & vbCrLf
logMsg = logMsg & "SQLState: " & errObj.SQLState & vbCrLf
logMsg = logMsg & "NativeError: " & errObj.NativeError & vbCrLf
logMsg = logMsg & "------------------------" & vbCrLf
Next errObj
Else
' ADOエラーではなく、VBA自体のエラーの場合
logMsg = logMsg & "VBA Error: " & Err.Description & " (Number: " & Err.Number & ")" & vbCrLf
End If
logMsg = logMsg & "--- [Error Log End] ---"
' イミディエイトウィンドウに出力(実務ではここをテキストファイルやDBログテーブルへ書き出す)
Debug.Print logMsg
' 【アドバイス】実務では、この logMsg を 'ErrorLogTable' というAccess内のテーブルに
' Insertして保存するように実装すると、後からの調査が爆速になりますよ!
End Sub
4. ここをクリアすれば、あなたはもう「初心者」ではない
このコードを読み解く上で、重要なポイントを3つにまとめます。
① トランザクションの「Commit」と「Rollback」
プロのコードにおいて、データの更新(Insert/Update/Delete)は必ず「セット」で行われます。`BeginTrans` で始めたら、成功したときだけ `CommitTrans` し、エラーが起きたら即座に `RollbackTrans` する。これによって、「一部のデータだけ更新されて、他が更新されていない」というデータの不整合(ゴミデータ)を防ぐことができます。
② Errorsコレクションの「ループ処理」
`Err.Description` は「最後のエラー」しか教えてくれませんが、`For Each errObj In cn.Errors` は「発生したエラーの連鎖」をすべて暴き出します。これが、サーバー側で何が起きたのかを正確に知るための唯一の手段です。
③ NativeErrorとSQLStateの活用
もしログに `NativeError: 2627` と出ていたら、あなたは迷わず「あ、主キー制約違反だ」と判断できます。もし `SQLState: 08S01` と出ていたら、「通信断(Network error)だ」と分かります。この「エラーコードによる即時判断」こそが、エンジニアの価値を決めるのです。
最後に:エンジニアとしての歩み
Access VBAは、単なる「マクロの延長」ではありません。ADOを使いこなし、エラーの深淵まで目を向けることで、それは強力な「業務アプリケーション」へと進化します。
最初はエラーが出ると怖くなるかもしれません。でも、エラーは敵ではなく、「システムをより良くするためのヒント」をくれる親切なガイドなのです。
今回の `Errors` コレクションの実装を、ぜひあなたのプロジェクトに取り入れてみてください。次にエラーが起きたとき、あなたはきっと、冷静に、そしてスマートに原因を特定できているはずですよ。
応援しています。次は、さらに高度なパフォーマンスチューニングの世界でお会いしましょう。
