Compartir a través de


sp_trace_setstatus (Transact-SQL)

Modifica el estado actual de la traza especificada.

Icono de vínculo a temasConvenciones 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.

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.

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.

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.