

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Creazione di messaggi di errore personalizzati per Amazon RDS for SQL Server
<a name="Appendix.SQLServer.CommonDBATasks.CustomMessage"></a>

Le applicazioni spesso definiscono i propri messaggi di errore in `sys.messages` modo da poterli generare`RAISERROR`. Su un'istanza database Amazon RDS, a cui aggiungere un messaggio personalizzato`sys.messages`, utilizza la `rds_create_custom_message` stored procedure. La procedura passa i suoi parametri a. `sp_addmessage`

La procedura `rds_create_custom_message` include i seguenti parametri.



| Nome del parametro | Tipo di dati | Default | Campo obbligatorio | Description | 
| --- | --- | --- | --- | --- | 
| `@msgnum` | int | NULL | obbligatorio | L'ID del messaggio. Il valore deve essere compreso tra 50001 e 2147483647. | 
| `@severity` | smallint | NULL | obbligatorio | Il livello di gravità del messaggio. Il valore deve essere compreso tra 1 e 25. | 
| `@msgtext` | nvarchar (255) | NULL | obbligatorio | Il testo del messaggio. Il valore non può essere vuoto. | 
| `@lang` | SYSNAME | NULL | facoltativo | La lingua del messaggio. L'impostazione predefinita è la lingua predefinita della sessione. | 
| `@with_log` | varchar (5) | NULL | facoltativo | Speciifica se scrivere il messaggio nel registro delle applicazioni di Windows quando il messaggio viene generato. | 
| `@replace` | varchar(7) | NULL | facoltativo | `REPLACE`Specificare di sovrascrivere un messaggio esistente con lo stesso ID e la stessa lingua. | 

I parametri hanno lo stesso significato dei parametri di`sp_addmessage`. Per ulteriori informazioni, vedere [sp\_addmessage](https://learn.microsoft.com/en-us/sql/relational-databases/system-stored-procedures/sp-addmessage-transact-sql) sul sito Web Microsoft Learn.

L'esempio seguente aggiunge un messaggio `sys.messages` e lo registra nel registro delle applicazioni di Windows quando viene generato. Nell'esempio, sostituite il `@msgnum` valore{{50002}}, il `@severity` valore {{16}} e il `@msgtext` valore con l'ID, la gravità e il testo del messaggio personalizzati.

```
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'esempio seguente sostituisce il testo di un messaggio esistente. Nell'esempio, sostituite il `@msgnum` valore{{50002}}, il `@severity` valore {{16}} e il `@msgtext` valore con l'ID, la gravità e il testo del messaggio personalizzati.

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

Per confermare che il messaggio è stato aggiunto, interroga`sys.messages`. Nell'esempio, sostituisci il `message_id` valore {{50002}} con l'ID del messaggio.

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