ストアドプロシージャを SQL Mail からデータベースメールに変換する方法 (Transact-SQL)

[アーティクル]
12/16/2008

データベースメールを使用すると、Microsoft SQL Server 2005 から電子メールを送信できます。電子メールを送信するには、sp_send_dbmail ストアドプロシージャを使用します。このプロシージャで必要な引数は、xp_sendmail の引数と似ています。したがって、xp_sendmail を使用するプロシージャを sp_send_dbmail を使用するように変換する作業は簡単です。

sp_send_dbmail で独自に必要になる最も重要なパラメータは、必要に応じてメッセージの送信に使用するメールプロファイルです。データベースメールプロファイルは、データベースメール構成ウィザードまたはデータベースメールのストアドプロシージャを使用して作成します。メールホストデータベースとして使用できるのは、msdb データベースだけです。

ストアドプロシージャを SQL Mail からデータベースメールに変換するには

データベースメールがまだ有効になっていない場合は、有効にします。データベースメールを有効にするには、データベースメール構成ウィザードを使用します。
まだプロファイルを作成していない場合は、データベースメールプロファイルを作成します。データベースメールプロファイルを作成する方法の詳細については、「データベースメールのプライベートプロファイルを作成する方法 (Transact-SQL)」を参照してください。
xp_sendmail への呼び出しを sp_send_dbmail への呼び出しと置き換えます。次の表で示すように、引数を xp_sendmail から sp_send_dbmail にマップします。

xp_sendmail 引数	sp_send_dbmail 引数
@recipients	@recipients
@message	@body
@query	@query
@attachments	@file_attachments @query_attachment_filename
@copy_recipients	@copy_recipients
@blind_copy_recipients	@blind_copy_recipients
@subject	@subject
@type	なし
@attach_results	@attach_query_result_as_file
@no_output	@exclude_query_output
@no_header	@query_result_header
@width	@query_result_width
@separator	@query_result_separator
@echo_error	なし
@set_user	なし
@dbuse	@execute_query_database

プロシージャを更新するときは、次の相違点を考慮してください。

MAPI メッセージ入力を使用できません。データベースメールでは拡張 MAPI を使用しないので、ストアドプロシージャからメッセージ型を設定することはできません。
@query パラメータを指定した場合、クエリからのエラーが sp_send_dbmail を呼び出したセッションに返されます。
@query パラメータを指定した場合、クエリが現在のユーザーとして実行されます。ただし、クエリには、EXECUTE AS ステートメントなど、任意の有効な Transact-SQL が含まれていることがあります。
データベースメールでは、SQL Mail でサポートされていない以下のオプションがサポートされています。

sp_send_dbmail 引数	説明
@profile_name	メッセージに使用するメールプロファイルを指定します。データベースメールでは、高い信頼性とスケーラビリティを提供するために、複数のプロファイルと各プロファイルの複数のアカウントがサポートされています。メールホストデータベースまたは sp_send_dbmail を呼び出しているユーザーの既定のプロファイルがある場合は、@profile_name を省略できます。
@body_format	TEXT または HTML のいずれかで電子メールメッセージの形式を指定します。
@importance	電子メールメッセージの重要度を指定します。
@sensitivity	電子メールメッセージの秘密度を指定します。
@query_attachment_filename	クエリの結果をファイルとして添付するときに使用するファイル名を指定します。@attach_results= TRUE の xp_sendmail @query parameter を使用する場合、@attachments パラメータでは、メールメッセージに添付するファイルを 1 つだけ指定できます。sp_send_dbmail には、@file_attachments と @query_attachment_filename の両方が含まれています。

使用例

次の例では、SQL Mail を使用して、メッセージを danw@Adventure-Works.com に送信します。

EXEC master.dbo.xp_sendmail 
    @recipients=N'danw@Adventure-Works.com',
    @message=N'The master database is full.' ;

次の例では、データベースメールと現在のユーザーの既定のプロファイルを使用して、同じメッセージを送信します。

EXEC msdb.dbo.sp_send_dbmail
    @recipients=N'danw@Adventure-Works.com',
    @body=N'The master database is full.' ;

このプロシージャが msdb データベースで実行されることに注意してください。

参照

ストアド プロシージャを SQL Mail からデータベース メールに変換する方法 (Transact-SQL)

ストアド プロシージャを SQL Mail からデータベース メールに変換するには

使用例

参照

概念

その他の技術情報

ヘルプおよび情報

その他のリソース

ストアドプロシージャを SQL Mail からデータベースメールに変換する方法 (Transact-SQL)

ストアドプロシージャを SQL Mail からデータベースメールに変換するには