【実務・中級編】ADOの接続タイムアウトを制御する:ネットワーク不安定時のアプリフリーズを回避する接続設定 – Access VBA解析バイブル

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

「動けばいい」は素人の発想だ。ADOのタイムアウト制御で、フリーズしない堅牢なAccessアプリを設計せよ

開発現場で、こんな報告を受けたことはないか?
「ボタンを押した瞬間、Accessが『応答なし』になって固まりました。数分待ったら動きましたが、それまで何もできませんでした」

もし君がこの報告を聞いて、「ネットワークが遅かったんですね」で済ませるなら、君はまだ設計者ではなく、ただのコーダーだ。プロのアーキテクトなら、即座に「接続タイムアウトとコマンドタイムアウトの設計が破綻している」と断じる。

Access VBAで外部データベース(SQL Server等)にADO経由で接続する際、ネットワークの瞬断やサーバーの過負荷は「起こるもの」として設計に組み込まなければならない。ユーザーを「応答なし」の地獄に突き落とさないための、極限の接続制御術を伝授しよう。

1. 致命的な誤解:ConnectionTimeout と CommandTimeout の混同

多くの開発者が陥る罠がある。それは、「タイムアウト設定は一つで十分」という思い込みだ。
ADOには、性質の全く異なる2つのタイムアウトが存在する。この違いを理解していないコードは、実戦では使い物にならない。

ConnectionTimeout(接続のタイムアウト)

これは、「データベースサーバーの門を叩いて、応答が返ってくるまでの時間」を制御するものだ。
接続文字列(ConnectionString)の確立フェーズで機能する。ネットワークが遮断されている、あるいはサーバーがダウンしている場合、この設定が適切でないと、AccessはOSレベルの長い待ち時間(数十秒〜数分)を食い潰し、UIスレッドを完全にロックする。

CommandTimeout(実行のタイムアウト)

これは、「接続は確立できたが、投げたクエリ(SQL)の実行結果が返ってくるまでの時間」を制御するものだ。
巨大な集計処理や、インデックスの効いていない重いSQLを投げた際、サーバーが処理を終えるのを待つ時間だ。

「接続に失敗するケース」と「処理に時間がかかるケース」は、対処すべき戦略が根本的に異なるのだ。

2. アーキテクチャ設計:なぜ「フリーズ」が起きるのか

Access VBAはシングルスレッドで動作する。つまり、ADOの`.Open`メソッドや`.Execute`メソッドが実行されている間、VBAの制御はそれらのメソッドに奪われ、ユーザーのクリックや画面描画といったイベント処理が一切停止する。

これを「ブロッキング(Blocking)」と呼ぶ。

ネットワークが不安定な環境で、デフォルト設定のまま接続を試みると、TCP/IPレベルの再試行が何度も繰り返される。この間、Accessは「返事待ち」の状態で固まり、ユーザーは「アプリが壊れた」と判断してタスクマネージャーから強制終了させる。これが、業務ツールにおける最大の「信頼失墜」の瞬間だ。

我々が目指すべきは「Fail Fast(早く失敗させる)」の原則だ。
いつまでも待ち続けるのではなく、適切な時間で「通信に問題があります」とユーザーに制御を返し、次のアクション(再試行やログ出力)を促す設計にしなければならない。

3. プロダクション・グレードの接続実装例

では、具体的にどう書くべきか。
単なるプロシージャではなく、エラーハンドリングとタイムアウト制御を完全に分離した、保守性の高い実装パターンを示す。

以下のコードは、接続確立とコマンド実行のそれぞれに対して、厳格なタイムアウト管理を行うための設計思想に基づいている。

Option Compare Database
Option Explicit

'---------------------------------------------------------------------------------------
' モジュール名: modDatabaseCore
' 概要: 堅牢なADO接続管理のためのコアモジュール
'---------------------------------------------------------------------------------------

Public Sub ExecuteSecureQuery()
    Dim conn As ADODB.Connection
    Dim cmd As ADODB.Command
    Dim rs As ADODB.Recordset
    
    ' 接続文字列(環境に合わせて適切に設定すること)
    Dim strConn As String
    strConn = "Provider=SQLOLEDB;Data Source=YourServerName;Initial Catalog=YourDB;Integrated Security=SSPI;"

    On Error GoTo ErrorHandler

    ' 1. Connectionオブジェクトの生成
    Set conn = New ADODB.Connection

    ' 【重要】ConnectionTimeoutの設定
    ' .Openを呼び出す前に設定する必要がある。
    ' ネットワーク不安定を考慮し、デフォルト(15秒)より短め、あるいは業務要件に合わせる。
    conn.ConnectionTimeout = 5 ' 5秒以内に応答がなければ諦める

    Debug.Print "Attempting to connect..."
    conn.Open strConn
    Debug.Print "Connection established."

    ' 2. Commandオブジェクトの生成
    Set cmd = New ADODB.Command
    With cmd
        .ActiveConnection = conn
        .CommandText = "SELECT * FROM HeavyTable WHERE Status = 'Active'" ' 重いクエリを想定
        .CommandType = adCmdText
        
        ' 【重要】CommandTimeoutの設定
        ' クエリの複雑さに応じて設定。0は無限待ち(絶対禁止)
        .CommandTimeout = 30 ' 30秒待っても結果が返らなければタイムアウト
    End With

    ' 3. 実行フェーズ
    Debug.Print "Executing command..."
    Set rs = cmd.Execute

    ' 結果の処理(ここではデバッグ出力のみ)
    Do While Not rs.EOF
        Debug.Print rs.Fields(0).Value
        rs.MoveNext
    Loop

CleanUp:
    ' オブジェクトの解放(ライフサイクル管理の鉄則)
    On Error Resume Next
    If Not rs Is Nothing Then If rs.State = adStateOpen Then rs.Close: Set rs = Nothing
    If Not cmd Is Nothing Then Set cmd = Nothing
    If Not conn Is Nothing Then If conn.State = adStateOpen Then conn.Close: Set conn = Nothing
    Exit Sub

ErrorHandler:
    ' ADOのエラーコードを詳細に解析する
    ' エラー番号: -2147467259 は、一般的なADOの実行エラー(タイムアウト含む)
    Select Case Err.Number
        Case -2147467259 ' ADO Timeout Error
            ' エラーメッセージからConnectionかCommandかを判断するロジックを組むことも可能
            MsgBox "【タイムアウト】サーバーからの応答がありません。" & vbCrLf & _
                   "ネットワーク状態を確認してください。", vbCritical, "通信エラー"
        Case Else
            MsgBox "【致命的なエラー】" & vbCrLf & _
                   "Error No: " & Err.Number & vbCrLf & _
                   "Description: " & Err.Description, vbCritical, "システムエラー"
    End Select
    Resume CleanUp
End Sub

プロフェッショナルの視点:コードの解説

1. ConnectionTimeoutのタイミング:
`conn.Open` を呼ぶ前に設定している点に注目せよ。これを忘れて `.Open` を実行すると、OSのデフォルト値(非常に長い)が適用され、君のアプリはフリーズする。
2. CommandTimeoutの明示:
`cmd.CommandTimeout = 30` と明示している。これを設定しない場合、ADOのデフォルトは30秒だが、現場の複雑な集計処理ではこれでは足りないこともある。逆に、あまりに長く設定しすぎるのも、ユーザーを待たせすぎるため悪手だ。
3. エラーハンドリングの分離:
`Select Case Err.Number` を使い、タイムアウトとその他の致命的なエラーを分けている。ユーザーに対し、「ネットワークが悪いのか」「SQLが間違っているのか」「サーバーが落ちているのか」を、可能な限り推測させるメッセージを返すのが、優れたUX(ユーザー体験)への第一歩だ。
4. オブジェクトのライフサイクル:
`CleanUp` セクションにおいて、`rs`, `cmd`, `conn` の順で、かつ `State` を確認しながら確実に閉じる。メモリリークや接続の残留(ゾンビ接続)を防ぐのは、アーキテクトの義務である。

4. まとめ:堅牢なツールを作るために

Access VBAは、使い勝手が良い反面、エラーに対する「甘え」が許されない環境だ。
「たぶん大丈夫だろう」という設計は、本番環境のネットワーク負荷や、ユーザーの不適切な操作によって容易に崩壊する。

  • ConnectionTimeout で「入り口」を制御せよ。
  • CommandTimeout で「中身」を制御せよ。
  • Fail Fast の原則に基づき、ユーザーを待たせすぎるな。

これらを徹底することで、君の作るツールは「ただ動く道具」から、「プロが信頼して使うシステム」へと昇華する。次回の設計からは、このタイムアウトの概念を脳の深層に刻み込んでおけ。

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