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) 的参数的类型都受到严格限制。如果没有用正确的输入参数数据类型（参数说明中指定的类型）来调用这些参数，则存储过程将返回错误。

权限

用户必须拥有 ALTER TRACE 权限。

请参阅

参考

fn_trace_geteventinfo (Transact-SQL)
fn_trace_getfilterinfo (Transact-SQL)
sp_trace_generateevent (Transact-SQL)
sp_trace_setevent (Transact-SQL)
sp_trace_setfilter (Transact-SQL)

其他资源

SQL 跟踪简介

帮助和信息

获取 SQL Server 2005 帮助