Sdílet prostřednictvím

sp_audit_write (Transact-SQL)

  • Článek

platí pro:SQL Server

Přidá událost auditu definovanou uživatelem do USER_DEFINED_AUDIT_GROUP. Pokud USER_DEFINED_AUDIT_GROUP není povolené, sp_audit_write se ignoruje.

Transact-SQL konvence syntaxe

Syntax

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

Argumenty

Důležitý

Argumenty rozšířených uložených procedur musí být zadány v určitém pořadí, jak je popsáno v části Syntaxe. Pokud jsou parametry zadány mimo pořadí, dojde k chybové zprávě.

[ @user_defined_event_id = ] user_defined_event_id

Parametr definovaný uživatelem a zaznamenaný ve sloupci user_defined_event_id protokolu auditu. @user_defined_event_id je malý.

[ @succeeded = ] úspěšně

Parametr předaný uživatelem, který označuje, jestli byla událost úspěšná nebo ne. Tato hodnota se zobrazí ve sloupci succeeded protokolu auditu. @succeeded je bitová.

[ @user_defined_information = ] N'user_defined_information'

Text definovaný uživatelem a zaznamenaný v novém user_defined_event_id sloupci protokolu auditu. @user_defined_information je nvarchar(4000).

Návratové hodnoty kódu

0 (úspěch) nebo 1 (selhání).

Selhání jsou způsobená nesprávnými vstupními parametry nebo selháním zápisu do cílového protokolu auditu.

Poznámky

Když se USER_DEFINED_AUDIT_GROUP přidá do specifikace auditu serveru nebo specifikace auditu databáze, událost aktivovaná sp_audit_write se zahrne do protokolu auditu.

Dovolení

Vyžaduje členství v roli databáze veřejné.

Příklady

A. Vytvoření události auditu definované uživatelem s informačním textem

Následující příklad vytvoří událost auditu s @user_defined_event_id hodnotou 27, @succeeded hodnotu 0a obsahuje volitelný informační text.

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

B. Vytvoření události auditu definované uživatelem bez informačního textu

Následující příklad vytvoří událost auditu s @user_defined_event_id hodnotou 27, @succeeded hodnotu 0a nezahrnuje volitelný informační text nebo volitelné názvy parametrů.

EXEC sp_audit_write 27, 0;

Související obsah