
フォームを開いて確かめるのではなく、テキストの差分で見る —— SaveAsTextでVBAをGit管理する【完全版スクリプト付き】
連載「Accessを移行するのではなく、「移行できる形」に変える」の Step 1 後編です。
前回は、ODBC経由でテーブル構造をCSVに書き出しました。建物にたとえるなら、設計図が手に入った状態です。今回は、配管図と制御プログラム——つまりクエリとVBAを取りに行きます。
なぜODBCでは足りないのか
前回のスキーマ分析で取れたのは、テーブル・列・キーといった「器」の情報でした。しかし、Accessシステムの本体は器ではなく、その上で動いているロジックです。
標準モジュール・クラスモジュールの VBAソース
マクロの定義
フォーム/レポートのデザインと、そこに埋め込まれたイベント処理
保存済みクエリのSQL
これらはODBCの窓口からは見えません。Access内部の独自形式だからです。ここを取り出すには、Access自身が持っているエクスポート機能を使うしかありません。
核心は SaveAsText という公式API
Microsoft Accessには、オブジェクトをテキストファイルに書き出す SaveAsText という機能が(あまり知られていませんが)公式に備わっています。
# オブジェクト種別, オブジェクト名, 出力ファイルパス
app.SaveAsText(5, "Module1", r"C:\out\modules\Module1.bas") # 5 = モジュール
app.SaveAsText(2, "Form1", r"C:\out\forms\Form1.txt") # 2 = フォーム
「フォームを開いてVBEからコピペすればいいのでは?」と思うかもしれません。実際、手作業ならそれでも取れます。しかし数十のフォームとモジュールを、毎回、漏れなく、同じ形式で取り出せるでしょうか。SaveAsTextを使う理由は3つです。
Microsoftが公式にサポートしている機能なので、出力形式が安定している
Gitのdiffが意味のある粒度で取れる
スクリプトから呼べるので、再現性がある(=定期実行できる)
つまりこれは「一度きりの調査」ではなく、仕組みとしての可視化です。
つまずきポイント:AccessのCOMは直感と違う
SaveAsTextはCOM経由(PythonならpywinでAccessを裏から操作)で呼びますが、AccessのCOMオブジェクトモデルには、直感に反する部分があります。ここで多くの人が最初にハマります。
まず、動かないパターンから。
app.Modules.Item(i) # ❌ 直接参照できない
app.Forms("Form1") # ❌ 一覧取得の用途には不向き(開いているフォームしか見えない)
正しくは、Containers という入れ物経由でオブジェクト名の一覧を取り、名前を指定してSaveAsTextを呼びます。
containers = app.CurrentDb().Containers
modules = containers("Modules")
for i in range(modules.Documents.Count):
name = modules.Documents(i).Name
app.SaveAsText(5, name, str(out_dir / f"{name}.bas"))
コンテナ名と種別定数の対応は、この4つを覚えておけば足ります。
コンテナ名 内容 SaveAsText種別 Modules VBAモジュール 5 (acModule) Scripts マクロ 4 (acMacro) Forms フォーム 2 (acForm) Reports レポート 3 (acReport)
(マクロのコンテナ名が Macros ではなく Scripts なのも、初見では気づきにくいポイントです。さらに、この種別定数はコンテナの並びとは無関係な値なので、思い込みで書くと全滅します——私は実際に一度やりました。詳しくは有料部分のトラブルシュートで)
出力されるフォルダ一式
前回のスキーマ抽出と合わせた統合版を実行すると、最終的にこういうフォルダ一式が手に入ります。
access_project/
├── schema_dump/ … テーブル・列・キー(前回の成果物)
└── access_src/
├── modules/ … VBAモジュール (*.bas)
├── macros/ … マクロ (*.txt)
├── forms/ … フォーム定義 (*.txt) ※埋め込みイベント含む
├── reports/ … レポート定義 (*.txt)
└── queries/ … クエリSQL (*.sql)
それぞれのフォルダから分かることを一言で言うと、こうなります。
フォルダ 分析で分かること modules/ ビジネスロジックの本体、共通関数、外部連携 macros/ 画面遷移と自動実行の流れ forms/ UI構成と、イベントハンドラがどこにあるか queries/ データ加工ロジック、集計の条件
ここからが本番:Gitに入れて「資産」にする
テキスト化した成果物は、Gitリポジトリに入れて初めて価値が出ます。おすすめの構成はこうです。
your-access-project/
├── schema_dump/ … スキーマCSV(Git管理)
├── access_src/ … VBA・マクロ等(Git管理)
├── scripts/ … 抽出スクリプト
└── README.md … 分析メモ・更新手順
元の .accdb 本体はGit管理外で構いません。管理したいのはバイナリではなく、そこから抽出した「読める形」のほうです。
運用サイクルは単純です。
[Accessで開発・修正]
↓
[抽出スクリプト実行] ← 日次 or リリース前
↓
[git diff で変更確認]
↓
[コミット]
これが回り始めると、差分の見え方が変わります。columns.csv に行が増えていれば「テーブルに列が追加された」、modules/*.bas に差分があれば「ロジックが変わった」、forms/*.txt なら「画面かイベントが変わった」。フォームを一つずつ開いて目視確認する世界から、diffを読む世界へ——タイトルの意味はここにあります。
引き継ぎの場面を想像してみてください。「画面を触りながら口頭で説明する」のと、「リポジトリのURLとREADMEを渡す」のと、どちらが資産でしょうか。
今日やること1つ
抽出した modules/ フォルダの、ファイル数と合計行数を数えてください。
前回の「テーブル数・フィールド数」がデータ側の分母だとすれば、今回の「モジュール数・VBA行数」はロジック側の分母です。この2組の数字が揃うと、次のStep 2——どのVBAがAIに任せられて、どれが人間の仕事かを仕分ける準備が整います。
いよいよ棚卸しです。
【有料部分のご案内】完全版スクリプト一式
ここから先の有料部分(850円)には、以下が含まれます。すべて、テーブル200件・フォーム78本・クエリ240本規模の本番稼働中Accessシステムで動作検証済みです。
access_schema_extractor.py — スキーマ抽出の完全版(前回のExcel VBA最小版のPython版。日本語フィールド名対応、エラーテーブルのスキップとログ記録、CREATE TABLE風DDL生成付き)
access_objects_extractor.py — VBA・マクロ・フォーム・レポート・クエリの一括テキスト化(本記事の本体)。さらに移行分析用に、全テーブルのリンク/ローカル区分(linked_tables.csv)とローカルテーブルの主キー・インデックス(local_indexes.csv)も出力します
access_extract_all.py — 上記2本の統合実行
extract_access.bat — ダブルクリック/タスクスケジューラ用バッチ
拡張トラブルシュート集(10項目) — 私自身がこの検証で実際に踏んだ罠を含む、実運用でのハマりどころ(文字コードの二重の罠、SaveAsText定数の全滅パターン、Accessプロセスの残留、ロックファイルなど)
付録:バックエンドDB側スキーマ抽出SQL — 実データがMySQL/MariaDB等にあるシステム向けに、information_schemaから主キー・外部キーの「本物」を取るSQL
動作環境と免責(購入前に必ずお読みください)
Windows + Microsoft Access本体(デスクトップ版)がインストールされた環境が必要です。オブジェクト抽出はCOM経由で実際のAccessを操作するため、Access本体なしでは動作しません
Python 3.10以降、pyodbc および pywin32 を使用します
OfficeとACEドライバ、Pythonのビット数(32bit/64bit)が揃っている必要があります
動作確認環境:Windows 11 + Microsoft 365 (64bit) + Python 3.12 ※ご自身の検証結果に合わせて更新してください
本スクリプトは読み取り(抽出)のみを行い、元の .accdb を変更しませんが、実行は自己責任でお願いします。まずコピーしたファイルでお試しください
サポートはNoteのコメント欄での質疑応答の範囲とさせていただきます
なお、「スクリプトを動かす時間がない」「抽出はできたが、この後どう読めばいいか分からない」という方向けに、Access棚卸し診断(お手元のAccessの抽出〜三分類〜移行難易度の所見レポート納品)も承っています。ご興味があれば記事末尾の連絡先からご相談ください。
- #AI
- #生成AI
- #ChatGPT
- #AI活用
- #キャリア
- #働き方
- #仕事術
- #業務効率化
- #サラリーマン副業
- #エンジニア
- #個人事業主
- #DX
- #プログラミング
- #IT
- #データ分析
- #ビジネススキル
- #自動化
- #業務改善
- #python
- #人工知能
- #効率化
- #スキルアップ
- #生産性向上
- #思考法
- #時短
- #仕事効率化
- #仕事のコツ
- #AI時代
- #時間管理
- #ITエンジニア
- #タスク管理
- #問題解決
- #DX推進
- #システム開発
- #ノーコード
- #業務自動化
- #デジタルトランスフォーメーション
- #AI導入
- #課題解決
- #作業効率化
- #データ活用
- #現場改善
- #コスト削減
- #構造化
- #RPA
- #AI仕事術
- #業務改革
- #AIと仕事
- #業務設計
- #自動化ツール
- #ローコード
- #AI活用事例
- #ITツール
- #システム運用
- #IT活用
- #業務効率
- #改善活動
- #業務フロー
- #業務システム
- #Selenium
- #AIと共存
- #業務標準化
- #論理思考
- #システム化
- #IT戦略
- #データ処理
- #ツール活用
- #ブラウザ自動化
- #業務分析
- #業務効率化ツール
- #無駄削減
- #WEB自動化
- #業務自動化ツール
- #業務改善事例
- #自動化事例
- #RPA運用
- #iMacros
- #RPA開発
- #UIvision
- #PHPRunner
- #自動化エンジニア
- #RPA事例
- #MacroScheduler