• [アーティクル]

sp_help_jobcount (Transact-SQL)

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

トピック リンク アイコン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