sp_attach_schedule (Transact-SQL)

  • [アーティクル]

適用対象:SQL Server

ジョブのスケジュールを設定します。

Transact-SQL 構文表記規則

構文

sp_attach_schedule
    [ [ @job_id = ] 'job_id' ]
    [ , [ @job_name = ] N'job_name' ]
    [ , [ @schedule_id = ] schedule_id ]
    [ , [ @schedule_name = ] N'schedule_name' ]
    [ , [ @automatic_post = ] automatic_post ]
[ ; ]

引数

[ @job_id = ] 'job_id'

スケジュールが追加されるジョブのジョブ識別番号。 @job_idは uniqueidentifier で、既定値は NULL.

@job_idまたは@job_nameを指定する必要がありますが、両方を指定することはできません。

[ @job_name = ] N'job_name'

スケジュールが追加されるジョブの名前。 @job_nameは sysname で、既定値は NULL.

@job_idまたは@job_nameを指定する必要がありますが、両方を指定することはできません。

[ @schedule_id = ] schedule_id

ジョブに設定するスケジュールの識別番号を指定します。 @schedule_idは int で、既定値は NULL.

@schedule_idまたは@schedule_nameを指定する必要がありますが、両方を指定することはできません。

[ @schedule_name = ] N'schedule_name'

ジョブに設定するスケジュールの名前を指定します。 @schedule_nameは sysname で、既定値は NULL.

@schedule_idまたは@schedule_nameを指定する必要がありますが、両方を指定することはできません。

[ @automatic_post = ] automatic_post

@automatic_postはビットで、既定値は 1.

解説

スケジュールとジョブの所有者は同じである必要があります。

スケジュールは複数のジョブに対して設定できます。 ジョブは複数のスケジュールで実行できます。

このストアド プロシージャは、データベースから実行する msdb 必要があります。

アクセス許可

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

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

  • SQLAgentUserRole
  • SQLAgentReaderRole
  • SQLAgentOperatorRole

ジョブ所有者は、スケジュール所有者である必要なく、ジョブをスケジュールにアタッチし、スケジュールからジョブをデタッチできます。 ただし、呼び出し元がスケジュール所有者でない限り、デタッチによってジョブが残らない場合は、スケジュールを削除できません。

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

ユーザーがジョブとスケジュールの両方を所有している場合、SQL Server チェック。

例

次の例では、という名前 NightlyJobsのスケジュールを作成します。 このスケジュールを使用するジョブは、毎日、サーバーの時間が 01:00 になると実行されます。 この例では、ジョブとジョブ BackupDatabase にスケジュールをアタッチします RunReports。

Note

この例では、ジョブとジョブBackupDatabaseRunReportsが既に存在することを前提としています。

USE msdb;
GO

EXEC sp_add_schedule
    @schedule_name = N'NightlyJobs' ,
    @freq_type = 4,
    @freq_interval = 1,
    @active_start_time = 010000 ;
GO

EXEC sp_attach_schedule
   @job_name = N'BackupDatabase',
   @schedule_name = N'NightlyJobs' ;
GO

EXEC sp_attach_schedule
   @job_name = N'RunReports',
   @schedule_name = N'NightlyJobs' ;
GO

関連するコンテンツ