Share via


jobs.sp_add_job(Azure 탄력적 작업)(Transact-SQL)

적용 대상:Azure SQL Database

Azure SQL Database용 Azure Elastic Jobs 서비스에 새 작업을 추가합니다.

이 저장 프로시저는 SQL Server 에이전트 서비스의 SQL Server에서 유사한 개체와 이름을 sp_add_job 공유합니다. 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 기본값Once인 nvarchar(50)이며 다음 값 중 하나일 수 있습니다.

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

@schedule_interval_count

작업의 각 실행 사이에 발생할 schedule_interval_count 기간의 수입니다. schedule_interval_count 기본값1인 int입니다. 값은 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.00000000입니다.

탄력적 작업의 모든 시간은 UTC 표준 시간대를 따릅니다.

@job_id

성공적으로 생성된 작업에 할당되는 작업 ID입니다. job_id uniqueidentifier 형식의 출력 변수입니다.

반환 코드 값

0(성공) 또는 1(실패)

설명

저장 프로시저 jobs.sp_add_job 는 작업 에이전트를 만들 때 지정된 작업 에이전트 데이터베이스에서 실행해야 합니다.

jobs.sp_add_job 작업을 추가하기 위해 실행된 후 jobs.sp_add_jobstep 사용하여 작업에 대한 작업을 수행하는 단계를 추가할 수 있습니다. 작업의 초기 버전 번호는 0첫 번째 단계가 추가될 1 때 증가하는 번호입니다.

사용 권한

sysadmin 고정 서버 역할의 멤버는 기본적으로 이 저장 프로시저를 실행할 수 있습니다. sysadmin의 멤버만 이 저장 프로시저를 사용하여 다른 사용자가 소유한 작업의 특성을 편집할 수 있습니다.