jobs.sp_add_job （Azure 彈性作業） （Transact-SQL）

  • 發行項

適用於：Azure SQL 資料庫

在適用於 Azure SQL 資料庫 的 Azure 彈性作業服務中新增作業。

這個預存程式會與 SQL Server Agent 服務中的類似物件共用 的名稱 sp_add_job 。 如需 SQL Server Agent 版本的相關信息，請參閱 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

指定是否啟用作業的排程。 Enabled 為 bit，預設值為 0 （disabled）。 如果 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.00000000。

彈性作業的所有時間都在UTC時區。

@schedule_end_time

作業執行可以停止的日期。 schedule_end_time是DATETIME2，預設值為9999-12-31 11：59：59.0000000000。

彈性作業的所有時間都在UTC時區。

@job_id

作業建立成功時，指派給作業的作業識別碼。 job_id是 uniqueidentifier 類型的輸出變數。

傳回碼值

0 (成功) 或 1 (失敗)

備註

您必須從建立作業代理程式時指定的作業代理程式資料庫執行預存程式 jobs.sp_add_job 。

執行作業以新增作業之後 jobs.sp_add_job ， jobs.sp_add_jobstep 可用來新增執行作業活動的步驟。 作業的初始版本號碼是 0，當第一個步驟新增時，會遞增至 1 。

權限

依預設，只有 系統管理員 (sysadmin) 固定伺服器角色的成員，才能夠執行這個預存程序。 只有系統管理員的成員可以使用此預存程序來編輯其他使用者所擁有的作業屬性。

相關內容