Bagikan melalui

sp_delete_jobstep (T-SQL)

  • Artikel

Berlaku untuk: SQL Server Azure SQL Managed Instance

Menghapus langkah pekerjaan dari pekerjaan di layanan SQL Server Agent.

Konvensi sintaks transact-SQL

Sintaks

sp_delete_jobstep
    [ [ @job_id = ] 'job_id' ]
    [ , [ @job_name = ] N'job_name' ]
    , [ @step_id = ] step_id
[ ; ]

Argumen

[ @job_id = ] 'job_id'

Nomor identifikasi pekerjaan tempat langkah akan dihapus. @job_id adalah uniqueidentifier, dengan default NULL.

Baik @job_id atau @job_name harus ditentukan; keduanya tidak dapat ditentukan.

[ @job_name = ] N'job_name'

Nama pekerjaan yang mana langkahnya akan dihapus. @job_name adalah sysname, dengan default NULL.

Baik @job_id atau @job_name harus ditentukan; keduanya tidak dapat ditentukan.

[ @step_id = ] step_id

Nomor identifikasi langkah yang dihapus. @step_id int, tanpa default.

Mengembalikan nilai kode

0 (berhasil) atau 1 (kegagalan).

Tataan hasil

Tidak ada.

Keterangan

Menghapus langkah pekerjaan secara otomatis memperbarui langkah pekerjaan lain yang mereferensikan langkah yang dihapus.

Untuk informasi selengkapnya tentang langkah-langkah yang terkait dengan pekerjaan tertentu, jalankan sp_help_jobstep.

Catatan

Memanggil sp_delete_jobstep dengan nilai @step_id nol akan menghapus semua langkah pekerjaan untuk pekerjaan tersebut.

SQL Server Management Studio menyediakan cara grafis yang mudah untuk mengelola pekerjaan, dan merupakan cara yang direkomendasikan untuk membuat dan mengelola infrastruktur pekerjaan.

Prosedur tersimpan sp_delete_jobstep ini berbagi nama dengan objek serupa untuk layanan Azure Elastic Jobs untuk Azure SQL Database. Untuk informasi tentang versi pekerjaan elastis, lihat jobs.sp_delete_jobstep (Pekerjaan Azure Elastic) (Transact-SQL).

Izin

Prosedur tersimpan ini dimiliki oleh peran db_owner . Anda dapat memberikan EXECUTE izin untuk pengguna mana pun, tetapi izin ini dapat ditimpa selama peningkatan SQL Server.

Pengguna lain harus diberikan salah satu peran database tetap SQL Server Agent berikut dalam msdb database:

  • SQLAgentUserRole
  • SQLAgentReaderRole
  • SQLAgentOperatorRole

Untuk detail tentang izin peran ini, lihat Peran Database Tetap Agen SQL Server.

Hanya anggota sysadmin yang dapat menghapus langkah pekerjaan yang dimiliki oleh pengguna lain.

Contoh

Contoh berikut menghapus langkah 1 pekerjaan dari pekerjaan Weekly Sales Data Backup.

USE msdb;
GO

EXEC dbo.sp_delete_jobstep
    @job_name = N'Weekly Sales Data Backup',
    @step_id = 1;
GO

Konten terkait