sa_user_defined_counter_set 系统过程

sa_user_defined_counter_set( 
counter_name 
, value
[, apply_to_con
[, appy_to_db
[, apply_to_server ] ] ]

counter_name 使用此 VARCHAR(128) 参数可以为要更改值的用户定义计数器指定名称。用户定义的计数器名称示例包括 UserDefinedCounterRate01 和 UserDefinedCounterRaw01。
value 使用此 BIGINT 参数指定要将用户定义的计数器设置成什么值。
apply_to_con 使用此 INT 参数指定是否调整当前连接的计数器值。0 表示不调整值，1 表示调整值。缺省值为 1。
apply_to_db 使用此 INT 参数指定是否调整数据库的计数器值。0 表示不调整值，1 表示调整值。缺省值为 0。
apply_to_server 使用此 INT 参数指定是否调整数据库服务器的计数器值。0 表示不调整值，1 表示调整值。缺省值为 0。

此函数返回 INTEGER 状态代码。

如果已定义 value，则此函数返回 1；如果未定义 value，则返回 0；如果出现错误，则返回错误代码。错误的示例包括：

计数器的并发访问会自动应用，因此可以通过多个并发请求重置计数器值。

用户定义的计数器以 32 位 UNSIGNED INTEGER 值的形式实现。

您必须具有 SERVER OPERATOR 系统特权。

无

以下语句用于将当前连接、数据库和数据库服务器的 UserDefinedCounterRate01 值设置为 0：

SELECT sa_user_defined_counter_set( 'UserDefinedCounterRate01', 0, 1, 1, 1 );