sp_trace_setstatus (Transact-SQL)

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

重要提示
后续版本的 Microsoft SQL Server 将删除该功能。请避免在新的开发工作中使用该功能，并着手修改当前还在使用该功能的应用程序。 请改用扩展事件。

Transact-SQL 语法约定

语法

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

参数

• [ @traceid= ] trace_id
  要修改的跟踪的 ID。 trace_id 的数据类型为 int，无默认值。 用户采用该 trace_id 值来标识、修改和控制跟踪。 有关检索 trace_id 的信息，请参阅 sys.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 权限。

请参阅

参考

sys.fn_trace_geteventinfo (Transact-SQL)

sys.fn_trace_getfilterinfo (Transact-SQL)

sp_trace_generateevent (Transact-SQL)

sp_trace_setevent (Transact-SQL)

sp_trace_setfilter (Transact-SQL)

概念

SQL 跟踪