Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Création de messages d'erreur personnalisés pour Amazon RDS for SQL Server
<a name="Appendix.SQLServer.CommonDBATasks.CustomMessage"></a>

Les applications définissent souvent leurs propres messages d'erreur `sys.messages` afin de pouvoir les générer`RAISERROR`. 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 de`sp_addmessage`. Pour plus d'informations, consultez [sp\_addmessage sur le site Web](https://learn.microsoft.com/en-us/sql/relational-databases/system-stored-procedures/sp-addmessage-transact-sql) 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` valeur{{50002}}, 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` valeur{{50002}}, 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é, interrogez`sys.messages`. Dans l'exemple, remplacez la `message_id` valeur par {{50002}} l'ID de votre message.

```
SELECT * FROM sys.messages WHERE message_id = {{50002}};
```