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

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

「応答なし」の恐怖を断て:ADO接続タイムアウトを制御する堅牢な設計思想

業務システムを構築しているエンジニアにとって、最も避けなければならない事態は何か?
それは、計算ロジックのミスでも、データの不整合でもない。「ユーザーの操作を完全に封殺する、アプリケーションのフリーズ」だ。

特に、AccessをフロントエンドとしてSQL Serverなどの外部データベースと連携させている場合、ネットワークの瞬断やサーバーの過負荷によって、Accessが「応答なし(白抜き状態)」になり、タスクマネージャーから強制終了するしかなくなる。この現象が起きる原因は、コードの書き方が悪いのではない。「接続のライフサイクルとタイムアウトの設計」が欠落しているからだ。

本稿では、中級者へステップアップするために避けては通れない、ADO(ActiveX Data Objects)における接続タイムアウトの制御と、ネットワーク不安定下でもシステムを死なせないための堅牢な設計術を伝授する。

1. なぜAccessは「フリーズ」するのか?:DAOとADOの構造的差異

まず、君が使っている技術の正体を理解せよ。Access開発において、DAO(Data Access Objects)とADOは似て非なるものだ。

  • DAO: Accessのエンジン(ACE/Jet)に深く統合された、いわば「身内」の技術だ。ローカルのテーブル操作には最強のパフォーマンスを発揮するが、外部ネットワークへの耐性は設計思想レベルで考慮されていない。
  • ADO: 外部のデータベース(SQL Server, Oracle等)へ通信するための「外交官」だ。OLE DBやODBCドライバを介して通信を行うため、「通信路の断絶」という物理的なリスクと常に隣り合わせである。

フリーズが発生するメカニズムはこうだ。
ADOが外部サーバーにリクエストを投げた際、ネットワークが遮断されると、ADO(およびその背後のドライバ)は「返事が来るまで待ち続ける」。このとき、デフォルトのタイムアウト設定が適切でないと、プログラムの実行スレッドは通信の完了(あるいはタイムアウト)を待ち続ける「ブロッキング状態」に陥る。これが、ユーザーから見た「フリーズ」の正体である。

2. 二つの「タイムアウト」を峻別せよ

多くの開発者が犯す致命的なミスは、「ConnectionTimeout」と「CommandTimeout」を混同していることだ。これらを使い分けられない限り、堅牢なシステムは作れない。

ConnectionTimeout(接続タイムアウト)

「サーバーに接続を確立するまで」の制限時間だ。
サーバーがダウンしている、あるいはネットワーク経路が遮断されている場合に、どれくらい待つかを決定する。ここが適切に設定されていないと、接続を試みるだけでアプリが数分間固まる。

CommandTimeout(コマンドタイムアウト)

「接続はできたが、SQLの実行結果が返ってくるまで」の制限時間だ。
サーバーは生きているが、巨大な集計クエリを実行していて処理が重い、あるいはデッドロックが発生している場合に、どれくらい待つかを決定する。

結論:ネットワーク不安定対策には、まず `ConnectionTimeout` を攻めろ。

3. プロダクション品質の接続クラス:実装例

単なるプロシージャではなく、オブジェクトのライフサイクルを管理できる「クラスモジュール」として実装するのがプロの流儀だ。以下に、エラーハンドリングとタイムアウト制御を組み込んだ、そのまま現場で使えるコードを示す。

クラスモジュール名:`clsDBConnector`

Option Explicit

' ==============================================================================
' Class: clsDBConnector
' Description: 外部DB接続を管理する堅牢なコネクタクラス
' 設計思想: タイムアウト制御によるフリーズ防止と、確実なリソース解放
' ==============================================================================

Private mConn As ADODB.Connection
Private mConnectionString As String

' 設定値(定数として定義するか、外部から注入する)
Private Const DEFAULT_CONN_TIMEOUT As Integer = 5  ' 接続待ちを5秒に制限
Private Const DEFAULT_CMD_TIMEOUT As Integer = 30  ' クエリ実行を30秒に制限

''' <summary>
''' クラスの初期化。接続文字列を受け取る。
''' </summary>
Public Sub Initialize(ByVal strConn As String)
    Set mConn = New ADODB.Connection
    mConnectionString = strConn
End Sub

''' <summary>
''' データベースへの接続を確立する。
''' </summary>
Public Function Connect() As Boolean
    On Error GoTo Err_Connect
    
    ' 1. 接続タイムアウトの設定(ここがフリーズ防止の肝)
    mConn.ConnectionTimeout = DEFAULT_CONN_TIMEOUT
    
    ' 2. コマンドタイムアウトの設定
    mConn.CommandTimeout = DEFAULT_CMD_TIMEOUT
    
    ' 3. 接続試行
    mConn.Open mConnectionString
    
    Connect = True
    Exit Function

Err_Connect:
    ' ネットワーク切断やサーバーダウン時はここへ飛ぶ
    Debug.Print "【Connection Error】: " & Err.Description
    ' ユーザーへの通知(実務ではメッセージボックス等)
    MsgBox "データベースへの接続に失敗しました。ネットワーク環境を確認してください。" & vbCrLf & _
           "Error: " & Err.Description, vbCritical, "接続エラー"
    Connect = False
End Function

''' <summary>
''' 接続を安全に切断する。
''' </summary>
Public Sub Disconnect()
    On Error Resume Next
    If Not mConn Is Nothing Then
        If mConn.State = adStateOpen Then
            mConn.Close
        End If
        Set mConn = Nothing
    End If
    On Error GoTo 0
End Sub

''' <summary>
''' 実行中の接続オブジェクトを返す(Recordset取得用)
''' </summary>
Public Property Get Connection() As ADODB.Connection
    Set Connection = mConn
End Property

''' <summary>
''' クラス破棄時のクリーンアップ
''' </summary>
Private Sub Class_Terminate()
    Disconnect
End Sub

標準モジュールでの利用例

Sub Sample_ExecuteQuery()
    Dim db As New clsDBConnector
    Dim rs As ADODB.Recordset
    Dim strConn As String
    
    ' SQL Serverへの接続文字列(環境に合わせて書き換え)
    strConn = "Provider=SQLOLEDB;Data Source=YourServerName;Initial Catalog=YourDB;Integrated Security=SSPI;"
    
    ' 1. 初期化と接続
    db.Initialize strConn
    
    If Not db.Connect() Then
        ' 接続失敗時はここで処理を中断。アプリをフリーズさせない。
        Exit Sub
    End If
    
    ' 2. クエリ実行
    On Error GoTo Err_Execute
    Set rs = New ADODB.Recordset
    
    ' 接続オブジェクトをクラスから取得して使用
    rs.Open "SELECT TOP 10 * FROM LargeTable", db.Connection, adOpenStatic, adLockReadOnly
    
    ' データ処理のロジック...
    If Not rs.EOF Then
        Debug.Print rs.Fields(0).Value
    End If

Clean_Up:
    ' 3. リソースの確実な解放(これが重要)
    On Error Resume Next
    If Not rs Is Nothing Then
        If rs.State = adStateOpen Then rs.Close
        Set rs = Nothing
    End If
    db.Disconnect ' クラスのDisconnectを呼び出す
    Set db = Nothing
    Exit Sub

Err_Execute:
    MsgBox "クエリ実行中にエラーが発生しました: " & Err.Description, vbExclamation
    Resume Clean_Up
End Sub

4. トランザクション処理における「死の罠」

ネットワークが不安定な環境で、最も恐ろしいのは「不完全なトランザクション」だ。

`BeginTrans` を発行した直後にネットワークが切断された場合、サーバー側ではトランザクションが「宙に浮いた状態(Orphaned Transaction)」になる可能性がある。クライアント側(Access)で `Rollback` を試みようとしても、接続自体が死んでいるため、エラーが発生してさらに処理が混乱する。

設計の鉄則:
1. 接続状態の確認: `Rollback` を行う前に、必ず `If mConn.State = adStateOpen Then` で接続が生きているかを確認せよ。
2. 最小単位のトランザクション: トランザクションの範囲は極限まで短くしろ。通信回数が増えれば増えるほど、切断に遭遇する確率は指数関数的に上がる。
3. サーバー側での制御: 可能であれば、複雑な一連の処理はAccess側から何度も命令を送るのではなく、サーバー側の「ストアドプロシージャ」にまとめ、一撃で完結させろ。これが最も堅牢な防御策だ。

まとめ:防御的プログラミングを習慣化せよ

「動けばいい」という考えで書かれたコードは、本番環境の荒波(ネットワークの揺らぎ、サーバーの負荷)に耐えられない。

  • ConnectionTimeout を設定し、ユーザーを「待ちぼうけ」にさせない。
  • Classモジュール でオブジェクトのライフサイクル(Open/Close)を厳格に管理する。
  • エラーハンドリング を「例外を無視するため」ではなく、「安全に後片付け(Cleanup)をするため」に使う。

これらを徹底することで、君の作るツールは「単なる便利ツール」から「プロフェッショナルな業務システム」へと昇華する。設計の重みを、そのコードに刻み込め。

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