Compartir por

sp_trace_setevent (Transact-SQL)

  • Artigo

Se aplica a: SQL Server

Agrega o quita un evento o una columna de evento en un seguimiento. sp_trace_setevent solo se puede ejecutar en seguimientos existentes que se detengan (@status es 0). Se devuelve un error si este procedimiento almacenado se ejecuta en un seguimiento que no existe o cuya @status no 0es .

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_setevent
    [ @traceid = ] traceid
    , [ @eventid = ] eventid
    , [ @columnid = ] columnid
    , [ @on = ] on
[ ; ]

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.

[ @eventid = ] eventid

Identificador del evento que se va a activar. @eventid es int, sin ningún valor predeterminado.

Esta tabla muestra una lista de los eventos que pueden agregarse o quitarse de un seguimiento.

Número de evento Nombre del evento Descripción
0 a 9 Reserved Reserved
10 RPC:Completed Se produce cuando se ha completado una llamada a procedimiento remoto (RPC).
11 RPC:Starting Se produce cuando se ha iniciado una RPC.
12 SQL:BatchCompleted Se produce cuando se ha completado un lote de Transact-SQL.
13 SQL:BatchStarting Se produce cuando se ha iniciado un lote de Transact-SQL.
14 Audit Login Se produce cuando un usuario inicia sesión correctamente en SQL Server.
15 Audit Logout Se produce cuando un usuario cierra la sesión de SQL Server.
16 Attention Se produce cuando tienen lugar eventos de atención como, por ejemplo, las solicitudes de interrupción de clientes o las conexiones de cliente interrumpidas.
17 ExistingConnection Detecta toda la actividad por parte de los usuarios conectados a SQL Server antes de iniciar el seguimiento.
18 Audit Server Starts and Stops Se produce cuando se modifica el estado del servicio SQL Server.
19 DTCTransaction Realiza un seguimiento de las transacciones coordinadas del Coordinador de transacciones distribuidas (MS DTC) de Microsoft entre dos o más bases de datos.
20 Audit Login Failed Indica que se produjo un error al intentar iniciar sesión en SQL Server desde un cliente.
21 EventLog Indica que los eventos se han grabado en el registro de aplicación de Windows.
22 ErrorLog Indica que los eventos de error se han registrado en el registro de errores de SQL Server.
23 Lock:Released Indica que se ha liberado un bloqueo en un recurso, como una página.
24 Lock:Acquired Indica la adquisición de un bloqueo en un recurso, como una página de datos.
25 Lock:Deadlock Indica que dos transacciones simultáneas se han interbloqueado mutuamente al intentar obtener bloqueos incompatibles en recursos que son propiedad de la otra transacción.
26 Lock:Cancel Indica la anulación de la adquisición de un bloqueo en un recurso (por ejemplo, debido a un interbloqueo).
27 Lock:Timeout Indica que una solicitud de un bloqueo en un recurso, como una página, ha agotado el tiempo de espera debido a que existía otra transacción que mantenía un bloqueo en el recurso requerido. El tiempo de espera viene determinado por la función @@LOCK_TIMEOUT y se puede establecer con la instrucción SET LOCK_TIMEOUT.
28 Degree of Parallelism Event Se produce antes de ejecutarse una instrucción SELECT, INSERT o UPDATE.
29 a 31 Reserved Utilice el evento 28 en su lugar.
32 Reserved Reserved
33 Exception Indica que se ha producido una excepción en SQL Server.
34 SP:CacheMiss Indica cuándo no se encuentra un procedimiento almacenado en la memoria caché de procedimientos.
35 SP:CacheInsert Indica que se ha insertado un elemento en la caché de procedimientos.
36 SP:CacheRemove Indica que se ha eliminado un elemento de la caché de procedimientos.
37 SP:Recompile Indica que se ha vuelto a compilar un procedimiento almacenado.
38 SP:CacheHit Indica que se ha encontrado un procedimiento almacenado en la caché de procedimientos.
39 Deprecated En desuso
40 SQL:StmtStarting Se produce cuando se ha iniciado la instrucción Transact-SQL.
41 SQL:StmtCompleted Se produce cuando se ha completado la instrucción Transact-SQL.
42 SP:Starting Indica el inicio de un procedimiento almacenado.
43 SP:Completed Indica la conclusión de un procedimiento almacenado.
44 SP:StmtStarting Indica que se ha iniciado la ejecución de una instrucción Transact-SQL dentro de un procedimiento almacenado.
45 SP:StmtCompleted Indica que una instrucción Transact-SQL dentro de un procedimiento almacenado ha terminado de ejecutarse.
46 Object:Created Indica que se ha creado un objeto, como para las instrucciones CREATE INDEX, CREATE TABLE o CREATE DATABASE.
47 Object:Deleted Indica que se ha eliminado un objeto, como en las instrucciones DROP INDEX o DROP TABLE.
48 Reserved
49 Reserved
50 SQL Transaction Realiza un seguimiento de las instrucciones TRANSACT-SQL BEGIN, COMMIT, SAVE y ROLLBACK TRANSACTION.
51 Scan:Started Indica que se ha iniciado un recorrido de tabla o de índice.
52 Scan:Stopped Indica que se ha detenido un recorrido de tabla o de índice.
53 CursorOpen Indica cuándo se abre un cursor en una instrucción Transact-SQL mediante ODBC, OLE DB o DB-Library.
54 TransactionLog Realiza un seguimiento cuando se escriben transacciones en el registro de transacciones.
55 Hash Warning Indica que una operación de hash (por ejemplo, combinación hash, agregado hash, unión hash y hash distinct) que no se está procesando en una partición de búfer se ha revertido a un plan alternativo. Esto puede producirse debido a la profundidad de repetición, el sesgo de datos, las marcas de seguimiento o el recuento de bits.
56 a 57 Reserved
58 Auto Stats Indica una actualización automática de las estadísticas indizadas.
59 Lock:Deadlock Chain Se produce para cada evento que lleva a un interbloqueo.
60 Lock:Escalation Indica que un bloqueo específico se ha convertido en un bloqueo general (por ejemplo, un bloqueo de página se ha concentrado o convertido en un bloqueo de tabla o de HoBT).
61 OLE DB Errors Indica un error OLE DB.
62 a 66 Reserved
67 Execution Warnings Indica las advertencias que se produjeron durante la ejecución de una instrucción o procedimiento almacenado de SQL Server.
68 Showplan Text (Unencoded) Muestra el árbol de plan de la instrucción Transact-SQL ejecutada.
69 Sort Warnings Indica las operaciones de ordenación que no caben en la memoria. No incluye operaciones de ordenación que implican la creación de índices; solo operaciones de ordenación dentro de una consulta (por ejemplo, una cláusula ORDER BY usada en una instrucción SELECT).
70 CursorPrepare Indica cuándo se prepara un cursor en una instrucción Transact-SQL para su uso por ODBC, OLE DB o DB-Library.
71 Prepare SQL ODBC, OLE DB o DB-Library ha preparado una instrucción o instrucciones Transact-SQL para su uso.
72 Exec Prepared SQL ODBC, OLE DB o DB-Library ha ejecutado una instrucción o instrucciones Transact-SQL preparadas.
73 Unprepare SQL ODBC, OLE DB o DB-Library no está preparado (eliminado) una instrucción o instrucciones Transact-SQL preparadas.
74 CursorExecute Se ejecuta un cursor previamente preparado en una instrucción Transact-SQL por ODBC, OLE DB o DB-Library.
75 CursorRecompile Un cursor abierto en una instrucción Transact-SQL por ODBC o DB-Library se ha vuelto a compilar directamente o debido a un cambio de esquema.

Se desencadena para cursores ANSI y no ANSI.
76 CursorImplicitConversion SQL Server convierte un cursor en una instrucción Transact-SQL de un tipo a otro.

Se desencadena para cursores ANSI y no ANSI.
77 CursorUnprepare Un cursor preparado en una instrucción Transact-SQL no está preparado (eliminado) por ODBC, OLE DB o DB-Library.
78 CursorClose Se cierra un cursor abierto previamente en una instrucción Transact-SQL por ODBC, OLE DB o DB-Library.
79 Missing Column Statistics Las estadísticas de columna que podrían haber sido útiles para el optimizador no están disponibles.
80 Missing Join Predicate Consulta que no se ejecuta ningún predicado de combinación. Esto podría dar como resultado una consulta de ejecución prolongada.
81 Server Memory Change El uso de memoria de SQL Server ha aumentado o disminuido en 1 megabyte (MB) o el 5 por ciento de la memoria máxima del servidor, lo que sea mayor.
82 a 91 User Configurable (0 - 9) Datos de eventos definidos por el usuario.
92 Data File Auto Grow Indica que el servidor ha extendido automáticamente un archivo de datos.
93 Log File Auto Grow Indica que el servidor ha extendido automáticamente un archivo de registro.
94 Data File Auto Shrink Indica que el servidor ha reducido automáticamente un archivo de datos.
95 Log File Auto Shrink Indica que el servidor ha reducido automáticamente un archivo de registro.
96 Showplan Text Muestra el árbol del plan de consulta de la instrucción SQL desde el optimizador de consultas. La TextData columna no contiene el plan de presentación de este evento.
97 Showplan All Muestra el plan de consulta con detalles completos del tiempo de compilación de la instrucción SQL ejecutada. La TextData columna no contiene el plan de presentación de este evento.
98 Showplan Statistics Profile Muestra el plan de consulta con detalles completos del tiempo de ejecución de la instrucción SQL ejecutada. La TextData columna no contiene el plan de presentación de este evento.
99 Reserved
100 RPC Output Parameter Produce valores de salida de los parámetros para cada RPC.
101 Reserved
102 Audit Database Scope GDR Se produce cada vez que cualquier usuario de SQL Server emite un permiso GRANT, DENY, REVOKE para una instrucción para acciones de solo base de datos, como conceder permisos en una base de datos.
103 Audit Object GDR Event Se produce cada vez que cualquier usuario de SQL Server emite un permiso GRANT, DENY, REVOKE para un objeto.
104 Audit AddLogin Event Se produce cuando se agrega o quita un inicio de sesión de SQL Server; para sp_addlogin y sp_droplogin.
105 Audit Login GDR Event Se produce cuando se agrega o quita un derecho de inicio de sesión de Windows; para sp_grantlogin, sp_revokeloginy sp_denylogin.
106 Audit Login Change Property Event Se produce cuando se modifica una propiedad de un inicio de sesión, excepto las contraseñas; para sp_defaultdb y sp_defaultlanguage.
107 Audit Login Change Password Event Se produce cuando se cambia una contraseña de inicio de sesión de SQL Server.

Las contraseñas no se registran.
108 Audit Add Login to Server Role Event Se produce cuando se agrega o quita un inicio de sesión de un rol fijo de servidor; para sp_addsrvrolemembery sp_dropsrvrolemember.
109 Audit Add DB User Event Se produce cuando se agrega o quita un inicio de sesión como usuario de base de datos (Windows o SQL Server) a una base de datos; para sp_grantdbaccess, sp_revokedbaccess, sp_addusery sp_dropuser.
110 Audit Add Member to DB Role Event Se produce cuando se agrega o quita un inicio de sesión como usuario de base de datos (fijo o definido por el usuario) en una base de datos; para sp_addrolemember, sp_droprolemembery sp_changegroup.
111 Audit Add Role Event Se produce cuando se agrega o quita un inicio de sesión como usuario de base de datos a una base de datos; para sp_addrole y sp_droprole.
112 Audit App Role Change Password Event Se produce cuando se cambia una contraseña de un rol de aplicación.
113 Audit Statement Permission Event Se produce cuando se utiliza un permiso de instrucción (como CREATE TABLE).
114 Audit Schema Object Access Event Se produce cuando se utiliza un permiso de objeto (como SELECT), tanto con éxito como con error.
115 Audit Backup/Restore Event Se produce cuando se emite un comando BACKUP o RESTORE.
116 Audit DBCC Event Se produce cuando se emiten comandos DBCC.
117 Audit Change Audit Event Se produce cuando se realizan modificaciones en el seguimiento de auditoría.
118 Audit Object Derived Permission Event Tiene lugar cuando se emiten los comandos de objeto CREATE, ALTER y DROP.
119 OLEDB Call Event Se produce cuando las llamadas de proveedor OLE DB se realizan para consultas distribuidas y procedimientos almacenados remotos.
120 OLEDB QueryInterface Event Se produce cuando se realizan llamadas OLE DB QueryInterface para consultas distribuidas y procedimientos almacenados remotos.
121 OLEDB DataRead Event Se produce cuando se realiza una llamada de solicitud de datos al proveedor OLE DB.
122 Showplan XML Se produce cuando se ejecuta una instrucción SQL. Incluya este evento para identificar los operadores de plan de presentación. Cada evento se almacena en un documento XML correcto. La Binary columna de este evento contiene el plan de presentación codificado. Use SQL Server Profiler para abrir el seguimiento y ver el plan de presentación.
123 SQL:FullTextQuery Se produce al ejecutar una consulta de texto completo.
124 Broker:Conversation Informa del progreso de una conversación de Service Broker.
125 Deprecation Announcement Se produce cuando se usa una característica que se quitará de una versión futura de SQL Server.
126 Deprecation Final Support Se produce cuando se usa una característica que se quitará de la próxima versión principal de SQL Server.
127 Exchange Spill Event Se produce cuando los búferes de comunicación de un plan de consulta paralelo se han escrito temporalmente en la tempdb base de datos.
128 Audit Database Management Event Se produce al crear, modificar o quitar una base de datos.
129 Audit Database Object Management Event Se produce al ejecutar una instrucción CREATE, ALTER o DROP en objetos de base de datos como, por ejemplo, esquemas.
130 Audit Database Principal Management Event Se produce al crear, modificar o quitar entidades de seguridad, como usuarios, en una base de datos.
131 Audit Schema Object Management Event Se produce al crear, modificar o quitar objetos de servidor.
132 Audit Server Principal Impersonation Event Se produce cuando hay una suplantación dentro del ámbito del servidor, como EXECUTE AS LOGIN.
133 Audit Database Principal Impersonation Event Se produce cuando hay una suplantación en el ámbito de la base de datos, como EXECUTE AS USER o SETUSER.
134 Audit Server Object Take Ownership Event Se produce cuando se cambia el propietario de objetos en el ámbito del servidor.
135 Audit Database Object Take Ownership Event Se produce cuando se cambia el propietario de objetos en el ámbito de la base de datos.
136 Broker:Conversation Group Se produce cuando Service Broker crea un nuevo grupo de conversaciones o quita un grupo de conversación existente.
137 Blocked Process Report Se produce cuando un proceso ha estado bloqueado durante más tiempo del especificado. No incluye procesos o procesos del sistema que están esperando recursos que no detectan interbloqueos. Use sp_configure para configurar el umbral y la frecuencia con la que se generan informes.
138 Broker:Connection Informa del estado de una conexión de transporte administrada por Service Broker.
139 Broker:Forwarded Message Sent Se produce cuando Service Broker reenvía un mensaje.
140 Broker:Forwarded Message Dropped Se produce cuando Service Broker quita un mensaje que estaba pensado para reenviarse.
141 Broker:Message Classify Se produce cuando Service Broker determina el enrutamiento de un mensaje.
142 Broker:Transmission Indica que se han producido errores en la capa de transporte de Service Broker. Los valores del estado y del número de error indican el origen del mismo.
143 Broker:Queue Disabled Indica que se detectó un mensaje dudoso porque había cinco reversiones de transacciones consecutivas en una cola de Service Broker. El evento contiene el Id. de base de datos y el Id. de cola de la cola que contiene el mensaje dudoso.
144 a 145 Reserved
146 Showplan XML Statistics Profile Se produce cuando se ejecuta una instrucción SQL. Identifica los operadores de plan de presentación y muestra todos los datos de tiempo de compilación. La Binary columna de este evento contiene el plan de presentación codificado. Use SQL Server Profiler para abrir el seguimiento y ver el plan de presentación.
148 Deadlock Graph Se produce cuando se cancela un intento de obtener un bloqueo porque dicho intento forma parte de un interbloqueo y se ha elegido como sujeto del interbloqueo. Proporciona una descripción en XML de un interbloqueo.
149 Broker:Remote Message Acknowledgement Se produce cuando Service Broker envía o recibe una confirmación de mensaje.
150 Trace File Close Se produce cuando se cierra un archivo de seguimiento durante una reversión del mismo.
151 Reserved
152 Audit Change Database Owner Se produce cuando se utiliza ALTER AUTHORIZATION para cambiar el propietario de una base de datos y se comprueban los permisos para realizar dicha acción.
153 Audit Schema Object Take Ownership Event Se produce cuando se utiliza ALTER AUTHORIZATION para asignar un propietario a un objeto y se comprueban los permisos para realizar dicha acción.
154 Reserved
155 FT:Crawl Started Se produce cuando se inicia un rastreo de texto completo (llenado). Utilice esta clase de evento para comprobar si las tareas de trabajo están recogiendo una solicitud de rastreo.
156 FT:Crawl Stopped Se produce cuando se detiene un rastreo de texto completo (llenado). La detención se debe a un rastreo finalizado correctamente o a un error irrecuperable.
157 FT:Crawl Aborted Se produce cuando se ha detectado una excepción durante un rastreo de texto completo. Normalmente, el error hará que se detenga el rastreo de texto completo.
158 Audit Broker Conversation Informa de los mensajes de auditoría relacionados con la seguridad de diálogo de Service Broker.
159 Audit Broker Login Informa de los mensajes de auditoría relacionados con la seguridad de transporte de Service Broker.
160 Broker:Message Undeliverable Se produce cuando Service Broker no puede conservar un mensaje recibido que se debe haber entregado a un servicio.
161 Broker:Corrupted Message Se produce cuando Service Broker recibe un mensaje dañado.
162 User Error Message Muestra los mensajes de error tal y como los ven los usuarios cuando se produce un error o una excepción.
163 Broker:Activation Se produce cuando un monitor de cola inicia un procedimiento almacenado de activación, envía una QUEUE_ACTIVATION notificación o cuando se cierra un procedimiento almacenado de activación iniciado por un monitor de cola.
164 Object:Altered Se produce cuando se modifica un objeto de base de datos.
165 Performance statistics Se produce cuando un plan de consulta compilado se ha almacenado en caché por primera vez, se ha vuelto a compilar o se ha expulsado de la caché del plan.
166 SQL:StmtRecompile Se produce al realizar nuevas compilaciones de instrucción.
167 Database Mirroring State Change Se produce cuando cambia el estado de una base de datos reflejada.
168 Showplan XML For Query Compile Se produce cuando se compila una instrucción SQL. Muestra todos los datos de tiempo de compilación. La Binary columna de este evento contiene el plan de presentación codificado. Use SQL Server Profiler para abrir el seguimiento y ver el plan de presentación.
169 Showplan All For Query Compile Se produce cuando se compila una instrucción SQL. Muestra datos completos en tiempo de compilación. Utilice este evento para identificar los operadores de plan de presentación.
170 Audit Server Scope GDR Event Indica que se ha producido un evento de concesión, denegación o revocación para los permisos en el ámbito del servidor, como la creación de un inicio de sesión.
171 Audit Server Object GDR Event Indica que se ha producido un evento de concesión, denegación o revocación para un objeto de esquema, como una tabla o función.
172 Audit Database Object GDR Event Indica que se ha producido un evento de concesión, denegación o revocación para objetos de base de datos, como ensamblados y esquemas.
173 Audit Server Operation Event Se produce cuando se utilizan operaciones de auditoría de seguridad, como la modificación de la configuración, los recursos, el acceso externo o la autorización.
175 Audit Server Alter Trace Event Se produce cuando una instrucción busca el permiso ALTER TRACE.
176 Audit Server Object Management Event Se produce al crear, modificar o quitar objetos de servidor.
177 Audit Server Principal Management Event Se produce al crear, modificar o quitar entidades de seguridad de servidor.
178 Audit Database Operation Event Se produce cuando tienen lugar operaciones en una base de datos, como un punto de comprobación o una notificación de consulta de suscripción.
180 Audit Database Object Access Event Se produce cuando se tiene acceso a objetos de base de datos, como esquemas.
181 TM: Begin Tran starting Se produce cuando se inicia una BEGIN TRANSACTION solicitud.
182 TM: Begin Tran completed Se produce cuando se completa una BEGIN TRANSACTION solicitud.
183 TM: Promote Tran starting Se produce cuando se inicia una PROMOTE TRANSACTION solicitud.
184 TM: Promote Tran completed Se produce cuando se completa una PROMOTE TRANSACTION solicitud.
185 TM: Commit Tran starting Se produce cuando se inicia una COMMIT TRANSACTION solicitud.
186 TM: Commit Tran completed Se produce cuando se completa una COMMIT TRANSACTION solicitud.
187 TM: Rollback Tran starting Se produce cuando se inicia una ROLLBACK TRANSACTION solicitud.
188 TM: Rollback Tran completed Se produce cuando se completa una ROLLBACK TRANSACTION solicitud.
189 Lock:Timeout (timeout > 0) Se produce cuando se agota el tiempo de espera para una solicitud de bloqueo en un recurso, como una página.
190 Progress Report: Online Index Operation Informa del progreso de una operación de generación de índice en línea mientras está en ejecución.
191 TM: Save Tran starting Se produce cuando se inicia una SAVE TRANSACTION solicitud.
192 TM: Save Tran completed Se produce cuando se completa una SAVE TRANSACTION solicitud.
193 Background Job Error Se produce cuando un trabajo en segundo plano finaliza de forma anómala.
194 OLEDB Provider Information Se produce cuando una consulta distribuida se ejecuta y recopila información correspondiente a la conexión del proveedor.
195 Mount Tape Se produce cuando se recibe una solicitud de montaje de cinta.
196 Assembly Load Se produce cuando se ejecuta una solicitud para cargar un ensamblado CLR.
197 Reserved
198 XQuery Static Type Se produce cuando se ejecuta una expresión XQuery. Esta clase de eventos proporciona el tipo estático de la expresión XQuery.
199 QN: subscription Se produce cuando no se puede suscribir un registro de consultas. La TextData columna contiene información sobre el evento.
200 QN: parameter table La información sobre las suscripciones activas se almacena en tablas de parámetros internos. Esta clase de evento se produce al crear o eliminar una tabla de parámetros. Normalmente, estas tablas se crean o eliminan al reiniciar la base de datos. La TextData columna contiene información sobre el evento.
201 QN: template Una plantilla de consulta representa una clase de consultas de suscripción. Normalmente, las consultas de la misma clase son idénticas, excepto por los valores de los parámetros. Esta clase de eventos se produce cuando una nueva solicitud de suscripción entra en una clase ya existente de (Match), una nueva clase (Create) o una Drop clase , que indica la limpieza de plantillas para las clases de consulta sin suscripciones activas. La TextData columna contiene información sobre el evento.
202 QN: dynamics Hace un seguimiento de las actividades internas de las notificaciones de consulta. La TextData columna contiene información sobre el evento.
212 Bitmap Warning Indica que los filtros de mapas de bits se han deshabilitado en una consulta.
213 Database Suspect Data Page Indica cuándo se agrega una página a la suspect_pages tabla de msdb.
214 CPU threshold exceeded Indica cuándo el regulador de recursos detecta que una consulta ha superado el valor de umbral de CPU (REQUEST_MAX_CPU_TIME_SEC).
215 PreConnect:Starting Indica cuándo se ha iniciado la ejecución de un desencadenador LOGON o de una función clasificadora del regulador de recursos.
216 PreConnect:Completed Indica cuándo se ha conpletado la ejecución de un desencadenador LOGON o de una función clasificadora del regulador de recursos.
217 Plan Guide Successful Indica que el Motor de base de datos generó correctamente un plan de ejecución para una consulta o lote que contenía una guía de plan.
218 Plan Guide Unsuccessful Indica que el Motor de base de datos no pudo generar un plan de ejecución para una consulta o lote que contenía una guía de plan. El Motor de base de datos intentó generar un plan de ejecución para esta consulta o lote sin aplicar la guía de plan. Una guía de plan no válida podría ser la causa de este problema. Puede validar la guía de plan mediante la función del sys.fn_validate_plan_guide sistema.
235 Audit Fulltext

[ @columnid = ] columnid

Identificador de la columna que se va a agregar para el evento. @columnid es int, sin valor predeterminado.

En la tabla siguiente se muestra una lista de las columnas que pueden agregarse para un evento.

Column number Nombre de la columna Descripción
1 TextData Valor de texto que depende de la clase de eventos capturada en el seguimiento.
2 BinaryData Valor binario que depende de la clase de eventos que se captura en el seguimiento.
3 DatabaseID Identificador de la base de datos especificada por la instrucción USE database o la base de datos predeterminada si no se emite ninguna instrucción USE database para una conexión determinada.

El valor para una base de datos se puede determinar mediante la función DB_ID.
4 TransactionID Id. de la transacción asignado por el sistema.
5 LineNumber Contiene el número de la línea que incluye el error. Para los eventos que implican instrucciones Transact-SQL, como SP:StmtStarting, contiene LineNumber el número de línea de la instrucción en el procedimiento almacenado o lote.
6 NTUserName Nombre del usuario de Windows.
7 NTDomainName Dominio de Windows al que pertenece el usuario.
8 HostName Nombre del equipo cliente que ha originado la solicitud.
9 ClientProcessID Id. asignado por el equipo cliente al proceso en el que se ejecuta la aplicación cliente.
10 ApplicationName Nombre de la aplicación cliente que creó la conexión a una instancia de SQL Server. Esta columna se rellena con los valores que pasa la aplicación, en lugar de con el nombre que se muestra para el programa.
11 LoginName Nombre de inicio de sesión de SQL Server del cliente.
12 SPID Id. de proceso de servidor asignado por SQL Server al proceso asociado al cliente.
13 Duration Cantidad de tiempo transcurrido (en microsegundos) que tarda el evento. El evento no rellena Hash Warning esta columna de datos.
14 StartTime Hora a la que se inició el evento, si está disponible.
15 EndTime Hora de finalización del evento. Esta columna no se rellena para iniciar clases de eventos, como SQL:BatchStarting o SP:Starting. El evento tampoco lo Hash Warning rellena.
16 Reads Número de lecturas lógicas de disco que realiza el servidor en nombre del evento. El evento no rellena Lock:Released esta columna.
17 Writes Número de escrituras físicas de disco que realiza el servidor en nombre del evento.
18 CPU Cantidad de tiempo de CPU (en milisegundos) que utiliza el evento.
19 Permissions Representa el mapa de bits de permisos; utilizado por Auditoría de seguridad.
20 Severity Nivel de gravedad de una excepción.
21 EventSubClass Tipo de la subclase de eventos. Esta columna de datos no se rellena para todas las clases de eventos.
22 ObjectID Identificador del objeto asignado por el sistema.
23 Success Utilización de permisos correcta; se utiliza para la auditoría.

1 = correcto
0 = error
24 IndexID Id. del índice del objeto afectado por el evento. Para determinar el identificador de índice de un objeto, use la indid columna de la tabla del sysindexes sistema.
25 IntegerData Valor entero que depende de la clase de eventos capturada en el seguimiento.
26 ServerName Nombre de la instancia de SQL Server, nombredeservidor o nombreDeServidor\nombreDeInstancia, que se realiza el seguimiento.
27 EventClass Tipo de clase de evento que se está registrando.
28 ObjectType Tipo de objeto, por ejemplo: tabla, función o procedimiento almacenado.
29 NestLevel Nivel de anidamiento en el que se ejecuta este procedimiento almacenado. Consulte @@NESTLEVEL.
30 State Estado del servidor, si se produce un error.
31 Error Número de error.
32 Mode Modo de bloqueo del bloqueo adquirido. El evento no rellena Lock:Released esta columna.
33 Handle Identificador del objeto al que se hace referencia en el evento.
34 ObjectName Nombre del objeto al que se obtiene acceso.
35 DatabaseName Nombre de la base de datos especificada en la instrucción USE database .
36 FileName Nombre lógico del nombre de archivo modificado.
37 OwnerName Nombre del propietario del objeto al que se hace referencia.
38 RoleName Nombre de la base de datos o del rol de todo el servidor que es el destino de una instrucción.
39 TargetUserName Nombre de usuario del destino de alguna acción.
40 DBUserName Nombre de usuario de la base de datos de SQL Server del cliente.
41 LoginSid SID (número de identificación de seguridad) del usuario que ha iniciado la sesión.
42 TargetLoginName Nombre de inicio de sesión del destino de alguna acción.
43 TargetLoginSid SID del inicio de sesión que es el destino de alguna acción.
44 ColumnPermissions Estado de los permisos de nivel de columna; utilizado por Auditoría de seguridad.
45 LinkedServerName Nombre del servidor vinculado.
46 ProviderName Nombre del proveedor OLE DB.
47 MethodName Nombre del método OLE DB.
48 RowCounts Número de filas del lote.
49 RequestID Identificador de la solicitud que contiene la instrucción.
50 XactSequence Token que describe la transacción actual.
51 EventSequence Número de secuencia de este evento.
52 BigintData1 valor bigint , que depende de la clase de eventos capturada en el seguimiento.
53 BigintData2 valor bigint , que depende de la clase de eventos capturada en el seguimiento.
54 GUID Valor GUID que depende de la clase de evento capturado en el seguimiento.
55 IntegerData2 Valor entero, que depende de la clase de evento capturada en el seguimiento.
56 ObjectID2 Id. de la entidad u objeto relacionado si está disponible.
57 Type Valor entero, que depende de la clase de evento capturada en el seguimiento.
58 OwnerID Tipo de objeto propietario de un bloqueo. Solo para eventos de bloqueo.
59 ParentName Nombre del esquema en el que se encuentra el objeto.
60 IsSystem Indica si el evento ha ocurrido en un proceso del sistema o en un proceso de usuario.

1 = sistema
0 = usuario.
61 Offset Desplazamiento inicial de la instrucción en el procedimiento almacenado o lote.
62 SourceDatabaseID Id. de la base de datos en la que se encuentra el origen del objeto.
63 SqlHandle Hash de 64 bits basado en el texto de una consulta ad hoc o la base de datos y el identificador de objeto de un objeto SQL. Este valor se puede pasar a sys.dm_exec_sql_text() para recuperar el texto SQL asociado.
64 SessionLoginName Nombre de inicio de sesión del usuario que originó la sesión. Por ejemplo, si se conecta a SQL Server mediante Login1 y ejecuta una instrucción como Login2, SessionLoginName muestra Login1, mientras LoginName que muestra Login2. En esta columna de datos se muestran los inicios de sesión de SQL Server y de Windows.

[ @on = ] on

Especifica si habilite (1) o deshabilite (0) el evento. @on es bit, sin valor predeterminado.

Si @on se establece 1en y @columnid es NULL, el evento se establece ON en y se borran todas las columnas. Si @columnid no es null, la columna se establece en ON para ese evento.

Si @on se establece 0en y @columnid es NULL, el evento se activa OFF y se borran todas las columnas. Si @columnid no es null, la columna está desactivada.

En esta tabla se muestra la interacción entre @on y @columnid.

@on @columnid Resultado
ON (1) NULL El evento está activado.

Se borran todas las columnas.
NOT NULL La columna está activada para el evento especificado.
OFF (0) NULL El evento está desactivado.

Se borran todas las columnas.
NOT NULL La columna está desactivada para el evento especificado.

Valores de código de retorno

En la tabla siguiente se describen los valores de código que se pueden obtener después de completar el procedimiento almacenado.

Código devuelto Descripción
0 Ningún error.
1 Error desconocido.
2 El seguimiento está actualmente en ejecución. Si se cambia el seguimiento en este momento, se producirá un error.
3 El evento especificado no es válido. Es posible que el evento no exista o no sea adecuado para el procedimiento de almacén.
4 La columna especificada no es válida.
9 El identificador de seguimiento especificado no es válido.
11 La columna especificada se usa internamente y no se puede quitar.
13 Memoria insuficiente Se devuelve cuando no hay suficiente memoria para realizar la acción especificada.
16 La función no es válida para este seguimiento.

Comentarios

sp_trace_setevent realiza muchas de las acciones ejecutadas anteriormente por procedimientos almacenados extendidos disponibles en versiones anteriores de SQL Server. Use sp_trace_setevent en lugar de:

  • xp_trace_addnewqueue
  • xp_trace_eventclassrequired
  • xp_trace_seteventclassrequired

Los usuarios deben ejecutarse sp_trace_setevent para cada columna agregada para cada evento. Durante cada ejecución, si @on se establece 1en , sp_trace_setevent agrega el evento especificado a la lista de eventos del seguimiento. Si @on se establece 0en , sp_trace_setevent quita el evento especificado de la lista.

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 del uso de procedimientos almacenados de seguimiento, vea Crear un seguimiento.

Permisos

Requiere el permiso ALTER TRACE.

Contenido relacionado