TSL_GetLogMessage 函数

TSL_GetLogMessage 函数指定从装入器消息队列中检索的消息数。

语法

TSL_GetLogMessage(
           handle          lvarchar,
           max_messages    integer)
returns lvarchar

handle: TSL_Attach 函数返回的表名和列名组合。
max_messages: 0 = 将检索所有消息。
正整数 = 要检索的消息数。如果该数字大于队列中的消息总数，将检索所有消息。

用法

作为装入器程序的一部分，使用 TSL_GetLogMessage 函数检索装入器消息。要检索消息，日志方式必须设置为 2，这样消息才能发送到装入器程序。日志方式由 TSL_Init 函数进行设置，或由 TSL_SetLogMode 函数进行重置。必须在由 TSL_Init 函数初始化的装入器会话的上下文中运行 TSL_GetLogMessage 函数。可以使用 TSL_GetLogMessage 函数来监视由 TSL_Put 函数装入并由 TSL_Flush 函数保存到磁盘的数据。

TSL_GetLogMessage 函数是迭代器函数。可以通过虚拟表使用 SQL 游标来检索消息。

返回结果

装入器消息队列中指定数量的消息。如果返回 NULL，说明装入器消息队列为空。

示例

在装入器程序的上下文中，以下语句从装入器消息日志中检索 50 条消息：

EXECUTE FUNCTION TSL_GetLogMessage('ts_data-raw_reads',50);