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

conn-id :integer

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

expression のサイズがデータベースページサイズを超えた場合、expression はデータベースページサイズに収まるようにトランケートされます。データベースに有効なページサイズをチェックするには、PageSize データベースプロパティに対するクエリを実行します (SELECT DB_PROPERTY( 'PageSize' );)。

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

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

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

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

CREATE EVENT CheckIdleTime2
TYPE ServerIdle
WHERE event_condition( 'IdleTime' ) > 100
HANDLER
BEGIN
   MESSAGE 'Idle server' 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 以降の DBLib、ODBC、または SQL Anywhere JDBC ドライバが必要です。IMMEDIATE 句は、非スレッド型の UNIX クライアントライブラリではサポートされません。IMMEDIATE 句をサポートしない宛先接続にメッセージが送信されると、エラーメッセージが生成されます。MESSAGE 文の実行元と同じ接続に IMMEDIATE メッセージが送信されると、エラーメッセージが生成されます。

MESSAGE 'Please disconnect' TYPE WARNING TO CLIENT 
    FOR CONNECTION 16 IMMEDIATE;

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

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

FOR 句、TO EVENT LOG 句、TO SYSTEM LOG 句を含む MESSAGE 文を実行するには、SERVER OPERATOR システム権限を持っている必要があります。それ以外の場合、この文について権限は必要ありません。

なし

• sa_conn_info システムプロシージャ
• CREATE PROCEDURE 文
• debug_messages オプション
• db_register_a_callback 関数
• WAITFOR 文

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

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

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

CALL message_text( );