Udostępnij za pośrednictwem

sp_audit_write (Transact-SQL)

  • Artykuł

Dotyczy:programu SQL Server

Dodaje zdarzenie inspekcji zdefiniowane przez użytkownika do USER_DEFINED_AUDIT_GROUP. Jeśli USER_DEFINED_AUDIT_GROUP nie jest włączona, sp_audit_write jest ignorowana.

Transact-SQL konwencje składni

Składnia

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

Argumenty

Ważny

Argumenty dla rozszerzonych procedur składowanych należy wprowadzić w określonej kolejności zgodnie z opisem w sekcji składni. Jeśli parametry są wprowadzane poza kolejnością, wystąpi komunikat o błędzie.

[ @user_defined_event_id = ] user_defined_event_id

Parametr zdefiniowany przez użytkownika i zarejestrowany w kolumnie user_defined_event_id dziennika inspekcji. @user_defined_event_id jest smallint.

[ @succeeded = ] powiodło się

Parametr przekazany przez użytkownika, aby wskazać, czy zdarzenie zakończyło się pomyślnie, czy nie. Ta wartość jest wyświetlana w kolumnie succeeded dziennika inspekcji. @succeeded jest bitowym.

[ @user_defined_information = ] N'user_defined_information'

Tekst zdefiniowany przez użytkownika i zarejestrowany w nowej kolumnie user_defined_event_id dziennika inspekcji. @user_defined_information jest nvarchar(4000).

Zwracanie wartości kodu

0 (powodzenie) lub 1 (niepowodzenie).

Błędy są spowodowane nieprawidłowymi parametrami wejściowymi lub niepowodzeniem zapisu w docelowym dzienniku inspekcji.

Uwagi

Po dodaniu USER_DEFINED_AUDIT_GROUP do specyfikacji inspekcji serwera lub specyfikacji inspekcji bazy danych zdarzenie wyzwalane przez sp_audit_write jest uwzględniane w dzienniku inspekcji.

Uprawnienia

Wymaga członkostwa w roli bazy danych publicznej.

Przykłady

A. Tworzenie zdarzenia inspekcji zdefiniowanego przez użytkownika z tekstem informacyjnym

Poniższy przykład tworzy zdarzenie inspekcji z wartością @user_defined_event_id27, @succeeded wartość 0i zawiera opcjonalny tekst informacyjny.

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

B. Tworzenie zdarzenia inspekcji zdefiniowanego przez użytkownika bez tekstu informacyjnego

Poniższy przykład tworzy zdarzenie inspekcji z wartością @user_defined_event_id27, @succeeded wartość 0i nie zawiera opcjonalnego tekstu informacyjnego ani opcjonalnych nazw parametrów.

EXEC sp_audit_write 27, 0;

Powiązana zawartość