MySQLのドキュメント作成「mysqldoc」
Javadoc、PHPDocなど、プログラミングソースからドキュメントを生成するソリューションは幾つか存在する。きちんとコメントを書けば、それがドキュメントになってくれるので、手間が減りつつもプログラムの品質は向上すると一石二鳥だ。
出力中
そして同様の手法をMySQLにも適用しようと言うのがこのソフトウェアだ。
今回紹介するオープンソース・ソフトウェアはmysqldoc、MySQLの構造ドキュメント出力ソフトウェアだ。
mysqldocはターミナル上で利用するソフトウェアで、指定したデータベース(または全て)のテーブルの構造を一覧にしてくれる。カラム名、テーブルタイプ、型、デフォルト値、詳細な説明を一覧にする。
HTMLでの出力例
テーブルのステータス等も出力される。結果はテキスト(デフォルト)、HTMLまたはXMLで出力が可能だ。SSLを使った接続への対応や、トリガーやユーザファンクションの表示設定等、細かなオプションが多数存在する。
項目はまだそれほど多くはないが、多人数での開発や定期的なメンテナンスで構造の詳細が分からなくなってしまうことはあるだろう。そうした時に一覧で出してくれると便利そうだ。
テキストでの出力例
mysqldoc - Google Code