sp_audit_write (Transact-SQL)

Articolo
06/18/2013

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

Icona di collegamento a un argomento Convenzioni della sintassi Transact-SQL

Sintassi

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

Argomenti

@user_defined_event_id
Parametro definito dall'utente e registrato nella colonna user_defined_event_id del log di controllo. @user\_defined\_event\_id è di tipo smallint.
@succeeded
Parametro passato dall'utente per indicare se l'evento ha avuto esito positivo o meno. Viene visualizzato nella colonna del log di controllo indicante l'esito positivo. @succeeded è di tipo bit.
@user_defined_information
Testo definito dall'utente e registrato nella nuova colonna user_defined_event_id del log di controllo. @user\_defined\_information è di tipo nvarchar(4000).

Valori di codice restituiti

0 (esito positivo) o 1 (esito negativo)

Gli errori sono causati da parametri di input errati o da problemi di scrittura nel log di controllo di destinazione.

Osservazioni

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

Autorizzazioni

È richiesta l'appartenenza al ruolo di database public.

Esempi

A.Creazione di un evento di controllo definito dall'utente con testo informativo

Nell'esempio seguente viene creato un evento di controllo con ID 27, valore di esito positivo pari a 0 e testo informativo facoltativo incluso.

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

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

Nell'esempio seguente viene creato un evento di controllo con ID 27, valore di esito positivo pari a 0 e senza testo informativo o nomi di parametri facoltativi.