Création de messages d'erreur personnalisés pour Amazon RDS for SQL Server

Les applications définissent souvent leurs propres messages d'erreur sys.messages afin de pouvoir les générerRAISERROR. Sur une instance de base de données Amazon RDS, pour ajouter un message personnalisésys.messages, utilisez la procédure rds_create_custom_message stockée. La procédure transmet ses paramètres àsp_addmessage.

La procédure rds_create_custom_message possède les paramètres suivants.

Nom du paramètre	Type de données	Par défaut	Obligatoire	Description
@msgnum	int	NULL	obligatoire	ID du message. La valeur doit être comprise entre 50001 et 2147483647.
@severity	smallint	NULL	obligatoire	Niveau de gravité du message. La valeur doit être comprise entre 1 et 25.
@msgtext	Navarchar (255)	NULL	obligatoire	Le texte du message. La valeur ne peut pas être vide.
@lang	SYSNAME	NULL	facultatif	Langue du message. La langue par défaut est la langue par défaut de la session.
@with_log	varchar (5)	NULL	facultatif	Spécifie s'il faut écrire le message dans le journal des applications Windows lorsque le message est envoyé.
@replace	varchar(7)	NULL	facultatif	Spécifiez REPLACE pour remplacer un message existant ayant le même identifiant et la même langue.

Les paramètres ont la même signification que les paramètres desp_addmessage. Pour plus d'informations, consultez sp_addmessage sur le site Web de Microsoft Learn.

L'exemple suivant ajoute un message sys.messages et l'enregistre dans le journal des applications Windows lorsqu'il est déclenché. Dans l'exemple, remplacez la @msgnum valeur50002, la @severity valeur 16 et la @msgtext valeur par l'identifiant, la sévérité et le texte de votre message.

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';

L'exemple suivant remplace le texte d'un message existant. Dans l'exemple, remplacez la @msgnum valeur50002, la @severity valeur 16 et la @msgtext valeur par l'identifiant, la sévérité et le texte de votre message.

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';

Pour confirmer que le message a été ajouté, interrogezsys.messages. Dans l'exemple, remplacez la message_id valeur par 50002 l'ID de votre message.

SELECT * FROM sys.messages WHERE message_id = 50002;