sp_add_jobschedule (języka Transact-SQL)
Tworzy harmonogram dla zadanie.
.gif "Ikona łącza do tematu")
Składnia
sp_add_jobschedule [ @job_id = ] job_id, | [ @job_name = ] 'job_name', [ @name = ] 'name'
[ , [ @enabled = ] enabled_flag ]
[ , [ @freq_type = ] frequency_type ]
[ , [ @freq_interval = ] frequency_interval ]
[ , [ @freq_subday_type = ] frequency_subday_type ]
[ , [ @freq_subday_interval = ] frequency_subday_interval ]
[ , [ @freq_relative_interval = ] frequency_relative_interval ]
[ , [ @freq_recurrence_factor = ] frequency_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 ]
[ , [ @schedule_id = ] schedule_id OUTPUT ]
Argumenty
[ @job_id= ] job_id
Numer identyfikacyjny zadanie , do którego jest dodawana harmonogram zadania.job_idjest uniqueidentifier, z braku domyślne.[ @job_name= ] 'job_name'
Nazwa zadanie , do którego jest dodawana harmonogramu.job_namejest nvarchar(128), z braku domyślne.Ostrzeżenie
Albo job_id lub job_name musi być określona, ale nie może być jednocześnie określone.
[ @name= ] 'name'
Nazwa harmonogramu.namejest nvarchar(128), z braku domyślne.[ @enabled= ] enabled_flag
Wskazuje bieżący stan harmonogramu.enabled_flagjest tinyint, domyślnie 1 (włączone).Jeśli 0, harmonogram nie jest włączona.Po wyłączeniu harmonogramu zadanie nie będzie uruchamiane.[ @freq_type= ] frequency_type
Wartość wskazująca, kiedy zadanie ma zostać wykonana.frequency_typejest int, domyślnie 0, i może mieć jedną z następujących wartości:Wartość
Opis
1
Raz
4
Dzienny
8
Tygodniowy
16
Miesięczne
32
Miesięczne względemfrequency_interval.
64
Uruchomione po SQL Server uruchomieniu usługa agenta.
128
Uruchom, kiedy komputer jest bezczynny.
[ @ freq_interval= ] frequency_interval
Dzień, w którym zadanie jest wykonywane.frequency_intervaljest int, domyślna wartość 0 i zależy od wartości frequency_type jak podano w poniższej tabela:Wartość
Efekt
1 (raz)
frequency_intervaljest nieużywany.
4 (codziennie)
Każdy frequency_interval dni.
8 (co tydzień)
frequency_intervalma jedną lub więcej z następujących czynności (w połączeniu z operatorlogicznego lub):
1 = Niedziela
2 = Poniedziałek
4 = Wtorek
8 = Środa
16 = Czwartek
32 = Piątek
64 = Sobota
16 (co miesiąc)
Na frequency_interval dzień miesiąca.
32 (względne miesięcznych)
frequency_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 = Dzień
9 = Dzień tygodnia
10 = Dzień wolny
64 (po SQL Server uruchamia usługa agenta)
frequency_intervaljest nieużywany.
128
frequency_intervaljest nieużywany.
[ @ freq_subday_type= ] frequency_subday_type
Określa jednostki dla frequency_subday_interval.frequency_subday_typejest int, z Brak domyślnej i może mieć jedną z następujących wartości:Wartość
Opis (jednostka)
0x1
W określonym czas
0x4
Minutes
0x8
Hours
[ @ freq_subday_interval= ] frequency_subday_interval
Liczba frequency_subday_type okresów między każdym wykonanie zadanie.frequency_subday_intervaljest int, domyślna wartość 0.[ @ freq_relative_interval= ] frequency_relative_interval
Dalsze definiuje frequency_interval po frequency_type jest zestaw na 32 (względne miesięcznych).frequency_relative_intervaljest int, z Brak domyślnej i może mieć jedną z następujących wartości:
Wartość
Opis (jednostka)
1
First
2
Drugie
4
Trzecia
8
Czwarty
16
Last
frequency_relative_intervalWskazuje wystąpienie interwału.Na przykład jeśli frequency_relative_interval jest zestaw na 2, frequency_type jest zestaw na 32, i frequency_interval jest zestaw na 3, zaplanowane zadanie mogą się pojawić w drugi wtorek każdego miesiąca.
[ @ freq_recurrence_factor= ] frequency_recurrence_factor
Liczba tygodni lub miesięcy między planowane wykonanie zadanie.frequency_recurrence_factoris used only if frequency_type is zestaw to 8, 16, or 32.frequency_recurrence_factorjest int, domyślna wartość 0.[ @ active_start_date= ] active_start_date
Data, na które zadanie można rozpocząć wykonywanie.active_start_datejest int, z braku domyślne.data jest w formacie RRRRMMDD.Jeśli active_start_date jest zestaw, 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, na które zadanie można zatrzymać wykonywanie.active_end_datejest int, z braku domyślne.data jest 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 wykonania zadanie .active_start_timejest int, z braku domyślne.czas jest formatowana jako HHMMSS na zegarze 24-godzinnym.[ **@ active_end_time=**active_end_time
Czas na dowolny dzień pomiędzy active_start_date i active_end_date do końca wykonanie zadanie .active_end_timejest int, z braku domyślne.czas jest formatowana jako HHMMSS na zegarze 24-godzinnym.[ @schedule_id=schedule_idOUTPUT
Planowanie numer identyfikacyjny przypisany do harmonogramu, jeśli jest tworzony pomyślnie.schedule_idjest zmienną wyjście typu int, z braku domyślne.[ @ schedule_uid=] schedule_uiddanych wyjściowych
Identyfikator unikatowy dla harmonogramu.schedule_uidjest zmienną typu uniqueidentifier.
Wartości kodów powrotnych
0 (sukces) lub 1 (błąd)
Zestawy wyników
Brak
Uwagi
Harmonogramy zadań można teraz zarządzać niezależnie od zadania.Aby dodać harmonogram zadanie, należy użyć sp_add_schedule do tworzenia harmonogramu i sp_attach_schedule dołączyć harmonogram zadanie.
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.
Zobacz także