• 项目

sp_trace_setstatus (Transact-SQL)

修改指定跟踪的当前状态。

主题链接图标Transact-SQL 语法约定

语法

sp_trace_setstatus [ @traceid = ] trace_id , [ @status = ] status

参数

  • [ @traceid= ] trace_id
    要修改的跟踪的 ID。trace_id 的数据类型为 int，无默认值。用户采用该 trace_id 值来标识、修改和控制跟踪。有关检索 trace_id 的信息，请参阅 fn_trace_getinfo (Transact-SQL)。

  • [ @status= ] status
    指定要在跟踪上实现的操作。status 的数据类型为 int，无默认值。

    下表列出了可以指定的状态。

    状态

    说明

    0

    停止指定的跟踪。

    1

    启动指定的跟踪。

    2

    关闭指定的跟踪并从服务器中删除其定义。
    注意注意

    在关闭跟踪前首先必须先停止它。在查看跟踪前首先必须先停止并关闭它。

返回代码值

下表说明在存储过程完成后用户可能获得的代码值。

返回代码

说明

0

没有错误。

1

未知错误。

8

指定的状态无效。

9

指定的跟踪句柄无效。

13

内存不足。在没有足够内存执行指定的操作时返回此代码。

如果跟踪已经处于指定的状态，则 SQL Server 将返回 0。

注释

所有 SQL 跟踪存储过程 (sp_trace_xx) 的参数的类型都受到严格限制。如果没有用正确的输入参数数据类型（参数说明中指定的类型）来调用这些参数，则存储过程将返回错误。

有关使用跟踪存储过程的示例，请参阅如何创建跟踪 (Transact-SQL)。

权限

用户必须拥有 ALTER TRACE 权限。