今回は、Excel VBAでOracleに接続し、指定したSELECT文のデータを取得するプログラムを作成してみたので、そのサンプルプログラムを共有する。
前提条件
下記記事の設定が完了していること。
Excel VBAでOracle接続するプログラムを作成する準備をしてみたExcel VBAでOracleに接続するプログラムを作成することができるが、そのために、いろいろ準備が必要である。今回は、その準備を行...
また、以下のように、接続先となるデータベースに、user_dataテーブルのデータが存在し、user_data2テーブルが存在しないこと
freelance hubを利用して10万件を超える案件情報からJava Spring案件を検索してみたfreelance hubは、レバテックフリーランスやフリエン(furien)を始めとした多くのフリーランスエージェントの案件をまとめて...
サンプルプログラムの作成
ファイル「DbDump.xlsm」を開き、実行情報シートを以下のように編集する。
また、「取得」ボタンが押下された場合、以下のプログラムの「dbDump」サブプロシージャが呼び出されるようになっていて、チェック処理、DB接続処理、SQL実行、DB切断処理の順に処理を行っている。
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 | Option Explicit '変数の宣言を必須にする '----------------------------------------------------------- ' 機能: DBダンプを取得する ' 引数: なし ' 返り値: なし '----------------------------------------------------------- Sub dbDump() '変数宣言 Dim ADOConnection As ADODB.Connection Dim sSQL As String Dim lnSqlIdx As Long Dim sWorkSheetName As String Dim lnLstRow As Long Dim blSqlResult As Boolean '入力チェックを行う If chkInput() = False Then Exit Sub End If 'DBに接続 Set ADOConnection = connectDB() 'DBに接続できなければ、処理を終了 If ADOConnection Is Nothing Then Exit Sub End If '実行SQL文を生成 sSQL = getSQL() 'ワークシート名を取得し、再作成 sWorkSheetName = Worksheets("実行情報").Cells(12, 4).Value Call addWorkSheet(sWorkSheetName) 'SQL実行結果を記載 blSqlResult = writeSqlResult(sSQL, sWorkSheetName, 2, ADOConnection) 'DBから切断 Call disConnectDB(ADOConnection) 'SQL実行結果記載処理でエラーがなければ、実行情報シートを 'アクティブにし、完了メッセージを表示 If blSqlResult = True Then Worksheets("実行情報").Activate MsgBox "DBダンプ取得処理が完了しました" End If End Sub '----------------------------------------------------------- ' 機能: 「実行情報」シートの入力チェック処理を行う ' 引数: なし ' 返り値: 処理結果(True:エラー無、False:エラー有) '----------------------------------------------------------- Function chkInput() As Boolean 'SIDが未入力の場合はエラー If Worksheets("実行情報").Cells(5, 3).Value = "" Then MsgBox "SIDを入力してください" chkInput = False Worksheets("実行情報").Cells(5, 3).Select Exit Function End If 'ユーザーIDが未入力の場合はエラー If Worksheets("実行情報").Cells(6, 3).Value = "" Then MsgBox "ユーザーIDを入力してください" chkInput = False Worksheets("実行情報").Cells(6, 3).Select Exit Function End If 'パスワードが未入力の場合はエラー If Worksheets("実行情報").Cells(7, 3).Value = "" Then MsgBox "パスワードを入力してください" chkInput = False Worksheets("実行情報").Cells(7, 3).Select Exit Function End If '取得タイミングが未入力の場合はエラー If Worksheets("実行情報").Cells(5, 7).Value = "" Then MsgBox "取得タイミングを入力してください" chkInput = False Worksheets("実行情報").Cells(5, 7).Select Exit Function End If 'テーブル名が未入力の場合はエラー If Worksheets("実行情報").Cells(12, 4).Value = "" Then MsgBox "テーブル名を入力してください" chkInput = False Worksheets("実行情報").Cells(12, 4).Select Exit Function End If chkInput = True End Function '----------------------------------------------------------- ' 機能: DB接続を行う ' 引数: なし ' 返り値: DB接続コネクション '----------------------------------------------------------- Function connectDB() As ADODB.Connection '変数定義 Dim sId As String Dim sUser As String Dim sPass As String Dim ADOConnection As ADODB.Connection 'DB接続情報 sId = Worksheets("実行情報").Cells(5, 3).Value 'SID sUser = Worksheets("実行情報").Cells(6, 3).Value 'ユーザーID sPass = Worksheets("実行情報").Cells(7, 3).Value 'パスワード 'DB接続 On Error GoTo ErrOpenDb Set ADOConnection = New ADODB.Connection ADOConnection.ConnectionString = "Provider=OraOLEDB.Oracle;Data Source=" _ & sId & ";User ID=" & sUser & ";Password=" & sPass & ";" ADOConnection.Open Set connectDB = ADOConnection Exit Function ErrOpenDb: 'エラー時は、エラーメッセージを表示 MsgBox "エラーが発生しました" _ & vbCrLf & vbCrLf & Err.Description Set connectDB = Nothing End Function '--------------------------------------------------------------- ' 機能: 実行情報シートの実行SQLで指定された行のSQL文を生成する ' 引数: なし ' 返り値: 生成されたSQL文 '--------------------------------------------------------------- Function getSQL() As String '変数定義 Dim sTblName As String Dim sWhere As String 'テーブル名とWhere句を取得 sTblName = Worksheets("実行情報").Cells(12, 4).Value sWhere = Worksheets("実行情報").Cells(12, 6).Value 'SELECT文を生成 getSQL = "select * from " & sTblName If sWhere <> "" Then getSQL = getSQL & " where " & sWhere End If End Function '---------------------------------------------------------------------- ' 機能: 指定されたシート名のワークシートを再作成する ' 引数: sWorkSheetName : シート名 ' 返り値: なし '---------------------------------------------------------------------- Sub addWorkSheet(sWorkSheetName As String) '指定したシートが存在する場合は削除 Call deleteWorkSheet(sWorkSheetName) '指定したシートを追加 Worksheets().Add After:=Worksheets(Worksheets.Count) ActiveSheet.Name = sWorkSheetName ActiveSheet.Cells.Select Selection.NumberFormatLocal = "@" '書式は文字列を指定 Range("A1").Select End Sub '---------------------------------------------------------------------- ' 機能: 指定されたシート名のワークシートを削除する ' 引数: sWorkSheetName : シート名 ' 返り値: なし '---------------------------------------------------------------------- Sub deleteWorkSheet(sWorkSheetName As String) '変数定義 Dim ws As Worksheet '指定したシートが存在するかどうかチェック '指定したシートが存在する場合は、削除確認メッセージを非表示にして削除 For Each ws In Sheets If ws.Name = sWorkSheetName Then Application.DisplayAlerts = False Worksheets(sWorkSheetName).Delete Application.DisplayAlerts = True Exit For End If Next End Sub '------------------------------------------------------------------ ' 機能: 引数で指定したSQL文の実行結果を出力する ' 引数: sSQL : 実行するSQL行 ' sWorkSheetName : ワークシート名 ' lnFstRow : 記載開始行 ' ADOConnection : DB接続コネクション ' 返り値: 処理結果(True:エラー無、False:エラー有) '------------------------------------------------------------------ Function writeSqlResult(sSQL As String, sWorkSheetName As String _ , lnFstRow As Long, ADOConnection As ADODB.Connection) As Boolean '変数定義 Dim sEvent As String Dim sInstance As String Dim sUser As String Dim sPassword As String Dim ADORecordset As New ADODB.Recordset Dim myRS As New ADODB.Recordset Dim inFldCnt As Integer Dim lnRowCnt As Long Dim i As Long 'SQLの実行 On Error GoTo ErrExecSelect ADORecordset.Open sSQL, ADOConnection 'アクティブシートをテーブル名のシートに設定 Worksheets(sWorkSheetName).Activate '実行タイミングをワークシートに追記し、セル結合 sEvent = Worksheets("実行情報").Cells(5, 7).Value Cells(lnFstRow, 1) = "【実行タイミング】" & sEvent Range(Cells(lnFstRow, 1), Cells(lnFstRow, 10)).Merge 'SQL文をワークシートに追記し、セル結合 Cells(lnFstRow + 1, 1) = "SQL: " & sSQL Range(Cells(lnFstRow + 1, 1), Cells(lnFstRow + 1, 10)).Merge 'カラム数を取得 inFldCnt = ADORecordset.Fields.Count 'カラム名を先頭に表示 For i = 1 To inFldCnt Cells(lnFstRow + 2, i).Value = ADORecordset.Fields(i - 1).Name Cells(lnFstRow + 2, i).Interior.Color = RGB(0, 32, 96) Cells(lnFstRow + 2, i).Font.Color = RGB(255, 255, 255) Next '先頭レコードからEOFまで繰り返し追記 lnRowCnt = lnFstRow + 3 Do Until ADORecordset.EOF For i = 1 To inFldCnt 'カラム値を順に表示 Cells(lnRowCnt, i) = ADORecordset.Fields(i - 1).Value Cells(lnRowCnt, i).Interior.Color = RGB(221, 235, 247) Next ADORecordset.MoveNext lnRowCnt = lnRowCnt + 1 Loop 'ADORecordsetを閉じる ADORecordset.Close Set ADORecordset = Nothing '列幅を自動調整する Range(Columns(1), Columns(inFldCnt)).EntireColumn.AutoFit Range(Columns(11), Columns(14)).EntireColumn.AutoFit writeSqlResult = True Exit Function ErrExecSelect: '指定したシートを削除 Call deleteWorkSheet(sWorkSheetName) 'エラー時は、エラーメッセージを表示 MsgBox "エラーが発生しました" _ & vbCrLf & vbCrLf & Err.Description writeSqlResult = False End Function '----------------------------------------------------------- ' 機能: DB切断を行う ' 引数: ADOConnection : DB接続コネクション ' 返り値: なし '----------------------------------------------------------- Sub disConnectDB(ADOConnection As ADODB.Connection) 'DB切断 If Not (ADOConnection Is Nothing) Then ADOConnection.Close Set ADOConnection = Nothing End If End Sub |
なお、実際に作成したVBAファイルの内容は、以下のサイトを参照のこと。
https://github.com/purin-it/vba/tree/master/excel-vba-oracle
「FlexClip」はテンプレートとして利用できる動画・画像・音楽などが充実した動画編集ツールだったテンプレートとして利用できるテキスト・動画・画像・音楽など(いずれも著作権フリー)が充実している動画編集ツールの一つに、「FlexCli...
サンプルプログラムの実行結果
正常にuser_dataテーブルのデータが取得できる場合の実行結果は、以下の通り。
1-1) 以下のように各セルを指定し、「取得」ボタンを押下
1-2) 以下のように、完了メッセージが表示される
1-3) 「user_data」シートには、以下のように、取得したデータが設定されることが確認できる
また、必須項目(SID)が入力されなかった場合の実行結果は、以下の通り。
2-1) 以下のように、SIDの入力がない状態で、「取得」ボタンを押下
2-2) 以下のように、エラーメッセージが表示されることが確認できるので、「OK」ボタンを押下
2-3) 以下のように、エラーの原因となる項目にカーソルが設定されることが確認できる
さらに、DB接続時にエラーになる場合の実行結果は、以下の通り。
3-1) 以下のように、接続先のうち「パスワード」が違っている状態で、「取得」ボタンを押下
3-2) 以下のように、ログインできなかった旨のエラーメッセージが表示されることが確認できる
また、実行SQLエラーになる場合の実行結果は、以下の通り。
4-1) 以下のように、実行SQLで指定したテーブル名が存在しない状態で、「取得」ボタンを押下
4-2) 以下のように、表(テーブル)が存在しない旨のエラーメッセージが表示されることが確認できる
要点まとめ
- Excel VBAでOracleに接続するには、ADOというMicrosoftが提唱しているデータアクセス技術を利用して、ADODB.Connectionのオープン(DB接続)→ADORecordsetのオープン(SQL実行)→ADORecordset、ADODB.Connectionのクローズの順に実行すればよい。
