この文は、メッセージを表示するために使用します。

構文

MESSAGE expression, ...
[ TYPE { INFO | ACTION | WARNING | STATUS } ]
[ TO { CONSOLE 
   | CLIENT [ FOR { CONNECTION conn-id [ IMMEDIATE ] | ALL } ] 
   | [ EVENT | SYSTEM ] LOG }
   [ DEBUG ONLY ] ]

conn-id : integer

パラメータ

備考

MESSAGE 文は、メッセージを表示します。これには、任意の式を指定できます。句は、メッセージ・タイプおよびメッセージが表示される場所を指定します。

MESSAGE ... TO CLIENT 文を発行するプロシージャは、接続に関連付けられている必要があります。

たとえば、次の例ではイベントが接続以外で発生しているため、ウィンドウは表示されません。

CREATE EVENT CheckIdleTime
TYPE ServerIdle
WHERE event_condition( 'IdleTime' ) > 100
HANDLER
BEGIN
   MESSAGE 'Idle engine' TYPE WARNING TO CLIENT;
END;

ただし、次の例では、データベース・サーバ・メッセージ・ウィンドウにメッセージが書き込まれます。

CREATE EVENT CheckIdleTime
TYPE ServerIdle
WHERE event_condition( 'IdleTime' ) > 100
HANDLER
BEGIN
   MESSAGE 'Idle engine' TYPE WARNING TO CONSOLE;
END;

有効な式には、引用文字列または他の定数、変数、関数を含めることができます。

FOR 句を使用すると、アプリケーションでイベントを明示的にチェックしなくても、データベース・サーバ上で検出されたイベントを別のアプリケーションに通知できます。FOR 句が使用されている場合、受信者は、SQL 文を次に実行するときにメッセージを受信します。受信者が現在 SQL 文を実行している場合は、文の完了時にメッセージが受信されます。実行されている文がストアド・プロシージャ呼び出しである場合、メッセージは呼び出しが完了する前に受信されます。

アプリケーションがメッセージの送信直後に通知を必要とし、接続が SQL 文を実行していない場合は、複数の WAITFOR DELAY 文を同時に使用するのではなく、IMMEDIATE 句を使用してクライアント通知を実装します。

通常、宛先の接続がデータベース・サーバ要求を実行していない場合でも、IMMEDIATE 句を使用して送信されたメッセージは 5 秒未満で配信されます。クライアント接続が 1 秒間に複数の要求を実行した場合、クライアント接続が非常に大きな BLOB データを受信した場合、またはクライアントのメッセージ・コールバックの実行に 1 秒以上かかった場合、メッセージの配信が遅れる可能性があります。また、複数の IMMEDIATE メッセージを 1 つの接続に 2 秒ごとに送信すると、メッセージの配信が遅れたり、エラー・メッセージが生成されたりすることがあります。クライアント接続が切断されると、MESSAGE ... IMMEDIATE 文が正常に配信されないことがあります。

IMMEDIATE 句のないメッセージが送信されるのは、クライアントが特定の要求または WAITFOR DELAY 文を実行した場合のみです。そのため、メッセージの配信時間は無制限になります。

IMMEDIATE 句には、SQL Anywhere バージョン 11.0.1 か、新しい DBLib、ODBC、または iAnywhere JDBC クライアントライブラリが必要です。IMMEDIATE 句は、非スレッド型の UNIX クライアント・ライブラリではサポートされません。IMMEDIATE 句をサポートしない宛先接続にメッセージが送信されると、エラー・メッセージが生成されます。

MESSAGE ... TO CLIENT 式は、2048 バイトにトランケートされます。IMMEDIATE 句が指定されて送信されたメッセージの場合、メッセージ式は、接続のパケット・サイズと 2048 バイトのうちの小さい方にトランケートされます。

Embedded SQL と ODBC クライアントは、メッセージ・コールバック関数を介してメッセージを受信します。それぞれの場合に、これらの関数を登録してください。Embedded SQL では、メッセージのコールバックが DB_CALLBACK_MESSAGE パラメータを使用して db_register_a_callback に登録されます。ODBC では、メッセージのコールバックが ASA_REGISTER_MESSAGE_CALLBACK を使用して SQLSetConnectAttr に登録されます。

パーミッション

FOR 句、TO EVENT LOG 句、または TO SYSTEM LOG 句を含む MESSAGE 文を実行するには、DBA 権限が必要です。

関連する動作

なし

参照

• CREATE PROCEDURE 文 [Web サービス]
• debug_messages オプション [データベース]
• db_register_a_callback 関数

標準と互換性

例

次のプロシージャは、データベース・サーバ・メッセージ・ウィンドウにメッセージを表示します。

CREATE PROCEDURE message_text()
BEGIN
MESSAGE 'The current date and time: ', Now();
END;

次の文は、データベース・サーバ・メッセージ・ウィンドウに文字列 The current date and time を表示し、続けて現在の日付と時刻を表示します。

CALL message_text();