sp_altermessage (Transact-SQL)

Kullanıcı tanımlı iletilerin bir kopyasını durumunu değiştirirSQL Server Database Engine.İleti kullanıcı tarafından tanımlanmış görüntülenen kullanaraksys.Messages Katalog görünümü.

Topic link iconTransact-SQL sözdizimi kuralları

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

Bağımsız değişkenler

  • [@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.Ifwrite_to_logolan küme WITH_LOG veya NULL değeri için
    @ parametre_deðeri
    trueiletiyi Windows Uygulama günlüğünü yazılır durumda Ifwrite_to_logolan küme WITH_LOG veya NULL değeri için**@ parametre_deðeri** olan false, ileti her zaman Windows Uygulama günlüğüne yazılır, ancak bağlı nasıl hata yükseltilmiş üzerine yazılabilir.Ifwrite_to_logbelirtilen değeri**@ parametre_deðeri** de belirtilmelidir.

    Not

    Windows Uygulama günlüğüne bir ileti yazılır, bu da yazılanDatabase EngineHata günlük dosyası.

  • [ @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.IftrueWindows Uygulama günlüğünü için her zaman hata yazılır,Iffalse, hata her zaman Windows Uygulama günlüğüne yazılır, ancak bağlı nasıl hata yükseltilmiş üzerine yazılabilir.Ifvaluebelirtilmişse,write_to_logiçin
    @ parametre
    de belirtilmelidir.

Dönüş Kodu Değerleri

0 (başarılı) veya 1 (hatası)

Sonuç Kümeleri

None

Remarks

Etkisisp_altermessage oturum açma davranışını bir varolan iletiyi. sp_altermessage değişiklikleri dışında WITH_LOG seçeneğiyle RAISERROR ile günlük parametresinin benzer WITH_LOG olarak değiştirilmiş bir ileti, bir kullanıcının hata nasıl çağırır ne olursa olsun Windows Uygulama günlüğüne, her zaman yazılır.RAISERROR WITH_LOG seçeneği olmadan yürütülür bile, hata Windows Uygulama günlüğüne yazılır.

Sistem iletileri kullanılarak değiştirilemezsp_altermessage.

İzinler

Üyelik gerektirenserveradmin sunucu sabit rolü.

Örnekler

Aşağıdaki örnek, varolan iletiyi neden oluyor55001Windows Uygulama günlüğünü için oturum

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