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