sp_update_schedule (języka Transact-SQL)
Zmienia ustawienia dla SQL Server Agent harmonogramu.
.gif "Ikona łącza do tematu")
Składnia
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 ]
Argumenty
[ @ schedule_id = ] schedule_id
Identyfikator harmonogramu do zmodyfikowania.schedule_idjest int, z braku domyślne.Albo schedule_id lub schedule_name musi być określony.[ @name =] 'schedule_name'
Nazwa harmonogramu do zmodyfikowania.schedule_namejest sysname, z braku domyślne.Albo schedule_id lub schedule_name musi być określony.[ @ nowa_nazwa=] new_name
Nowa nazwa harmonogramu.new_namejest sysname, domyślna wartość NULL.Gdy new_name ma wartość NULL, Nazwa harmonogramu nie ulega zmianie.[ @ włączone = ] enabled
Wskazuje bieżący stan harmonogramu.enabledjest tinyint, domyślnie 1 (włączone).Jeśli 0, harmonogram nie jest włączona.Gdy harmonogramu nie jest włączone, żadne zadanie nie będzie działać zgodnie z tym harmonogramem.[ @ freq_type = ] freq_type
Wartość wskazująca, kiedy zadanie ma zostać wykonana.freq_typejest int, domyślnie 0, i może być jedną z tych wartości.Wartość
Opis
1
Raz
4
Dzienny
8
Tygodniowy
16
Miesięczne
32
Miesięczne względemfreq interval
64
Uruchamianie podczas uruchamiania SQLServerAgent usługa
128
Uruchomić, gdy komputer jest bezczynny
[ @ freq_interval = ] freq_interval
Dni, w których są wykonywane zadanie .freq_intervaljest int, domyślnie 0i zależy od wartości freq_type.Wartośćfreq_type
Wpływ nafreq_interval
1 (raz)
freq_intervaljest nieużywany.
4 (codziennie)
Każdy freq_interval dni.
8 (co tydzień)
freq_intervalma jedną lub więcej z następujących czynności (w połączeniu z lub operatorlogicznego):
1 = Niedziela
2 = Poniedziałek
4 = Wtorek
8 = Środa
16 = Czwartek
32 = Piątek
64 = Sobota
16 (co miesiąc)
Na freq_interval dzień miesiąca.
32 (względne miesięcznych)
freq_intervaljest jedną z następujących czynności:
1 = Niedziela
2 = Poniedziałek
3 = Wtorek
4 = Środa
5 = Czwartek
6 = Piątek
7 = Sobota
8 = Day
9 = Dzień tygodnia
10 = Dzień wolny
64 (po uruchomieniu SQLServerAgent usługa )
freq_intervaljest nieużywany.
128
freq_intervaljest nieużywany.
[ @ freq_subday_type = ] freq_subday_type
Określa jednostki dla freq_subday_interval*.* freq_subday_typejest int, domyślnie 0, i może być jedną z tych wartości.Wartość
Opis (jednostka)
0x1
W określonym czas
0x2
Seconds
0x4
Minutes
0x8
Hours
[ @ freq_subday_interval = ] freq_subday_interval
Liczba freq_subday_type okresów między każdym wykonanie zadanie.freq_subday_intervaljest int, domyślnie 0.[ @ freq_relative_interval = ] freq_relative_interval
Wystąpienie zadanie freq_interval w każdym miesiącu, jeśli freq_interval jest 32 (względne miesięcznych).freq_relative_intervaljest int, domyślnie 0, i może być jedną z tych wartości.Wartość
Opis (jednostka)
1
First
2
Drugie
4
Trzecia
8
Czwarty
16
Last
[ @ freq_recurrence_factor = ] freq_recurrence_factor
Liczba tygodni lub miesięcy między planowane wykonanie zadanie.freq_recurrence_factoris used only if freq_type is 8, 16, or 32.freq_recurrence_factorjest int, domyślnie 0.[ @ active_start_date = ] active_start_date
data rozpoczęciem wykonanie zadanie .active_start_datejest int, z domyślną wartość NULL, która wskazuje bieżącą data.data jest w formacie RRRRMMDD.Jeśli active_start_date nie jest NULL, data musi być większa lub równa 19900101.Po utworzeniu harmonogramu przejrzeć data rozpoczęcia i potwierdzić, że jest poprawną data.Aby uzyskać więcej informacji zobacz sekcję "Planowanie daty rozpoczęcia" in Tworzenie i dołączanie harmonogramy zadań.
[ @ active_end_date = ] active_end_date
data zrezygnować wykonanie zadanie .active_end_datejest int, domyślnie 99991231, która wskazuje 31 grudnia 9999.W formacie RRRRMMDD.[ @ active_start_time = ] active_start_time
czas na dowolny dzień pomiędzy active_start_date i active_end_date do rozpoczęcia realizacji zadanie.active_start_timejest int, z domyślnymi 000000, która wskazuje 0: 00: 00na zegarze 24-godzinnym i muszą być wprowadzane przy użyciu formularza HHMMSS.[ @ active_end_time = ] active_end_time
czas na dowolny dzień pomiędzy active_start_date i active_end_date na celu wykonanie zadanie.active_end_timejest int, domyślnie 235959, która wskazuje od 11:59:59na zegarze 24-godzinnym i muszą być wprowadzane przy użyciu formularza HHMMSS.[ @ owner_login_name=] 'owner_login_name"]
Nazwa podmiotu serwera, który jest właścicielem harmonogramu.owner_login_namejest sysname, domyślna wartość NULL, co oznacza, że harmonogram właścicielem jest twórca.[ @ automatic_post =] automatic_post
Zarezerwowane.
Wartości kodów powrotnych
0 (sukces) lub 1 (błąd)
Uwagi
Wszystkie zadania, które używają harmonogramu natychmiast użyć nowych ustawień.Jednakże zmiana harmonogramu nie zatrzymuje zadania, które są aktualnie uruchomione.
Uprawnienia
Domyślnie członkowie sysadmin stała rola serwera można wykonać tę procedura składowana.Inni użytkownicy muszą być przyznawane jedną z następujących SQL Server Agent ról stałej bazy danych w msdb bazy danych:
SQLAgentUserRole
SQLAgentReaderRole
SQLAgentOperatorRole
Szczegółowe informacje na temat uprawnień tych ról, zobacz Ról stałej bazy danych programu SQL Server Agent.
Tylko członkowie sysadmin można zmodyfikować harmonogram posiadane przez innego użytkownika.
Przykłady
Poniższy przykład powoduje zmianę stanu włączonego NightlyJobs Harmonogram 0 i ustawia właściciela do terrid.
USE msdb ;
GO
EXEC dbo.sp_update_schedule
@name = 'NightlyJobs',
@enabled = 0,
@owner_login_name = 'terrid' ;
GO
Zobacz także