sp_help_jobcount (Transact-SQL)
スケジュールがアタッチされているジョブの数を表示します。
構文
sp_help_jobcount
[ @schedule_name = ] 'schedule_name' ,
[ @schedule_id = ] schedule_id
引数
[ @schedule_id= ] schedule_id
一覧表示するスケジュールの識別子を指定します。schedule_id のデータ型は int で、既定値はありません。schedule_id または schedule_name のいずれかを指定できます。[ @schedule_name= ] 'schedule_name'
一覧表示するスケジュールの名前を指定します。schedule_name のデータ型は sysname で、既定値はありません。schedule_id または schedule_name のいずれかを指定できます。
戻り値
0 (成功) または 1 (失敗)
結果セット
次の結果セットを返します。
列名 |
データ型 |
説明 |
---|---|---|
JobCount |
int |
指定されたスケジュールに対するジョブの数。 |
説明
このプロシージャでは、指定されたスケジュールにアタッチされたジョブの数が一覧表示されます。
権限
既定では、このストアド プロシージャを実行できるのは、sysadmin 固定サーバー ロールのメンバです。他のユーザーには、msdb データベースの次のいずれかの SQL Server エージェント固定データベース ロールが許可されている必要があります。
SQLAgentUserRole
SQLAgentReaderRole
SQLAgentOperatorRole
これらのロールの権限の詳細については、「SQL Server エージェントの固定データベース ロール」を参照してください。
sysadmin のメンバのみが、他のメンバが所有するジョブの数を表示できます。
例
次の例では、NightlyJobs スケジュールにアタッチされたジョブの数を一覧表示します。
USE msdb ;
GO
EXEC sp_help_jobcount
@schedule_name = N'NightlyJobs' ;
GO