sysmail_configure_sp (Transact-SQL)
S'applique à : 
SQL Server
Modifie les paramètres de configuration de la messagerie de base de données. Les paramètres de configuration spécifiés avec sysmail_configure_sp s’appliquent à l’ensemble de l’instance SQL Server.
Conventions de la syntaxe Transact-SQL
Syntaxe
sysmail_configure_sp [ [ @parameter_name = ] 'parameter_name' ]
[ , [ @parameter_value = ] 'parameter_value' ]
[ , [ @description = ] 'description' ]
[ ; ]
Arguments
[ @parameter_name = ] 'parameter_name'
Nom du paramètre à modifier.
[ @parameter_value = ] 'parameter_value'
Nouvelle valeur du paramètre.
[ @description = ] 'description'
Description du paramètre.
Valeurs des codes de retour
0 (réussite) or 1 (échec).
Jeu de résultats
Aucune.
Notes
La messagerie de base de données utilise les paramètres suivants :
| Nom du paramètre | Description | Valeur par défaut |
|---|---|---|
AccountRetryAttempts |
Nombre de fois où le processus de messagerie externe tente d'envoyer le message électronique à l'aide de chaque compte présent dans le profil spécifié. | 1 |
AccountRetryDelay |
Quantité de temps, en secondes, d'attente du processus de messagerie externe entre chaque tentative d'envoi d'un message. | 5000 |
DatabaseMailExeMinimumLifeTime |
Durée minimale (en secondes) pendant laquelle le processus de messagerie externe reste actif. Lorsque la messagerie de base de données envoie un nombre important de messages, augmentez cette valeur afin de conserver cette messagerie de base de données active et d'éviter la charge de gestion engendrée par des démarrages et arrêts fréquents. | 600 |
DefaultAttachmentEncoding |
Encodage par défaut pour les pièces jointes de messagerie électronique. | MIME |
MaxFileSize |
Taille maximale d'une pièce jointe, en octets. | 1000000 |
ProhibitedExtensions |
Liste séparée par des virgules des extensions qui ne peuvent pas être envoyées en pièces jointes dans un message électronique. | exe,dll,vbs,js |
LoggingLevel |
Spécifiez quels messages sont enregistrés dans le journal de la messagerie de base de données. Une des valeurs numériques suivantes : 1 - Mode normal. Seules les erreurs sont consignées dans le journal. 2 - Mode étendu. Les erreurs, les avertissements et les messages à contenu informatif sont consignés dans le journal. 3 - Mode documenté. Les erreurs, les avertissements, les messages informatifs et de réussite ainsi que d'autres messages internes sont consignés dans le journal. Utilisez ce mode lorsque vous tentez de résoudre des problèmes. |
2 |
La procédure sysmail_configure_sp stockée se trouve dans la msdb base de données et appartient au dbo schéma. La procédure doit être exécutée avec un nom en trois parties si la base de données actuelle n’est pas msdb.
autorisations
Nécessite CONTROL SERVER une autorisation sur le serveur ou l’appartenance au rôle de base de données db_owner dans la msdb base de données.
Vous pouvez également accorder EXECUTE des autorisations pour n’importe quel utilisateur, ce qui permet à l’utilisateur d’utiliser cette procédure pour lire la configuration, mais de ne pas modifier les paramètres. Ces autorisations ajoutées peuvent être remplacées lors d’une mise à niveau de SQL Server.
Exemples
R. Définir la messagerie de base de données pour réessayer chaque compte 10 fois
L’exemple suivant montre comment définir la messagerie de base de données pour réessayer chaque compte 10 fois avant de considérer que le compte est inaccessible.
EXECUTE msdb.dbo.sysmail_configure_sp 'AccountRetryAttempts', '10';
B. Définir la taille maximale des pièces jointes sur 2 mégaoctets
L'exemple suivant illustre le paramétrage de la taille de pièce jointe maximale à 2 mégaoctets.
EXECUTE msdb.dbo.sysmail_configure_sp 'MaxFileSize', '2097152';