EXITONDELAY - Basic Teradata Query

目的

この制御によって、ユーザーは、CLIがリクエストをタイムアウトする前に、実行依頼されたSQLリクエストが処理されるまでの最大期間を指定できます。タイムアウトが発生すると、BTEQプロセスは終了します。データベースがダウンするか期間を超えるとタイムアウトがトリガーされます。

このコマンドはワークステーション プラットフォームでのみ利用可能です。

構文

次のような場合に当てはまります。

OFF

BTEQは、LOGONコマンドまたは長時間実行されるSQLリクエストをタイムアウトせず、DBSがダウン状態になった場合、無期限に待ち続けます。

ON

• BTEQは、割り当てられた時間を超過したとき、ログオンにタイムアウト ファクタを使用して0以外の戻りコードで終了します。
• BTEQは、データベースから応答が返される前に割り当てられた時間を超過したとき、長期間実行されるSQLリクエストにタイムアウト ファクタを使用して0以外の戻りコードで終了します。
• BTEQは、実行依頼されたSQLリクエストでDBSクラッシュが発生した場合にタイムアウト ファクタを使用して、直ちにまたは割り当てられた時間を超過したとき(CLIのAutomatic Redrive設定で決まる)、0以外の戻りコードで終了します。

CLIのAutomatic Redrive設定が有効になっている場合、BTEQは割り当てられた時間を超過するまで待機してから終了します。これにより、EXITONDELAYタイムアウト期間を超過する前にDBSが復旧した場合にリクエストを完了できるようになります。

Automatic RedriveとRecoverable Network Protocolが無効になっている場合、CLIは接続を再試行できないため、BTEQはDBSクラッシュ(ハードまたは一時的)またはネットワークの機能停止が発生するとすぐに終了します。

Automatic Redrive設定の構成については、CLIのマニュアルを参照してください。

MAXREQTIME t

EXITONDELAY ONが使用されると、オプションのキーワードMAXREQTIME(最大リクエスト時間)は、BTEQがログオンが有効になるのを待機するまたは長時間実行されるSQLリクエストが実行可能状態になるのを待機する秒数を受け入れます。

MAXREQTIMEの範囲は、10から65535になります。

MAXREQTIMEが使用されないと、デフォルトの待機時間は10秒になります。

RC

EXITONDELAY ONを使用すると、オプションのキーワードRC(戻りコード)には、正数、ERRORCODE、またはERRORLEVELを使用できます。

RCが使用されない場合、デフォルトの戻りコードは致命的エラーのものになります。

RCが使用されている場合、次を指定します。

• n – BTEQは指定されたコードを返します。

  nの値は、0～2147483647です。

• ERRORLEVEL – BTEQは、発生した最も高い重大度を返します。
• ERRORCODE – BTEQは、最後のTeradata SQLリクエストにより生成されたエラー コードを返します。

使用上の注意

EXITONDELAYの設定をログオン前または後に変更できます。すなわち、コマンドはSQL固有に使用できます。

EXITONDELAYコマンドはSQL ECHO文を使って実行できません。これは、リクエストの1つの文だけでなくリクエスト全体に影響を与える必要があるためです。

SET DEFAULTSコマンドは、EXITONDELAY設定に影響しません。