SQL 文から ER 図を自動生成してくれる SchemaSpy を docker-compose でやってみた | ライタス株式会社

お世話になります。 田所です。

弊社は開発をすることは基本はないのですが、データベース周りを扱うことはよくあります。

最近、こんな連絡がありました。

DB設計をしてみたのでテーブル内容、リレーション等不備がないか確認をお願いします。 添付ファイル: DB.sql

添付の中を確認しますと、、

CREATE TABLE product (
    category INT NOT NULL, id INT NOT NULL,
    price DECIMAL,
    PRIMARY KEY(category, id)
)   ENGINE=INNODB;

......
...........続く

なるほど、わからん。

SQL文だけではさすがにしんどいですよね。

なのでSQL文からER図を作成してくれるSchemaspyを使ってみました。

どうやらSchemaspyはJavaベースで動いて、MYSQL等のデータベースへアクセスして情報を取得し、最終的なレポートを静的なHTMLで生成してくれるものみたいですね。

手順として以下のような感じになります。

  1. JavaとMySQLをインストール
  2. MySQLにSQL文をマイグレート
  3. Schemaspyを実行

うーん、、、なかなか面倒そうだし、ってことなので使い回しも考えてDocker化しちゃいます!

参考記事

構成

  • 構成図

  • ファイル構成
SchemaSpy/
├── README.md
├── Dockerfile
├── docker-compose.yml
├── mysql
│   └── table.sql   // xxxx.sql と拡張子がsqlになっているSQL文のファイルを配置する
└── output   // このフォルダにHTML,CSS,JSが生成される

Dockerイメージにはschemaspy/schemaspy:snapshotのイメージがあるので使いました。

しかし実行の際にmysql-connector-javaのバージョンが低いため失敗するので新しいmysql-connector-javaを入れています。

参考記事: Docker でサクッと MySQL 8 から ER 図を作成する

Dockerfile

FROM schemaspy/schemaspy:snapshot
USER root
RUN apk update && \
    apk add mysql-client && \
    mkdir -p drivers && \
    apk add --update openssl && \
    wget -P /tmp https://dev.mysql.com/get/Downloads/Connector-J/mysql-connector-java-8.0.16.tar.gz && \
    tar xvzf /tmp/mysql-connector-java-8.0.16.tar.gz -C /tmp && \
    cp /tmp/mysql-connector-java-8.0.16/mysql-connector-java-8.0.16.jar /drivers/. && \
    rm -rf /tmp/mysql-connector-java-8.0.16*

docker-composeは若干の工夫が必要で、 先にschemaspyコンテナが起動するとMySQLへの接続エラーとなるため、 MySQLが正常に接続できるようになるのを確認したらschemaspyコンテナを起動させます。

そのためMySQLコンテナにヘルスチェック項目を、 schemaspyコンテナにはdepends_onでcondition: service_health、 とすることでMySQLのヘルスチェックが成功した後、schemaspyコンテナを起動します。

MySQLコンテナの公式に/docker-entrypoint-initdb.dに.sqlファイルを配置したらこれらをインポートすると書いてあるのでこれを利用してマウントさせています。

docker-compose.yml

version: "2"
services:
  db:
    image: mysql:8
    container_name: "mysql"
    volumes:
      - ./mysql:/docker-entrypoint-initdb.d
    environment:
      - MYSQL_ROOT_PASSWORD=root
      - MYSQL_DATABASE=SCHEMASPY_DATABASE
    ports:
      - 3306:3306
    healthcheck:
      test: mysqladmin ping -h 127.0.0.1 -u root -proot || exit 1
  schemaspy:
    build:
      context: .
    container_name: "schemaspy"
    environment:
      - MYSQL_ROOT_PASSWORD=root
    volumes:
      - ./output:/output
    depends_on:
      db:
        condition: service_healthy
    command: -t mysql -host db:3306 -db SCHEMASPY_DATABASE -u root -p root -s SCHEMASPY_DATABASE

実行

1. mysql フォルダに拡張子が.sql の SQL ファイルを配置する

今回はサンプルとしてMySQL 公式の SQL 文をtable.sqlという名前で配置しています。

※SQL文にはCREATE DATABASEの記載はせずCREATE TABLEのみ記載してください。

2. コマンド実行: docker-compose build

mysql-connector-java-8.0.16.tar.gzがリンクぎれになってエラーになった場合は最新のものを取得してください。

参考: https://www.mysql.com/jp/products/connector/

3. コマンド実行: docker-compose up

まずMySQLが立ち上がります。

xxxx@DESKTOP-xxxxx:~/schemaspy$ docker-compose up
[+] Running 2/2
 ⠿ Container mysql      Created                                                                                                                                                                                                         0.1s
 ⠿ Container schemaspy  Created                                                                                                                                                                                                         0.1s
Attaching to mysql, schemaspy
mysql      | 2022-01-14 10:29:42+00:00 [Note] [Entrypoint]: Entrypoint script for MySQL Server 8.0.27-1debian10 started.
mysql      | 2022-01-14 10:29:42+00:00 [Note] [Entrypoint]: Switching to dedicated user 'mysql'
mysql      | 2022-01-14 10:29:42+00:00 [Note] [Entrypoint]: Entrypoint script for MySQL Server 8.0.27-1debian10 started.
mysql      | 2022-01-14 10:29:43+00:00 [Note] [Entrypoint]: Initializing database files
......
........続く
mysql      | 2022-01-14T10:30:00.672640Z 0 [System] [MY-011323] [Server] X Plugin ready for connections. Bind-address: '::' port: 33060, socket: /var/run/mysqld/mysqlx.sock
mysql      | 2022-01-14T10:30:00.672703Z 0 [System] [MY-010931] [Server] /usr/sbin/mysqld: ready for connections. Version: '8.0.27'  socket: '/var/run/mysqld/mysqld.sock'  port: 3306  MySQL Community Server - GPL.

準備ができ、そのまま少し待つとSchemaSpyが起動します。

schemaspy  | Using drivers:mysql-connector-java-8.0.16.jar
schemaspy  |   ____       _                          ____
schemaspy  |  / ___|  ___| |__   ___ _ __ ___   __ _/ ___| _ __  _   _
schemaspy  |  \___ \ / __| '_ \ / _ \ '_ ` _ \ / _` \___ \| '_ \| | | |
schemaspy  |   ___) | (__| | | |  __/ | | | | | (_| |___) | |_) | |_| |
schemaspy  |  |____/ \___|_| |_|\___|_| |_| |_|\__,_|____/| .__/ \__, |
schemaspy  |                                              |_|    |___/
schemaspy  |
schemaspy  |                                               6.1.1-SNAPSHOT
schemaspy  |
schemaspy  | SchemaSpy generates an HTML representation of a database schema's relationships.
schemaspy  | SchemaSpy comes with ABSOLUTELY NO WARRANTY.
schemaspy  | SchemaSpy is free software and can be redistributed under the conditions of LGPL version 3 or later.
schemaspy  | http://www.gnu.org/licenses/
schemaspy  |
schemaspy  | INFO  - Starting Main v6.1.1-SNAPSHOT on 28ae269f727b with PID 1 (/usr/local/lib/schemaspy/schemaspy-6.1.1-SNAPSHOT.jar started by root in /)
schemaspy  | INFO  - The following profiles are active: default
schemaspy  | INFO  - Started Main in 1.523 seconds (JVM running for 2.257)
schemaspy  | INFO  - Starting schema analysis
mysql      | mbind: Operation not permitted
...................
schemaspy exited with code 0

無事終了したら Ctrl + C　でコンテナを終了させます。

^CGracefully stopping... (press Ctrl+C again to force)
[+] Running 2/2
 ⠿ Container schemaspy  Stopped                                                                                                                                                                                                         3.1s
 ⠿ Container mysql      Stopped                                                                                                                                                                                                         2.0s
canceled

4. output フォルダに HTML,CSS,JS が生成される

ホスト側のoutputフォルダにファイルが生成されています!

この中にあるIndex.htmlファイルを開きます。

問題なくみれました!

上にある「Relationships」をからER図を確認してみます。

いい感じにER図作らています!

今回のソースはGitHubにも上げています。

使いまわしが効くので便利です!

ご参考までに!

https://github.com/tadokoroshoma/schemaspy_docker_compose

コメント

コメントを投稿

このブログの人気の投稿

[Virus Error]と件名に挿入されたメール

とあるWebシステムで、ユーザーのメール機能を使って運営者に問い合わせができるようにしているものがあります。 （いわゆる、mailtoを使ったもの） あるとき、運営者が受け取ったときに、[Virus Error] (本来の件名)　という件名のメールが 届いているというので、調べてほしいと依頼があり調べてみました。 メールのヘッダーを確認したところ、 ・auのiPhoneからだと思われる ・メールの配送ルートは一般的なもの ネットの情報を引いてみると、日本語の情報は少なく、海外の掲示板をあたったほうが いろいろと情報が出てくるようですが・・・よくわかりません。 記事を流し読みしていてわかったことは以下。 ・iCloud経由のメールでこれがつくことがあるらしい https://discussions.apple.com/thread/7060793 真相は不明ですが、iCloud側の実装で何かあったのかもしれませんね。 本記事は、弊社代表のブログ記事 なんでもIT屋の宿命 からの転載です。
続きを読む

Firefoxを起動したら、Couldn't load XPCOM. というエラーが出る時の対処法 | ライタス株式会社

イメージ
今朝方、Firefoxを起動したら、Couldn't load XPCOM. というエラーが出るようになり、起動できなくなりました。 確か、システムの復元が走ったので、そのせいかなと思います。 対処法については、こちらに記載がありました。 http://www.thewindowsclub.com/firefox-couldnt-load-xpcom-windows 英語だったので、日本語訳してみます。 XPCOM is a cross-platform component object model, which is similar to Microsoft COM, and is required for file and memory management, basic data structures and so on. XPCOMは、クロスプラットフォームコンポーネントで、Microsoft COMに似ています。このファイルはメモリー管理、基礎データ構造などに利用されています。 This Firefox start-up error can typically occur after performing a Windows System Restore or if you run it in a Sandbox. In fact I too received this message a few days back after I had system restore my omputer a couple of times to fix some other issues. Firefoxの起動エラーは、Windowsのシステム復元を行ったときに出ることがあります。実際、私もシステム復元のあとに、このメッセージが出た時は、次のように対処しました。 1] Open Firefox Menu, click the “?” Help button and select  Restart with addons disabled . If this solves your issue, you may need to disable some problem-causing addon. 1] Fire
続きを読む

マテビュー（マテリアライズドビュー：Materialized View）のせいで、表領域が削除ができない | ライタス株式会社

久々にOracleで困ったことに遭遇したのと、日本語の情報が少なかったので、 記録がてら記事にします。 表領域のDROPをしなくてはならない状況になったので、 おとなしくコマンドを叩いていました。 DROP TABLESPACE [表領域名] INCLUDING CONTENTS AND DATAFILES CASCADE CONSTRAINTS; なんでか、この時に、 ORA-23515 : マテリアライズド・ビューまたはその索引(あるいはその両方)が表領域に存在します. が、発生しました。 おとなしく削除されてくれればいいものを、、、 調べたところ、このパターンは、マテビューを手動で削除すれば、治るようですね。 外人さんが、こんなSQLを作ってくれていました。 SQL> select ‘drop materialized view ‘||owner||’.'||name||’ PRESERVE TABLE;’ from dba_registered_snapshots where name in  (select table_name from dba_tables where tablespace_name = ‘BLUH’); この人は、BLUHというテーブルスペースをDROPしようとして失敗していたようなので、 その部分を書き換えると、マテビューの削除用SQLを出力してくれます。 そのまま、これを実行すれば、マテビューが削除できて、そのあと表領域を削除すれば、 ちゃんと削除できます。 意外と便利そうなSQLだったので、機会があれば使ってみてください。 = 参考元 = http://ora34913.wordpress.com/2008/09/04/ora-23515-and-ora-02449-on-drop-tablespace/ 本記事は、弊社代表のブログ記事 なんでもIT屋の宿命 からの転載です。
続きを読む