概要

DBドキュメントを自動生成できるツールの有名所でいうと、MySQL Workbenchが筆頭に上がると思うが、それ以外にも良いOSSがないか漁ってみてちょっと触ってみたので感想を残す。

Schemaspy

DBに接続してhtmlでDBドキュメントを生成してくれるJava製のツール。

Dockerhubにイメージがあるので、それを使って簡単に試してみることができる。

MySQL5.7（多分5.8も大丈夫だと思う・・）は、こんな感じでいけるはず。 docker run -v "$PWD/schema:/output" --net="host" schemaspy/schemaspy:latest \ -t mysql -host {DBHOST}:{DBPORT} -db {DBNAME} -u {DBUSER} -p {DBPASSWORD}

MySQL5.6環境下ではコマンドをちょっといじる必要がある。 docker run -v "$PWD/schema:/output" --net="host" schemaspy/schemaspy:latest -t mysql -host {DBHOST}:{DBPORT} -db {DBNAME} -u {DBUSER} -p {DBPASSWORD} -connprops useSSL\\=false -s {DBNAME}

いずれもワンライナーでお試しできるので簡単。

もちろんmysql以外でもOK。

tbls

github.com - k1Low/tbls

CIフレンドリーなDBドキュメンテーションツールで、markdownでドキュメントを生成してくれる。

depでもrpmでもbrewでもgoでもdockerでもインストールできる。

使い方は簡単なのでgithubのREADME参照。

ドキュメントはmarkdownですべて管理したいので個人のアプリケーションのドキュメンテーションに採用している。

所感

ER図だけで比較すると、結論はMySQL Workbenchが一番見やすいかもしれない。ただしテーブル数による。少ないテーブル数であればどれでも良さそう。
MySQL WorkbenchのER生成はリレーション関係にないテーブルを自動で落としてくれないが、schemaspyはちゃんと落として生成してくれるぽい。
schemaspyのER図はテーブル数が多いとリレーションの線が追いづらいので、UIでなんとか調整できると良いと思った。MySQL Workbenchは手動で調整できるのでそのへん柔軟。（自動整頓の機能はあるが、限界があるぽい...）
ERについては全テーブルのリレーションを吐き出すのは物理的限界を感じるので、そこは使う側の工夫が必要なのかなぁと思う。一度に全テーブルを対象としてリレーションをみたいというケースはそんなにないと思うので、テーブルを絞るなどすれば良いと思う。schemaspyはERとして生成するテーブルを絞ったりできるのかな・・？ちゃんと見ていないがパッと見できなそう・・
tblsはCIフレンドリーなのでCIに組み込みやすいと思うが、schemaspyの方も比較的に容易に組み込むことができそう。
rarejob-tech-dept.hatenablog.com - ER図の自動作成を CI に組み込んだ話