sysmail_stop_sp (Transact-SQL)
適用対象: SQL サーバー
外部プログラムが使用する Service Broker オブジェクトを停止して、データベース メールを停止します。
構文
sysmail_stop_sp
[ ; ]
引数
[なし] :
リターン コードの値
0
(成功) または 1
(失敗)。
解説
このストアド プロシージャは、 msdb
データベースにあります。
sysmail_stop_sp
は、送信メッセージ要求を保持する データベース メール キューを停止し、外部プログラムの Service Broker のアクティブ化をオフにします。
キューが停止すると、データベース メール外部プログラムはメッセージを処理しません。 このストアド プロシージャを使用すると、トラブルシューティングやメンテナンスの目的でデータベース メールを停止できます。
データベース メールを開始するには、sysmail_start_sp
を使用します。 Service Broker オブジェクトが停止しても、 sp_send_dbmail
は引き続きメールを受け入れることに注意してください。
Note
sysmail_stop_sp
は、データベース メールのキューのみを停止します。 このストアド プロシージャは、データベース内の Service Broker メッセージ配信を非アクティブ化しません。 このストアド プロシージャは、データベース メール拡張ストアド プロシージャを無効にして、サーフェス領域を減らしません。 拡張ストアド プロシージャを無効にするには、sp_configure
システム ストアド プロシージャの データベース メール XPs オプションを参照してください。
アクセス許可
このストアド プロシージャは、 db_owner ロールによって所有されています。 EXECUTE
アクセス許可は任意のユーザーに付与できますが、SQL Server のアップグレード中にこれらのアクセス許可がオーバーライドされる可能性があります。
例
次の例は、msdb
データベースでのデータベース メールの停止を示しています。 この例では、データベース メールが有効になっていることを前提としています。
USE msdb;
GO
EXECUTE dbo.sysmail_stop_sp;
GO