A5:SQL Mk-2で「脱・属人化」！Gitを活用した最強のDB設計共有ワークフロー
こんにちは。DBアーキテクチャの荒波を越えてきた皆さんに、今日は「A5:SQL Mk-2」という伝説的なツールを、チーム開発で最大限に活かすための「極意」を伝授します。
多くの現場で、「ER図が誰のPCに保存されているかわからない」「最新のテーブル定義が反映されていない」という悲劇が起きています。これを解決し、「ER図をコードのように扱う」ための実践的なノウハウを共有します。
—
1. なぜA5:SQL Mk-2 × Gitなのか？
A5:SQL Mk-2は、単なるDBクライアントではありません。強力なERモデリングツールです。しかし、GUIで完結するツールであるがゆえに、「個人のPCで完結しがち」という弱点があります。
Gitで管理することで、以下のメリットが生まれます。
- 変更履歴の可視化: 誰が、いつ、どのカラムを追加したのかが明確になる。
- コンフリクトの回避: 設計の変更をプルリクエスト（PR）でレビューできる。
- シングルソース・オブ・トゥルース（信頼できる唯一の情報源）: DB設計が常にチームの共有財産になる。
—
2. 最初のセットアップ：ここから全てが変わる
まずは、A5:SQL Mk-2を使いこなすための「儀式」です。
ステップ1：インストールとプロジェクトフォルダの構成
公式サイトから最新版をダウンロードし、プロジェクトルートに`docs/db/`といったディレクトリを作成しましょう。
/my-project
├── .git/
├── src/ # ソースコード
└── docs/
└── db/
├── schema.erdx # ER図本体
└── connection.ini # 接続設定（後述！）
ステップ2：もっとも重要な「設定ファイルの分離」
ここが最も重要です。A5:SQL Mk-2の設定（`a5m2.ini`など）には、ローカル環境のパスやパスワードが含まれる可能性があります。これらをGitに含めてはいけません。
- ER図ファイル（.erdx）: Git管理対象。
- DB接続情報: Gitには含めず、各メンバーのローカル設定にするか、機密情報を含まないテンプレートを共有しましょう。
—
3. Hello World：最初のER図共有
まずは、簡単なテーブルを一つ作成し、Gitに乗せるまでの手順を体験しましょう。
1. ER図の作成: 新規ER図を作成し、`users`テーブルを作成します。
2. 保存: `docs/db/schema.erdx`として保存します。
3. Gitの初期化:
git init
git add docs/db/schema.erdx
git commit -m “feat: 初期ER図の追加”
これで、あなたのDB設計は「コード」になりました。
—
4. チーム開発を加速させる「差分管理の極意」
ER図（`.erdx`）はバイナリ形式を含みますが、A5:SQL Mk-2のファイルは非常に優秀で、テキストベースの差分が読み取りやすい設計になっています。
実践ワークフロー
1. ブランチを切る: 設計変更を行う際は必ず別のブランチを切ってください。
`git checkout -b feature/add-order-table`
2. A5:SQL Mk-2で編集: テーブルを追加し、保存します。
3. コミット:
`git add .`
`git commit -m “feat: 注文管理テーブルの定義追加”`
4. PRを作成: GitHub/GitLab上で「ER図の変更内容」をチームで見直します。
ここでプロのコツ:
PRを作成する際、A5:SQL Mk-2の「HTML出力機能」を使って、ER図を画像として書き出し、一緒にリポジトリへコミットしてください。こうすることで、レビューアはA5:SQL Mk-2を起動しなくてもブラウザ上で変更内容を確認できます。
—
5. 絶対に守るべき「3つの鉄則」
現場で震えるほど役立つ、トラブル回避の知恵です。
1. 同時編集を避ける: A5:SQL Mk-2のER図ファイルは、同時に複数人が編集するとマージが困難です。設計変更は「一人が責任を持って行う」または「役割分担を明確にする」のが鉄則です。
2. DDLを生成し、Git管理する: ER図から生成される`.sql`ファイル（DDL）も必ずGit管理してください。DBサーバーへの適用は、このDDLをベースに行うのが安全です。
3. 「SQL履歴」を汚さない: A5:SQL Mk-2のSQL実行履歴は便利ですが、Gitで共有すると個人情報が漏れるリスクがあります。共有リポジトリには含めないように`.gitignore`で除外設定を忘れずに。
—
最後に：ツールは「文化」を作る
ツールを導入するだけでは、チームは変わりません。A5:SQL Mk-2をGitで管理し始めたその日から、「DB設計を議論する文化」を育ててください。
「このカラム、なぜこの型にしたの？」「この制約は必要？」といった会話がPR上で生まれるようになれば、あなたのチームのDB品質は、間違いなく世界トップクラスのレベルに到達します。
さあ、今すぐ`.erdx`ファイルをリポジトリへ放り込みましょう。毎日の作業が、今日から劇的に楽になりますよ！