Delen via


sp_audit_write (Transact-SQL)

van toepassing op:SQL Server-

Voegt een door de gebruiker gedefinieerde auditgebeurtenis toe aan USER_DEFINED_AUDIT_GROUP. Als USER_DEFINED_AUDIT_GROUP niet is ingeschakeld, wordt sp_audit_write genegeerd.

Transact-SQL syntaxisconventies

Syntaxis

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

Argumenten

Belangrijk

Argumenten voor uitgebreide opgeslagen procedures moeten worden ingevoerd in de specifieke volgorde, zoals beschreven in de sectie Syntaxis. Als de parameters niet in de volgorde zijn ingevoerd, treedt er een foutbericht op.

[ @user_defined_event_id = ] user_defined_event_id

Een parameter die is gedefinieerd door de gebruiker en vastgelegd in de kolom user_defined_event_id van het auditlogboek. @user_defined_event_id is kleine.

[ @succeeded = ] geslaagd

Een parameter die door de gebruiker is doorgegeven om aan te geven of de gebeurtenis is geslaagd of niet. Deze waarde wordt weergegeven in de kolom succeeded van het auditlogboek. @succeeded is bit.

[ @user_defined_information = ] N'user_defined_information'

De tekst die is gedefinieerd door de gebruiker en vastgelegd in de nieuwe kolom user_defined_event_id van het auditlogboek. @user_defined_information is nvarchar(4000).

Codewaarden retourneren

0 (geslaagd) of 1 (mislukt).

Fouten worden veroorzaakt door onjuiste invoerparameters of fouten bij het schrijven naar het doelcontrolelogboek.

Opmerkingen

Wanneer de USER_DEFINED_AUDIT_GROUP wordt toegevoegd aan een servercontrolespecificatie of een databasecontrolespecificatie, wordt de gebeurtenis die door sp_audit_write wordt geactiveerd, opgenomen in het auditlogboek.

Machtigingen

Vereist lidmaatschap van de openbare databaserol.

Voorbeelden

Een. Een door de gebruiker gedefinieerde controlegebeurtenis maken met informatieve tekst

In het volgende voorbeeld wordt een controlegebeurtenis gemaakt met een @user_defined_event_id waarde van 27, de @succeeded waarde van 0en bevat optionele informatieve tekst.

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

B. Een door de gebruiker gedefinieerde controlegebeurtenis maken zonder informatieve tekst

In het volgende voorbeeld wordt een controlegebeurtenis gemaakt met een @user_defined_event_id waarde van 27, de @succeeded waarde van 0en bevat geen optionele informatieve tekst of de optionele parameternamen.

EXEC sp_audit_write 27, 0;