sysmail_configure_sp (Transact-SQL)
Gilt für: SQL Server
Ändert Konfigurationseinstellungen für Datenbank-E-Mail. Die konfigurationseinstellungen, die für sysmail_configure_sp
die gesamte SQL Server-Instanz angegeben sind.
Transact-SQL-Syntaxkonventionen
Syntax
sysmail_configure_sp [ [ @parameter_name = ] 'parameter_name' ]
[ , [ @parameter_value = ] 'parameter_value' ]
[ , [ @description = ] 'description' ]
[ ; ]
Argumente
[ @parameter_name = ] 'parameter_name'
Der Name des Parameters, der geändert werden soll
[ @parameter_value = ] 'parameter_value'
Der neue Wert des Parameters
[ @description = ] 'description'
Eine Beschreibung des Parameters
Rückgabecodewerte
0
(erfolgreich) oder 1
Fehler.
Resultset
Keine.
Hinweise
Datenbank-E-Mail verwendet die folgenden Parameter:
Parametername | Beschreibung | Standardwert |
---|---|---|
AccountRetryAttempts |
Gibt an, wie oft der externe E-Mail-Prozess versucht, die E-Mail-Nachricht zu senden, wobei jedes Konto im angegebenen Profil verwendet wird. | 1 |
AccountRetryDelay |
Gibt an, wie lange (in Sekunden) der externe E-Mail-Prozess zwischen zwei Versuchen, eine Nachricht zu senden, warten soll. | 5000 |
DatabaseMailExeMinimumLifeTime |
Gibt an, wie lange (in Sekunden) der externe E-Mail-Prozess mindestens aktiv bleibt. Wenn Datenbank-E-Mail viele Nachrichten sendet, sollten Sie diesen Wert erhöhen, damit Datenbank-E-Mail aktiv bleibt und unnötiger Aufwand durch häufiges Starten und Beenden vermieden wird. | 600 |
DefaultAttachmentEncoding |
Die Standardcodierung für E-Mail-Anlagen | MIME |
MaxFileSize |
Die maximale Größe einer Anlage in Bytes. | 1000000 |
ProhibitedExtensions |
Eine durch Trennzeichen getrennte Liste von Erweiterungen, die nicht als Anlage an eine E-Mail-Nachricht gesendet werden können. | exe,dll,vbs,js |
LoggingLevel |
Gibt an, welche Nachrichten im Datenbank-E-Mail-Protokoll aufgezeichnet werden. Einer der folgenden numerischen Werte: 1 - Dies ist der normale Modus. Es werden nur Fehler protokolliert. 2 - Dies ist der erweiterte Modus. Es werden Fehler-, Warn- und Informationsmeldungen protokolliert. 3 - Dies ist der ausführliche Modus. Es werden Fehler-, Warn-, Informations-, Erfolgs- sowie zusätzliche interne Meldungen protokolliert. Verwenden Sie diesen Modus zur Problembehandlung. |
2 |
Die gespeicherte Prozedur sysmail_configure_sp
befindet sich in der msdb
Datenbank und befindet sich im Besitz des dbo-Schemas . Die Prozedur muss mit einem dreiteiligen Namen ausgeführt werden, wenn die aktuelle Datenbank nicht msdb
vorhanden ist.
Berechtigungen
Diese gespeicherte Prozedur gehört der db_owner Rolle. Sie können berechtigungen für jeden Benutzer erteilen EXECUTE
, diese Berechtigungen können jedoch während eines SQL Server-Upgrades außer Kraft gesetzt werden.
Beispiele
A. Festlegen Datenbank-E-Mail, dass jedes Konto 10 Mal erneut versucht wird
Das folgende Beispiel zeigt, dass Datenbank-E-Mail jedes Konto 10 Mal erneut versuchen soll, bevor es berücksichtigt wird, dass das Konto nicht erreichbar ist.
EXEC msdb.dbo.sysmail_configure_sp
'AccountRetryAttempts', '10';
B. Festlegen der maximalen Anlagengröße auf 2 MB
Im folgenden Beispiel wird gezeigt, wie die maximale Anlagengröße auf 2 MB festgelegt wird.
EXEC msdb.dbo.sysmail_configure_sp
'MaxFileSize', '2097152';