sysmail_add_profileaccount_sp (Transact-SQL)

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

データベースメールプロファイルにデータベースメールアカウントを追加します。sysmail_add_account_sp (Transact-SQL) でデータベースアカウントを作成し、sysmail_add_profile_sp (Transact-SQL) でデータベースプロファイルを作成した後、sysmail_add_profileaccount_sp を実行します。

トピックリンクアイコン Transact-SQL 構文表記規則

構文

sysmail_add_profileaccount_sp { [ @profile_id = ] profile_id | [ @profile_name = ] 'profile_name' } ,
    { [ @account_id = ] account_id | [ @account_name = ] 'account_name' }
    [ , [ @sequence_number = ] sequence_number ]

引数

[ @profile_id = ] profile_id
アカウントを追加するプロファイル ID を指定します。profile_id のデータ型は int で、既定値は NULL です。profile_id または profile_name のいずれかを指定する必要があります。

[ @profile_name = ] 'profile_name'
アカウントを追加するプロファイル名を指定します。profile_name のデータ型は sysname で、既定値は NULL です。profile_id または profile_name のいずれかを指定する必要があります。

[ @account_id = ] account_id
プロファイルに追加するアカウント ID を指定します。account_id のデータ型は int で、既定値は NULL です。account_id または account_name のいずれかを指定する必要があります。

[ @account_name = ] 'account_name'
プロファイルに追加するアカウント名を指定します。account_name のデータ型は sysname で、既定値は NULL です。account_id または account_name のいずれかを指定する必要があります。

[ @sequence_number = ] sequence_number
プロファイル内にあるアカウントのシーケンス番号を指定します。sequence_number のデータ型は int で、既定値はありません。シーケンス番号によって、プロファイルで使用されるアカウントの順番が決まります。

解説

プロファイルとアカウントの両方が既に存在している必要があります。両方またはいずれかが存在しないと、このストアドプロシージャはエラーを返します。

このストアドプロシージャでは、指定したプロファイルに既に関連付けられているアカウントのシーケンス番号は変更されないことに注意してください。アカウントのシーケンス番号の更新に関する詳細については、「sysmail_update_profileaccount_sp (Transact-SQL)」を参照してください。

シーケンス番号によって、データベースメールではプロファイル内のアカウントがどの順番で使用されるかが決まります。新しい電子メールメッセージの場合、データベースメールでは、一番小さなシーケンス番号の付いたアカウントから処理が開始されます。そのアカウントが失敗すると、データベースメールでは、このアカウントよりも大きいシーケンス番号を持つアカウントに処理が移ります。このように、データベースメールによってメッセージが正常に送信されるか、一番大きなシーケンス番号のアカウントが失敗するまで順に処理されます。一番大きなシーケンス番号のアカウントが失敗すると、データベースメールでは、sysmail_configure_sp の AccountRetryDelay パラメータで設定された時間数に基づいてメール送信が一時停止し、一番小さなシーケンス番号からメール送信が再開されます。指定されたプロファイルの各アカウントを使用して電子メールメッセージの送信を試行するよう、外部メールの処理回数を構成するには、sysmail_configure_sp の AccountRetryAttempts パラメータを使用します。

同じシーケンス番号を持つアカウントが複数存在する場合、データベースメールでは、指定された電子メールメッセージに対して、これらのアカウントのいずれか 1 つのみが使用されます。この場合、そのシーケンス番号に対してどのアカウントが使用されるか、またメッセージごとに同じアカウントが使用されるかついては、データベースメールでは保証されません。

ストアドプロシージャ sysmail_add_profileaccount_sp は msdb データベースにあり、dbo スキーマが所有しています。現在のデータベースが msdb でない場合、このプロシージャを実行するときには名前に 3 つの要素を指定する必要があります。

権限

このプロシージャの実行権限は、既定では sysadmin 固定サーバーロールのメンバに与えられています。

戻り値

0 (成功) または 1 (失敗)

例

次の例では、プロファイル AdventureWorks Administrator をアカウント Audit Account に関連付けます。監査アカウントのシーケンス番号は 1 です。

EXECUTE msdb.dbo.sysmail_add_profileaccount_sp
    @profile_name = 'AdventureWorks Administrator',
    @account_name = 'Audit Account',
    @sequence_number = 1 ;

参照

その他の技術情報

データベースメール
 データベースメールアカウント
 データベースメールプロファイル
 [構成タスクの選択] (データベースメール)

ヘルプおよび情報

SQL Server 2005 の参考資料の入手

次の方法で共有

sysmail_add_profileaccount_sp (Transact-SQL)

構文

引数

解説

権限

戻り値

例

参照

関連項目

その他の技術情報

ヘルプおよび情報

その他のリソース