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

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

「応答なし」の恐怖を克服する:ADOのタイムアウト制御で、止まらないAccessアプリを作る

こんにちは。今日もコードと格闘していますか?

Access VBAを使いこなせるようになってくると、次は「ローカルのテーブルだけでなく、SQL Serverなどの外部データベースに接続したい」というステップに進みますよね。そこで必ず出会うのがADO(ActiveX Data Objects)です。

しかし、ここで多くの開発者が、ある「恐ろしい現象」に直面します。
ネットワークが少し不安定になった瞬間、Accessが「応答なし」になり、画面が真っ白になって固まってしまう……。

ユーザーから「アプリが壊れた!」と電話がかかってくる、あの絶望的な瞬間です。

今日は、この「フリーズ」という恐怖を技術的にねじ伏せるための、極めて重要な知見をお話ししましょう。「ConnectionTimeout」と「CommandTimeout」の違いを完璧に理解すれば、あなたはもう、ネットワークの不安定さに怯える必要はありません。

ここをクリアすれば、Access VBAの基本はバッチリですよ。さあ、一緒に見ていきましょう。

1. なぜアプリは「フリーズ」してしまうのか?

まず、原因を解剖しましょう。

VBAのプログラムは、基本的に「シングルスレッド」で動いています。つまり、一度に一つの仕事しかできません。
ADOを使ってサーバーにデータを要求したとき、もしサーバーからの返事が来なかったらどうなるでしょうか?

VBAは「返事が来るまで、次の行のコードに進まずに待ち続ける」のです。
この「待ち時間」が、OSから見れば「何もしていない(応答がない)状態」となり、あの忌々しい「応答なし」が発生します。

これを防ぐには、「いつまでも待たずに、あきらめてエラーとして処理する」というルールを決めておく必要があります。そのルールこそが「タイムアウト」の設定です。

2. 混同厳禁!「Connection」と「Command」の違い

ここが、プロとアマチュアを分ける境界線です。タイムアウトには2つの種類があります。これを混同すると、設定したのに効かない!という事態に陥ります。

図解的なイメージで説明しましょう。

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

「電話をかけて、相手が受話器を取るまでの待ち時間」です。

  • 目的: サーバー自体にたどり着けるか、接続を確立できるかを判定します。
  • 失敗の理由: サーバーがダウンしている、LANケーブルが抜けている、IPアドレスが間違っている、など。
  • 設定場所: 接続を開始する(`.Open` する)前の設定。

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

「注文した料理が、テーブルに届くまでの待ち時間」です。

  • 目的: 接続はできているけれど、データの検索や更新に時間がかかりすぎていないかを判定します。
  • 失敗の理由: 検索対象のデータが数百万件あって重い、SQL文が非効率でサーバーが苦戦している、など。
  • 設定場所: 接続が確立した後の、SQLを実行する際の設定。
項目 ConnectionTimeout CommandTimeout
対象 サーバーへの「入り口」 サーバー内での「作業」
例えるなら 電話が繋がるまで 料理が運ばれてくるまで
主な原因 ネットワーク断絶、サーバー停止 重いクエリ、大量データ

3. 実践:フリーズを回避する鉄壁のコード

それでは、実際に現場で使える、堅牢な接続コードを書いてみましょう。
単に値を設定するだけでなく、「エラーが起きたときに、ユーザーに優しく、かつ適切に伝える」ためのエラーハンドリングもセットにしています。

Option Compare Database
Option Explicit

''' <summary>
''' 外部データベースへ安全に接続し、データを取得するサンプル
''' </summary>
Public Sub SafeConnectionExample()
    Dim cn As ADODB.Connection
    Dim rs As ADODB.Recordset
    Dim strConn As String
    Dim strSQL As String
    
    ' 接続文字列(環境に合わせて書き換えてください)
    strConn = "Provider=SQLOLEDB;Data Source=YourServerName;Initial Catalog=YourDBName;Integrated Security=SSPI;"
    
    ' 実行するSQL(あえて重い処理を想定)
    strSQL = "SELECT * FROM LargeTable WHERE Status = 'Active'"

    ' エラーハンドリングの開始
    On Error GoTo ErrorHandler

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

    ' ---------------------------------------------------------
    ' 【重要】ConnectionTimeoutの設定
    ' 接続が確立できない場合、15秒待って諦める(デフォルトは長い場合がある)
    ' ---------------------------------------------------------
    cn.ConnectionTimeout = 15 

    ' 2. 接続開始
    Debug.Print "サーバーに接続中..."
    cn.Open strConn
    Debug.Print "接続成功!"

    ' ---------------------------------------------------------
    ' 【重要】CommandTimeoutの設定
    ' 接続後、SQLの実行に30秒以上かかったら諦める
    ' ---------------------------------------------------------
    cn.CommandTimeout = 30

    ' 3. レコードセットの取得
    Debug.Print "データを取得中..."
    Set rs = cn.Execute(strSQL)

    ' 4. データの利用(ここではデバッグ出力のみ)
    Do While Not rs.EOF
        Debug.Print rs.Fields(0).Value
        rs.MoveNext
    Loop

    Debug.Print "処理が正常に完了しました。"

CleanUp:
    ' 後片付け(オブジェクトの解放)
    ' ライフサイクルを管理することは、メモリリークを防ぐ基本です
    On Error Resume Next
    If Not rs Is Nothing Then
        If rs.State = adStateOpen Then rs.Close
        Set rs = Nothing
    End If
    If Not cn Is Nothing Then
        If cn.State = adStateOpen Then cn.Close
        Set cn = Nothing
    End If
    Exit Sub

ErrorHandler:
    ' エラーの種類に応じたメッセージ出し分け
    Select Case Err.Number
        Case -2147467259 ' ADOの一般的な接続エラー(タイムアウト含む)
            MsgBox "サーバーへの接続、またはデータの取得に失敗しました。" & vbCrLf & _
                   "ネットワークの状態を確認してください。" & vbCrLf & _
                   "(詳細: " & Err.Description & ")", vbCritical, "接続エラー"
        Case Else
            MsgBox "予期せぬエラーが発生しました。" & vbCrLf & _
                   "エラー番号: " & Err.Number & vbCrLf & _
                   "内容: " & Err.Description, vbCritical, "システムエラー"
    End Select
    
    ' エラーが起きても必ず後片付け処理へ飛ばす
    Resume CleanUp
End Sub

4. アーキテクトからのアドバイス:運用上の勘所

コードが書けたら、最後は「運用」の視点を持ちましょう。

なぜデフォルト設定ではダメなのか?

ADOのデフォルト設定は、環境によって非常に長い(あるいは無制限に近い)場合があります。
例えば、`ConnectionTimeout` がデフォルトのまま、LANケーブルが抜けていたら?
ユーザーは「ボタンを押してから数分間、画面が固まったまま」になります。これは実質的に「フリーズ」と同じです。
「ユーザーを待たせすぎないこと」。これが優れたアプリケーションの条件です。

トランザクションとの関係

もし、データの更新(`UPDATE`や`INSERT`)を行う場合は、タイムアウト設定がさらに重要になります。
ネットワークが途切れてタイムアウトが発生した際、「どこまで書き込みが終わっているのか?」が分からなくなるからです。

複数の更新を行う場合は、必ず `cn.BeginTrans` と `cn.CommitTrans` を使い、エラー時には `cn.RollbackTrans` で元の状態に戻すように設計してください。タイムアウトによるエラーが発生した際、このロールバックが正しく動くことで、データの整合性を守ることができます。

まとめ:ここをクリアすれば、もう怖くない

1. ConnectionTimeout は「接続そのもの」にかかる制限。
2. CommandTimeout は「データのやり取り」にかかる制限。
3. エラーハンドリング を徹底し、タイムアウト時に「応答なし」ではなく「エラーメッセージ」を出す。

これらを意識するだけで、あなたの作るAccessアプリケーションの品質は、劇的に向上します。
「動けばいい」という段階から、「どんな状況でも制御できる」というプロフェッショナルの段階へ。

一歩ずつ、着実に進んでいきましょう。応援していますよ!

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