Udostępnij za pośrednictwem

  • Artykuł

sp_altermessage (Transact-SQL)

Zmienia stan wiadomości przez użytkownika w wystąpienie z SQL Server Database Engine. Zdefiniowane przez użytkownika wiadomości można przeglądać za pomocą sys.messages Służy do wyświetlania katalogu.

Topic link iconKonwencje składni języka Transact-SQL

sp_altermessage [ @message_id = ] message_number   ,[ @parameter = ]'write_to_log'
      ,[ @parameter_value = ]'value'

Argumenty

  • [@message_id = ] message_number
    Is the error number of the message to alter from sys.messages.message_number is int with no default value.

  • [ @parameter = ] **'**write_to_log'
    Is used with @parameter_value to indicate that the message is to be written to the Microsoft Windows application log.write_to_log is sysname with no default value.write_to_log must be set to WITH_LOG or NULL.Jeśli write_to_log jest zestaw WITH_LOG lub wartość NULL, a wartość @ parameter_value is true, wiadomości są zapisywane w dzienniku aplikacji systemu Windows. Jeśli write_to_log jest ustawiona na WITH_LOG lub wartość NULL, a wartość @ parameter_value is false, wiadomości nie są zawsze zapisywane w dzienniku aplikacji systemu Windows, ale mogą być zapisane w zależności od tego, w jaki sposób podniesiono błędu. Jeśli write_to_log jest określony, wartość @ parameter_value musi być także określona.

    Uwaga

    Jeśli wiadomość jest napisana w dzienniku aplikacji systemu Windows, są również zapisywane na Database Engine plik dziennik błędów.

  • [ @parameter_value = ]**'**value'
    Is used with @parameter to indicate that the error is to be written to the Microsoft Windows application log.value is varchar(5), with no default value.Jeśli true, błąd są zawsze zapisywane w dzienniku aplikacji systemu Windows. Jeśli false, błędu nie zawsze jest zapisywane w dzienniku aplikacji systemu Windows, ale mogą być zapisane w zależności od tego, w jaki sposób podniesiono błędu. Jeśli value jest określony, write_to_log dla Parametr @ musi być także określona.

Wartości kodów powrotnych

0 (sukces) lub 1 (brak)

Zestawy wyników

None

Remarks

Efekt sp_altermessage jest podobny do parametru RAISERROR WITH dziennik, z wyjątkiem tej z opcją WITH_LOGsp_altermessage zmienia zachowanie istniejący komunikat logowania.Jeśli wiadomość została zmieniona się WITH_LOG, są zawsze zapisywane w dzienniku aplikacji systemu Windows, niezależnie od tego, w jaki sposób użytkownik wywoła błąd.Nawet po wykonaniu instrukcji RAISERROR bez opcji WITH_LOG błędu są zapisywane w dzienniku aplikacji systemu Windows.

Komunikaty systemowe nie mogą być modyfikowane za pomocą sp_altermessage.

Uprawnienia

Członkostwo w grupie wymaga serveradmin ustalić roli serwera.

Przykłady

Poniższy przykład powoduje, że istniejący komunikat 55001 mają być rejestrowane w dzienniku aplikacji systemu Windows.

sp_altermessage 55001, 'WITH_LOG', 'true';
GO