sysmail_delete_profile_sp (Transact-SQL)

適用対象:SQL Server

データベース メールによって使用されるメール プロファイルを削除します。

Transact-SQL 構文表記規則

構文

sysmail_delete_profile_sp { [ @profile_id = ] profile_id | [ @profile_name = ] 'profile_name' }
[ ; ]

引数

[ @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を指定する必要があります。

リターン コードの値

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

結果セット

ありません。

解説

プロファイルを削除しても、プロファイルで使用されているアカウントは削除されません。

このストアド プロシージャは、ユーザーがプロファイルにアクセスできるかどうかに関係なく、プロファイルを削除します。 ユーザーの既定のプライベート プロファイルまたはデータベースの既定のパブリック プロファイルを削除する場合は注意が msdb 必要です。 既定のプロファイルが使用できない場合は、 sp_send_dbmail プロファイルの名前を引数として指定する必要があります。 そのため、既定のプロファイルを削除すると、呼び出しが失敗する sp_send_dbmail 可能性があります。 詳細については、「sp_send_dbmail (Transact-SQL)」を参照してください。

ストアド プロシージャsysmail_delete_profile_spはデータベース内msdbにあり、dbo スキーマによって所有されています。 現在のデータベースが実行されていない msdb場合は、プロシージャを 3 部構成の名前で実行する必要があります。

アクセス許可

このストアド プロシージャは、db_owner ロールによって所有されています。 任意のユーザーにアクセス許可を付与 EXECUTE できますが、SQL Server のアップグレード中にこれらのアクセス許可がオーバーライドされる可能性があります。

例

次の例では、AdventureWorks Administrator というプロファイルを削除します。

EXEC msdb.dbo.sysmail_delete_profile_sp
    @profile_name = 'AdventureWorks Administrator';

関連するコンテンツ

• データベース メール
• データベース メール構成オブジェクト
• データベース メール ストアド プロシージャ (Transact-SQL)