Aracılığıyla paylaş


sp_delete_schedule (Transact-SQL)

Şunlar için geçerlidir: SQL Server

Bir programı siler.

Transact-SQL söz dizimi kuralları

Sözdizimi

sp_delete_schedule
    [ [ @schedule_id = ] schedule_id ]
    [ , [ @schedule_name = ] N'schedule_name' ]
    [ , [ @force_delete = ] force_delete ]
    [ , [ @automatic_post = ] automatic_post ]
[ ; ]

Arguments

[ @schedule_id = ] schedule_id

Silinecek programın takvim tanımlama numarası. @schedule_idint, varsayılan olarak NULL.

Ya @schedule_id ya da @schedule_name belirtilmelidir, ancak ikisi de belirtilemez.

[ @schedule_name = ] N'schedule_name'

Silme programının adı. @schedule_namesysname'dir ve varsayılan olarak ' NULLdir.

Ya @schedule_id ya da @schedule_name belirtilmelidir, ancak ikisi de belirtilemez.

[ @force_delete = ] force_delete

Programın bir işe bağlı olması durumunda prosedürün başarısız olup olmayacağını belirtir. @force_deletebit'tir, varsayılan olarak .0

  • @force_delete0olduğunda, program bir işe bağlıysa saklanan prosedür başarısız olur.
  • @force_delete1olduğunda, program bir işe bağlı olup olmamasından bağımsız olarak silinir.

[ @automatic_post = ] automatic_post

Yalnızca bilgilendirme amacıyla tanımlanır. Desteklenmiyor. Gelecekteki uyumluluk garanti edilmemektedir.

Dönüş kodu değerleri

0 (başarı) veya 1 (başarısızlık).

Sonuç kümesi

Yok.

Açıklamalar

Varsayılan olarak, bir çalışma programı bir işe bağlıysa bir program silinmez. Bir işe bağlı bir programı silmek için, @force_delete için bir değer 1 belirtin. Bir programı silmek, şu anda çalışan işleri durdurmaz.

Permissions

EXECUTE Bu prosedür üzerinde izinler verebilirsiniz, ancak bu izinler SQL Server yükseltmesi sırasında geçersiz kalabilir.

Diğer kullanıcılara, veritabanındaki aşağıdaki sabit veritabanı rollerinden birine msdb sahip olmalıdır:

  • SQLAgentUserRole
  • SQLAgentReaderRole
  • SQLAgentOperatorRole

İş sahibi, bir işi bir programa ekleyebilir ve bir işi programdan ayırabilir, aynı zamanda program sahibi olmak zorunda kalmadan. Ancak, bir takvim işsiz bırakacaksa, arayan program sahibi ise silinmez.

Bu rollerin izinleri hakkında detaylar için SQL Server Agent Fixed Database Roles bölümüne bakınız.

Sadece sistem yöneticisi rolünün üyeleri, başka bir kullanıcıya ait olan iş programını silebilir.

Örnekler

A. Zamanlamayı silme

Aşağıdaki örnek, takvimi NightlyJobssiler. Eğer program herhangi bir işe bağlıysa, örnek programı silmez.

USE msdb;
GO

EXECUTE dbo.sp_delete_schedule @schedule_name = N'NightlyJobs';
GO

B. Bir işe bağlı bir programı sil

Aşağıdaki örnek, programın bir işe bağlı olup olmamasına bakılmaksızın programı RunOncesiler.

USE msdb;
GO

EXECUTE dbo.sp_delete_schedule
    @schedule_name = 'RunOnce',
    @force_delete = 1;
GO