ER Diagram from SQL Schema and Migrations (draw.io)ER図の自動生成(SQL・マイグレーション・Prisma から draw.io)

ER Diagram turns the database schema in your repository into an ER diagram (ER図) you can hand to a client, and a document that says which relations are facts and which are guesses.

What you get:

• docs/design/er-diagram.drawio: an editable draw.io diagram in crow's foot notation, with primary and foreign keys, column types and a cardinality symbol on each end of every relation. Tables are laid out by a script, so the same schema always gives the same diagram and boxes do not overlap.
• docs/design/er-diagram.md: the table list, every relation with the file and line it comes from, inferred relations, dropped tables and columns, warnings, and questions for the system owner. PMDesk can comment on this file.
• An optional PNG, only after you agree, because it starts the draw.io desktop app. PMDesk previews PNG but not .drawio.

How it works: a script reads SQL files in file-name order and applies CREATE TABLE, ALTER TABLE, DROP and RENAME, so the final state is what gets drawn, including foreign keys added in a later migration. It also reads schema.prisma (PostgreSQL, MySQL and SQLite DDL are covered at the usual level). A column such as doctor_id with no foreign key is drawn as a dashed, inferred relation, never as a fact. Other ORMs (TypeORM, Sequelize, Django, Rails, SQLAlchemy) are read by the agent from the model code into the same format.

Limits: it reads local files only and never connects to a database, so it shows what the files say, not what runs in production. Views, functions and statements it cannot read are listed as warnings, not guessed. Large schemas are split into several diagrams by group of tables.

In our test sample, a clinic database in six migration files (9 live tables, 1 dropped table, 1 dropped column, 11 foreign keys), all three runs found all 11 foreign keys, including one added by a later ALTER TABLE, left out the dropped table and column, and drew the unconstrained doctor_id as a dashed inferred relation. A single run without the skill drew the dropped table and column, got the cardinality wrong on 2 of the 11 foreign keys and wrote no explanation document.

Drawing a different diagram? For use case, activity or state diagrams see the UML Diagrams skill. For infrastructure see the AWS Infra Diagram skill and the Azure Infra Diagram skill.

ER図 自動生成スキルは、リポジトリにあるデータベースのスキーマから、お客様に渡せる ER図を作り、どの関係が事実でどれが推測かを書いた説明書も残します。

できあがるもの:

• docs/design/er-diagram.drawio: 鳥の足記法の ER図(draw.io で編集可能)。主キー・外部キー・カラムの型、各関係の両端のカーディナリティを表示します。配置はスクリプトが決めるので、同じスキーマなら同じ図になり、テーブルが重なりません。
• docs/design/er-diagram.md: テーブル一覧、各リレーションとその根拠のファイル・行、推定リレーション、削除されたテーブルとカラム、警告、システム担当者への確認事項。PMDesk でコメントできます。
• PNG(任意): draw.io デスクトップアプリを起動するため、確認してから出力します。PMDesk は PNG をプレビューできますが .drawio は表示できません。

仕組み: スクリプトが SQL ファイルをファイル名の順に読み、CREATE TABLE・ALTER TABLE・DROP・RENAME を適用します。そのため最終状態が描かれ、後のマイグレーションで ALTER により追加された外部キーも漏れません。schema.prisma も読めます(PostgreSQL・MySQL・SQLite の一般的な DDL に対応)。doctor_id のように外部キー制約のない列は、事実ではなく破線の推定リレーションとして描きます。TypeORM、Sequelize、Django、Rails、SQLAlchemy などはエージェントがモデルのコードを読み、同じ形式に変換します。

制限: 読むのはローカルのファイルだけで、データベースには接続しません。図が示すのはファイルの内容であり、本番の状態とは限りません。ビュー・関数・読めなかった文は警告として載せ、推測では補いません。テーブルが多いスキーマはグループごとに複数の図に分けます。

検証用のサンプル(6 本のマイグレーションからなる診療所のデータベース。現存テーブル 9、削除済みテーブル 1、削除済みカラム 1、外部キー 11)では、スキルありの 3 回とも、後のマイグレーションで ALTER TABLE により追加された外部キーを含む 11 本すべてを検出し、削除済みのテーブルとカラムは図に含めず、制約のない doctor_id は破線の推定リレーションとして描きました。スキルなしの 1 回では、削除済みのテーブルとカラムが図に残り、外部キー 11 本のうち 2 本で多重度を誤り、説明書も作られませんでした。

ほかの図が必要な場合、ユースケース図・アクティビティ図・状態遷移図は UML Diagrams スキル、インフラ構成図は AWS Infra Diagram スキルと Azure Infra Diagram スキルをご利用ください。