はじめに

ドキュメントを共有するにはConfluenceは最強のツールです。だた、図を描くのにGUIのLucid Chartは大変便利ですが、ネットワーク環境が良くない場所だと動きが遅く作業がはかどらないことがままあります。

VisualCodeなどではPlantUMLというCUIで図を描くことができるツールがあり以前からウェブでこれが利用できないかと思っていたところ、Confluenceで使えるという記事を見つけました。記事では、PlantUMLを使ってテキストベースでER図を作成する方法が紹介されていましたので、そこから引用させていただきました

使い方

Confluence上でPlantUMLを使ってER図を作成する方法をご紹介します。
１．記事を書く画面で「＋」→「その他のマクロ」

２． PlantUMLマクロを選択

３．「挿入」を押す

４．↓の枠がでてくるので、この中にER図描画用の情報を記入すればOK。コンフルを保存すれば、ER図ができあがり。

テンプレート

@startuml
' ER図を見やすくするための設定
' monotone color
skinparam monochrome true
' shadow off
skinparam shadowing false
' change font
skinparam defaultFontName Ricty Diminished
' hide the spot
hide circle
' avoid problems with angled crows feet
skinparam linetype ortho

' 1. table list
object table1
object table2
object table3

' 2. column list
table1 : column1_1
table1 : column1_2
table2 : column2_1
table2 : column2_2
table3 : column3_1
table3 : column3_2
table3 : column3_3

' 3. relation list
table1 }o--||  table2: (column1_1=column2_1)
table1 ||--o{ table3 : (column1_2=column3_1)

@enduml

大きく分けて3つのブロックに分かれており、
– テーブルリスト
– カラムリスト
– リレーション
をそれぞれ列挙すればOKです。

↓こんな感じで出力されます。

補足的にJOINの条件を (column1_1=column2_1)といったテキストで表示させています。（これは無くすこともできます）

リレーションのバリエーション

リレーションのバリエーションは↓ですべてカバーできると思います。

N:1
Member }o--||  TPref: (mePrefID-prPrefID)
Member }|--||  TPref: (mePrefID-prPrefID)

1:N
Member ||--o{  TPref: (mePrefID-prPrefID)
Member ||--|{  TPref: (mePrefID-prPrefID)

1:1
Member ||--||  TPref: (mePrefID-prPrefID)
Member |o--||  TPref: (mePrefID-prPrefID)
Member ||--o|  TPref: (mePrefID-prPrefID)


N:N ※基本的にないはず
Member }o--o{  TPref: (mePrefID-prPrefID)
Member }|--|{  TPref: (mePrefID-prPrefID)