仕組み

更新 2026-10-30

ERDismのプロジェクトがどのような形をしているかを、出会う順番に説明します。

1. ワークスペースがプロジェクトをまとめます

登録するとワークスペースが作られます。ワークスペースはプロジェクトをまとめ、プロジェクトはダイアグラムをまとめます。メンバーはワークスペースに招待され、そこでロールを持つので、アクセス権はプロジェクトごとではなく一度で決まります。

2. ひとつのプロジェクトがひとつのスキーマです

プロジェクトの中でエディターを開きます。キャンバスがダイアグラムで、その下のパネルがSQL、横のパネルはプロパティの編集・ タイムラインの閲覧・問題の確認を行うインスペクターです。これらはひとつのモデルを見る三つの画面なので、どこで変更しても残りの二つに反映されます。

ひとつのプロジェクトに、同じテーブルを扱うダイアグラムを複数置けます。テーブルはプロジェクトに一度だけ存在し、好きなだけ多くのダイアグラムに配置できるので、チームごとに担当する部分のビューを持てます。

3. 運用中のスキーマをインポートするか、新しく描きます

インポートとは、SQLを貼り付けるかファイルをアップロードすることです。インポートは三つのステップで進みます。分析では、 SQLが何を表しているか、どのテーブルを追加または変更することになるかを示します。確認では、どのテーブルをどのダイアグラムに置くかを選び、インポートによって除外されるものに同意します。インポートで実際に適用します。 ERDismがモデルとして扱わない句は、書かれたとおりに保持されます。

描く場合は、キャンバスにテーブルを置き、列とキーを追加し、テーブルの間にリレーションシップを引きます。その間、 ERDismがテーブルごとに CREATE TABLE を書きます。

4. 説明を書きます

テーブルごとにMarkdownで書くドキュメントページがあります。ドキュメントはテーブルと一緒にあるので、次にそのテーブルを開いた人が列のすぐ横で説明を読めます。

5. すべての変更が記録されます

タイムラインは、変更ごとに誰がいつ行ったかを記録します。テーブルと列の追加・更新・削除・復元、そしてSQLブロックの承認・却下・発行がすべて残ります。元に戻す・やり直しは、自分が行った変更だけが対象で、ダイアグラムごとではなくプロジェクト内のすべてのダイアグラムにわたって動作します。

6. 変更は承認を経ます

テーブルを編集すると下書きができます。下書きは保存したときに保存され、各SQLブロックはチームメイトが承認または却下するまで承認状態を持ちます。サーバーはプロジェクトが対象とするデータベースとバージョンに照らしてスキーマをチェックし、そのバージョンがサポートしないものは問題として表示されます。

7. 発行して、エクスポートします

発行とは、承認されたSQLをまとめて、発行されたバージョンとして記録することです。発行するにはスキーマの準備ができている必要があります。ブロックが承認済みで、未解決のリレーションシップがなく、サポートされている方言であることです。発行したあとは、SQLをファイルとしてエクスポートできます。現在はスキーマ全体であり、ERDismはまだ二つのバージョンの間の ALTER 文を書き出しません。

同じプロジェクトに他の人がいるとき

誰かがテーブルやSQLブロックを選択または編集すると、他の人にはそれが使用中として表示され、解放されるまでその人たちには読み取り専用になります。これはマージではなく排他制御です。2人が同じテーブルを同時に編集することはありません。