Partilhar via


sp_audit_write (Transact-SQL)

Aplica-se a: SQL Server

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.

Convenções de sintaxe de Transact-SQL

Sintaxe

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

Argumentos

@user_defined_event_id [ = ] user_defined_event_id

Um parâmetro definido pelo usuário e registrado na user_defined_event_id coluna do log de auditoria. @user_defined_event_id é smallint.

@succeeded [ = ] conseguiu

Um parâmetro passado por usuário para indicar se o evento teve êxito ou não. Esse valor aparece na succeeded coluna do log de auditoria. @succeeded é pouco.

@user_defined_information [ = ] N'user_defined_information'

O texto definido pelo usuário e registrado na nova user_defined_event_id coluna do log de auditoria. @user_defined_information é nvarchar(4000).

Valores do código de retorno

0 (sucesso) ou 1 (falha).

As falhas são causadas por parâmetros de entrada incorretos ou falha ao gravar 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úblico .

Exemplos

R. Criar um evento de auditoria definido pelo usuário com texto informativo

O exemplo a seguir cria um evento de auditoria com um @user_defined_event_id valor de 27, o @succeeded valor de 0, e inclui texto informativo opcional.

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

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

O exemplo a seguir cria um evento de auditoria com um @user_defined_event_id valor de 27, o @succeeded valor de e não inclui texto informativo opcional ou os nomes de 0parâmetro opcionais.

EXEC sp_audit_write 27, 0;