sp_help_jobcount (Transact-SQL)sp_help_jobcount (Transact-SQL)

適用対象: yesSQL Server noAzure SQL Database noAzure Synapse Analytics (SQL DW) noParallel Data Warehouse APPLIES TO: yesSQL Server noAzure SQL Database noAzure Synapse Analytics (SQL DW) noParallel Data Warehouse

関連付けられているスケジュールをジョブの数を提供します。Provides the number of jobs that a schedule is attached to.

トピック リンク アイコン Transact-SQL 構文表記規則Topic link icon Transact-SQL Syntax Conventions

構文Syntax

  
sp_help_jobcount   
     [ @schedule_name = ] 'schedule_name' ,  
     [ @schedule_id = ] schedule_id   

引数Arguments

[ @schedule_id = ] schedule_id 一覧表示するスケジュールの識別子。[ @schedule_id = ] schedule_id The identifier of the schedule to list. schedule_idint、既定値はありません。schedule_id is int, with no default. いずれかschedule_idまたはschedule_name指定することがあります。Either schedule_id or schedule_name may be specified.

[ @schedule_name = ] 'schedule_name' 一覧表示するスケジュールの名前。[ @schedule_name = ] 'schedule_name' The name of the schedule to list. schedule_namesysname、既定値はありません。schedule_name is sysname, with no default. いずれかschedule_idまたはschedule_name指定することがあります。Either schedule_id or schedule_name may be specified.

リターン コードの値Return Code Values

0 (成功) または1 (失敗)0 (success) or 1 (failure)

結果セットResult Sets

次の結果セットを返します。Returns the following result set:

列名Column name データ型Data type 説明Description
JobCountJobCount intint 指定されたスケジュールに対するジョブの数。Number of jobs for the specified schedule.

コメントRemarks

この手順では、指定されたスケジュールにアタッチされたジョブの数が一覧表示します。This procedure lists the number of jobs attached to the specified schedule.

アクセス許可Permissions

既定では、このストアド プロシージャを実行できるのは、 sysadmin 固定サーバー ロールのメンバーです。By default, members of the sysadmin fixed server role can execute this stored procedure. 他のユーザーには、 SQL ServerSQL Server msdb データベースの次のいずれかの エージェント固定データベース ロールが許可されている必要があります。Other users must be granted one of the following SQL ServerSQL Server Agent fixed database roles in the msdb database:

  • SQLAgentUserRoleSQLAgentUserRole

  • SQLAgentReaderRoleSQLAgentReaderRole

  • SQLAgentOperatorRoleSQLAgentOperatorRole

これらのロールの権限の詳細については、「 SQL Server エージェントの固定データベース ロール」を参照してください。For details about the permissions of these roles, see SQL Server Agent Fixed Database Roles.

メンバーだけsysadmin他のユーザーによって所有されているジョブの数を表示できます。Only members of sysadmin can view counts for jobs that are owned by others.

使用例Examples

次の例では、NightlyJobs スケジュールにアタッチされたジョブの数を一覧表示します。The following example lists the number of jobs attached to the NightlyJobs schedule.

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

関連項目See Also

SQL Server エージェント ストアド プロシージャ(TRANSACT-SQL) SQL Server Agent Stored Procedures (Transact-SQL)
sp_add_schedule (TRANSACT-SQL) sp_add_schedule (Transact-SQL)
sp_attach_schedule (TRANSACT-SQL) sp_attach_schedule (Transact-SQL)
sp_delete_schedule (TRANSACT-SQL) sp_delete_schedule (Transact-SQL)
sp_detach_schedule (TRANSACT-SQL)sp_detach_schedule (Transact-SQL)