

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Erstellen von benutzerdefinierten Fehlermeldungen für Amazon RDS for SQL Server
<a name="Appendix.SQLServer.CommonDBATasks.CustomMessage"></a>

Anwendungen definieren häufig ihre eigenen Fehlermeldungen, `sys.messages` damit sie sie auslösen können`RAISERROR`. Verwenden Sie auf einer Amazon RDS-DB-Instance die `rds_create_custom_message` gespeicherte Prozedur`sys.messages`, um eine benutzerdefinierte Nachricht hinzuzufügen. Die Prozedur übergibt ihre Parameter an`sp_addmessage`.

Die Prozedur `rds_create_custom_message` hat die folgenden Parameter.



| Parametername | Datentyp | Standard | Erforderlich | Description | 
| --- | --- | --- | --- | --- | 
| `@msgnum` | int | NULL | Erforderlich | Die ID der Nachricht Der Wert muss zwischen 50001 und 2147483647 liegen. | 
| `@severity` | smallint | NULL | Erforderlich | Der Schweregrad der Nachricht. Der Wert muss zwischen 1 und 25 liegen. | 
| `@msgtext` | nvarchar (255) | NULL | Erforderlich | Der Text der Nachricht. Der Wert darf nicht leer sein. | 
| `@lang` | SYSNAME | NULL | optional | Die Sprache der Nachricht. Die Standardsprache ist die Standardsprache der Sitzung. | 
| `@with_log` | varchar (5) | NULL | optional | Gibt an, ob die Nachricht in das Windows-Anwendungsprotokoll geschrieben werden soll, wenn die Meldung ausgelöst wird. | 
| `@replace` | varchar(7) | NULL | optional | Geben Sie `REPLACE` an, dass eine vorhandene Nachricht mit derselben ID und Sprache überschrieben werden soll. | 

Die Parameter haben dieselbe Bedeutung wie die Parameter von`sp_addmessage`. Weitere Informationen finden Sie unter [sp\_addmessage](https://learn.microsoft.com/en-us/sql/relational-databases/system-stored-procedures/sp-addmessage-transact-sql) auf der Microsoft Learn-Website.

Das folgende Beispiel fügt dem Windows-Anwendungsprotokoll eine Meldung hinzu `sys.messages` und protokolliert sie, wenn sie ausgelöst wird. Ersetzen Sie im Beispiel den `@msgnum` Wert{{50002}}, den `@severity` Wert {{16}} und den `@msgtext` Wert durch Ihre eigene Nachrichten-ID, den Schweregrad und den Text.

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

Das folgende Beispiel ersetzt den Text einer vorhandenen Nachricht. Ersetzen Sie im Beispiel den `@msgnum` Wert{{50002}}, den `@severity` Wert {{16}} und den `@msgtext` Wert durch Ihre eigene Nachrichten-ID, den Schweregrad und den Text.

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

Um zu bestätigen, dass die Nachricht hinzugefügt wurde, fragen Sie ab`sys.messages`. Ersetzen Sie im Beispiel den `message_id` Wert {{50002}} durch Ihre Nachrichten-ID.

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