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

srs-id:整数

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 CheckIdleTime
TYPE ServerIdle
WHERE event_condition( 'IdleTime' ) > 100
HANDLER
BEGIN
   MESSAGE 'Idle server' TYPE WARNING TO CONSOLE;
END;

有效的表达式可以包括带引号的字符串或者其它常量、变量或函数。

FOR 子句可用于将数据库服务器上所检测到的事件通知其它应用程序，而不需要该应用程序显式地检查事件。使用 FOR 子句后，接收者在下次执行 SQL 语句时会接收到消息。如果接收者当前正在执行 SQL 语句，则将在该语句完成后接收到消息。如果正在执行的语句是存储过程调用，则将在调用完成前收到消息。

如果应用程序需要在消息发出不久和连接不执行 SQL 语句时得到通知，则应使用 IMMEDIATE 子句实现客户端通知，而不使用多个并发的 WAITFOR DELAY 语句。

通常情况下，使用 IMMEDIATE 子句发送的消息将在 5 秒内传送出去，即使在目标连接未发出数据库服务器请求时也是如此。如果客户端连接每秒发出多次请求，或收到庞大的 BLOB 数据，或者客户端消息回调的执行时间超过 1 秒，均可能会造成消息传送延迟。此外，在两秒内将多个 IMMEDIATE 消息发送给同一连接也可能会延迟消息传送或生成错误消息。如果断开客户端连接，可能无法传送成功的 MESSAGE...IMMEDIATE 语句。

对于未使用 IMMEDIATE 子句发送的消息，只有在客户端执行某个特定请求或执行 WAITFOR DELAY 语句时才会传送它们。因此，消息的传送时间没有限制。

IMMEDIATE 子句需要 SQL Anywhere 11 或更高版本的 DBLib、ODBC 或 SQL Anywhere JDBC 驱动程序。非线程 Unix 客户端库不支持 IMMEDIATE 子句。当消息被发送到不支持 IMMEDIATE 子句的目标连接时，会生成错误消息。当消息被发送到执行 MESSAGE 语句的同一个连接时，会生成错误消息。

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

MESSAGE...TO CLIENT 表达式可以截断为 2048 个字节。对于使用 IMMEDIATE 子句发送的消息，消息表达式可以被截断为小于连接的包大小或 2048 个字节。

嵌入式 SQL 和 ODBC 客户端通过消息回调函数接收消息。在每种情况下，都必须注册这些函数。在嵌入式 SQL 中，使用 DB_CALLBACK_MESSAGE 参数向 db_register_a_callback 注册消息回调。在 ODBC 中，使用 SA_REGISTER_MESSAGE_CALLBACK 参数向 SQLSetConnectAttr 注册消息回调。

执行包含 FOR 子句、TO EVENT LOG 子句或 TO SYSTEM LOG 子句的 MESSAGE 语句需要具有 DBA 权限。

无。

• 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( );