sp_trace_setstatus (Transact-SQL)
Modifica el estado actual de la traza especificada.
.gif "Icono de vínculo a temas")
Convenciones de sintaxis de Transact-SQL
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.
Notas
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.
Permisos
El usuario debe tener permiso ALTER TRACE.
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.
Vea también
Referencia
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)