sp_audit_write (Transact-SQL)

Artigo
06/18/2013

Adiciona um evento de auditoria definido pelo usuário ao USER_DEFINED_AUDIT_GROUP. Se USER_DEFINED_AUDIT_GROUP não estiver habilitado, sp_audit_write será ignorado.

Ícone de vínculo de tópico Convenções da sintaxe Transact-SQL

Sintaxe

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

Argumentos

@user_defined_event_id
Um parâmetro definido pelo usuário e registrado na coluna user_defined_event_id do log de auditoria. @user\_defined\_event\_id é do tipo smallint.
@succeeded
Um parâmetro passado por usuário para indicar se o evento teve êxito ou não. Isso aparece na coluna Êxito do log de auditoria. @succeeded é bit.
@user_defined_information
É o texto definido pelo usuário e registrado na coluna user_defined_event_id do log de auditoria. @user\_defined\_information é nvarchar(4000).

Valores de código de retorno

0 (êxito) ou 1 (falha)

As falhas são provocadas por parâmetros de entrada incorretos ou erros de gravação no log de auditoria de destino.

Comentários

Quando o USER_DEFINED_AUDIT_GROUP é adicionado a uma especificação de auditoria de servidor ou a uma especificação de auditoria de banco de dados, o evento disparado por sp_audit_write é incluído no log de auditoria.

Permissões

Requer associação na função de banco de dados pública.

Exemplos

A.Criando um evento de auditoria definido pelo usuário com texto informativo

O exemplo a seguir cria um evento de auditoria com a id 27, o valor de êxito igual a 0 e o texto informativo opcional incluído.

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

B.Criando um evento de auditoria definido pelo usuário sem texto informativo

O exemplo a seguir cria um evento de auditoria com a id 27, o valor de êxito igual a 0 e não inclui o texto informativo opcional ou os nomes dos parâmetros opcionais.