sp_audit_write (Transact-SQL)

Artículo
06/18/2013

Agrega un evento de auditoría definido por el usuario a USER_DEFINED_AUDIT_GROUP. Si USER_DEFINED_AUDIT_GROUP no está habilitado, se ignora sp_audit_write.

Icono de vínculo a temas Convenciones de sintaxis de Transact-SQL

Sintaxis

sp_audit_write [ @user_defined_event_id =  ] user_defined_event_id , 
        [ @succeeded =  succeeded 
    [ , [ @user_defined_information =  ] 'user_defined_information' ] 
    [ ; ]

Argumentos

@user_defined_event_id
Parámetro definido por el usuario y registrado en la columna user_defined_event_id del registro de auditoría. @user\_defined\_event\_id es de tipo smallint.
@succeeded
Parámetro pasado por el usuario para indicar si el evento se realizó correctamente o no. Aparece en la columna "succeeded" del registro de auditoría. @succeeded es de tipo bit.
@user_defined_information
Es el texto definido por el usuario y registrado en la nueva columna user_defined_event_id column del registro de auditoría. @user\_defined\_information es de tipo nvarchar(4000).

Valores del código de retorno

0 (correcto) o 1 (error)

Los errores los producen parámetros de entrada incorrectos o errores al escribir en el registro de auditoría de destino.

Comentarios

Cuando USER_DEFINED_AUDIT_GROUP se agregue a una especificación de auditoría de servidor o a una especificación de auditoría de base de datos, el evento desencadenado por sp_audit_write se incluirá en el registro de auditoría.

Permisos

Debe pertenecer al rol de base de datos public.

Ejemplos

A.Crear un evento de auditoría definido por el usuario con texto informativo

En el ejemplo siguiente se crea un evento de auditoría con el identificador 27, el valor "succeeded" 0 y la inclusión de texto informativo opcional.

EXEC sp_audit_write @user_defined_event_id =  27 , 
              @succeeded =  0 
            , @user_defined_information = N'Access to a monitored object.' ;

B.Crear un evento de auditoría definido por el usuario sin texto informativo

En el ejemplo siguiente se crea un evento de auditoría con identificador 27, el valor de "succeeded" 0 y sin incluir texto informativo opcional ni nombres de parámetro opcionales.