Condividi tramite


sp_audit_write (Transact-SQL)

Si applica a: SQL Server

Aggiunge un evento di controllo definito dall'utente a USER_DEFINED_AUDIT_GROUP. Se USER_DEFINED_AUDIT_GROUP non è abilitato, sp_audit_write viene ignorato.

Convenzioni relative alla sintassi Transact-SQL

Sintassi

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

Argomenti

[ @user_defined_event_id = ] user_defined_event_id

Parametro definito dall'utente e registrato nella user_defined_event_id colonna del log di controllo. @user_defined_event_id è smallint.

[ @succeeded = ] riuscito

Parametro passato dall'utente per indicare se l'evento ha avuto esito positivo o meno. Questo valore viene visualizzato nella succeeded colonna del log di controllo. @succeeded è bit.

[ @user_defined_information = ] N'user_defined_information'

Testo definito dall'utente e registrato nella nuova user_defined_event_id colonna del log di controllo. @user_defined_information è nvarchar(4000).

Valori del codice restituito

0 (esito positivo) o 1 (errore).

Gli errori sono causati da parametri di input non corretti o da errori di scrittura nel log di controllo di destinazione.

Osservazioni:

USER_DEFINED_AUDIT_GROUP Quando viene aggiunto a una specifica di controllo del server o a una specifica di controllo del database, l'evento attivato da sp_audit_write viene incluso nel log di controllo.

Autorizzazioni

Richiede l'appartenenza al ruolo del database pubblico .

Esempi

R. Creare un evento di controllo definito dall'utente con testo informativo

Nell'esempio seguente viene creato un evento di controllo con un @user_defined_event_id valore , 27il @succeeded valore di 0e include testo informativo facoltativo.

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

B. Creare un evento di controllo definito dall'utente senza testo informativo

Nell'esempio seguente viene creato un evento di controllo con un @user_defined_event_id valore , 27il @succeeded valore di 0e non include il testo informativo facoltativo o i nomi dei parametri facoltativi.

EXEC sp_audit_write 27, 0;