jobs.sp_update_job (Azure 弹性作业) (Transact-SQL)

适用于:Azure SQL 数据库

更新在 Azure 弹性作业服务中创建的Azure SQL 数据库作业。

此存储过程与 SQL Server 中用于SQL Server 代理服务的类似对象共享名称sp_update_job。 有关SQL Server 代理版本的信息,请参阅sp_update_job

Transact-SQL 语法约定

语法

[jobs].sp_update_job [ @job_name = ] 'job_name'
  [ , [ @new_name = ] 'new_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_name

要更新的作业的名称。 job_name 为 nvarchar(128)。

@new_name

作业的新名称。 new_name为 nvarchar(128)。

@description

作业的说明。 说明参数为 nvarchar(512)。

@enabled

指定作业的计划是已启用 (1) 还是未启用 (0)。 @enabled 位。

@schedule_interval_type

其值指示何时会执行作业。 schedule_interval_type为 nvarchar(50),可以是以下值之一:

  • '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 时区。

返回代码值

0(成功)或 1(失败)。

注解

jobs.sp_add_job执行后添加作业,请使用jobs.sp_add_jobstep添加执行作业活动的步骤。

权限

默认情况下,只有 sysadmin 固定服务器角色的成员才可以执行此存储过程。 仅 sysadmin 的成员可以使用此存储过程来编辑其他用户拥有的作业的属性。