sp_dropmessage (Transact-SQL)sp_dropmessage (Transact-SQL)

APLICA-SE A: simSQL Server (a partir do 2008) nãoBanco de Dados SQL do Azure nãoSQL Data Warehouse do Azure nãoParallel Data Warehouse APPLIES TO: yesSQL Server (starting with 2008) noAzure SQL Database noAzure SQL Data Warehouse noParallel Data Warehouse

Descarta uma mensagem de erro definida pelo usuário especificada de uma instância do Mecanismo de Banco de Dados do SQL ServerSQL Server Database Engine.Drops a specified user-defined error message from an instance of the Mecanismo de Banco de Dados do SQL ServerSQL Server Database Engine. Mensagens definidas pelo usuário podem ser exibidas usando o sys. messages exibição do catálogo.User-defined messages can be viewed using the sys.messages catalog view.

Ícone de link do tópico Convenções de sintaxe de Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SintaxeSyntax

  
sp_dropmessage [ @msgnum = ] message_number  
    [ , [ @lang = ] 'language' ]  

ArgumentosArguments

[ @msgnum = ] message_number É o número de mensagem para descartar.[ @msgnum = ] message_number Is the message number to drop. message_number deve ser uma mensagem definida pelo usuário que tem um número maior que 50000.message_number must be a user-defined message that has a message number greater than 50000. message_number está int, com um padrão NULL.message_number is int, with a default of NULL.

[ @lang = ] 'language' É o idioma da mensagem a ser descartada.[ @lang = ] 'language' Is the language of the message to drop. Se todos os for especificado, todas as versões de idioma do message_number são descartados.If all is specified, all language versions of message_number are dropped. linguagem está sysname, com um padrão NULL.language is sysname, with a default of NULL.

Valores do código de retornoReturn Code Values

0 (êxito) ou 1 (falha)0 (success) or 1 (failure)

Conjuntos de resultadosResult Sets

Nenhum.None.

PermissõesPermissions

Requer associação na sysadmin e serveradmin funções de servidor fixas.Requires membership in the sysadmin and serveradmin fixed server roles.

ComentáriosRemarks

A menos que todos os é especificado para idiomalocalizado todas as versões de uma mensagem devem ser descartadas antes de descartar a versão em inglês dos EUA.Unless all is specified for language, all localized versions of a message must be dropped before the U.S. English version of the message can be dropped.

ExemplosExamples

A.A. Descartando uma mensagem definida pelo usuárioDropping a user-defined message

O exemplo a seguir descarta uma mensagem definida pelo usuário, o número 50001, da sys. messages.The following example drops a user-defined message, number 50001, from sys.messages.

USE master;  
GO  
EXEC sp_dropmessage 50001;  

B.B. Descartando uma mensagem definida pelo usuário que inclui uma versão localizadaDropping a user-defined message that includes a localized version

O exemplo a seguir descarta uma mensagem definida pelo usuário, número 60000, que inclui uma versão localizada da mensagem.The following example drops a user-defined message, number 60000, that includes a localized version of the message.

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.C. Descartando uma versão localizada de uma mensagem definida pelo usuárioDropping a localized version of a user-defined message

O exemplo a seguir descarta uma versão localizada de uma mensagem definida pelo usuário, número 60000, sem descartar a mensagem inteira.The following example drops a localized version of a user-defined message, number 60000, without dropping the whole message.

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  

Consulte tambémSee Also

RAISERROR (Transact-SQL) RAISERROR (Transact-SQL)
sp_addmessage (Transact-SQL) sp_addmessage (Transact-SQL)
sp_altermessage (Transact-SQL) sp_altermessage (Transact-SQL)
FORMATMESSAGE (Transact-SQL) FORMATMESSAGE (Transact-SQL)
sys.messages (Transact-SQL) sys.messages (Transact-SQL)
Procedimentos armazenados do sistema (Transact-SQL)System Stored Procedures (Transact-SQL)