sp_audit_write (Transact-SQL)sp_audit_write (Transact-SQL)

SI APPLICA A: sìSQL Server noAzure SQL Database noAzure Synapse Analytics (SQL DW) noParallel Data Warehouse APPLIES TO: yesSQL Server noAzure SQL Database noAzure Synapse Analytics (SQL DW) noParallel Data Warehouse

Aggiunge un evento di controllo definito dall'utente al USER_DEFINED_AUDIT_GROUP.Adds a user-defined audit event to the USER_DEFINED_AUDIT_GROUP. Se USER_DEFINED_AUDIT_GROUP non è abilitato, sp_audit_write viene ignorato.If USER_DEFINED_AUDIT_GROUP is not enabled, sp_audit_write is ignored.

Icona di collegamento a un argomento Convenzioni della sintassi Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SintassiSyntax

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

ArgomentiArguments

[ @user_defined_event_id = ] user_defined_event_id
Parametro definito dall'utente e registrato nella colonna user_defined_event_id del log di controllo.A parameter defined by the user and recorded in the user_defined_event_id column of the audit log. user_defined_event_id è di tipo smallint. * @*@user_defined_event_id is type smallint.

[ @succeeded = ] succeeded
Parametro passato dall'utente per indicare se l'evento ha avuto esito positivo o meno.A parameter passed by user to indicate whether the event was successful or not. Viene visualizzato nella colonna del log di controllo indicante l'esito positivo.This appears in the succeeded column of the audit log. @succeededè di bit.@succeeded is bit.

[ @user_defined_information = ] 'user_defined_information'
Testo definito dall'utente e registrato nella nuova colonna user_defined_event_id del log di controllo.Is the text defined by the user and recorded in the new user_defined_event_id column of the audit log. @user_defined_informationè di tipo nvarchar (4000).@user_defined_information is nvarchar(4000).

Valori del codice restituitoReturn Code Values

0 (operazione completata) o 1 (operazione non riuscita)0 (success) or 1 (failure)

Gli errori sono causati da parametri di input errati o da problemi di scrittura nel log di controllo di destinazione.Failures are caused by incorrect input parameters or failure to write to the target audit log.

OsservazioniRemarks

Quando il USER_DEFINED_AUDIT_GROUP viene aggiunto a una specifica del controllo del server o a una specifica del controllo del database, l'evento attivato da sp_audit_write verrà incluso nel log di controllo.When the USER_DEFINED_AUDIT_GROUP is added to either a server audit specification or a database audit specification, the event triggered by sp_audit_write will be included in the audit log.

AutorizzazioniPermissions

È richiesta l'appartenenza al ruolo di database public .Requires membership in the public database role.

EsempiExamples

R.A. Creazione di un evento di controllo definito dall'utente con testo informativoCreating a user-defined audit event with informational text

Nell'esempio seguente viene creato un evento di controllo con ID 27, valore di esito positivo pari a 0 e testo informativo facoltativo incluso.The following example creates an audit event with the id 27, the succeeded value of 0, and included optional informational text.

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

B.B. Creazione di un evento di controllo definito dall'utente senza testo informativoCreating a user-defined audit event without informational text

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.The following example creates an audit event with the id 27, the succeeded value of 0, and does not include optional informational text or the optional parameter names.

EXEC sp_audit_write 27, 0;  
  

Vedere ancheSee Also

Stored procedure di sicurezza ()Transact-SQL Security Stored Procedures (Transact-SQL)
sys.server_principals (Transact-SQL) sys.server_principals (Transact-SQL)
sp_addrole ()Transact-SQL sp_addrole (Transact-SQL)
CREAZIONE di un utente (Transact-SQL) CREATE USER (Transact-SQL)
sp_dropuser ()Transact-SQL sp_dropuser (Transact-SQL)
sp_grantdbaccess ()Transact-SQL sp_grantdbaccess (Transact-SQL)
sp_grantlogin ()Transact-SQL sp_grantlogin (Transact-SQL)
Stored procedure di sistema (Transact-SQL)System Stored Procedures (Transact-SQL)