Udostępnij za pośrednictwem

  • Artykuł

sp_update_job (języka Transact-SQL)

Zmienia atrybuty zadanie.

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

Składnia

sp_update_job [ @job_id =] job_id | [@job_name =] 'job_name'
     [, [@new_name =] 'new_name' ] 
     [, [@enabled =] enabled ]
     [, [@description =] 'description' ] 
     [, [@start_step_id =] step_id ]
     [, [@category_name =] 'category' ] 
     [, [@owner_login_name =] 'login' ]
     [, [@notify_level_eventlog =] eventlog_level ]
     [, [@notify_level_email =] email_level ]
     [, [@notify_level_netsend =] netsend_level ]
     [, [@notify_level_page =] page_level ]
     [, [@notify_email_operator_name =] 'email_name' ]
     [, [@notify_netsend_operator_name =] 'netsend_operator' ]
     [, [@notify_page_operator_name =] 'page_operator' ]
     [, [@delete_level =] delete_level ] 
     [, [@automatic_post =] automatic_post ]

Argumenty

  • [ @ job_id =] job_id
    Numer identyfikacyjny zadanie mają być aktualizowane.job_idis uniqueidentifier.

  • [ @ job_name =] 'job_name"
    Nazwa zadanie.job_nameis nvarchar(128).

    Ostrzeżenie

    Albo job_id lub job_name musi być określony, ale nie może być jednocześnie określone.

  • [ @ nowa_nazwa =] 'new_name"
    Nowa nazwa zadanie.new_nameis nvarchar(128).

  • [ @ włączone =] enabled
    Określa, czy zadanie jest włączone (1) lub wyłączone (0).enabledis tinyint.

  • [ @ Opis = ] 'description"
    Opis zadanie.descriptionis nvarchar(512).

  • [ @ start_step_id = ] step_id
    Numer identyfikacyjny pierwszy krok do wykonać zadanie.step_idis int.

  • [ @ category_name =] 'category"
    Kategoria zadanie.categoryis nvarchar(128).

  • [ @ owner_login_name = ] 'login"
    Nazwa logowania, który jest właścicielem zadanie.loginjest nvarchar(128) tylko członkowie sysadmin stała rola serwera można zmienić właściciela zadanie .

  • [ @ notify_level_eventlog = ] eventlog_level
    Określa, kiedy należy umieścić wpis w dzienniku aplikacji systemu Microsoft Windows dla tego zadanie.eventlog_leveljest int, i może być jedną z tych wartości.

    Wartość

    Opis (akcja)

    0

    Nigdy nie

    1

    W przypadku powodzenia

    2

    W przypadku awarii

    3

    Zawsze

  • [ @ notify_level_email = ] email_level
    Określa, kiedy wysłać wiadomość e-mail po zakończeniu tego zadanie.email_levelis int.email_levelużywa tej samej wartości jako eventlog_level.

  • [ @ notify_level_netsend = ] netsend_level
    Określa, kiedy wysłać komunikat sieciowy po zakończeniu tego zadanie.netsend_levelis int.netsend_levelużywa tej samej wartości jako eventlog_level.

  • [ @ notify_level_page = ] page_level
    Określa, kiedy wysłać strona po zakończeniu tego zadanie.page_levelis int.page_levelużywa tej samej wartości jako eventlog_level.

  • [ @ notify_email_operator_name = ] 'email_name"
    Nazwa e-mail operator , do którego zostanie wysłana wiadomość e-mail po email_level osiągnięciu.email_nameis nvarchar(128).

  • [ @ notify_netsend_operator_name = ] 'netsend_operator"
    Nazwa operator , do której jest wysyłany komunikat sieciowy.netsend_operatoris nvarchar(128).

  • [ @ notify_page_operator_name = ] 'page_operator"
    Nazwa operator , do którego wysyłane jest strona .page_operatoris nvarchar(128).

  • [ @ delete_level = ] delete_level
    Określa, kiedy usunąć zadanie.delete_valueis int.delete_levelużywa tej samej wartości jako eventlog_level.

  • [ @ automatic_post =] automatic_post
    Zarezerwowane.

Wartości kodów powrotnych

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

Uwagi

sp_update_job należy uruchomić z msdb bazy danych.

sp_update_job zmienia ustawienia, które parametru wartości są dostarczane.Jeśli parametr zostanie pominięty, bieżące ustawienie będzie zachowane.

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 używać tej procedura składowana do edytowania atrybutów zadań, które są własnością innych użytkowników.

Przykłady

Poniższy przykład zmienia nazwę, opis i włączony stan zadanie NightlyBackups.

USE msdb ;
GO

EXEC dbo.sp_update_job
    @job_name = N'NightlyBackups',
    @new_name = N'NightlyBackups -- Disabled',
    @description = N'Nightly backups disabled during server migration.',
    @enabled = 0 ;
GO