近來，我和一幫老客戶一起工作，他們讓花時(shí)間給他們說一下在他們新環(huán)境中使用的新工具。其中，我發(fā)現(xiàn)的一個(gè)非常有用的工具是SchemaSpy。

SchemaSpy是Java開發(fā)的的工具（要求java 5或更高版本的支持），主要用來分析數(shù)據(jù)庫(kù)中數(shù)據(jù)模型的元數(shù)據(jù)，并且能生成基于瀏覽器可視化的顯示。通過點(diǎn)擊就可了解數(shù)據(jù)表的層次結(jié)構(gòu)，父子表關(guān)系等，主要通過HTML 鏈接或者實(shí)體關(guān)系圖來表達(dá)。它也被設(shè)計(jì)成用來幫助解決由于約束而導(dǎo)致的數(shù)據(jù)庫(kù)關(guān)聯(lián)失敗的遲鈍錯(cuò)誤。

我所喜歡ERD工具所能做的一件事是能快速的生成一個(gè)圖形表達(dá)，來展現(xiàn)數(shù)據(jù)庫(kù)那個(gè)表被引用最多，那些表已經(jīng)被代替了是可以刪除的（為什么要保存你不需要的的數(shù)據(jù)呢？）。通過了解數(shù)據(jù)庫(kù)表關(guān)系而不是僅僅看查詢語句，這可以加快的開始步伐，并且還促進(jìn)開發(fā)的過程使其更有效。SchemaSpy的另一個(gè)優(yōu)點(diǎn)是，他是一個(gè)命令行工具，在每次執(zhí)行后才生成html頁(yè)面，所以特別適合用于crontab中，使得模型改變后能自動(dòng)調(diào)整頁(yè)面。很不錯(cuò)，是吧？

這個(gè)工具使用起來簡(jiǎn)單明了，可以幫你做很多的事。主要是，如果你的數(shù)據(jù)庫(kù)有一個(gè)外鍵，你就偷著樂吧，如果沒有，也不要太絕境，你還有更多的工作等著你。絕大多數(shù)情況下，SchemSpy可以出色的完成任務(wù)，但是有時(shí)候你需要以元數(shù)據(jù)文件的形式給它一點(diǎn)點(diǎn)的信息。

安裝SchemaSpy及其相關(guān)

    下載 SchemaSpy最新版的jar文件(書寫本文時(shí)的版本是5.0.0)
    確認(rèn)你有一個(gè)能運(yùn)行于你的操作平臺(tái)的Java JRE
    你需要一個(gè)你所用數(shù)據(jù)庫(kù)的Java驅(qū)動(dòng)——我在使用 MySQL Connector/J
    安裝graphiz 包

創(chuàng)建 mysql.properties文件

當(dāng)需求尚不明確時(shí)，我喜歡這樣建立一下，以便讓命令行能又短又整潔。這是我為我的Percona Server 5.6.10沙箱所使用的屬性文件：

Schema的例子：

CREATE TABLE `parent` (
 `parent_id` int(10) unsigned NOT NULL AUTO_INCREMENT,
 PRIMARY KEY (`parent_id`)
) ENGINE=InnoDB DEFAULT CHARSET=latin1

CREATE TABLE `child_A` (
 `id` int(10) unsigned NOT NULL AUTO_INCREMENT,
 `parent_id` int(10) unsigned DEFAULT NULL,
 PRIMARY KEY (`id`)
) ENGINE=InnoDB DEFAULT CHARSET=latin1

CREATE TABLE `child_B` (
 `id` int(10) unsigned NOT NULL AUTO_INCREMENT,
 `parent_id` int(10) unsigned DEFAULT NULL,
 PRIMARY KEY (`id`),
 KEY `parent_id` (`parent_id`),
 CONSTRAINT `child_B_ibfk_1` FOREIGN KEY (`parent_id`) REFERENCES `parent` (`parent_id`)
) ENGINE=InnoDB DEFAULT CHARSET=latin1

請(qǐng)注意，在表child_A里有一個(gè)隱含的通過parent_id作為外鍵關(guān)聯(lián)到parent的關(guān)系，但在表child_B中建立了一個(gè)顯式的外鍵parent_id。這會(huì)影響SchemaSpy如何辨別關(guān)系，以及你是否需要提供一個(gè)提示。
 運(yùn)行SchemaSpy（有外鍵）

如果沒有元數(shù)據(jù)文件，你運(yùn)行SchemaSpy，你將能看到parent 表和child_B表的關(guān)系如下圖所示：

表child_A也能被加進(jìn)來顯示，如果你的標(biāo)簽指出了他們關(guān)系框，但是這個(gè)通常只能在你的子表和父表使用完全一樣的名字（本例中parent_id）時(shí)候才能起作用。你的環(huán)境看起里就像是許多商店，在父表中名字是id，在他其的子表他們代表為parent_id——這情景對(duì)開發(fā)者可能比較熟悉，但是對(duì)SchemaSpy根本沒有任何的幫助。那就是需要元數(shù)據(jù)文件來大顯身手的時(shí)候。

 配置元數(shù)據(jù)文件

元數(shù)據(jù)文件是一個(gè)XML格式的。下面的配置實(shí)例是用來把child_A表鏈接到parent表。

<?xml version="1.0" encoding="UTF-8"?>
<schemaMeta xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="http://schemaspy.sourceforge.net/xmlschema/2011/02/05/schemaspy.meta.xsd">
<comments>
Main Production Database. Percona, Michael Coburn
</comments>
<tables>
<table name="parent" comments="Parent table">
<column name="parent_id" primaryKey="true">
</column>
</table>
<table name="child_A" comments="Non-FK relationship, implicit relationship to parent">
<column name="id" primaryKey="true">
</column>
<column name="parent_id">
<foreignKey table="parent" column="parent_id"/>
</column>
</table>
</tables>
</schemaMeta>

更多的復(fù)雜配置例子的可以 訪問。
運(yùn)行SchemaSpy

下面的語法是連接MySQL數(shù)據(jù)庫(kù)，SchemaSy同時(shí)對(duì)其他大多數(shù)流行的關(guān)系數(shù)據(jù)有很好支持。

java -jar schemaSpy_5.0.0.jar -t mysql -u msandbox_ro -p msandbox -meta schemaspy.meta.xml -o /var/www/schemaspy/

-o選項(xiàng)，標(biāo)識(shí)SchemaSpy的輸出文件目錄，要確定這個(gè)目錄可以被web服務(wù)器所操作。需要提及的是，我通過在jar包所在目錄建立一個(gè)mysql.properties文件，這樣我可以不用輸入任何的服務(wù)器：端口以及數(shù)據(jù)庫(kù)名稱的信息。
瀏覽SchemaSpy輸出

三個(gè)表的完整的關(guān)系視圖如下圖所示：

收尾感想

盡管我提及到了關(guān)系欄，SchemaSpy最有用的功能。為了避免SchemaSpy只有這個(gè)功能這樣的假象，我要提及一下更多的功能欄：

•      表——名稱，子表數(shù)量，父表，列計(jì)數(shù)，行計(jì)數(shù)，還有注解--大量用于高層次預(yù)覽表大小以及一種快捷的方法是，用瀏覽的搜索屬性定位到特定的表。
•     限制——列出數(shù)據(jù)庫(kù)中明確的外鍵限制（這不包括通過元數(shù)據(jù)文件配置的限制?。?。
•     異?！诿种赋隹赡艿淖侄?表的關(guān)系，沒有索引的表，標(biāo)識(shí)為可空的字段和唯一字段（吐了?。?，單列表，子增長(zhǎng)字段的名稱；空字符而不是實(shí)際sqlnull值的表；在發(fā)生重大錯(cuò)誤時(shí)候，這可以作為一個(gè)大體的數(shù)據(jù)庫(kù)檢查項(xiàng)，或者細(xì)節(jié)需求的瀏覽。
•     字段——庫(kù)總所有字段的列表，很方便通過名稱篩選來查看是否有忽略的明確限制，然后把它們寫到你的元數(shù)據(jù)文件中。
•     貢獻(xiàn)——這是一個(gè)自由軟件，John Currier請(qǐng)求得到你的捐獻(xiàn)，一般它能有更多的理由來花費(fèi)更多的精力和時(shí)間來維護(hù)這個(gè)軟件，而不僅僅是他老婆的抱怨。

最后，你不要忘了，把配置好的SchemaSpy寫到crontab來實(shí)現(xiàn)自動(dòng)化。

如果正在使用其他的ERD工具，和SchemaSpy相比較怎么樣？請(qǐng)通過評(píng)論暢所欲言。謝謝你有耐心讀完本文。