sysmail_stop_sp (Transact-SQL)
外部プログラムが使用している Service Broker オブジェクトを停止して、データベース メールを停止します。
.gif "トピック リンク アイコン")
構文
sysmail_stop_sp
引数
なし
解説
このストアド プロシージャは、msdb データベースにあります。
このストアド プロシージャは、送信メッセージ要求を保持しているデータベース メール キューを停止し、外部プログラムに対する Service Broker のアクティブ化をオフにします。
キューが停止すると、データベース メール外部プログラムではメッセージが処理されなくなります。このストアド プロシージャを使用すると、トラブルシューティングやメンテナンスの目的でデータベース メールを停止できます。
データベース メールを開始するには、sysmail_start_sp を使用します。Service Broker オブジェクトが停止していても、sp_send_dbmail では引き続きメールを受け取ることができる点に注意してください。
.gif "ms173412.note(ja-jp,SQL.90).gif") メモ : |
|---|
| このストアド プロシージャは、データベース メールのキューだけを停止します。データベースでの Service Broker のメッセージ配信は非アクティブになりません。Service Broker のメッセージ配信を非アクティブ化する方法については、「データベースで Service Broker のメッセージ配信を非アクティブ化する方法 (Transact-SQL)」を参照してください。このストアド プロシージャでは、外部からのアクセスを縮小するために、データベース メールの拡張ストアド プロシージャを無効にすることはできません。拡張ストアド プロシージャを無効にする方法については、「SQL Server セキュリティ構成」を参照してください。 |
権限
このプロシージャの実行権限は、既定では sysadmin 固定サーバー ロールのメンバに与えられています。
戻り値
0 (成功) または 1 (失敗)
例
次の例では、msdb データベースでデータベース メールを停止します。ここではデータベース メールが有効になっていることを前提としています。
USE msdb ;
GO
EXECUTE dbo.sysmail_stop_sp ;
GO
参照
関連項目
sysmail_start_sp (Transact-SQL)
データベース メールと SQL Mail のストアド プロシージャ (Transact-SQL)