SQLの「文字列結合」から卒業しよう。ADODB.Commandで手に入れる、安全で高速なデータ操作の極意
こんにちは。現場で数々のシステムを設計・構築してきたエンジニアです。
Access VBAを学び始め、マクロの記録から一歩踏み出し、「自分でSQLを書いてRecordsetを操作する」というフェーズに到達したあなた。おめでとうございます。ここが、単なる「作業者」から「エンジニア」へと脱皮する最大の分岐点です。
しかし、ここで多くの人が陥る「見えない罠」があります。
それは、「SQL文を文字列結合(`&`)で組み立ててしまうこと」です。
「動けばいいんだよ」と思っていると、ある日突然、システムがクラッシュしたり、データが書き換わったり、あるいは悪意ある操作によってデータを盗まれたりするかもしれません。
今日は、プロの現場で必須となる「パラメータクエリ」という技術を使い、安全かつ高速にRecordsetを操る極限のテクニックを伝授します。ここをクリアすれば、あなたのAccess開発は一段上のステージへ昇華しますよ。
1. なぜ「文字列結合」は危険なのか?
初心者の多くは、検索条件をSQLに組み込むとき、以下のようなコードを書きます。
' --- ⚠️ 初心者が陥りやすい、危険なコード例 ---
Dim strSQL As String
Dim strName As String
strName = Me.txtSearchName.Value ' 画面のテキストボックスから値を取得
' 文字列を & でつなげてSQLを作っている
strSQL = "SELECT * FROM T_顧客 WHERE 顧客名 = '" & strName & "'"
' この後、Recordsetを開く...
一見、これでも動きます。しかし、この書き方には3つの致命的な弱点があります。
① 「O’Brian」問題(データ形式の不一致)
もし、顧客名に `O’Brian` のようにシングルクォーテーション(’)が含まれていたらどうなるでしょうか?
SQLは `’O’Brian’` と解釈してしまい、「途中で文字列が終わっているぞ!」とエラーを吐いて止まってしまいます。これを防ぐために `Replace(strName, “‘”, “””)` と書く人もいますが、それはあくまで「その場しのぎ」の対処に過ぎません。
② SQLインジェクション(セキュリティリスク)
もし悪意のあるユーザーが、検索窓に `’ OR ‘1’=’1` と入力したらどうなるでしょう?
生成されるSQLは `SELECT * FROM T_顧客 WHERE 顧客名 = ” OR ‘1’=’1’` となり、全顧客のデータが抜き出されてしまいます。 これが、世界中で問題となっている「SQLインジェクション」です。
③ パフォーマンスの低下(実行計画の再利用不可)
データベースエンジンは、SQL文を解析して「どうやってデータを取ってくるか(実行計画)」を決めます。
文字列結合で作ると、検索ワードが変わるたびに「全く新しいSQL」だと認識され、毎回解析し直すため、大量のデータを扱う際に動作が重くなります。
2. 救世主:ADODB.Command による「パラメータクエリ」
プロのエンジニアは、SQL文を「命令のテンプレート」として先に作り、データは「後から流し込む」という手法を取ります。これがパラメータクエリです。
この手法では、SQLの中に具体的な値ではなく、「?(プレースホルダー)」を置いておきます。
-- イメージ図
SELECT * FROM T_顧客 WHERE 顧客名 = ?
この `?` に対して、型を指定して値を安全に流し込む。これが `ADODB.Command` オブジェクトの役割です。
3. 【実践】プロ仕様のデータ抽出コード
それでは、実際に現場でそのまま使える、堅牢なコードを見ていきましょう。
ここでは、最も汎用性が高く、外部連携にも強い `ADODB` を使用します。
''' <summary>
''' パラメータを利用して、安全かつ高速に顧客データを抽出する
''' </summary>
''' <param name="targetName">検索したい顧客名</param>
''' <returns>抽出結果のRecordset</returns>
Public Function GetCustomerRecordset(ByVal targetName As String) As ADODB.Recordset
On Error GoTo ErrorHandler
Dim cn As ADODB.Connection
Dim cmd As ADODB.Command
Dim rs As ADODB.Recordset
' 1. Connectionオブジェクトの生成
' ※ CurrentProject.Connection を使うことで、現在のAccess接続を再利用できる
Set cn = CurrentProject.Connection
' 2. Commandオブジェクトの生成(ここが心臓部!)
Set cmd = New ADODB.Command
With cmd
.ActiveConnection = cn
' SQL文には値の代わりに "?" を記述する
.CommandText = "SELECT 顧客ID, 顧客名, 電話番号 FROM T_顧客 WHERE 顧客名 = ?"
' 実行タイプを指定(サーバー側で処理を最適化させる)
.CommandType = adCmdText
' 3. パラメータの追加
' CreateParameter(名前, 型, 方向, サイズ, 値)
' adVarWChar = 文字列(Unicode), adParamInput = 入力用
.Parameters.Append .CreateParameter("@Name", adVarWChar, adParamInput, 100, targetName)
End With
' 4. CommandオブジェクトからRecordsetを直接開く
' これにより、SQLインジェクションは物理的に不可能になり、型も保証される
Set rs = cmd.Execute
' 成功したらRecordsetを返す
Set GetCustomerRecordset = rs
Exit_Proc:
' オブジェクトの解放(メモリリークを防ぐための極めて重要な作法)
' Recordsetは呼び出し元で使うため、ここではcmdのみ解放
Set cmd = Nothing
Exit Function
ErrorHandler:
MsgBox "エラーが発生しました: " & Err.Description, vbCritical, "実行エラー"
Set GetCustomerRecordset = Nothing
Resume Exit_Proc
End Function
''' <summary>
''' 呼び出し側の実装例
''' </summary>
Public Sub TestSearch()
Dim rs As ADODB.Recordset
Dim strSearch As String
strSearch = "O'Brian" ' 特殊文字が含まれていても大丈夫!
' 関数を呼び出し
Set rs = GetCustomerRecordset(strSearch)
' 結果の表示
If Not rs Is Nothing Then
If Not rs.EOF Then
Do Until rs.EOF
Debug.Print rs!顧客名 & " (" & rs!電話番号 & ")"
rs.MoveNext
Loop
Else
MsgBox "該当するデータは見つかりませんでした。"
End If
' 最後に必ず閉じる
rs.Close
Set rs = Nothing
End If
End Sub
4. ここがプロの視点:解説とエンジニアの心得
このコードには、単なる「動くコード」以上の、設計思想が詰まっています。
■ オブジェクトのライフサイクルを管理する
コード内の `Set cmd = Nothing` や `rs.Close` を見てください。
VBAにおいて、オブジェクト(メモリ上に作られた実体)を使い終わったら、明示的に「使い終わりましたよ」と伝えることは、大規模システムを安定させるための鉄則です。これを怠ると、メモリを食いつぶす「メモリリーク」の原因になります。
■ 型の安全性(Type Safety)
`.CreateParameter` の中で `adVarWChar`(文字列型)を指定しています。
これにより、もしユーザーが数値や日付を無理やり流し込もうとしても、データベースエンジンが「型が違います」と適切に処理してくれます。これが、データの整合性を守る最後の砦となります。
■ パフォーマンスの重み
`cmd.Execute` を使う手法は、データベースエンジンに対して「このSQLの構造はこれです。値は後で渡します」というメッセージを送っています。これにより、エンジンは効率的な実行プランをキャッシュでき、繰り返し検索を行う際に圧倒的なスピードを発揮します。
まとめ:一歩先のエンジニアへ
「文字列を `&` でつなぐ」手法は、小規模な使い捨てツールなら許されるかもしれません。
しかし、あなたが作るシステムが、誰かの業務を支え、大切なデータを扱うものであるなら、必ず `ADODB.Command` によるパラメータクエリ を選んでください。
1. 安全(Security):SQLインジェクションを防ぐ。
2. 堅牢(Robustness):特殊文字(’ など)によるエラーを防ぐ。
3. 高速(Performance):データベースの実行効率を最大化する。
この3つを意識できるようになったとき、あなたの書くコードは「ただの命令」から「洗練された設計」へと変わります。
ここをクリアすれば、Access VBAの基本はバッチリですよ。
さあ、次のステップへ進みましょう!
