sysmail_update_profile_sp (Transact-SQL)

  • [アーティクル]

適用対象:SQL Server

データベース メール プロファイルの説明または名前を変更します。

Transact-SQL 構文表記規則

構文

sysmail_update_profile_sp [ [ @profile_id = ] profile_id , ] [ [ @profile_name = ] 'profile_name' , ]
    [ [ @description = ] 'description' ]
[ ; ]

引数

[ @profile_id = ] profile_id

更新するプロファイル ID。 @profile_idは int で、既定値は NULL. 少なくとも 1 つの @profile_id または @profile_name を指定する必要があります。 両方を指定すると、プロシージャによってプロファイルの名前が変更されます。

[ @profile_name = ] 'profile_name'

更新するプロファイルの名前、またはプロファイルの新しい名前。 @profile_nameは sysname で、既定値は NULL. 少なくとも 1 つの @profile_id または @profile_name を指定する必要があります。 両方を指定すると、プロシージャによってプロファイルの名前が変更されます。

[ @description = ] 'description'

プロファイルの新しい説明。 @descriptionは nvarchar(256) で、既定値は NULL.

リターン コードの値

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

解説

プロファイル ID とプロファイル名の両方を指定すると、プロシージャはプロファイルの名前を指定された名前に変更し、プロファイルの説明を更新します。 これらの引数のいずれかが指定されている場合、プロシージャはプロファイルの説明を更新します。

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

アクセス許可

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

例

A. プロファイルの説明を変更する

次の例では、データベースに名前が付けられた AdventureWorks Administrator プロファイルの説明を msdb 変更します。

EXEC msdb.dbo.sysmail_update_profile_sp
    @profile_name = 'AdventureWorks Administrator',
    @description = 'Administrative mail profile.';

B. プロファイルの名前と説明を変更する

次の例では、プロファイル ID 750を使用してプロファイルの名前と説明を変更します。

EXEC msdb.dbo.sysmail_update_profile_sp
    @profile_id = 750,
    @profile_name = 'Operator',
    @description = 'Profile to send alert e-mail to operators.';

関連するコンテンツ