View a markdown version of this page

Criação de mensagens de erro personalizadas para o Amazon RDS para SQL Server - Amazon Relational Database Service

Criação de mensagens de erro personalizadas para o Amazon RDS para SQL Server

As aplicações geralmente definem suas próprias mensagens de erro em sys.messages para que possam gerá-las com RAISERROR. Em uma instância de banco de dados do Amazon RDS, para adicionar uma mensagem personalizada a sys.messages, use o procedimento armazenado rds_create_custom_message. O procedimento passa os parâmetros para sp_addmessage.

O procedimento rds_create_custom_message tem os seguintes parâmetros.

Nome do parâmetro Tipo de dados Padrão Obrigatório Descrição

@msgnum

int

NULL

obrigatório

O ID da mensagem. O valor deve estar entre 50001 e 2147483647.

@severity

smallint

NULL

obrigatório

O nível de gravidade da mensagem. O valor deve estar entre 1 e 25.

@msgtext

nvarchar(255)

NULL

obrigatório

O texto da mensagem. O valor não pode estar vazio.

@lang

SYSNAME

NULL

optional

O idioma da mensagem. O padrão é o idioma padrão da sessão.

@with_log

varchar(5)

NULL

optional

Especifica se a mensagem deve ser gravada no log de aplicativos do Windows quando for gerada.

@replace

varchar(7)

NULL

optional

Especifique REPLACE para substituir uma mensagem existente com o mesmo ID e idioma.

Os parâmetros têm o mesmo significado que os parâmetros de sp_addmessage. Consulte mais informações em sp_addmessage no site da Microsoft Learn.

O exemplo a seguir adiciona uma mensagem a sys.messages e a registra no log de aplicativos do Windows quando ela é gerada. No exemplo, substitua o valor 50002 de @msgnum, o valor 16 de @severity e o valor de @msgtext pelo seu próprio ID de mensagem, nível de gravidade e texto.

EXEC msdb.dbo.rds_create_custom_message @msgnum = 50002, @severity = 16, @msgtext = N'The order could not be processed.', @lang = 'us_english', @with_log = 'TRUE';

O exemplo a seguir substitui o texto de uma mensagem existente. No exemplo, substitua o valor 50002 de @msgnum, o valor 16 de @severity e o valor de @msgtext pelo seu próprio ID de mensagem, nível de gravidade e texto.

EXEC msdb.dbo.rds_create_custom_message @msgnum = 50002, @severity = 16, @msgtext = N'The order could not be processed. Contact support.', @lang = 'us_english', @with_log = 'TRUE', @replace = 'REPLACE';

Para confirmar que a mensagem foi adicionada, consulte sys.messages. No exemplo, substitua o valor 50002 de message_id pelo ID da sua mensagem.

SELECT * FROM sys.messages WHERE message_id = 50002;