Udostępnij za pośrednictwem


sp_add_schedule (języka Transact-SQL)

Tworzy harmonogram może być używana przez dowolną liczbę zadań.

Ikona łącza do tematuJęzyka Transact-SQL składni konwencje

Składnia

sp_add_schedule [ @schedule_name = ] 'schedule_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' ]
    [ , [ @schedule_uid = ] schedule_uid OUTPUT ]
    [ , [ @schedule_id = ] schedule_id OUTPUT ]
    [ , [ @originating_server = ] server_name ] /* internal */

Argumenty

  • [ @ schedule_name = ] 'schedule_name"
    Nazwa harmonogramu.schedule_namejest sysname, z braku domyślne.

  • [ @ 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 1i 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 operatorlogicznego lub):

    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_subday_intervalignorowane w tych przypadkach, gdzie freq_subday_type jest równa 1.Uwaga: Interwał powinien być dłuższy niż 10 sekund.

  • [ @ freq_relative_interval = ] freq_relative_interval
    Wystąpienie zadanie freq_interval w każdym miesiącu, jeśli freq_interval wynosi 32 (względne miesięcznych).freq_relative_intervaljest int, domyślnie 0, i może być jedną z tych wartości.freq_relative_intervalignorowane w tych przypadkach, gdzie freq_type nie jest równa 32.

    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, domyślnie 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.

  • [ @ schedule_uid=] schedule_uiddanych wyjściowych
    Identyfikator unikatowy dla harmonogramu.schedule_uidjest zmienną typu uniqueidentifier.

  • [ @ schedule_id=] schedule_iddanych wyjściowych
    Identyfikator harmonogramu.schedule_idjest zmienną typu int.

  • [ @ originating_server=] server_name
    Określone tylko w celach informacyjnych. Nieobsługiwane. Przyszła zgodność nie jest gwarantowana.

Wartości kodów powrotnych

0 (sukces) lub 1 (błąd)

Zestawy wyników

Brak

Uwagi

SQL Server Management Studiozapewnia łatwe, graficzny sposób Zarządzanie zadaniami i jest zalecanym sposobem tworzenia i zarządzania infrastrukturą 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.

Przykłady

A.Tworzenie harmonogramu

Poniższy przykład tworzy harmonogram o nazwie RunOnce.Harmonogram jest uruchamiane jeden czas, na 23:30 na dzień, w którym utworzony harmonogram.

USE msdb ;
GO

EXEC dbo.sp_add_schedule
    @schedule_name = N'RunOnce',
    @freq_type = 1,
    @active_start_time = 233000 ;

GO

B.Tworzenie harmonogramu, dołączanie do wielu zadań w harmonogramie

Poniższy przykład tworzy harmonogram o nazwie NightlyJobs.Zadania używające tego zaplanować wykonać każdego dnia, kiedy czas na serwerze jest 01:00.Przykład dołącza harmonogramu zadanie BackupDatabase i zadanie RunReports.

Ostrzeżenie

W tym przykładzie założono, że zadanie BackupDatabase i zadanie RunReports już istnieje.

USE msdb ;
GO

EXEC sp_add_schedule
    @schedule_name = N'NightlyJobs' ,
    @freq_type = 4,
    @freq_interval = 1,
    @active_start_time = 010000 ;
GO


EXEC sp_attach_schedule
   @job_name = N'BackupDatabase',
   @schedule_name = N'NightlyJobs' ;
GO

EXEC sp_attach_schedule
   @job_name = N'RunReports',
   @schedule_name = N'NightlyJobs' ;
GO