Aracılığıyla paylaş


sp_delete_job (Transact-SQL)

Şunlar için geçerlidir:SQL ServerAzure SQL Yönetilen Örneği

SQL Server Agent hizmetinden bir işi siler.

Transact-SQL söz dizimi kuralları

Sözdizimi

sp_delete_job
    [ [ @job_id = ] 'job_id' ]
    [ , [ @job_name = ] N'job_name' ]
    [ , [ @originating_server = ] N'originating_server' ]
    [ , [ @delete_history = ] delete_history ]
    [ , [ @delete_unused_schedule = ] delete_unused_schedule ]
[ ; ]

Arguments

[ @job_id = ] 'job_id'

Silecek işin kimlik numarası. @job_iduniqueidentifier'dır ve varsayılan olarak ' NULLdir.

Ya @job_id ya da @job_name belirtilmelidir; İkisi de belirtilemiyor.

[ @job_name = ] N'job_name'

Silecek işin adı. @job_namesysname'dir ve varsayılan olarak .NULL

Ya @job_id ya da @job_name belirtilmelidir; İkisi de belirtilemiyor.

[ @originating_server = ] N'originating_server'

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

[ @delete_history = ] delete_history

İşin geçmişinin silinip silinmediğini belirtir. @delete_historybit'tir, varsayılan olarak .1

  • @delete_history1olduğunda, işin iş geçmişi silinir.
  • @delete_history0olduğunda, iş geçmişi silinmez.

Bir iş silindiğinde ve geçmişi silinmediğinde, işin geçmiş bilgileri SQL Server Agent grafik kullanıcı arayüzü iş geçmişinde görünmez, ancak bilgi sysjobhistory veritabanındaki tabloda msdb kalır.

[ @delete_unused_schedule = ] delete_unused_schedule

Bu işe bağlı takviler başka bir işe bağlı değilse silinip silinmediğini belirtir. @delete_unused_schedulebit'tir, varsayılan 1olarak .

  • @delete_unused_schedule1olduğunda, bu işe bağlı takviler, başka hiçbir iş programa referans vermese silinir.
  • @delete_unused_schedule0olduğunda, programlar silinmez.

Dönüş kodu değerleri

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

Sonuç kümesi

Yok.

Açıklamalar

@originating_server argüman iç kullanım için ayrılmıştır.

@delete_unused_schedule argümanı, herhangi bir işe bağlı olmayan programları otomatik olarak kaldırarak önceki SQL Server sürümleriyle geriye doğru uyumluluk sağlar. Bu parametre varsayılan olarak geriye doğru uyumlu davranışa yöneliktir. İşe bağlı olmayan programları korumak için, değeri 0@delete_unused_schedule argüman olarak sunmalısınız.

SQL Server Management Studio işleri yönetmek için kolay, grafik bir yol sağlar ve iş altyapısını oluşturmak ve yönetmek için önerilen yoldur.

Bu saklanan prosedür bakım planlarını silemiyor ve bakım planlarının parçası olan görevleri silemiyor. Bunun yerine, bakım planlarını silmek için SQL Server Management Studio kullanın.

Bu saklanan prosedür, Azure SQL Veritabanı için Azure Elastic Jobs hizmeti için benzer bir nesneyle aynı adı paylaşırsp_delete_job. Elastic Jobs versiyonu hakkında bilgi için jobs.sp_delete_job (Azure Elastic Jobs) bölümüne bakınız.

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

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

Sysadmin sabit sunucu rolünün üyeleri herhangi bir işi silmek için sp_delete_job çalıştırabilir. Sistem yöneticisi sabit sunucu rolünde olmayan bir kullanıcı, yalnızca o kullanıcının sahip olduğu görevleri silebilir.

Örnekler

Aşağıdaki örnek işi NightlyBackupssiler.

USE msdb;
GO

EXECUTE sp_delete_job @job_name = N'NightlyBackups';
GO