メインコンテンツへスキップ
見出し画像

フォームを開いて確かめるのではなく、テキストの差分で見る —— 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システムで動作検証済みです。

    1. access_schema_extractor.py — スキーマ抽出の完全版(前回のExcel VBA最小版のPython版。日本語フィールド名対応、エラーテーブルのスキップとログ記録、CREATE TABLE風DDL生成付き)

    2. access_objects_extractor.py — VBA・マクロ・フォーム・レポート・クエリの一括テキスト化(本記事の本体)。さらに移行分析用に、全テーブルのリンク/ローカル区分(linked_tables.csv)とローカルテーブルの主キー・インデックス(local_indexes.csv)も出力します

    3. access_extract_all.py — 上記2本の統合実行

    4. extract_access.bat — ダブルクリック/タスクスケジューラ用バッチ

    5. 拡張トラブルシュート集(10項目) — 私自身がこの検証で実際に踏んだ罠を含む、実運用でのハマりどころ(文字コードの二重の罠、SaveAsText定数の全滅パターン、Accessプロセスの残留、ロックファイルなど)

    6. 付録:バックエンド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の抽出〜三分類〜移行難易度の所見レポート納品)も承っています。ご興味があれば記事末尾の連絡先からご相談ください。

     
     
    業務改善やRPAの現場で長く仕事をしています。現在は、4名のメンバーと一緒にRPA開発・運用と、AIを思考・開発のパートナーとして使いながら、 業務の構造 標準化の考え方 AI時代の仕事設計 について考えています。

    あなたへのおすすめ