sp_trace_setstatus (Transact-SQL)
Modifica el estado actual del seguimiento especificado.
Importante |
---|
Esta característica se quitará en una versión futura de Microsoft SQL Server. Evite utilizar esta característica en nuevos trabajos de desarrollo y tenga previsto modificar las aplicaciones que actualmente la utilizan. Use eventos extendidos en su lugar. |
Convenciones de sintaxis de Transact-SQL
Sintaxis
sp_trace_setstatus [ @traceid = ] trace_id , [ @status = ] status
Argumentos
[ @traceid= ] trace_id
Es el id. del seguimiento que va a modificarse. trace_id es de tipo int y no tiene valor predeterminado. El usuario utiliza este valor de trace_id para identificar, modificar y controlar el seguimiento. Para obtener información acerca de cómo recuperar el trace_id, vea sys.fn_trace_getinfo (Transact-SQL).[ @status= ] status
Especifica la acción que ha de implementarse en el seguimiento. status es de tipo int y no tiene valor predeterminado.En la tabla siguiente se muestra una lista de los estados que podrían especificarse.
Estado
Descripción
0
Detiene el seguimiento especificado.
1
Inicia el seguimiento especificado.
2
Cierra el seguimiento especificado y elimina su definición del servidor.
[!NOTA]
Para poder cerrar un seguimiento, primero debe detenerse. Para poder ver un seguimiento, antes debe detenerse y cerrarse.
Valores de código de retorno
En la tabla siguiente se describen los valores del código que los usuarios pueden obtener después de completar el procedimiento almacenado.
Código de retorno |
Descripción |
---|---|
0 |
Ningún error. |
1 |
Error desconocido. |
8 |
El estado especificado no es válido. |
9 |
El identificador de seguimiento especificado no es válido. |
13 |
Memoria insuficiente. Se devuelve cuando no hay memoria suficiente para realizar la acción especificada. |
Si el seguimiento ya se encuentra en el estado especificado, SQL Server devolverá 0.
Comentarios
Los parámetros de todos los procedimientos almacenados de Seguimiento de SQL (sp_trace_xx) tienen establecimiento inflexible de tipos. Si no se llama a estos parámetros con los tipos de datos de parámetros de entrada correctos, según se especifica en la descripción del argumento, el procedimiento almacenado devolverá un error.
Para obtener un ejemplo de cómo usar los procedimientos almacenados de seguimiento, vea Crear un seguimiento (Transact-SQL).
Permisos
El usuario debe tener permiso ALTER TRACE.
Vea también
Referencia
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)