sp_audit_write (Transact-SQL)
gäller för:
SQL Server
Lägger till en användardefinierad granskningshändelse i USER_DEFINED_AUDIT_GROUP. Om USER_DEFINED_AUDIT_GROUP inte är aktiverat ignoreras sp_audit_write.
Transact-SQL syntaxkonventioner
Syntax
sp_audit_write [ @user_defined_event_id = ] user_defined_event_id
[ , [ @succeeded = ] succeeded ]
[ , [ @user_defined_information = ] N'user_defined_information' ]
[ ; ]
Argument
Viktig
Argument för utökade lagrade procedurer måste anges i den specifika ordning som beskrivs i avsnittet Syntax. Om parametrarna anges i fel ordning visas ett felmeddelande.
[ @user_defined_event_id = ] user_defined_event_id
En parameter som definieras av användaren och registreras i kolumnen user_defined_event_id i granskningsloggen.
@user_defined_event_id är smallint.
[ @succeeded = ] lyckades
En parameter som skickas av användaren för att ange om händelsen lyckades eller inte. Det här värdet visas i kolumnen succeeded i granskningsloggen.
@succeeded är bit.
[ @user_defined_information = ] N'user_defined_information'
Texten som definieras av användaren och registreras i den nya user_defined_event_id kolumnen i granskningsloggen.
@user_defined_information är nvarchar(4000).
Returnera kodvärden
0 (lyckades) eller 1 (fel).
Fel orsakas av felaktiga indataparametrar eller att det inte går att skriva till målgranskningsloggen.
Anmärkningar
När USER_DEFINED_AUDIT_GROUP läggs till i antingen en servergranskningsspecifikation eller en databasgranskningsspecifikation inkluderas händelsen som utlöses av sp_audit_write i granskningsloggen.
Behörigheter
Kräver medlemskap i den offentliga databasrollen.
Exempel
A. Skapa en användardefinierad granskningshändelse med informationstext
I följande exempel skapas en granskningshändelse med värdet @user_defined_event_id27, @succeeded värdet för 0och innehåller valfri informationstext.
EXEC sp_audit_write @user_defined_event_id = 27,
@succeeded = 0,
@user_defined_information = N'Access to a monitored object.';
B. Skapa en användardefinierad granskningshändelse utan informationstext
I följande exempel skapas en granskningshändelse med värdet @user_defined_event_id27, @succeeded värdet för 0och innehåller inte valfri informationstext eller valfria parameternamn.
EXEC sp_audit_write 27, 0;