Bagikan melalui


sp_dropmessage (T-SQL)

Berlaku untuk:SQL Server

Menghilangkan pesan kesalahan yang ditentukan pengguna tertentu dari instans Mesin Database SQL Server. Pesan yang ditentukan pengguna dapat dilihat menggunakan sys.messages tampilan katalog.

Konvensi sintaks transact-SQL

Sintaks

sp_dropmessage
    [ [ @msgnum = ] msgnum ]
    [ , [ @lang = ] N'lang' ]
[ ; ]

Argumen

[ @msgnum = ] msgnum

Nomor pesan yang akan dihilangkan. @msgnum int, dengan default NULL. @msgnum harus berupa pesan yang ditentukan pengguna yang merupakan nomor pesan yang lebih besar dari 50000 (50.000).

[ @lang = ] N'lang'

Bahasa pesan yang akan dihilangkan. @lang adalah sysname, dengan default NULL. Jika all ditentukan, semua versi bahasa @msgnum dihilangkan.

Mengembalikan nilai kode

0 (berhasil) atau 1 (kegagalan).

Tataan hasil

Tidak ada.

Izin

Memerlukan keanggotaan dalam peran server tetap sysadmin dan serveradmin .

Keterangan

Kecuali all ditentukan untuk @lang, semua versi pesan yang dilokalkan harus dihilangkan sebelum pesan versi bahasa Inggris A.S. dapat dihilangkan.

Contoh

J. Menghapus pesan yang ditentukan pengguna

Contoh berikut menghilangkan pesan yang ditentukan pengguna, nomor 50001, dari sys.messages.

USE master;
GO
EXEC sp_dropmessage 50001;

B. Menghapus pesan yang ditentukan pengguna yang menyertakan versi yang dilokalkan

Contoh berikut menambahkan pesan yang ditentukan pengguna, nomor 60000, yang menyertakan versi yang dilokalkan, lalu menghilangkan kedua variasi pesan.

USE master;
GO

-- Create a user-defined message in U.S. English
EXEC sp_addmessage
    @msgnum = 60000,
    @severity = 16,
    @msgtext = N'The item named %s already exists in %s.',
    @lang = 'us_english';

-- Create a localized version of the same message.
EXEC sp_addmessage
    @msgnum = 60000,
    @severity = 16,
    @msgtext = N'L''élément nommé %1! existe déjà dans %2!',
    @lang = 'French';
GO

-- This statement will fail as long as the localized version
-- of the message exists.
EXEC sp_dropmessage 60000;
GO

-- This statement will drop the message.
EXEC sp_dropmessage @msgnum = 60000,
    @lang = 'all';
GO

C. Menghapus versi yang dilokalkan dari pesan yang ditentukan pengguna

Contoh berikut menghilangkan versi yang dilokalkan dari pesan yang ditentukan pengguna, angka 60000, tanpa menghilangkan seluruh pesan.

USE master;
GO

-- Create a user-defined message in U.S. English
EXEC sp_addmessage
    @msgnum = 60000,
    @severity = 16,
    @msgtext = N'The item named %s already exists in %s.',
    @lang = 'us_english';

-- Create a localized version of the same message.
EXEC sp_addmessage
    @msgnum = 60000,
    @severity = 16,
    @msgtext = N'L''élément nommé %1! existe déjà dans %2!',
    @lang = 'French';
GO

-- This statement will remove only the localized version of the
-- message.
EXEC sp_dropmessage
    @msgnum = 60000,
    @lang = 'French';
GO