sp_altermessage (Transact-SQL)
örnek kullanıcı tanımlı iletileri durumunu değiştirir SQL Server Veritabanı Altyapısı.Kullanıcı tanımlı iletileri kullanılarak görüntülenebilir sys.messages Katalog görünümü.
Sözdizimi
sp_altermessage [ @message_id = ] message_number ,[ @parameter = ]'write_to_log'
,[ @parameter_value = ]'value'
Bağımsız değişkenler
[@ message_id = ] message_number
Hata sayısı arasında değiştirmek için iletinin sys.messages.message_numberİş int ile hiçbir varsayılan değeri.[ parametre = ] **'**write_to_log'
İle kullanılan @ parametre_deðeri ileti yazılabilir olduğunu göstermek için Microsoft Windows Uygulama günlüğünüwrite_to_logİş sysname ile hiçbir varsayılan değeri.write_to_logküme WITH_LOG ya da null olmalıdır.write_to_log Olan WITH_LOG veya null, ve için değer küme @ parametre_deðeri olan true, iletiyi Windows Uygulama günlüğünü yazılırwrite_to_log , WITH_LOG veya null küme ve değeri @ parametre_deðeri olan false, her zaman Windows Uygulama günlüğüne yazılır değil, ancak hata nasıl düzeltileceğini üzerine bağlı olarak yazılabilir.write_to_log Belirtilen değeri @ parametre_deðeri de belirtilmelidir.Not
Windows Uygulama günlüğüne bir ileti yazılmışsa, onu da yazılan Veritabanı Altyapısı hata günlüğü dosyasına.
[ @ parametre_deðeri = ]**'**value'
İle kullanılan @ parametresi yazılacak hata olduğunu belirtmek için Microsoft Windows Uygulama günlüğünüvalueİş varchar(5), ile hiçbir varsayılan değer.true, Hata Windows Uygulama günlüğünü için yazılan her zamanfalse, Hata her zaman Windows Uygulama günlüğüne yazılır değil, ancak hata nasıl düzeltileceğini üzerine bağlı olarak yazılabilir.value Belirlendiğinde, write_to_log için @ parametresi de belirtilmelidir.
Dönüş Kodu Değerleri
0 (başarılı) veya 1 (hata)
Sonuç Kümeleri
Hiçbiri
Açıklamalar
Etkisini sp_altermessage ile WITH_LOG seçeneği dışında RAISERROR ile günlük parametresi, benzer sp_altermessage varolan bir iletiyi günlüğe kaydetme davranışını değiştirir.Bir ileti WITH_LOG olacak şekilde değiştirilmişse, nasıl bir kullanıcı hatası çağırır bakılmaksızın Windows Uygulama günlüğüne, her zaman yazılır.RAISERROR WITH_LOG seçeneği olmadan yürütülen bile hata Windows Uygulama günlüğüne kaydedilir.
Sistem iletilerini kullanarak değiştirilemez sp_altermessage.
İzinler
Üyelik gerektiren serveradmin'e üye sabit sunucu rolü.
Örnekler
Aşağıdaki örnek, varolan iletiyi neden olan 55001 Windows Uygulama günlüğünü için tutulacak
sp_altermessage 55001, 'WITH_LOG', 'true';
GO