Megosztás a következőn keresztül:


sp_delete_schedule (Transact-SQL)

A következőkre vonatkozik:SQL Server

Törli az ütemtervet.

Transact-SQL szintaxis konvenciók

Szemantika

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

A törlésre kerülő melléklet ütemezési azonosító száma. @schedule_idint, alapértelmezés NULL.

Vagy @schedule_id , akár @schedule_name meg kell határozni, de mindkettőt nem lehet meghatározni.

[ @schedule_name = ] N'schedule_name'

A törlésre szánt menetrend neve. @schedule_name a sysname, alapértelmezés NULLszerint .

Vagy @schedule_id , akár @schedule_name meg kell határozni, de mindkettőt nem lehet meghatározni.

[ @force_delete = ] force_delete

Megadja, hogy az eljárás elbukjon-e, ha az ütemezés egy feladathoz van csatolva. @force_deletebit, alapértelmezettként 0.

  • Ha @force_delete , 0a tárolt eljárás meghibásodik, ha az ütemezés egy feladathoz van csatolva.
  • Ha @force_delete1, az ütemezés törlődik, függetlenül attól, hogy az időpont egy feladathoz van-e csatolva.

[ @automatic_post = ] automatic_post

Csak tájékoztatási célokra van meghatározva. Nem támogatott. A jövőbeli kompatibilitás nem garantált.

Kódértékek visszaadása

0 (sikeres) vagy 1 (hiba).

Eredményhalmaz

Nincs.

Megjegyzések

Alapértelmezés szerint az ütemezés nem törölhető, ha az egy munkaidőhöz van kötve. Egy feladathoz csatolt ütemezés törléséhez megadjunk egy értéket1 @force_delete értékére. Egy ütemezés törlése nem állítja meg a jelenleg futó munkákat.

Permissions

Ezen az eljáráshoz engedélyeket adhatsz EXECUTE , de ezek az engedélyek felülbírálhatók egy SQL Server frissítés során.

Más felhasználóknak az alábbi SQL Server Agent rögzített adatbázis-szerepek egyikét kell megadniuk az msdb adatbázisban:

  • SQLAgentUserRole
  • SQLAgentReaderRole
  • SQLAgentOperatorRole

A munka tulajdonosa összekapcsolhat egy munkát egy beosztáshoz, és leválaszthat egy munkát az órarendtől anélkül, hogy ő is az időbeosztás tulajdonosának kellene lennie. Azonban egy menetrend nem törölhető, ha a leválasztó munka nélkül hagyná, kivéve, ha a hívó az időpont tulajdonosa.

Ezeknek a szerepköröknek a jogosultságairól az SQL Server Agent Fixed Database Roles oldalon találja a részleteket.

Csak a rendszergazdi szerep tagjai törölhetnek egy másik felhasználó tulajdonában lévő munkamenetrendet.

Példák

A. Egy ütemterv törlése

A következő példa törli az ütemtervet NightlyJobs. Ha az ütemezés bármely feladathoz van csatolva, a példa nem törli az ütemezést.

USE msdb;
GO

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

B. Töröld a munkavégzéshez csatolt beosztást

A következő példa törli az ütemezést RunOnce, függetlenül attól, hogy az az időpont egy feladathoz van-e csatolva.

USE msdb;
GO

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