PostgreSQL 上で，Eclipse の Clay プラグインを使う

必要となるソフトウエア

• Eclipse のWebページの記述に従って，Eclipse のインストールが終わっていること．

• 「Eclipse の GEF (Graphical Editing Framework) プラグインの更新」の Web ページの記述に従って，GEF プラグイン の更新が終わっていること．

• 「Eclipse の Clay プラグイン」の Web ページの記述に従って，Clay プラグイン のインストールが終わっていること．

• 「Postgres のインストール」の Web ページの記述に従って，PostgreSQL のインストールが終わっていること．

あらかじめ決めておく事項

使用する Eclipse のプロジェクト名を決めておくこと． この Web ページでは，次のように書きます．

※ Eclipse のプロジェクトの新規作成の方法については， 「Eclipse 3.4 インストールと基本操作」の Web ページ を見てください．

• Eclipse プロジェクト名： HelloWorld

使用するデータベースのデータベース論理名と， PostgreSQL にログインするために使うデータベース・一般ユーザのアカウント（ユーザ名とパスワード）を決めておくこと． この Web ページでは，次のように書きます．

• データベース論理名： testdb

  使用するデータベースの名前のことを，「データベース論理名」と呼ぶことにします． データベース論理名は，自由に決めていいですが，半角文字（つまり英字と英記号）を使い，スペースを含まないこと， すでに存在するデータベースを使ってもいい（つまり，既存のデータベースのデータベース論理名を使う）し，新しいデータベースを作ることにしてもいいです．

• PostgreSQL にログインするために使うデータベース・一般ユーザのアカウント（ユーザ名とパスワード）
  • ユーザ名: testuser
  • パスワード: hoge$#34hoge5

  データベース論理名 testdb の権限を持ったユーザにして下さい．（そうで無いとエラーが出ます）．

（参考）データベースとアカウントの作成

この Web ページの手順を試すために，新しいデータベースと，新しい一般ユーザのアカウントを作りたいという場合は， PostgreSQL のコマンドラインクライアント を使って作るのが簡単です． Windows のコマンドプロンプトなどで，次のコマンドを実行します．

※ まずは，Windows で「スタート」 →「プログラム」 →「PostgreSQL 8.3」 →「コマンド・プロンプト」と操作
createuser -U pgadmin -P -S -D -R testuser
createdb -U pgadmin -O testuser -E UTF8 testdb

なお，データベースとアカウントの作成には，PostgreSQL データベース管理者のユーザ名とパスワードが必要になるので，前もって調べておくこと． 上記では，Postgres データベース管理者のユーザ名を pgadmin と書いています．

設定項目

PostgreSQL を使うために，次の設定を行うことになるので，確認しておく．

• データベースURL(接続文字列)： jdbc:postgresql:testdb

  リレーショナルデータベースとして PostgreSQL を使うので，データベースURL(接続文字列)は， jdbc:postgresql:に，データベース論理名を付けて， jdbc:postgresql:testdbになります．

• JDBC ドライバ名：org.postgresql.Driver

  PostgreSQL の JDBC ドライバ名はこのようになります．

• PostgreSQL 用 JDBC の jar ファイル：C:\Program Files\psqlJDBC\postgresql-8.3-603.jdbc4.jar

  PostgreSQL 用 JDBC の Java ファイルが存在するディレクトリ C:\Program Files\psqlJDBC を探すとすぐに見つかります。

  ※ JDBC の jar ファイルが無いときは，http://jdbc.postgresql.org/

Clay の実行

Database Modeling Graphical Editor の起動

1. 開始

   Eclipse で，「ファイル」→「新規」→「その他」と操作する．

2. Database Modeling の展開

   Database Modeling の左横の「+」をクリックして，展開する．

   

   「Database Modeling」が現れないときは， 「Eclipse の Clay プラグイン」の Web ページの記述に従って，Clay プラグイン のインストールを行うこと．

3. Clay Database Design Diagram」の選択

   「Clay Database Design Diagram」をクリックし，「次へ」をクリック．

   

4. Eclipse プロジェクト名と SQL 方言の種類の選択

   PostgreSQL を使うので，つぎのように選択する．

   • Eclipse プロジェクト名: HelloWorld

     ※ プロジェクト名は，何でもよい． Eclipse のプロジェクトの新規作成の方法については， 「Eclipse 3.4 インストールと基本操作」の Web ページ を見てください．

   • SQL 方言: PostgreSQL 7.3/7.4

     (使用している PostgreSQL のバージョンが 7.2 のときは，「PostgreSQL 7.2」を選ぶ)

   選択が終わったら，「終了」をクリック．

   

5. Database Modeling Graphical Editor が開く
   

データベースのリバースエンジニアリング

新規接続の作成

1. Database Modeling Graphical Editor の中の任意の場所で右クリック．「データベースのリバースエンジニア」を選択

2. 「接続」のウインドウ（これは，データベースの接続設定を行うウインドウ）が開く。最初は，何も「接続」が無いので，「新規追加」をクリック
   

3. ウインドウが開くので，次の設定を行う． 設定が終わったら，「次へ」をクリック．
   • 接続テンプレート: PostgreSQL を設定

   • 別名：好きな名前をつける（後で分かりやすい名前を付けておく）．

   • URL： データベースURL(接続文字列) jdbc:postgresql:testdb を設定

   • ユーザ： testuser を設定

   • パスワード： hoge$#34hoge5 を設定

   • JDBC ドライバ： JDBC ドライバ名 org.postgresql.Driver を設定

   • ドライバの場所： PostgreSQL 用 JDBC の jar ファイル C:\Program Files\psqlJDBC\postgresql-8.3-603.jdbc4.jar を設定
   

4. インポートするデータベーススキーマの選択

   特に必要がない限り「public」だけを選んで，「＞」をクリックし，「次へ」をクリック．

   

5. インポートするテーブルの選択

   使用したいテーブル（複数可）を選んで，「＞」をクリックする． 終わったら，「終了」をクリック．

6. 図ができる
   

以上で、新規接続ができた。 (次回からは、新規接続を作成する必要は無い)。

参考Webページ： http://www.stackasterisk.jp/tech/java/eclipse02_03.jsp