sp_trace_setstatus (Transact-SQL)

  • Artículo

Se aplica a:SQL Server

Modifica el estado actual del seguimiento especificado.

Importante

Esta característica se quitará en una versión futura de 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 = ] traceid
    , [ @status = ] status
[ ; ]

Argumentos

[ @traceid = ] traceid

Identificador del seguimiento que se va a modificar. @traceid es int, sin valor predeterminado. El usuario emplea este valor @traceid para identificar, modificar y controlar el seguimiento. Para obtener información sobre cómo recuperar el @traceid, consulte sys.fn_trace_getinfo (Transact-SQL).

[ @status = ] status

Especifica la acción que ha de implementarse en el seguimiento. @status es int, sin 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 devuelto 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 suficiente memoria para realizar la acción especificada.

Si el seguimiento ya está en el estado especificado, SQL Server devuelve 0.

Comentarios

Los parámetros de todos los procedimientos almacenados de seguimiento de SQL (sp_trace_*) se escriben estrictamente. 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 devuelve un error.

Para obtener un ejemplo de cómo usar los procedimientos almacenados de seguimiento, vea Crear un seguimiento (Transact-SQL).

Permisos

Requiere el permiso ALTER TRACE.

Contenido relacionado