Bagikan melalui

jobs.sp_add_job (Pekerjaan Azure Elastic) (Transact-SQL)

  • Artikel

Berlaku untuk: Azure SQL Database

Menambahkan pekerjaan baru di layanan Azure Elastic Jobs untuk Azure SQL Database.

Prosedur tersimpan sp_add_job ini berbagi nama dengan objek serupa di SQL Server untuk layanan SQL Server Agent. Untuk informasi tentang versi SQL Server Agent, lihat sp_add_job.

Konvensi sintaks transact-SQL

Sintaks

[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 ]

Argumen

@job_name

Nama pekerjaan. Nama harus unik dan tidak boleh berisi karakter persen (%). job_name adalah nvarchar(128), tanpa default.

@description

Deskripsi dari pekerjaan. deskripsi adalah nvarchar(512), dengan default NULL. Jika deskripsi dihilangkan, string kosong digunakan.

@enabled

Menentukan apakah jadwal pekerjaan diaktifkan. Diaktifkan adalah bit, dengan default 0 (dinonaktifkan). Jika 0, pekerjaan tidak diaktifkan dan tidak berjalan sesuai dengan jadwalnya; namun, pekerjaan dapat dijalankan secara manual. Jika 1, pekerjaan akan berjalan sesuai dengan jadwalnya, dan juga dapat dijalankan secara manual.

@schedule_interval_type

Nilai menunjukkan kapan pekerjaan akan dijalankan. schedule_interval_type adalah nvarchar(50), dengan default Once, dan bisa menjadi salah satu nilai berikut:

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

@schedule_interval_count

Jumlah periode schedule_interval_count yang akan terjadi antara setiap eksekusi pekerjaan. schedule_interval_count int, dengan default 1. Nilai harus lebih besar dari atau sama dengan 1.

@schedule_start_time

Tanggal pelaksaan pekerjaan dapat dimulai. schedule_start_time DATETIME2, dengan default 0001-01-01 00:00:00.00000000.

Setiap kali dalam pekerjaan elastis berada di zona waktu UTC.

@schedule_end_time

Tanggal pelaksaan pekerjaan dapat dihentikan. schedule_end_time DATETIME2, dengan default 9999-12-31 11:59:59.00000000.

Setiap kali dalam pekerjaan elastis berada di zona waktu UTC.

@job_id

Nomor identifikasi pekerjaan yang ditetapkan untuk pekerjaan jika berhasil dibuat. job_id adalah variabel output dari jenis pengidentifikasi unik.

Mengembalikan nilai kode

0 (berhasil) atau 1 (kegagalan).

Keterangan

Prosedur jobs.sp_add_job tersimpan harus dijalankan dari database agen pekerjaan yang ditentukan saat membuat agen pekerjaan.

Setelah jobs.sp_add_job dijalankan untuk menambahkan pekerjaan, jobs.sp_add_jobstep dapat digunakan untuk menambahkan langkah-langkah yang melakukan aktivitas untuk pekerjaan tersebut. Nomor versi awal pekerjaan adalah 0, yang ditambahkan ke 1 saat langkah pertama ditambahkan.

Izin

Secara default, anggota peran server tetap sysadmin dapat menjalankan prosedur tersimpan ini. Hanya anggota sysadmin yang dapat menggunakan prosedur tersimpan ini untuk mengedit atribut pekerjaan yang dimiliki oleh pengguna lain.

Konten terkait