SQLの「文字列連結」を卒業しよう。ADO Commandオブジェクトで手に入れる、鉄壁の防御と美しいコード
こんにちは。現場でシステム設計の指揮を執っている、あなたの「少し先を行く先輩エンジニア」です。
Access VBAを学び始め、マクロの記録から一歩踏み出して、自分でSQLを組み立てるようになった……。もしあなたが今、そんな段階にいるとしたら、素晴らしい一歩を踏み出しましたね。
しかし、ここで一つ、非常に重要な「分かれ道」があります。
それは、「SQLを文字列連結(`&`)で作っているか、それともパラメータクエリを使っているか」という点です。
もしあなたが、以下のようなコードを書いていたら……。
`strSQL = “SELECT * FROM T_社員 WHERE 社員名 = ‘” & txt氏名 & “‘”`
残念ながら、それは「動くけれど、プロの設計としてはまだ危うい」状態です。
今日は、実務で必須となる「SQLインジェクション対策」と、それをエレガントに解決する「ADO Commandオブジェクト」の使い方を、魂を込めて解説します。
ここをクリアすれば、あなたのAccess開発のレベルは、一気に「実務レベル」へと跳ね上がりますよ。
1. なぜ「文字列連結」は危険なのか?
まずは、なぜ `&` でSQLを組み立てるのがいけないのか、その理由を理解しましょう。理由は大きく分けて2つあります。
① セキュリティの脅威:SQLインジェクション
これが最大の理由です。
例えば、社員名を検索する画面があるとします。悪意のあるユーザーが、テキストボックスに以下のような文字列を入力したらどうなるでしょうか?
`’ OR ‘1’=’1`
これを文字列連結でSQLに組み込むと、完成するSQLはこうなります。
`SELECT * FROM T_社員 WHERE 社員名 = ” OR ‘1’=’1’`
`’1’=’1’` は常に正しい(True)ため、条件に関わらず全社員のデータが流出してしまうのです。これが「SQLインジェクション」と呼ばれる攻撃の基本原理です。
② コードの複雑化とバグの温床
シングルクォーテーション(`’`)の閉じ忘れ、日付型のフォーマット(`#`)、NULL値の扱い……。文字列連結でSQLを作ろうとすると、これらの「記号のパズル」に追われ、コードが非常に読みづらくなります。
2. 救世主「Commandオブジェクト」の思想
ここで登場するのが、ADO(ActiveX Data Objects)の `Command` オブジェクトです。
プロの設計思想では、「命令(SQLの構造)」と「データ(検索値)」を明確に分離します。
- 命令(CommandText): 「社員テーブルから、この名前のレコードを探してこい」というテンプレート。
- データ(Parameters): 「探すべき名前は『田中』である」という具体的な値。
Commandオブジェクトを使うと、SQLの中に `?`(プレースホルダ)を置いておき、後から値を流し込むことができます。こうすることで、入力された値が「命令の一部」として解釈される隙を与えず、単なる「データ」として安全に処理できるのです。
3. 実践:パラメータクエリの正しい実装手順
それでは、実際に使えるコードを見ていきましょう。
ここでは、参照設定で 「Microsoft ActiveX Data Objects x.x Library」 にチェックが入っていることを前提とします。
【プロ仕様】安全な検索処理のテンプレート
''' <summary>
''' パラメータクエリを用いて、安全に社員情報を取得する
''' </summary>
''' <param name="targetName">検索したい社員名</param>
Public Sub SearchEmployeeSafe(ByVal targetName As String)
Dim cn As ADODB.Connection
Dim cmd As ADODB.Command
Dim rs As ADODB.Recordset
Dim strSQL As String
' エラーハンドリング(現場では必須!)
On Error GoTo ErrorHandler
' 1. 接続オブジェクトの生成
Set cn = CurrentProject.Connection ' Access内のローカルテーブルを使う場合
' 2. SQLテンプレートの作成
' 値が入るべき場所に「?」を置くのがポイントです
strSQL = "SELECT 社員ID, 社員名, 部署 FROM T_社員 WHERE 社員名 = ?"
' 3. Commandオブジェクトの初期設定
Set cmd = New ADODB.Command
With cmd
.ActiveConnection = cn ' 使用する接続を指定
.CommandText = strSQL ' SQLテンプレートをセット
.CommandType = adCmdText ' テキスト形式のSQLであることを指定
' 4. パラメータの追加(ここが最重要!)
' CreateParameter(名前, 型, 方向, サイズ, 値)
' adVarChar = 文字列型, adParamInput = 入力用
' サイズは、フィールドの定義に合わせて適切に設定します
.Parameters.Append .CreateParameter("@Name", adVarChar, adParamInput, 50, targetName)
End With
' 5. 実行
Set rs = cmd.Execute
' 6. 結果の処理(例としてイミディエイトウィンドウに出力)
If Not rs.EOF Then
Do Until rs.EOF
Debug.Print "ID: " & rs![社員ID] & " | Name: " & rs![社員名]
rs.MoveNext
Loop
Else
MsgBox "該当する社員は見つかりませんでした。", vbInformation
End If
CleanUp:
' 7. オブジェクトの解放(メモリリークを防ぐための儀式)
On Error Resume Next
If Not rs Is Nothing Then If rs.State = adStateOpen Then rs.Close: Set rs = Nothing
Set cmd = Nothing
Set cn = Nothing
Exit Sub
ErrorHandler:
MsgBox "エラーが発生しました: " & Err.Description, vbCritical, "実行エラー"
Resume CleanUp
End Sub
4. ここが落とし穴!陥りやすいエラーと対策
この高度な手法を使い始めると、いくつか特有の壁にぶつかります。事前に知っておけば怖くありません。
① 「パラメータが足りません」エラー
SQL文の中に `?` を2つ書いたのに、`.Parameters.Append` を1回しかしていない場合に発生します。「? の数」と「Append の回数」は必ず一致させてください。
② データ型の不一致
`CreateParameter` で指定する型(`adVarChar`, `adInteger` など)が、実際のテーブルの型と異なるとエラーになります。
- 文字列なら `adVarChar`
- 数値(長整数型)なら `adInteger`
- 日付なら `adDate`
ここを正確に指定することが、パフォーマンスと安定性の鍵です。
③ NULL値の扱い
もし、検索条件が「空(Null)」になる可能性がある場合、単に変数を入れるだけではエラーになることがあります。その場合は、`targetName` が空かどうかを判定し、適切に処理するロジックを組み込んでください。
まとめ:一歩先のエンジニアへ
文字列連結によるSQL構築は、手軽ですが「剥き出しの刃」を持ったまま作業するようなものです。
一方で、Commandオブジェクトとパラメータクエリは、堅牢な「盾」を持って戦うプロの作法です。
1. SQLは `?` を使ったテンプレートとして書く
2. `Command.Parameters.Append` で値を流し込む
3. 型とサイズを正確に指定する
この3点を守るだけで、あなたの作るシステムは劇的に安全になり、コードの美しさも向上します。
最初は少し記述量が増えて、面倒に感じるかもしれません。でも、一度この「型」を身につけてしまえば、もう二度と文字列連結の泥沼には戻れなくなるはずです。
さあ、自信を持って、より安全で美しいコードを書き進めていきましょう。応援していますよ!
