sp_update_schedule (Transact-SQL)sp_update_schedule (Transact-SQL)

DIESES THEMA GILT FÜR:jaSQL Server (ab 2008)neinAzure SQL-DatenbankneinAzure SQL Data Warehouse neinParallel Data Warehouse THIS TOPIC APPLIES TO:yesSQL Server (starting with 2008)noAzure SQL DatabasenoAzure SQL Data Warehouse noParallel Data Warehouse

Ändert die Einstellungen für einen SQL ServerSQL Server-Agent-Zeitplan.Changes the settings for a SQL ServerSQL Server Agent schedule.

Themenlinksymbol Transact-SQL Syntax Conventions (Transact-SQL-Syntaxkonventionen)Topic link icon Transact-SQL Syntax Conventions

SyntaxSyntax


sp_update_schedule   
    {   [ @schedule_id = ] schedule_id   
      | [ @name = ] 'schedule_name' }  
    [ , [ @new_name = ] new_name ]  
    [ , [ @enabled = ] enabled ]  
    [ , [ @freq_type = ] freq_type ]  
    [ , [ @freq_interval = ] freq_interval ]   
    [ , [ @freq_subday_type = ] freq_subday_type ]   
    [ , [ @freq_subday_interval = ] freq_subday_interval ]   
    [ , [ @freq_relative_interval = ] freq_relative_interval ]   
    [ , [ @freq_recurrence_factor = ] freq_recurrence_factor ]   
    [ , [ @active_start_date = ] active_start_date ]   
    [ , [ @active_end_date = ] active_end_date ]   
    [ , [ @active_start_time = ] active_start_time ]   
    [ , [ @active_end_time = ] active_end_time ]   
    [ , [ @owner_login_name = ] 'owner_login_name' ]  
    [ , [ @automatic_post =] automatic_post ]  

ArgumenteArguments

[ @schedule_id = ] Schedule_id[ @schedule_id = ] schedule_id
Der Bezeichner des Zeitplans, der geändert werden soll.The identifier of the schedule to modify. Schedule_id ist Int, hat keinen Standardwert.schedule_id is int, with no default. Entweder Schedule_id oder Schedule_name muss angegeben werden.Either schedule_id or schedule_name must be specified.

[ @name = ] "Schedule_name"[ @name = ] 'schedule_name'
Der Name des zu ändernden Zeitplan.The name of the schedule to modify. Schedule_nameist Sysname, hat keinen Standardwert.schedule_nameis sysname, with no default. Entweder Schedule_id oder Schedule_name muss angegeben werden.Either schedule_id or schedule_name must be specified.

[ @new_name =] Neuer_Name[ @new_name= ] new_name
Der neue Name des Zeitplans.The new name for the schedule. New_name ist Sysname, hat den Standardwert NULL.new_name is sysname, with a default of NULL. Wenn New_name NULL ist, der Namen des Zeitplans bleibt unverändert.When new_name is NULL, the name of the schedule is unchanged.

[ @enabled = ] aktiviert[ @enabled = ] enabled
Gibt den aktuellen Status des Zeitplans an.Indicates the current status of the schedule. aktiviertist "tinyint", hat den Standardwert 1 (aktiviert).enabledis tinyint, with a default of 1 (enabled). Wenn 0, der Zeitplan ist nicht aktiviert.If 0, the schedule is not enabled. Wenn der Zeitplan nicht aktiviert ist, werden über diesen Zeitplan keine Aufträge ausgeführt.When the schedule is not enabled, no jobs will run on this schedule.

[ @freq_type = ] Freq_type[ @freq_type = ] freq_type
Ein Wert, der angibt, wann ein Auftrag ausgeführt werden soll.A value indicating when a job is to be executed. Freq_typeist Int, hat den Standardwert 0, und kann einen der folgenden Werte sein.freq_typeis int, with a default of 0, and can be one of these values.

WertValue BeschreibungDescription
11 EinmalOnce
44 TäglichDaily
88 Wöchentlicher ZeitplanWeekly
1616 Monatlicher ZeitplanMonthly
3232 Monatlich, relativ zum freq_intervalMonthly, relative to freq interval
6464 Ausführen beim Start des SQLServerAgent-DienstsRun when SQLServerAgent service starts
128128 Ausführen, wenn sich der Computer im Leerlauf befindetRun when the computer is idle

[ @freq_interval = ] Freq_interval[ @freq_interval = ] freq_interval
Die Tage, an denen ein Auftrag ausgeführt wird.The days that a job is executed. Freq_interval ist Int, hat den Standardwert 0, und hängt vom Wert der Freq_type.freq_interval is int, with a default of 0, and depends on the value of freq_type.

Wert des Freq_typeValue of freq_type Auswirkung auf Freq_intervalEffect on freq_interval
1 (einmal)1 (once) Freq_interval wird nicht verwendet.freq_interval is unused.
4 (täglich)4 (daily) Jede Freq_interval Tage.Every freq_interval days.
8 (wöchentlich)8 (weekly) Freq_interval kann einen oder mehrere der folgenden (zusammen mit einem OR logischer Operator):freq_interval is one or more of the following (combined with an OR logical operator):

1 = Sonntag1 = Sunday

2 = Montag2 = Monday

4 = Dienstag4 = Tuesday

8 = Mittwoch8 = Wednesday

16 = Donnerstag16 = Thursday

32 = Freitag32 = Friday

64 = Samstag64 = Saturday
16 (monatlich)16 (monthly) Auf der Freq_interval Tag des Monats.On the freq_interval day of the month.
32 (mit relativem Monatsintervall)32 (monthly relative) Freq_interval ist eines der folgenden:freq_interval is one of the following:

1 = Sonntag1 = Sunday

2 = Montag2 = Monday

3 = Dienstag3 = Tuesday

4 = Mittwoch4 = Wednesday

5 = Donnerstag5 = Thursday

6 = Freitag6 = Friday

7 = Samstag7 = Saturday

8 = Tag8 = Day

9 = Arbeitstag9 = Weekday

10 = Wochenendtag10 = Weekend day
64 (wenn der SQLServerAgent-Dienst startet)64 (when SQLServerAgent service starts) Freq_interval wird nicht verwendet.freq_interval is unused.
128128 Freq_interval wird nicht verwendet.freq_interval is unused.

[ @freq_subday_type = ] Freq_subday_type[ @freq_subday_type = ] freq_subday_type
Gibt die Einheiten für Freq_subday_interval.Specifies the units for freq_subday_interval. Freq_subday_typeist Int, hat den Standardwert 0, und kann einen der folgenden Werte sein.freq_subday_typeis int, with a default of 0, and can be one of these values.

WertValue Beschreibung (Einheit)Description (unit)
0 x 10x1 Zum angegebenen ZeitpunktAt the specified time
0 x 20x2 SekundenSeconds
0 x 40x4 MinutenMinutes
0 x 80x8 StundenHours

[ @freq_subday_interval = ] Freq_subday_interval[ @freq_subday_interval = ] freq_subday_interval
Die Anzahl der Freq_subday_type -Perioden zwischen den einzelnen Ausführungen eines Auftrags auftreten.The number of freq_subday_type periods to occur between each execution of a job. Freq_subday_intervalist Int, hat den Standardwert 0.freq_subday_intervalis int, with a default of 0.

[ @freq_relative_interval = ] Freq_relative_interval[ @freq_relative_interval = ] freq_relative_interval
Ein Einzelvorgang des Freq_interval in jedem Monat, wenn Freq_interval ist 32 (mit relativem Monatsintervall).A job's occurrence of freq_interval in each month, if freq_interval is 32 (monthly relative). Freq_relative_intervalist Int, hat den Standardwert 0, und kann einen der folgenden Werte sein.freq_relative_intervalis int, with a default of 0, and can be one of these values.

WertValue Beschreibung (Einheit)Description (unit)
11 ErsterFirst
22 ZweimalSecond
44 DritterThird
88 VierterFourth
1616 LetzterLast

[ @freq_recurrence_factor = ] Freq_recurrence_factor[ @freq_recurrence_factor = ] freq_recurrence_factor
Die Anzahl der Wochen oder Monate zwischen der geplanten Ausführung eines Auftrags.The number of weeks or months between the scheduled execution of a job. Freq_recurrence_factor wird nur verwendet, wenn Freq_type ist 8, 16, oder 32.freq_recurrence_factor is used only if freq_type is 8, 16, or 32. Freq_recurrence_factorist Int, hat den Standardwert 0.freq_recurrence_factoris int, with a default of 0.

[ @active_start_date = ] Active_start_date[ @active_start_date = ] active_start_date
Das Datum, an dem die Ausführung eines Auftrags beginnen kann.The date on which execution of a job can begin. Active_start_dateist Int, hat den Standardwert NULL, womit des heutigen Datums.active_start_dateis int, with a default of NULL, which indicates today's date. Das Datum wird das Format YYYYMMDD.The date is formatted as YYYYMMDD. Wenn Active_start_date ist nicht NULL ist, muss das Datum größer oder gleich 19900101 sein.If active_start_date is not NULL, the date must be greater than or equal to 19900101.

Überprüfen Sie nach dem Erstellen des Zeitplans, ob das Startdatum korrekt ist.After the schedule is created, review the start date and confirm that it is the correct date. Weitere Informationen finden Sie im Abschnitt "Planen von Startdaten" in erstellen und Zuweisen von Zeitplänen zu Aufträgen.For more information, see the section "Scheduling Start Date" in Create and Attach Schedules to Jobs.

[ @active_end_date = ] Active_end_date[ @active_end_date = ] active_end_date
Das Datum, an dem die Ausführung eines Auftrags beendet werden kann.The date on which execution of a job can stop. Active_end_dateist Int, hat den Standardwert 99991231, womit der 31. Dezember 9999 angegeben.active_end_dateis int, with a default of 99991231, which indicates December 31, 9999. Im Format JJJJMMTT.Formatted as YYYYMMDD.

[ @active_start_time = ] Active_start_time[ @active_start_time = ] active_start_time
Die Zeit an einem beliebigen Tag zwischen Active_start_date und Active_end_date die Ausführung eines Auftrags beginnen soll.The time on any day between active_start_date and active_end_date to begin execution of a job. Active_start_timeist Int, hat den Standardwert 000000, womit 00:00:00 Uhractive_start_timeis int, with a default of 000000, which indicates 12:00:00 A.M. im 24-Stunden-Format an und muss im Format HHMMSS eingegeben werden.on a 24-hour clock, and must be entered using the form HHMMSS.

[ @active_end_time = ] Active_end_time[ @active_end_time = ] active_end_time
Die Zeit an einem beliebigen Tag zwischen Active_start_date und Active_end_date zu der die Ausführung eines Auftrags.The time on any day between active_start_date and active_end_date to end execution of a job. Active_end_timeist Int, hat den Standardwert 235959, womit 23:59:59 Uhractive_end_timeis int, with a default of 235959, which indicates 11:59:59 P.M. im 24-Stunden-Format an und muss im Format HHMMSS eingegeben werden.on a 24-hour clock, and must be entered using the form HHMMSS.

[ @owner_login_name =] "Owner_login_name"][ @owner_login_name= ] 'owner_login_name']
Der Name des Serverprinzipals, der Besitzer des Zeitplans ist.The name of the server principal that owns the schedule. Owner_login_name ist Sysname, hat den Standardwert NULL, gibt an, dass der Zeitplan im Besitz des Erstellers ist.owner_login_name is sysname, with a default of NULL, which indicates that the schedule is owned by the creator.

[ @automatic_post =] Automatic_post[ @automatic_post =] automatic_post
Reserviert.Reserved.

RückgabecodewerteReturn Code Values

0 (Erfolg) oder 1 (Fehler)0 (success) or 1 (failure)

HinweiseRemarks

Alle Aufträge, die den Zeitplan verwenden, verwenden sofort die neuen Einstellungen.All jobs that use the schedule immediately use the new settings. Zurzeit ausgeführte Aufträge werden durch das Ändern eines Zeitplans jedoch nicht beendet.However, changing a schedule does not stop jobs that are currently running.

BerechtigungenPermissions

Standardmäßig können nur Mitglieder der festen Serverrolle sysadmin diese gespeicherte Prozedur ausführen.By default, members of the sysadmin fixed server role can execute this stored procedure. Andere Benutzer müssen Mitglieder der festen SQL ServerSQL Server -Agent-Datenbankrollen in der msdb -Datenbank sein:Other users must be granted one of the following SQL ServerSQL Server Agent fixed database roles in the msdb database:

  • SQLAgentUserRoleSQLAgentUserRole

  • SQLAgentReaderRoleSQLAgentReaderRole

  • SQLAgentOperatorRoleSQLAgentOperatorRole

    Weitere Informationen zu den Berechtigungen dieser Rollen finden Sie unter Feste Datenbankrollen des SQL Server-Agents.For details about the permissions of these roles, see SQL Server Agent Fixed Database Roles.

    Nur Mitglieder der Sysadmin können einen Zeitplan, der Besitz eines anderen Benutzers ändern.Only members of sysadmin can modify a schedule owned by another user.

BeispieleExamples

Im folgenden Beispiel wird der aktivierte Status des NightlyJobs-Zeitplans zu 0 und der Besitzer zu terrid geändert.The following example changes the enabled status of the NightlyJobs schedule to 0 and sets the owner to terrid.

USE msdb ;  
GO  

EXEC dbo.sp_update_schedule  
    @name = 'NightlyJobs',  
    @enabled = 0,  
    @owner_login_name = 'terrid' ;  
GO  

Siehe auchSee Also

Erstellen und Zuweisen von Zeitplänen zu Aufträgen Create and Attach Schedules to Jobs
Planen eines Auftrags Schedule a Job
Erstellen Sie einen Zeitplan Create a Schedule
SQL Server-Agent-gespeicherte Prozeduren ( Transact-SQL ) SQL Server Agent Stored Procedures (Transact-SQL)
Sp_add_schedule ( Transact-SQL ) sp_add_schedule (Transact-SQL)
Sp_add_jobschedule ( Transact-SQL ) sp_add_jobschedule (Transact-SQL)
Sp_delete_schedule ( Transact-SQL ) sp_delete_schedule (Transact-SQL)
Sp_help_schedule ( Transact-SQL ) sp_help_schedule (Transact-SQL)
sp_attach_schedule (Transact-SQL)sp_attach_schedule (Transact-SQL)