スクリプト

スクリプトとは

スクリプトとは、SQL及びコマンドをSQL区切り記号?（改行ではない）で区切った命令の集まりです。

スクリプトをスクリプトエディタ?に記述し、実行する事で、結果ペイン?にその実行結果を表示する事ができます。

スクリプト記述例
#ERASE;
SELECT * FROM testtableA;
SELECT * FROM testtableB;
#TAB;
SELECT * FROM testtableC;

(結果ペイン?のテキストをクリアし、testtableAとtesttableBの全件データを結果ペイン?に表示。その後、結果出力モード?をTAB出力?に切り替え、testtableCの全件データを表示)

スクリプトファイルとは

スクリプトファイルとは、スクリプト全体をテキストファイルとして保存したものです。 ValueSQLは、このスクリプトファイル名を指定して実行する事ができます。

エクスプローラなどからスクリプトファイルを、スクリプトエディタ?にドラッグ アンド ドロップしてみてください。

• マウス左ドラッグにてドロップ
  ファイル名の先頭に 「@」がプレフィックスとして自動的に追加され、 スクリプトファイル名がフルパスにて展開されます。
  • 例) @c\ValueSQL\Test.sql

• マウス右ドラッグにてドロップ
  スクリプトファイルを展開して貼り付けるか、左ドラッグと同じようにスクリプトファイル名を貼り付けるかを選択するメニューが表示されます。

スクリプトファイル内からスクリプトファイルの呼び出し

例）
(Main.SQLファイル)
SELECT * FROM TESTTABLE1;
SELECT * FROM TESTTABLE2;
@C:\SQL\Sub.SQL /*（Sub.SQLの呼び出し）*/
SELECT * FROM TESTTABLE5;

(Sub.SQLファイル)
SELECT * FROM TESTTABLE3;
SELECT * FROM TESTTABLE4;

この場合、TESTTABLE1からTESTTABLE5までのSELECT発行が順番どおりに行われます。

なお、スクリプトファイル名に相対パスを使用した場合は、カレントフォルダ環境変数に設定されているフォルダからの相対指定となります。デフォルトはアプリケーションの作業フォルダです。

スクリプトパラメータ

スクリプトがファイルに保存されており、そのスクリプトファイルを実行するときには、パラメータ（スクリプト変数）を指定することができます。

• 例) @c\ValueSQL\Test.sql おはよう こんにちは "a アンド b"
  • (Test.sql ファイルの中の3つのスクリプト変数に、それぞれを代入して実行する)

パラメータはいくつでも指定することができます。

指定方法は、スクリプトファイル指定後、順次半角スペース区切りでパラメータを並べて設定します。
パラメータの中に半角スペースを含めたいときは、ダブルクォーテーションで囲ってください。 例：@c\ValueSQL\Test.sql "お   は  よ う"
また、ダブルクオーテーションをパラメータに含めたいときは、ダブルクオーテーションでエスケープしてください。 例：@c\ValueSQL\Test.sql " ""ValueSQL"" "

パラメータをスクリプト内で使用するには、以下の記述を行ってください。

• {%(パラメータ番号)}

実行時にこの記述がパラメータ文字と置き換わります。

  例１
  
  @Test.sql "ご機嫌いかが？"   まあまあです。  """どうでもいいですね。""";
  の場合、Test.sqlファイルの内容であるスクリプトが
  
  #Print {%1}と質問したら;
  #Print {%2}と答えました;
  #Print {%3};
    
  の場合、実行結果は
  
  ご機嫌いかが？と質問したら
  まあまあです。と答えました
  "どうでもいいですね。"  
  
  となります。

  例２
  
  @Test.sql 5 6;
  
  の場合、Test.sqlの内容が
  
  Select * 
    From TestTable
    Where A = {%1} AND B = {%2}
    ;
  
  である場合の実行結果は、
  
  Select * 
    From TestTable
    Where A = 5 AND B = 6
    ;
  
  の発行結果となります。

  例３
  
  @Test.sql  5  6  c:\Res.txt;
  
  の場合、Test.sqlの内容が
  
  #Reconnect;
  #Newsheet;
  
  Select * 
    From TestTable
    Where A = {%1} AND B = {%2}
    ;
    
  #SaveToFile {%3};
  #Exit;
  
  
  である場合の実行結果は、
  
  Select * 
    From TestTable
    Where A = 5 AND B = 6
    ;
  
  の結果を、c:\Res.txtに保存してValueSQLを終了します。

また、第ゼロパラメータ {%0}は、スクリプト名となります。

コマンドラインパラメータ

ValueSQLは、コマンドプロンプトからも起動できます。

パラメータ１番目は、スクリプトファイル名、二番目以降は上記スクリプトパラメータの設定方法と同じです。

  例：c:\> c:\ValueSQL\ValueSQL.exe @d:\TEST.Script  こんにちは  さようなら

上記例は、ValueSQLを起動しつつ、d:\TEST.Script に記述されているスクリプトを実行し、パラメータとして、「こんにちは」と「さようなら」をスクリプトパラメータの１番目と２番目として処理します。 ValueSQLは、起動時に自動的にRDBに接続しませんので、スクリプトファイルには、#Reconnect; コマンドなどが仕込まれている必要があります。