sp_help_operator (Transact-SQL)

  • [アーティクル]

サーバーに対して定義されたオペレーターに関する情報をレポートします。

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

構文

sp_help_operator
     { [ @operator_name = ] 'operator_name' 
     | [ @operator_id = ] operator_id }

引数

  • [ @operator_name= ] 'operator_name'
    オペレーター名を指定します。 operator_name のデータ型は sysname です。 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 データベースから実行する必要があります。

権限

既定では、このストアド プロシージャを実行できるのは、sysadmin 固定サーバー ロールのメンバーです。 他のユーザーには、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

関連項目

参照

sp_add_operator (Transact-SQL)

sp_delete_operator (Transact-SQL)

sp_update_operator (Transact-SQL)

システム ストアド プロシージャ (Transact-SQL)