照会での変数およびコメントの使用

 

SQL 照会に変数およびコメントを組み込むことができます。また、ルックアップ変数も使用できます。この変数は、他の照会や結果を参照して、代替値のドロップダウン・メニューを生成します。

変数およびコメントを含む SQL 照会を作成するためには、次のようにしてください。

1.         DB2 Web Query Tool ナビゲーション・ツリー内の希望する接続ブランチで、「SQL 照会」をクリックします。ドロップダウン・メニューが表示されます。

2.         ドロップダウン・メニューで「新規」をクリックします。「照会の編集」ページが開きます。

3.         SQL ステートメントの入力」フィールドに SQL ステートメントを入力します。照会に変数を組み込むには、以下のいずれかのフォーマットを使用してください。

o   ?

o   :variable

o   [variable]

o   &variable

例えば、次の SQL ステートメントで、&userid は変数です。

select * from table.sample where user=&userid

以下のうちの任意のシステム変数を使用することもできます。

 

wqsys.time

現在時刻を置き換えます。

wqsys.date

現在日付を置き換えます。

wqsys.timestamp

現在のタイム・スタンプを置き換えます。

wqsys.user

ログインに使用するユーザー名を置き換えます。

wqsys.sqlid

ログインに使用する SQL ID を置き換えます。

wqsys.database

アクセスしているデータベースの名前を置き換えます。

4.         照会に検索変数を組み込むには、以下のいずれかのフォーマットを使用してください。

o   [q.groupname.queryname]

o   [r.groupname.resultname]

o   [qm.groupname.queryname]

o   [rm.groupname.resultname]

ドロップダウン・メニューを表示させたい照会または結果の名前を使用します。"qm." または "rm." で始まる検索変数では、その変数の値として複数の値を選択することができます。"q." または "r." で始まる検索変数では、1 つの値だけしか選択することができません。

5.         照会にコメントを組み込むには、以下のいずれかのフォーマットを使用してください。

o   -- comment

o   // comment

コメント記号の後に続くテキストのみがコメントとして扱われます。同じ行にある、コメント記号よりも前のテキストは、SQL ステートメントの一部として扱われます。

6.         次へ」をクリックします。「照会オプション」ページが開きます。

7.         「設定」セクションで「自動コミット」プリファレンスを選択します。

o     変更内容を自動的にはデータベースにコミットさせないようにするには、「オフ」を選択してください。このオプションを選択した場合、データベースへのコミットは手動で行わなければなりません。

変更内容を自動的にコミットさせないように選択した場合、データベースは非コミット状態のままになります。これにより、問題が生じる可能性があります。

o     すべての SQL ステートメントが実行された後で変更内容をデータベースにコミットさせたい場合には、「終了時」を選択してください。

o     れぞれの SQL ステートメントが実行された後で変更内容をデータベースにコミットさせたい場合には、「各ステートメントの後」を選択してください。

8.         結果名」フィールドに、結果セットに使用したい名前を入力します。DB2 Web Query Tool には、デフォルトの結果セット名が用意されています。この名前は、任意の名前に置き換えることができます。

9.         最大行数」フィールドに、結果セットに戻す最大行数を入力します。すべての行を結果セットに戻したい場合には、「最大行数」フィールドに "0" を入力してください。

10.       タイムアウト」フィールドにタイムアウト限界値を入力します。

11.       「アクション」ドロップダウンから、LOB データが検出された場合に行いたいアクションを選択します。

o     LOB を省略する場合には、「省略」を選択してください。

o     LOB を検索するには、「検索」を選択します。

o     LOB を結果セットに組み込みたい場合には、「組み込み」を選択します。

12.       ご使用のシステムに SQL\PA がインストールされていて、照会がまだ SQL/PA によって分析されていない場合には、「SQL/PA 」セクションで SQL/PA の隣に「未分析」と表示されます。SQL/PA で照会を分析するには、「設定」セクションの「SQL/PA」セクションで「分析」をクリックしてください。SQL/PA は、一度に 1 つのステートメントを分析します。したがって、照会に複数の SQL ステートメントが組み込まれている場合、結果は累積形式で表示されます。SQL/PA 分析のオプションを設定するには、「分析オプション」をクリックしてください。

13.       SQL/PA をインストールしていない場合には、「SQL/PA」セクションの SQL/PA の隣に、「未インストール」と表示されます。

14.       オプション: SQL 照会を編集するには、「SQL の編集」をクリックします。

15.       これで、照会を実行または保管できるようになりました。