Udostępnij za pośrednictwem


sp_update_schedule (języka Transact-SQL)

Zmienia ustawienia dla SQL Server Agent harmonogramu.

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

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