sp_trace_setstatus (Transact-SQL)
Modifica el estado actual de la traza especificada.
.gif "Icono de vínculo a temas")
Sintaxis
sp_trace_setstatus [ @traceid = ] trace_id , [ @status = ] status
Argumentos
[ @traceid= ] trace_id
Es el Id. de la traza que va a modificarse. trace_id es de tipo int y no tiene ningún valor predeterminado. El usuario utiliza este valor de trace_id para identificar, modificar y controlar la traza. Para obtener información acerca de cómo recuperar el trace_id, vea fn_trace_getinfo (Transact-SQL).[ @status= ] status
Especifica la acción que ha de implementarse en la traza. status es de tipo int y no tiene ningún valor predeterminado.En la tabla siguiente se muestra una lista de los estados que podrían especificarse.
Estado
Descripción
0
Detiene la traza especificada.
1
Inicia la traza especificada.
2
Cierra la traza especificada y elimina su definición del servidor.
Nota
Para poder cerrar una traza, primero debe detenerse. Para poder ver una traza, 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 asa de traza especificado no es válido. |
13 |
Memoria insuficiente. Se devuelve cuando no hay memoria suficiente para realizar la acción especificada. |
Si la traza ya se encuentra en el estado especificado, SQL Server devolverá 0.
Comentarios
Los parámetros de todos los procedimientos almacenados de Traza 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 Cómo crear una traza (Transact-SQL).
Permisos
El usuario debe tener permiso ALTER TRACE.