次の方法で共有


sp_help_schedule (Transact-SQL)

適用対象: SQL サーバー

スケジュールに関する情報を一覧表示します。

Transact-SQL 構文表記規則

構文

sp_help_schedule
    [ [ @schedule_id = ] schedule_id ]
    [ , [ @schedule_name = ] N'schedule_name' ]
    [ , [ @attached_schedules_only = ] attached_schedules_only ]
    [ , [ @include_description = ] include_description ]
[ ; ]

引数

[ @schedule_id = ] schedule_id

一覧表示するスケジュールの識別子。 @schedule_idint で、既定値は NULL です。

@schedule_idまたは@schedule_nameを指定できます。

[ @schedule_name = ] N'schedule_name'

一覧表示するスケジュールの名前。 @schedule_namesysname で、既定値は NULL です。

@schedule_idまたは@schedule_nameを指定できます。

[ @attached_schedules_only = ] attached_schedules_only

ジョブがアタッチされているスケジュールのみを表示するかどうかを指定します。 @attached_schedules_onlybit で、既定値は 0 です。 @attached_schedules_only0されると、すべてのスケジュールが表示されます。 @attached_schedules_only1されると、結果セットにはジョブにアタッチされているスケジュールのみが含まれます。

[ @include_description = ] include_description

結果セットに説明を含めるかどうかを指定します。 @include_descriptionビットで、既定値は 0 です。 @include_description0されると、結果セットの@schedule_description列にプレースホルダーが含まれます。 @include_description1されると、スケジュールの説明が結果セットに含まれます。

リターン コードの値

0 (成功) または 1 (失敗)。

結果セット

このプロシージャは、次の結果セットを返します。

列名 データ型 説明
schedule_id int 識別子番号をスケジュールします。
schedule_uid uniqueidentifier スケジュールの識別子。
schedule_name sysname スケジュールの名前。
enabled int スケジュールが有効 (1) か有効でないか (0)。
freq_type int ジョブを実行するタイミングを示す値。

1 = 1 回
4 = 日単位
8 = 週単位
16 = 月単位
32 = 月単位(〘⾳ freq_interval
64 = SQLServerAgent サービスの開始時に実行します。
freq_interval int ジョブが実行される日数。 値は、 freq_typeの値によって異なります。 詳細については、「 sp_add_schedule」を参照してください。
freq_subday_type int freq_subday_intervalの単位。 詳細については、「 sp_add_schedule」を参照してください。
freq_subday_interval int ジョブの各実行間に発生する freq_subday_type 期間の数。 詳細については、「 sp_add_schedule」を参照してください。
freq_relative_interval int スケジュールされたジョブの毎月の freq_interval の発生。 詳細については、「 sp_add_schedule」を参照してください。
freq_recurrence_factor int ジョブのスケジュールされた実行の間の月数。
active_start_date int スケジュールをアクティブにした日付。
active_end_date int スケジュールの終了日。
active_start_time int スケジュールが開始される時刻。
active_end_time int スケジュールを終了する時刻。
date_created datetime スケジュールが作成された日付。
schedule_description nvarchar (4000) スケジュールの英語の説明 (要求された場合)。
job_count int このスケジュールを参照するジョブの数を返します。

解説

パラメーターが指定されていない場合、 sp_help_schedule インスタンス内のすべてのスケジュールの情報が一覧表示されます。

アクセス許可

このストアド プロシージャは、 db_owner ロールによって所有されています。 EXECUTEアクセス許可は任意のユーザーに付与できますが、SQL Server のアップグレード中にこれらのアクセス許可がオーバーライドされる可能性があります。

他のユーザーには、msdb データベース内の次SQL Server エージェント固定データベース ロールのいずれかを付与する必要があります。

  • SQLAgentUserRole
  • SQLAgentReaderRole
  • SQLAgentOperatorRole

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

SQLAgentUserRole のメンバーは、所有しているスケジュールのみを表示できます。

A. インスタンス内のすべてのスケジュールの情報を一覧表示する

次の例では、インスタンスのすべてのスケジュールに関する情報を一覧表示します。

USE msdb;
GO

EXEC dbo.sp_help_schedule;
GO

B. 特定のスケジュールの情報を一覧表示する

次の例では、NightlyJobs というスケジュールに関する情報を一覧表示します。

USE msdb;
GO

EXEC dbo.sp_help_schedule
    @schedule_name = N'NightlyJobs';
GO