Partager via


sysmail_stop_sp (Transact-SQL)

S'applique à : SQL Server

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

Conventions de la syntaxe Transact-SQL

Syntaxe

sysmail_stop_sp
[ ; ]

Arguments

Aucun.

Valeurs des codes de retour

0 (réussite) ou 1 (échec).

Notes

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

sysmail_stop_sp arrête la file d’attente de messagerie de base de données qui contient les demandes de messages sortantes et désactive l’activation de Service Broker pour le programme externe.

Lorsque les files d’attente sont arrêtées, le programme externe de messagerie de base de données ne traite pas 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 qu’il sp_send_dbmail accepte toujours le courrier lorsque les objets Service Broker sont arrêtés.

Remarque

sysmail_stop_sp arrête uniquement les files d’attente pour la messagerie de base de données. Cette procédure stockée ne désactive pas la remise des messages Service Broker dans la base de données. 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 XPs de messagerie de base de données de la sp_configure procédure stockée système.

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

L’exemple suivant montre l’arrêt de la messagerie de base de données dans la msdb base de données. Il suppose que la messagerie de base de données a été activée.

USE msdb;
GO

EXECUTE dbo.sysmail_stop_sp;
GO