Partager via


sysmail_stop_sp (Transact-SQL)

Arrête la messagerie de base de données en arrêtant les objets Service Broker utilisés par le programme externe.

Icône Lien de rubriqueConventions de la syntaxe de Transact-SQL

Syntaxe

sysmail_stop_sp

Arguments

Aucun

Valeurs des codes de retour

0 (succès) ou 1 (échec)

Notes

Cette procédure stockée figure dans la base de données msdb.

Elle arrête la file d'attente de la messagerie de base de données contenant les demandes de messages sortants et désactive Service Broker pour le programme externe.

Dès que les files d'attente sont arrêtées, le programme externe de la messagerie de base de données ne traite plus les messages. Cette procédure stockée vous permet d'arrêter la messagerie de base de données pour résoudre des problèmes ou effectuer des tâches de maintenance.

Pour démarrer la messagerie de base de données, utilisez sysmail_start_sp. Notez que sp_send_dbmail accepte toujours des messages lorsque les objets Service Broker sont arrêtés.

[!REMARQUE]

Cette procédure stockée arrête simplement les files d'attente de la messagerie de base de données. Elle ne désactive pas la remise de messages Service Broker dans la base de données. Pour plus d'informations sur la désactivation de la remise de messages Service Broker, consultez Procédure : désactiver la remise de messages Service Broker dans les bases de données (Transact-SQL). Cette procédure stockée ne désactive pas les procédures stockées étendues de la messagerie de base de données pour réduire la zone de surface. Pour désactiver les procédures stockées étendues, consultez l'option Database Mail XPs de la procédure stockée système sp_configure.

Autorisations

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

Exemples

L'exemple suivant montre comment arrêter la messagerie de base de données dans la base de données msdb. L'exemple suppose que la messagerie de base de données a été activée.

USE msdb ;
GO

EXECUTE dbo.sysmail_stop_sp ;
GO