Share via

jobs.sp_add_job (Azure エラスティック ジョブ) (Transact-SQL)

  • [アーティクル]

適用対象:Azure SQL Database

Azure SQL Database の Azure Elastic Jobs サービスに 新しいジョブを追加します。

このストアド プロシージャは、SQL Server エージェント サービスの sp_add_job SQL Server の同様のオブジェクトと名前を共有します。 SQL Server エージェントバージョンの詳細については、「sp_add_job (Transact-SQL)」を参照してください。

Transact-SQL 構文表記規則

構文

[jobs].sp_add_job [ @job_name = ] 'job_name'  
  [ , [ @description = ] 'description' ]
  [ , [ @enabled = ] enabled ]
  [ , [ @schedule_interval_type = ] schedule_interval_type ]  
  [ , [ @schedule_interval_count = ] schedule_interval_count ]
  [ , [ @schedule_start_time = ] schedule_start_time ]
  [ , [ @schedule_end_time = ] schedule_end_time ]
  [ , [ @job_id = ] job_id OUTPUT ]

引数

@job_name

ジョブの名前。 名前は一意である必要があり、パーセント (%) 文字を含めることはできません。 job_nameは nvarchar(128) で、既定値はありません。

@description

ジョブの説明。 description は nvarchar(512) で、既定値は NULL. 説明を省略すると、空の文字列が使用されます。

@enabled

ジョブのスケジュールを有効にするかどうかを指定します。 有効 はビットで、既定値は 0 (無効) です。 ジョブが有効ではなく、スケジュールに従って実行されない場合 0は、手動で実行できます。 の場合 1、ジョブはそのスケジュールに従って実行され、手動で実行することもできます。

@schedule_interval_type

値はジョブが実行されるときを示します。 schedule_interval_typeは nvarchar(50) で、既定値は Once、次のいずれかの値になります。

  • Once
  • Minutes
  • Hours
  • Days
  • Weeks
  • Months

@schedule_interval_count

ジョブの 各実行間に発生するschedule_interval_count 期間の数。 schedule_interval_countは int で、既定値は 1. 1 以上の値を指定する必要があります。

@schedule_start_time

ジョブの実行を開始できる日付。 schedule_start_timeはDATETIME2で、既定値は 0001-01-01 00:00:00.0000000 です。

エラスティック ジョブのすべての時間は、UTC タイム ゾーンが適用されます。

@schedule_end_time

ジョブの実行を停止できる日付。 schedule_end_timeはDATETIME2で、既定値は 9999-12-31 11:59:59.0000000 です。

エラスティック ジョブのすべての時間は、UTC タイム ゾーンが適用されます。

@job_id

正常に作成された場合にジョブに割り当てられるジョブ識別番号。 job_idは uniqueidentifier 型の出力変数です。

リターン コードの値

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

解説

ストアド プロシージャ jobs.sp_add_job は、ジョブ エージェントの作成時に指定されたジョブ エージェント データベースから実行する必要があります。

ジョブを追加するために実行された後jobs.sp_add_job、jobs.sp_add_jobstepを使用して、ジョブのアクティビティを実行するステップを追加できます。 ジョブの初期バージョン番号は 0、最初のステップが追加されたときにインクリメントされます 1 。

アクセス許可

既定では、このストアド プロシージャを実行できるのは、 sysadmin 固定サーバー ロールのメンバーです。 このストアド プロシージャを使って、他のユーザーが所有するジョブの属性を編集できるのは、sysadmin のメンバーだけです。

関連するコンテンツ