sp_help_jobcount (Transact-SQL)

適用対象:SQL Server

スケジュールがアタッチされているジョブの数を提供します。

構文

  
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 固定サーバーロールのメンバーです。他のユーザーには、 SQL Server msdb データベースの次のいずれかの エージェント固定データベースロールが許可されている必要があります。

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

sysadmin のメンバーのみが、他のユーザーが所有するジョブのカウントを表示できます。

次の例では、NightlyJobs スケジュールにアタッチされたジョブの数を一覧表示します。

USE msdb ;  
GO  
  
EXEC sp_help_jobcount  
    @schedule_name = N'NightlyJobs' ;  
GO