sysmail_configure_sp (Transact-SQL)

Article
03/07/2014

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 à la totalité de l'instance SQL Server.

S'applique à : SQL Server (SQL Server 2008 via la version actuelle).

Icône Lien de rubrique 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 (succès) ou 1 (échec)

Jeux de résultats

Aucun

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	Quantité de temps 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 de pièce jointe maximale, en octets.	1000000
ProhibitedExtensions	Liste d'extensions séparées par des virgules qui ne peuvent être envoyées sous forme de pièce jointe d'un message électronique.	exe,dll,vbs,js
LoggingLevel	Spécifie quels messages sont enregistrés dans le journal de la messagerie de base de données. Les valeurs possibles sont 1, 2 ou 3. 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 stockée sysmail_configure_sp se trouve dans la base de données msdb et appartient au schéma dbo. Cette procédure doit être exécutée avec un nom en trois parties si la base de données en cours n'est pas msdb.

Autorisations

Les autorisations d'exécution pour cette procédure reviennent par défaut aux membres du rôle de serveur fixe sysadmin.

Exemples

A. Paramétrage de la messagerie de base de données pour réessayer chaque compte 10 fois

L'exemple suivant illustre le paramétrage de la base de données de messagerie afin de réessayer chaque compte à dix reprises, avant de considérer que le compte est injoignable.

EXECUTE msdb.dbo.sysmail_configure_sp
    'AccountRetryAttempts', '10' ;

B. Paramétrage de la taille de pièce jointe maximale à deux 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' ;

Voir aussi

Référence

sysmail_help_configure_sp (Transact-SQL)

Procédures stockées de messagerie de base de données (Transact-SQL)

Concepts

Messagerie de base de données

Partager via