sp_help_operator (Transact-SQL)

  • [アーティクル]

適用対象: SQL サーバー

サーバーに対して定義されている演算子に関する情報を報告します。

Transact-SQL 構文表記規則

構文

sp_help_operator
    [ [ @operator_name = ] N'operator_name' ]
    [ , [ @operator_id = ] operator_id ]
[ ; ]

引数

[ @operator_name = ] N'operator_name'

演算子名。 @operator_name は sysname で、既定値は NULL です。 @operator_nameが指定されていない場合は、すべての演算子に関する情報が返されます。

@operator_idまたは@operator_nameを指定する必要がありますが、両方を指定することはできません。

[ @operator_id = ] operator_id

情報が要求されるオペレーターの識別番号。 @operator_id は int で、既定値は NULL です。

@operator_idまたは@operator_nameを指定する必要がありますが、両方を指定することはできません。

リターン コードの値

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

結果セット

列名 データ型 説明
id int オペレーター識別番号。
name sysname 演算子名。
enabled tinyint オペレーターが通知を受け取ることが可能かどうか。

1 = はい
0 = いいえ
email_address nvarchar(100) オペレーターの電子メール アドレス。
last_email_date int オペレーターが電子メールで最後に通知された日付。
last_email_time int オペレーターが電子メールで最後に通知された時刻。
pager_address nvarchar(100) オペレーター ポケットベル アドレス。
last_pager_date int オペレーターが前回、ポケットベルによる通知を受け取った日付。
last_pager_time int オペレーターがポケットベルによって最後に通知された時刻。
weekday_pager_start_time int 平日にオペレーターがポケットベルによる通知を受け取ることのできる開始時刻。
weekday_pager_end_time int オペレーターが平日にポケットベル通知を受信できる期間の終了。
saturday_pager_start_time int 土曜日にオペレーターがポケットベル通知を受信できる期間の開始。
saturday_pager_end_time int 土曜日にオペレーターがポケットベルによる通知を受け取ることのできる最終時刻。
sunday_pager_start_time int 日曜日にオペレーターがポケットベルによる通知を受け取ることのできる開始時刻。
sunday_pager_end_time int 日曜日にオペレーターがポケットベルによる通知を受け取ることのできる最終時刻。
pager_days tinyint オペレーターがポケットベル通知を受け取るタイミングを示す曜日のビットマスク (1 = 日曜日、 64 = 土曜日)。
netsend_address nvarchar(100) ネットワーク ポップアップ通知のオペレーター アドレス。
last_netsend_date int オペレーターがネットワーク ポップアップによって最後に通知された日付。
last_netsend_time int オペレーターが前回、ネットワーク ポップアップによる通知を受け取った時刻。
category_name sysname このオペレーターが所属するオペレーター カテゴリの名前。

解説

sp_help_operator は、 msdb データベースから実行する必要があります。

アクセス許可

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

他のユーザーには、msdb データベース内の次SQL Server エージェント固定データベース ロールのいずれかを付与する必要があります。

  • SQLAgentUserRole
  • SQLAgentReaderRole
  • SQLAgentOperatorRole

これらのロールの権限の詳細については、「 SQL Server エージェントの固定データベース ロール」を参照してください。

例

次の例では、オペレーター François Ajenstat についての情報をレポートします。

USE msdb;
GO

EXEC dbo.sp_help_operator
    @operator_name = N'François Ajenstat';
GO

関連するコンテンツ