version 3.1
目次
Stewは、JDBCを使った小規模なデータベースフロントエンドです。
コマンドラインのようなインターフェイスを持っていて、SQLを入力して実行したりできます。
ちょっとした処理であれば、バッチのように使用することもできます。
概要については、README_ja.txtをご覧ください。
パスワードは、デフォルトではそのまま保存します。生のパスワードを保存したくない場合は、暗号化を利用できます。
詳しくは、使い方-接続設定を参照してください。
デフォルトでは、disconnectコマンドによりコネクションを切断するとき、rollbackを発行しません。DBMSによっては、トランザクションが自動的にコミットされてしまうことがありますので注意が必要です。
「切断時に自動ロールバック」を設定すると、disconnectの際に自動的にrollbackを発行します。詳細は、使い方-接続設定を参照してください。
プロジェクトサイトにて追加説明を行っていますので、あわせてご利用ください。
JRE(Java実行環境)1.5以上がインストールされている必要があります。
また、利用するデータベースのJDBCドライバが必要です。
リリースパッケージを任意のディレクトリに展開します。
インストールサイズを最小限にしたい場合はリリースパッケージに含まれている"stew.jar"だけを展開してください。
起動コマンドの設定は、次の起動方法を参照してください。
GUIモードで起動する場合は、以下のコマンドを実行します。
> java -jar stew.jar --gui
CUIモードで起動する場合は、以下のコマンドを実行します。
> java -jar stew.jar --cui
起動スクリプトもしくはショートカットやエイリアスを作成しておくと便利です。UNIX系OSの場合は"stew.sh"を、Windowsの場合は"stew.bat"を参照してください。
Stewを実行すると、システムディレクトリ".stew"が作成され、設定の保存に使用されます。".stew"ディレクトリは、デフォルトではカレントディレクトリに作成されます。
インストールしたファイルと".stew"ディレクトリを削除してください。
Stewを使用するには、JDBC接続が可能なデータベースと、JDBCドライバが必要です。JDBCドライバ自体の詳細については、各データベースの説明書などを参照してください。
CUIの場合は、起動時に--editオプションを指定、またはコマンドとして--editを実行すると、編集プログラムが起動します。
GUIの場合は、メニューの"接続設定"を実行すると、編集ダイアログが開きます。
それぞれの設定項目の説明は次のとおりです。
これらの情報は、".stew/connectors.properties"に保存されます。手動で編集することもできますが、その際は注意して行ってください。
パスワードは設定ファイルに保存されるため、そのまま保存すると都合が悪い場合があります。パスワードの保存方法は、暗号化処理を選択することができます。
独自のパスワード暗号化を追加することもできます。(実装詳細:Passwordインタフェースの実装クラスを追加します。)
接続設定なしで接続を行うことができます。ドライバが特定できるようになっている必要があります。(次の段落で説明)
> connect <user>/<password>@<URL>
(例)
> connect user/password1@jdbc:firebirdsql://127.0.0.1//home/argius/test.fdb
最も簡単な方法は、ドライバファイルを起動ディレクトリに置くだけです。ドライバ名が指定されていない場合は、このファイルの中を探索してドライバ名を特定します。
但し、この探索は時間がかかるので、時間を節約するには"jdbc.drivers"システムプロパティを指定してください。
通常の起動では、対話モードでの操作となります。
対話モードでは、コマンド入力待ち状態になった時にコマンドを入力し、処理が終わると再びコマンド入力待ちになります。
FTPコマンドのようなプログラムの操作に似ているかもしれません。
Stewの処理が一行の入力で完結します。"stew"コマンドを設定していると仮定すると、次のような形式で実行します。
$ stew <connector-id> <command>
実行すると、<connector-id>の接続設定で接続を開始し、その接続を使用してコマンドを実行します。コマンド実行後、接続を切断して終了します。
このモードでは、ご利用のshell環境の制約(例えば、ワイルドカード,リダイレクト など)を受けますのでご注意ください。
長いコマンドに別名(alias)をつけて、短縮コマンドとして利用できます。詳しくは、コマンドalias,unaliasを参照してください。
組み込みコマンドは、Stewから切り離すことができないコマンドです。(実装詳細:Commandクラスのサブクラスではなく、Command.invokeメソッドに直接書かれている処理です。)
それ以外は、追加コマンドとして実装されています。(実装詳細:Commandクラスのサブクラスによる処理です。)
コマンドでない文が指定された場合は、SQLとして実行されます。バインド変数のあるSQL文を使う場合は、最後に";"(セミコロン)をつけ、それ以降にカンマ区切りでパラメータを指定できます。この機能は、一部のコマンドでも利用できます。
組み込みコマンドのうち、connect/-e/-f/alias/unalias/exitは接続時以外でも使用できます。
> connect <connector-id>
> -c <connector-id>
予め用意した接続設定を使用して、データベースに接続します。対話モードでは、disconnectまたは強制的に切断されるまで、接続が維持されます。
すでに接続中の場合は、その接続を切断してから接続を行います。
> disconnect
> -d
データベースとの接続を切断します。
接続設定でrollbackを指定している場合は、rollbackを試みます。
現在のトランザクションでの変更をコミットします。
コミットする際は、誤って必要なデータを削除しないよう注意してください。
現在のトランザクションでの変更をロールバックします。
> -e <コマンド> -e <コマンド> ...
コマンドを連続して実行させます。exportなどを同時に実行する場合や、コマンドラインからの実行の場合に使います。
> -f <ファイル>
ファイルの内容をコマンドとして実行します。再帰的に指定できますが、無限ループは検知できないので注意してください。
> cd <ディレクトリ>
カレントディレクトリを指定したディレクトリに移動します。
(このカレントディレクトリはStew内部で管理するものです。)
> @
カレントディレクトリとシステムディレクトリの場所を表示します。
> alias [<エイリアス> [<コマンド>]]
コマンド別名を登録します。引数が1つで実行した場合は、既に設定されたコマンド内容を表示します。引数なしで実行した場合は、すべての定義済みエイリアスを表示します。
登録または表示の前にファイルからメモリ上の情報を最新化します。ファイルを直接修正したり、他のスレッドで変更した内容を反映させたい場合は、このコマンドを実行してください。
(実装詳細:循環参照などの無限ループ抑制のために、展開の深さは最大100。)
> alias エイリアスは未定義です。 > alias search select * from > alias count select count(*) from > alias search alias search=[select * from] > search table1 >> select * from table1 (select * from table1 の結果) >
> unalias <エイリアス>
コマンド別名を解除します。解除する対象がない場合は何もしません。
解除対象の有無にかかわらず、ファイルからメモリ上の情報を最新化します。
> exit
Stewを終了します。確認待ちは行いません。
> load [<SQLファイル> | <データファイル> <テーブル名> [ HEADER ]]
指定されたファイルを読み込んで、SQLを実行します。
パラメータが1個の場合は、ファイルをSQL文と見なして実行します。
パラメータが2個以上の場合は、ファイルをデータファイルと見なして、インポートを実行します。ファイルの拡張子によって、ファイル形式が自動的に選択されます。(実装詳細:基本的にはimportと同じ動作ですが、バッチ実行ではなく1件ずつ処理されます。)
> import [<データファイル> <テーブル名> [ HEADER ]]
ファイルをデータファイルと見なして、インポートを実行します。ファイルの拡張子によって、ファイル形式が自動的に選択されます。(実装詳細:基本的には、loadのパラメータ2個以上指定した時と同じ動作ですが、Statement.addBatch()を使用します。)
一括で処理する件数をプロパティで設定することができます。
> export <ファイル> [ HEADER ] [command(select|find|report)]
指定したファイルに、コマンドの検索結果を出力します。ファイルの拡張子によって、ファイル形式が自動的に選択されます。
> time [<回数>] <SQL文>
指定したSQL文を実行し、その実行時間を計測して表示します。回数が指定された場合は、回数分SQLを繰り返し実行して、「合計」「平均」「最大」「最小」を集計します。回数を指定しない場合は、1回の実行時間を表示します。
> time select * from EMPLOYEE 実行時間 : 0.093 秒 > time 100 select * from EMPLOYEE 合計 : 0.484 秒 平均 : 0.005 秒 最大 : 0.094 秒 最小 : 0.000 秒 >
> find <テーブル名パターン> [<テーブル種別パターン> [<スキーマ名パターン> [<カタログ名パターン> [ FULL ]]]]
参照可能なテーブルの一覧を表示します。"パターン"というキーワードを含むパラメータは、ワイルドカード(*,?)が指定できます。
> report - | <テーブル名> [ PK | INDEX ]
接続中のコネクションに関する情報を表示します。
-(ハイフン)が指定された場合は、DBとJDBCドライバの名称とバージョン、接続ユーザとアドレスを表示します。
テーブル名のみが指定された場合は、テーブルの列情報が表示されます。
テーブル名とオプションが指定された場合は、PKを指定するとプライマリキーの一覧が、INDEXを指定するとインデックスキーの一覧が、それぞれ表示されます。
> download <ルートディレクトリ> SELECT <ダウンロードするデータの列> [, ファイルパス...] FROM ...
1つの列のデータをダウンロードしてファイルに保存します。どのデータ型でも利用できます。長めのテキスト項目やラージオブジェクト(BLOB,CLOB)を一挙にファイルに保存する場合などに有用です。
ファイルは、複数ファイルをダウンロードできるようにするため、データからファイル名を生成できるようになっています。ファイル名は、2列目以降の列を文字列として結合したものとなります。これはプライマリキーと拡張子を指定することを想定しています。
> download emp select FULL_NAME, JOB_COUNTRY, '/', EMP_NO, '.txt' from EMPLOYEE ディレクトリ[./emp/USA]を作成しました。 ダウンロードされました。 (0.014 Kbytes, file=[./emp/USA/2.txt]) ダウンロードされました。 (0.012 Kbytes, file=[./emp/USA/4.txt]) ・ ・ ・ ダウンロードされました。 (0.012 Kbytes, file=[./emp/USA/24.txt]) ディレクトリ[./emp/England]を作成しました。 ダウンロードされました。 (0.011 Kbytes, file=[./emp/England/28.txt]) ・ ・ ・ ダウンロードされました。 (0.018 Kbytes, file=[./emp/USA/145.txt]) 42 件 ヒットしました。
データが1件の場合は、データ列のみ指定すれば、ファイルパスの前半部分がそのままファイル名となります。
同名のファイルが存在したり、ディレクトリ作成時に権限が無い場合はエラーとなり、その時点で処理を中断します。
> upload <ファイルパス> <INSERT文 or UPDATE文>
SQLのプレースホルダで指定された列にファイル内容を登録します。
> wait 秒(小数第3位まで指定可)
指定された秒数、待機します。連続したコマンドを実行する場合などに使えるかもしれません。
GUIモードのメニューについての説明です。
新しいウィンドウを開きます。新しいウィンドウは、元のウィンドウとは独立した接続で処理が行われます。
ウィンドウを閉じます。コネクションが接続中の場合は、確認ダイアログを表示します。
開いているウィンドウが1つの場合は、終了(X)と同じ動作となります。
アプリケーションを終了します。確認ダイアログが表示され、"はい"を選択すると終了します。
選択範囲をクリップボードにコピーして、選択された部分を削除します。(基本的に、一般的なアプリケーションと同じ処理です。)
選択範囲をクリップボードにコピーします。(基本的に、一般的なアプリケーションと同じ処理です。)
カーソル位置にクリップボードの内容を貼り付けます。(基本的に、一般的なアプリケーションと同じ処理です。)
選択している領域(テーブルまたは入出力欄)を全選択状態にします。
選択している領域(テーブルまたは入出力欄)内の文字列を検索します。
テーブルはセル単位で検索します。入出力欄は、一致部分をハイライトします。
オプションで、「正規表現を使用する」「大文字と小文字を区別しない」が指定できます。
検索結果エリアと入力欄のフォーカスを入れ替えます(toggle)。
入出力欄のメッセージをクリアします。
選択された場合、ウィンドウの下部にステータスバーを表示します。
設定は保存されます。
選択された場合、検索結果の列名に番号を付けます。
選択された場合、データベース情報ツリーペインを表示します。
選択された場合、ウィンドウを常に手前に表示するようにします。
検索結果を表示した際のクエリを再発行して、最新状態を表示します。
検索結果の列幅をそれぞれ1.5倍に拡大します。
検索結果の列幅をそれぞれ2/3に縮小します。
検索結果の列幅を自動調整します。次項の「列幅自動調整」で選択されたモードで調整されます。
検索結果表示時に、検索結果の列幅を自動調整するモードを選択します。
コマンドを実行します。入出力欄でエンターキーを押したのと同じ効果があります。
コマンドを中断します。サーバ側の処理はキャンセルされません。
コマンド履歴を1つ遡ります。
コマンド履歴を1つ進みます。
確認ダイアログを表示し、OKを押すとロールバックを実行します。
確認ダイアログを表示し、OKを押すとコミットを実行します。
接続リストを表示します。接続リストで接続したい接続IDを選択して"了解"を押すと、connectと同じ処理が実行されます。
接続を切断します。disconnectコマンドと同じです。
起動中のプロセスで接続設定のパスワード暗号化に使用される秘密鍵を入力します。
接続設定ダイアログを表示します。
検索結果をファイルに出力します。exportコマンドとは独立した処理です。検索結果が表示されている場合のみ有効です。
検索結果のテーブルにファイルをインポートします。importコマンドとは独立した処理です。検索結果が表示されている場合のみ有効です。
検索結果をファイルに出力します。exportコマンドとは独立した処理です。検索結果が表示されている場合のみ有効です。
ヘルプを表示します。現在は未実装です。
バージョン情報ダイアログを表示します。
テキスト入力欄は共通して、「元に戻す」「やり直す」「切り取り」「コピー」「貼り付け」「すべて選択」のショートカットが利用できます。
これらは、コンテキストメニューからも操作できます。
検索コマンドを実行したときに、結果を表示します。最左列は行番号が表示されます。列幅自動調整が設定されていれば、列幅が自動的に調整されます。
セルを編集すると、テーブルに反映(UPDATE)されます。
行番号が"+"になっている行は「非リンク行」です。非リンク行については、コンテキストメニューを参照。
コマンドの入力とメッセージの出力が同居する、コマンドラインのようなインターフェイスです。
エンターキーを押すと、プロンプトから末尾までがコマンドとして解釈され実行されます。カーソルが末尾にない場合は、カーソルが末尾に移動します。プロンプトより前の部分は編集不可となっています。
デスクトップからファイルをドロップすると、「パスの貼り付け」「内容の貼り付け」のいずれかが実行できます。
直前のコマンドとその実行時間が表示されます。実行時間は、timeコマンドとは異なり、コマンドの開始から終了までの所要時間となります。
マウスの右クリックにより、そのコントロールに即した機能のメニューが表示されます。表示されるメニュー内容は、入力部分ごとに異なります。
メニューは以下のとおりです。
※COMMIT,ROLLBACKは手動です。
データベースのテーブルなどの情報をツリー表示します。
簡易SQL文自動生成機能が利用できます。
以下の設定が、ウィンドウを閉じたとき(終了したときではない)に保存され、次回以降のウィンドウの設定として使用されます。
システムディレクトリに"keybind.conf"という名前のファイルを作成し、内容には"メニューのアクション名=KeyStrokeの文字列表現"を設定すると、メニューのキー割り当てが変更できます。
メニュー以外(コンテキストメニューなど)には適用できません。
# 例 # アクション名はsrc/net/argius/stew/ui/window/messages_ja.propertiesのMenu.*を参照 HISTORY_BACK = ctrl K
起動時に値を決定できるパラメータです。Javaのシステムプロパティ(Javaの-Dオプション)で指定するか、stew.propertiesファイルに記述します。
"設定値"は、設定する値についての説明です。設定値のカッコ内の値は既定値です。カッコがないものは既定値がありません。
設定値:ファイルまたはディレクトリのパス
stew.propertiesファイルを優先的に検索する場所を指定します。
指定されたパスがファイルの場合は、そのファイルをstew.propertiesの代わりにプロパティファイルとして読み込みます。指定されたパスがディレクトリの場合は、そこにstew.propertiesがあるものとみなされます。
指定されない場合は、クラスパス、システムディレクトリの順に検索されます。無い場合はプロパティファイルが無いものとみなされます。
設定値:ディレクトリパス(カレントディレクトリ)
コマンドで使用するディレクトリの開始時のパスを指定します。デフォルトシステムディレクトリとは異なります。
設定値:完全修飾クラス名(net.argius.stew.ui.console.ConsoleLauncher)
net.argius.Stewから実行した場合のみ有効です。
Launcherは、アプリケーションの起動、入力、コマンド実行、出力の管理を行う機能です。ここではそのクラス(実装詳細:net.argius.stew.ui.Launcherインタフェースを実装している必要があります。)を指定します。デフォルトは、標準入出力Launcherです。
設定値:完全修飾クラス名(net.argius.stew.ui.console.ConsoleOutputProcessor)
net.argius.Stewから実行した場合のみ有効です。
OutputProcessorは、出力制御を行う機能です。ここではそのクラス(実装詳細:net.argius.stew.ui.OutputProcessorインタフェースを実装している必要があります)を指定します。デフォルトは、標準出力制御です。
設定値:整数秒(0)
コマンド内のクエリが発行時に設定するタイムアウト値を指定します。0以下はタイムアウト未指定とみなされます。
(実装詳細:java.sql.Statement#setQueryTimeoutに設定する値。)
設定値:上限値(Max=Integer.MAX_VALUE≒2,147,000,000)
検索結果を出力する上限件数を設定します。exportなどには適用されません。
設定値:上限値(10000)
Importコマンドで一度に実行する件数の上限値を決定します。
設定値:整数分
実験的な機能です。
指定した分ごとに画面の再描画を行い、アプリケーションがスワップアウトしないようにします。
デバッグ用のLoggerに関するプロパティです。プロパティファイルに直接は指定できません(-Dオプションで指定可能)。
標準のLoggingAPI(java.util.logging)を使用したい場合は、以下のシステムプロパティを設定してください。LoggingAPI自体の設定は、APIドキュメントを参照してください。
-Dnet.argius.logging=true -Dnet.argius.logging.class=net.argius.logging.LoggingApiWrapper