はじめに
AIにER図(データベースの表と、表どうしのつながりを描いた図)を頼むと、こんなことが起こりがちです。
- 画像生成AIに頼んだら、線がどの表どうしをつないでいるのか読み取れず、1本直すにも作り直すしかない
- Mermaidで出してもらったが、表の並びを決められず、関係の深い表が離れて置かれる
- draw.ioで描いてもらったが、線が表の上を横切り、どの線がどこへ行くのか追えない
当社は2026年の夏から、受託開発の設計資料でER図をAIに描かせてきました。何度か作り直したあとに落ち着いたのが、次の組み合わせです。
| 決めること | おすすめ |
|---|---|
| 道具 | draw.io(無料。デスクトップ版にPNGを書き出すコマンドがある) |
| 表記法 | IDEF1X(ER図の描き方の決まりの1つ) |
| 描き方 | AIにPythonのスクリプトを書かせ、.drawioのファイルを書き出す |
| 図の形 | 全部の列を載せた大きな1枚。業務のまとまりごとに破線の枠で囲む |
| 確かめ方 | draw.ioのコマンドでPNGにして、AIと人の両方で見る |
この組み合わせで描いたのが次の図です。架空の店舗予約サービスの8つの表を、1枚に載せています。画像を押すと大きく表示されます。
画像生成AIとMermaidで描いたとき
画像生成AI
同じ8つの表を、全部の列つきで画像生成AIに頼むと、次の画像になりました。Codexの画像生成の機能で、1回で出たものをそのまま載せています。
文字は、列名も型も日本語名も頼んだとおりに描けています。困るのは線です。店舗からメニューへの線は、店舗から予約への線の途中から分かれていて、スタッフから予約への線とも十字に交わっています。この交わりは、つながっているのか、上を通り過ぎているだけなのかを見分けられません。
直すときも困ります。線を1本だけ引き直したくても、画像を作り直すしかありません。作り直すと、合っていた表の位置や文字まで変わることがあります。設計資料のER図は、テーブル定義が変わるたびに直す図です。当社では、構造の図はdraw.ioで描くと決めています。
Mermaid
Mermaidは、文章のような書き方からブラウザで図を描くライブラリです。GitHubやNotionのMarkdownの中にそのまま書けるので、手軽さでは一番です。同じ8つの表をMermaidで描くと、次のようになります。
表と列の情報は正しく出ます。気になるのは並び方です。表の位置はMermaidが決めるので、「店舗まわりの表を左にまとめる」といった指定ができません。この図でも、店舗まわり(店舗、スタッフ、メニュー)の表と予約まわりの表が入り混じり、予約から伸びる線がメニューの表の下をかすめています。表が20を超えると、どの線がどこへ行くのかを目で追うのが難しくなります。
HTMLとCSSで自分で描けば、位置も色も自由です。ただ、そのときは線の通り道を計算するコードまで自分で書くことになります。
draw.ioで描くとき
draw.ioは、無料で使える作図のツールです。ブラウザ版のほかにデスクトップ版があり、デスクトップ版には、ファイルをPNGやSVGに書き出すコマンドが付いています。
AIに描かせる道具としては、次の3つが助かります。
- .drawioのファイルの中身はXMLの文字なので、AIが書けて、あとから人がdraw.ioの画面で直せる
- 箱の色、枠の太さ、線の種類、線の端の記号、線の通り道を、1つずつ指定できる
- 書き出しのコマンドがあるので、AIが自分で画像にして見直せる
標準の部品のままだと見づらいところ
draw.ioの標準の部品(見出しの付いた箱)で表を作り、配置と線の通り道をdraw.ioの自動に任せると、次の図になります。
道具は同じでも、読みにくさはMermaidより増えています。理由は3つあります。
- 線が表の上を横切り、列の名前に重なる。予約の表の左端に、6本の線が集まる
- 表が名前の順に並ぶだけで、店舗、予約、会員のまとまりが見えない
- 英語の名前しかなく、各列が何を表すのかは、別の資料を見ないとわからない
draw.ioで描くこと自体は正解でも、どう描くかまで指定しないと、この図が出てきます。
IDEF1Xで描く
IDEF1Xは、ER図の描き方の決まりの1つです。1993年に米国の連邦情報処理標準(FIPS PUB 184)として定められ、いまは多くの設計ツールが対応しています。日本の業務システムの設計書でもよく見る形です。
IDEF1Xで使う記号は多くありません。会員、予約、予約の明細、メニューの4つの表で、主な記号をひととおり描くと次のようになります。
予約の明細は、予約のidと行番号の2つで1行が決まる表です。親の主キーが自分の主キーに入るので、角の丸い箱になり、予約とは実線でつながります。最近のWebサービスのように、どの表も連番のidを主キーにする設計では、ほとんどの表が角の四角い箱になり、線も破線になります。
箱の作り
1つの表を大きくすると、次の作りになっています。
| 部分 | 描き方 |
|---|---|
| 箱 | 薄いクリーム色(#FFF3C4)の地に、2.5pxの濃い紺(#1E293B)の枠。色はIDEF1Xの決まりにはないので、好みで替えてよい |
| 名前 | 箱の外の上に置く。物理名(英語)を太字で、論理名(日本語)とテーブル名を灰色で並べる |
| 主キーの区画 | 横線の上に、主キーの列だけを置く |
| 属性の区画 | 1行に「物理名、型と長さ、(FK)、論理名」を並べる |
| 線 | 破線。多い側の端に黒丸。親がいなくてもよい側に白い菱形 |
関係線のdraw.ioの設定は次のとおりです。
edgeStyle=orthogonalEdgeStyle;rounded=0;strokeWidth=1.5;dashed=1;dashPattern=6 4;
endArrow=oval;endFill=1;endSize=9;startArrow=none;jumpStyle=arc;jumpSize=10;
orthogonalEdgeStyle で線を縦と横だけで曲げ、jumpStyle=arc で線どうしが交わる場所に小さな山を付けます。親がいなくてもよい関係では、startArrow=diamond;startFill=0; に替えます。
読みやすくする並べ方
表記をIDEF1Xにそろえても、並べ方が悪いと読みにくいままです。当社でAIに守らせているのは次の4つです。
| 決まり | 理由 |
|---|---|
| 表を業務のまとまりごとに破線の枠で囲む | 「予約まわり」「会員まわり」の単位で読める。技術の層(認証、マスタなど)で分けるより、業務の担当者に通じる |
| 線を1本ずつ、表の間のすき間に通す | 線が表の上を通らず、ほかの線と重ならない |
| 子の表に入る線は、名前を避けて右寄りに入れる | 名前の文字に線がかからない |
| 全部の列を載せた1枚を作る | 列を省いた図だと、外部キーの列がどの表のどこにあるかを別の資料で探すことになる |
1枚は大きくなります。冒頭の図は8つの表で1920×1080です。表が30を超えると5000px四方を超えますが、draw.ioの画面なら拡大して読め、PNGも拡大表示できます。表の数が多いときは、全部を載せた1枚とは別に、まとまりごとのページを足します。
今ある表に列を足す設計なら、冒頭の図のように、足す列を緑の太字にして頭に「+」を付け、表の名前の横に「列追加」「追加」の札を置くと、変わる部分がひと目でわかります。
AIに描かせる手順
Claude CodeやCodexに頼むときは、.drawioのXMLを直接書かせず、XMLを書き出すPythonのスクリプトを書かせます。直すたびに配置を1か所変えて流し直せるからです。
- 正しいスキーマを渡す。Prismaのschema.prismaや、CREATE TABLEの文、テーブル定義書など、元になるものを1つ決める
- 表と列と関係を、Pythonのデータとして書かせる。描画の処理とは分ける
- 箱の幅は文字の幅から計算させる。高さは行の数から決まる
- 線は1本ずつ、曲がる点(waypoint)を指定させる。draw.ioの自動に任せない
- draw.ioのコマンドでPNGに書き出させ、AIに画像を見せて、重なりやはみ出しを直させる
頼み方の例です。
schema.prismaのテーブルを、draw.ioのER図にしてください。
- PythonでXMLを書き出すスクリプトを作り、.drawioとPNGの両方を出す
- 表記はIDEF1Xにする。クリーム色の箱、濃い紺の太枠、名前は箱の外の上、
主キーと属性を横線で分ける、1行は「物理名 型 (FK) 論理名」
- 関係線は破線で、多い側の端に黒丸。親が無くてもよい側に白い菱形
- 業務のまとまりごとに破線の枠で囲む
- 線は全部に通り道を指定し、表の上やほかの線と重ならないようにする
- PNGを書き出したら自分で見て、重なりがなくなるまで直す
PNGへの書き出しは、Macのデスクトップ版なら次のコマンドです。-p はページの番号で、1から数えます。
drawio -x -f png -p 1 -s 1.5 -o er.png er.drawio
つまずきやすいところ
- 大きな図を高い倍率で書き出すと、下のほうが白く抜けることがあります。倍率を1.2〜1.5に下げ、書き出した画像を必ず開いて確かめます。当社では2回起き、2回目は人が見るまで気づきませんでした
- 文字の幅を半角と全角で同じに見積もると、日本語の論理名が箱からはみ出します。全角は文字の大きさと同じ幅、半角はその0.55〜0.6倍で計算させます
- draw.ioの標準の表の部品は、1つずつのセルに設定が付くので、表が40近くになるとファイルが600KBを超えます。テキストの部品を並べて表を組むと軽くなります
- AIにdraw.ioを操作させるMCPサーバーもありますが、当社の環境では接続が安定せず、コマンドでの書き出しで足りています

