Partage via


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) ou 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 d’extensions qui ne peuvent pas être envoyées en tant que pièce jointe à 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 schéma dbo . 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

Cette procédure stockée appartient au rôle db_owner . Vous pouvez accorder EXECUTE des autorisations pour n’importe quel utilisateur, mais ces autorisations 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.

EXEC 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.

EXEC msdb.dbo.sysmail_configure_sp
    'MaxFileSize', '2097152';