8.9.2　SQL実行時間警告出力機能の使用方法

(a)　PDCWAITTIMEに対する比率の指定

PDCWAITTIMEWRNPNT及びpd_cwaittime_wrn_pntオペランドでPDCWAITTIMEに対する比率（0％〜100％未満）を指定します。例えば，PDCWAITTIMEに100（秒）を指定し，PDCWAITTIMEWRNPNT又はpd_cwaittime_wrn_pntオペランドに90（％）を指定すると，SQLの実行後にHiRDBがSQLの実行時間を調べます。その結果，SQLの実行時間が90秒以上100秒未満の場合に警告情報が出力されます。

符号なし整数，又は符号なし10進数（小数点を含む数，小数第6位まで）で指定できます。

(b)　警告をファイルに出力する契機となる時間の指定

上記のオペランドでSQL実行時間の警告を出力する契機となる時間を，0からPDCWAITTIMEの設定値未満で指定します。

なお，PDCWAITTIMEWRNPNTの設定値にPDCWAITTIMEの指定値より大きな時間を設定した場合には，CONNECT要求時にエラーになります。

注意事項

• pd_cwaittime_wrn_pntオペランドの指定よりもPDCWAITTIMEWRNPNTの指定の方が優先されます。

• PDCWAITTIMEWRNPNTに0%を指定した場合，そのHiRDBクライアントから実行されるSQLについてはSQL実行時間警告出力機能が適用されません。

参考

警告時間は，前記に示すオペランドの値から次に示す計算式を使用してHiRDBが決定します。

• 符号なし整数でPDCWAITTIMEに対する比率を設定した場合

  警告時間＝MAX（↓（ａ×ｂ）÷100↓，1）

  ａ：PDCWAITTIMEの値

  ｂ：PDCWAITTIMEWRNPNT又はpd_cwaittime_wrn_pntオペランドの値（これらのオペランドの優先度に従い適用された値が代入されます）

• 符号なし10進数でPDCWAITTIMEに対する比率を設定した場合

  警告時間＝（ａ×ｂ）÷100

  ａ：PDCWAITTIMEの値

  ｂ：PDCWAITTIMEWRNPNT又はpd_cwaittime_wrn_pntオペランドの値（これらのオペランドの優先度に従い適用された値が代入されます）

  ただし，警告時間は小数第6位まで有効です。小数第7位以下は切り捨てられます。

• 警告をファイルに出力する契機となる時間を設定した場合

  警告時間＝警告をファイルに出力する契機となる時間の絶対値

なお，HiRDBサーバ内部で使用するタイマの精度がプラットフォームに依存するため，タイマの精度が低い場合，実際のSQLの実行時間が警告時間を超えても警告情報が出力されないことがあります。