version 2.3
目次
Stewは、JDBC接続を使ってデータベースにアクセスするツールです。Javaで書かれています。
2.0で主に変更された機能は以下のとおりです。
GUIモードで変更された機能は以下のとおりです。
また、ソースコードをすべて書き直しました。1.0との実装レベルでの互換性はほとんどありません。
オンライン情報も確認してください。
パスワードは、デフォルトではそのまま保存します。生のパスワードを保存したくない場合は、暗号化を利用できます。
詳しくは、使い方-接続設定を参照してください。
disconnectコマンドによりコネクションを切断するとき、rollbackを発行しません。DBMSによっては、トランザクションが自動的にコミットされてしまうことがありますので注意が必要です。
バージョン2.3より、「切断時に自動ロールバック」機能が利用可能になりました。
Wikiにて追加説明を行っていますので、あわせてご利用ください。
http://argius.net/wiki/index.php?Stew%20tutorial
JRE(Java実行環境)1.4以上がインストールされている必要があります。（1.3で使いたい方は、古いバージョン(1.0)をお使い下さい。）
Stewを実行すると、".stew"ディレクトリが作成され、設定の保存に使用されます。".stew"ディレクトリは、デフォルトではHOMEディレクトリ（実装詳細：システムプロパティ"user.home"のパス）に作成されます。GUIの場合は、起動ディレクトリに作成されます。
アーカイブを適当なディレクトリに展開します。ここでは"/opt/Stew"とします。
エイリアスを使う場合は、以下のコマンドを実行します。
alias stew="java -jar /opt/Stew/stew.jar"
エイリアスを使わない場合は、以下のスクリプトを記述したファイルを"stew"という名前でパスの通っているディレクトリに保存し、実行権限を与えてください。
#!/bin/sh java -jar /opt/Stew/stew.jar $*
コマンドを実行してみましょう。"stew -v"でバージョン情報が表示されたらインストール完了です。
アーカイブを適当なディレクトリに展開します。ここでは"C:\Program Files\Stew"とします。
stew.exeを実行します。stew.exeを使用すると、自動的にGUIモードになります。
stew.exeを使用しない場合は、以下のコマンドを記述したファイルを"stew.bat"という名前でパスの通っているディレクトリに保存してください。（"%*"はXP、2000、NTでしか使えないので注意。）
java -jar "C:\Program Files\Stew\stew.jar" %*
コマンドを実行してみましょう。"stew -v"でバージョン情報が表示されたらインストール完了です。
インストールで設定したもの全てと、".stew"ディレクトリを削除すればアンインストール完了です。
Stewを使用するには、JDBC接続が可能なデータベースと、JDBCドライバが必要です。JDBCドライバ自体の詳細については、各データベースの説明書などを参照してください。
CUIの場合は、起動時に--editオプションを指定すると、編集プログラムが起動します。
GUIの場合は、メニューの"接続設定"を実行すると、編集ダイアログが開きます。
それぞれの設定項目の説明は次のとおりです。
これらの情報は、".stew/connectors.properties"に保存されます。手動で編集することもできますが、その際は注意して行ってください。
パスワードは設定ファイルに保存されるため、そのまま保存すると都合が悪い場合があります。パスワードの保存方法は、暗号化処理を選択することができます。
独自のパスワード暗号化を追加することもできます。（実装詳細：Passwordインタフェースの実装クラスを追加します。）
通常の起動では、対話モードでの操作となります。
対話モードでは、コマンド入力待ち状態になった時にコマンドを入力し、処理が終わると再びコマンド入力待ちになります。
FTPコマンドのようなプログラムの操作に似ているかもしれません。
Stewの処理が一行の入力で完結します。"stew"コマンドを設定していると仮定すると、次のような形式で実行します。
$ stew <connector-id> <command>
実行すると、<connector-id>の接続設定で接続を開始し、その接続を使用してコマンドを実行します。コマンド実行後、接続を切断して終了します。
このモードでは、ご利用のshell環境の制約（例えば、ワイルドカード,リダイレクト など）を受けますのでご注意ください。
組み込みコマンドは、Stewから切り離すことができないコマンドです。（実装詳細：Commandクラスのサブクラスではなく、Command.invokeメソッドに直接書かれている処理です。）
それ以外は、追加コマンドとして実装されています。（実装詳細：Commandクラスのサブクラスによる処理です。）
> connect <connector-id>
> -c <connector-id>
予め用意した接続設定を使用して、データベースに接続します。対話モードでは、disconnectまたは強制的に切断されるまで、接続が維持されます。
すでに接続中の場合は、その接続を切断してから接続を行います。
> disconnect
> -d
データベースとの接続を切断します。
現在のトランザクションでの変更をコミットします。
コミットする際は、誤って必要なデータを削除しないよう注意してください。
現在のトランザクションでの変更をロールバックします。
> exit
Stewを終了します。確認待ちは行いません。
> <SQL-SELECT-STATEMENT>
> <SQL-UPDATE-STATEMENT>
> <SQL-INSERT-STATEMENT>
> <SQL-DELETE-STATEMENT>
> count <テーブル名> [<WHERE句>]
指定したテーブルの件数を表示します。（実装詳細：このコマンドは SELECT COUNT(*) FROM <table-name> [<where-phrase>] と同じＳＱＬを発行しますが、件数のみ表示します。）
> count test 12575 件 ヒットしました。 >
> load [<SQLファイル> | <データファイル> <テーブル名> [ HEADER ]]
指定されたファイルを読み込んで、ＳＱＬを実行します。
パラメータが1個の場合は、ファイルをSQL文と見なして実行します。
パラメータが2個以上の場合は、ファイルをデータファイルと見なして、インポートを実行します。ファイルの拡張子によって、ファイル形式が自動的に選択されます。
> import [<データファイル> <テーブル名> [ HEADER ]]
ファイルをデータファイルと見なして、インポートを実行します。ファイルの拡張子によって、ファイル形式が自動的に選択されます。
（実装詳細：基本的には、loadのパラメータ2個以上指定した時と同じ動作ですが、Statement.addBatch()を使用します。）
> export <ファイル> [ HEADER ] [command(select|find|report)]
指定したファイルに、コマンドの検索結果を出力します。ファイルの拡張子によって、ファイル形式が自動的に選択されます。
> time [<回数>] <SQL文>
指定したSQL文を実行し、その実行時間を計測して表示します。回数が指定された場合は、回数分SQLを繰り返し実行して、「合計」「平均」「最大」「最小」を集計します。回数を指定しない場合は、1回の実行時間を表示します。
> time select * from test 実行時間 : 0.050 秒 > time 100 select * from test 合計 : 1.870 秒 平均 : 0.018 秒 最大 : 0.160 秒 最小 : 0.000 秒 >
> find <テーブル名パターン> [<テーブル種別パターン> [<スキーマ名パターン> [<カタログ名パターン> [ FULL ]]]]
参照可能なテーブルの一覧を表示します。"パターン"というキーワードを含むパラメータは、ワイルドカード（*,?）が指定できます。
> report - | <テーブル名> [ PK | INDEX ]
接続中のコネクションに関する情報を表示します。
テーブル名のみが指定された場合は、テーブルの列情報が表示されます。
テーブル名とオプションが指定された場合は、PKを指定するとプライマリキーの一覧が、INDEXを指定するとインデックスキーの一覧が、それぞれ表示されます。
> bind <SQL文>:<値のカンマ区切りリスト>
バインド変数を指定してSQLを実行します。（実装詳細：java.sql.PreparedStatementによる実行。）
":"以降のパラメータは、空白をパラメータと見なすので注意してください。
GUIモードのメニューについての説明です。
新しいウィンドウを開きます。新しいウィンドウは、元のウィンドウとは独立した接続で処理が行われます。
ウィンドウを閉じます。コネクションが接続中の場合は、確認ダイアログを表示します。
開いているウィンドウが1つの場合は、終了(X)と同じ動作となります。
現在の作業ディレクトリを変更します。この処理は、ファイルの読み込みや書き込みを行うコマンドに影響します。
検索結果をファイルに出力します。exportコマンドとは独立した処理です。検索結果が表示されている場合のみ有効です。
アプリケーションを終了します。確認ダイアログが表示され、"はい"を選択すると終了します。
選択範囲をクリップボードにコピーして、選択された部分を削除します。（基本的に、一般的なアプリケーションと同じ処理です。）
選択範囲をクリップボードにコピーします。（基本的に、一般的なアプリケーションと同じ処理です。）
カーソル位置にクリップボードの内容を貼り付けます。（基本的に、一般的なアプリケーションと同じ処理です。）
選択している領域（テーブルまたは入出力欄）を全選択状態にします。
コマンドを入力できるようにするため、入出力欄の末尾にカーソルを移動します。
入出力欄のメッセージをクリアします。
選択された場合、ウィンドウの下部にステータスバーを表示します。
設定は保存されます。
選択された場合、検索結果の列名に番号を付けます。
設定は保存されません。
検索結果の列幅をそれぞれ1.5倍に拡大します。
検索結果の列幅をそれぞれ2/3に縮小します。
検索結果の列幅を自動調整します。次項の「列幅自動調整」で選択されたモードで調整されます。
検索結果表示時に、検索結果の列幅を自動調整するモードを選択します。
設定は保存されます。
検索結果を表示した際のクエリを再発行して、最新状態を表示します。
検索結果欄に表示する件数の最大値を設定します。
設定は保存されます。
フォント変更ダイアログを表示します。
設定すると、検索結果欄とメッセージ欄のフォントが変更されます。
接続リストを表示します。接続リストで接続したい接続IDを選択して"了解"を押すと、connectと同じ処理が実行されます。
接続を切断します。disconnectコマンドと同じです。
接続設定のパスワード暗号化に使用される秘密鍵を設定します。
接続設定ダイアログを表示します。
コマンドを実行します。入出力欄でエンターキーを押したのと同じ効果があります。
コマンド履歴を1つ遡ります。
コマンド履歴を1つ進みます。
ヘルプを表示します。（実装詳細：カレントディレクトリにMANUAL_jaファイルが必要です。）
バージョン情報ダイアログを表示します。
検索コマンドを実行したときに、結果を表示します。最左列は行番号が表示されます。列幅自動調整が設定されていれば、列幅が自動的に調整されます。
セルを編集すると、テーブルに反映(UPDATE)されます。
行番号が"*"になっている行は保留行です。保留行については、コンテキストメニューを参照。
コマンドの入力とメッセージの出力が同居する、コマンドラインのようなインターフェイスです。
エンターキーを押すと、プロンプトから末尾までがコマンドとして解釈され実行されます。カーソルが末尾にない場合は、カーソルが末尾に移動します。プロンプトより前の部分は編集不可となっています。
直前のコマンドとその実行時間が表示されます。実行時間は、timeコマンドとは異なり、コマンドの開始から終了までの所要時間となります。
マウスの右クリックにより、そのコントロールに即した機能のメニューが表示されます。表示されるメニュー内容は、入力部分ごとに異なります。
主なメニューは以下のとおりです。
※COMMIT,ROLLBACKは手動です。
以下の設定が、ウィンドウを閉じたとき(終了したときではない)に保存され、次回以降のウィンドウの設定として使用されます。
起動時に値を決定できるパラメータです。Javaのシステムプロパティ（Javaの-Dオプション）で指定するか、stew.propertiesファイルに記述します。
"設定値"は、設定する値についての説明です。設定値のカッコ内の値は既定値です。カッコがないものは既定値がありません。
設定値：ファイルまたはディレクトリのパス
stew.propertiesファイルを優先的に検索する場所を指定します。
指定されたパスがファイルの場合は、そのファイルをstew.propertiesの代わりにプロパティファイルとして読み込みます。指定されたパスがディレクトリの場合は、そこにstew.propertiesがあるものとみなされます。
指定されない場合は、クラスパス、システムディレクトリの順に検索されます。無い場合はプロパティファイルが無いものとみなされます。
設定値：ディレクトリパス(カレントディレクトリ)
コマンドで使用するディレクトリの開始時のパスを指定します。デフォルトシステムディレクトリとは異なります。
設定値：完全修飾クラス名(net.argius.stew.StandardInputLauncher)
Launcherは、アプリケーションの起動、入力、コマンド実行、出力の管理を行う機能です。ここではそのクラス（実装詳細：net.argius.stew.Launcherインタフェースを実装している必要があります。）を指定します。デフォルトは、標準入出力Launcherです。
設定値：完全修飾クラス名(net.argius.stew.StandardOutputProcessor)
OutputProcessorは、出力制御を行う機能です。ここではそのクラス（実装詳細：net.argius.stew.OutputProcessorインタフェースを実装している必要があります）を指定します。デフォルトは、標準出力制御です。
設定値：整数秒(0)
コマンド内のクエリが発行時に設定するタイムアウト値を指定します。0以下はタイムアウト未指定とみなされます。
（実装詳細：java.sql.Statement#setQueryTimeoutに設定する値。）
設定値：整数秒(10)
GUIの結果テーブルを編集した際に、バックグラウンドで発行されるクエリが使用するタイムアウト値です。
デバッグ用のLoggerに関するプロパティです。プロパティファイルに直接は指定できません(-Dオプションで指定可能)。
標準のLoggingAPI(java.util.logging)を使用したい場合は、以下のシステムプロパティを設定してください。LoggingAPI自体の設定は、APIドキュメントを参照してください。
-Dnet.argius.logging=true -Dnet.argius.logging.class=net.argius.logging.LoggingApiWrapper
2009 argius