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

関連項目

参照

SQL Server エージェントのストアド プロシージャ (Transact-SQL)

sp_add_schedule (Transact-SQL)

sp_attach_schedule (Transact-SQL)

sp_delete_schedule (Transact-SQL)

sp_detach_schedule (Transact-SQL)