Udostępnij za pośrednictwem

  • Artykuł

sp_update_job (języka Transact-SQL)

Zmienia atrybuty danego zadanie.

Topic link iconKonwencje składni języka Transact-SQL

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
    The identification number of the job to be updated.job_idis uniqueidentifier.

  • [ @job_name =] 'job_name'
    The name of the job.job_nameis nvarchar(128).

    Uwaga

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

  • [ @new_name =] 'new_name'
    The new name for the job.new_nameis nvarchar(128).

  • [ @enabled =] enabled
    Specifies whether the job is enabled (1) or not enabled (0).enabledis tinyint.

  • [ @description =] 'description'
    The description of the job.description is nvarchar(512).

  • [ @start_step_id =] step_id
    The identification number of the first step to execute for the job.step_idis int.

  • [ @category_name =] 'category'
    The category of the job.categoryis nvarchar(128).

  • [ @owner_login_name =] 'login'
    The name of the login that owns the job.loginis nvarchar(128) Only members of the sysadmin fixed server role can change job ownership.

  • [ @notify_level_eventlog =] eventlog_level
    Specifies when to place an entry in the Microsoft Windows application log for this job.eventlog_levelis int, and can be one of these values.

    Wartość

    Jest to nazwa, za pomocą których klucz asymetrycznego jest znany w bazie danych.

    0

    Nigdy nie

    1

    Sygnatura czasowa podczas wystąpienia ostatniego odczytu za pośrednictwem tego połączenia.

    2

    last_write

    3

    Zawsze

  • [ @notify_level_email =] email_level
    Specifies when to send an e-mail upon the completion of this job.email_levelis int.email_leveluses the same values as eventlog_level.

  • [ @notify_level_netsend =] netsend_level
    Specifies when to send a network message upon the completion of this job.netsend_levelis int.netsend_leveluses the same values as eventlog_level.

  • [ @notify_level_page =] page_level
    Specifies when to send a page upon the completion of this job.page_levelis int.page_leveluses the same values as eventlog_level.

  • [ @notify_email_operator_name =] 'email_name'
    The e-mail name of the operator to whom the e-mail is sent when email_level is reached.email_name is nvarchar(128).

  • [ @notify_netsend_operator_name =] 'netsend_operator'
    The name of the operator to whom the network message is sent.netsend_operator is nvarchar(128).

  • [ @notify_page_operator_name =] 'page_operator'
    The name of the operator to whom a page is sent.page_operator is nvarchar(128).

  • [ @delete_level =] delete_level
    Specifies when to delete the job.delete_valueis int.delete_leveluses the same values as eventlog_level.

  • [ @automatic_post =] automatic_post
    Zarezerwowane.

Wartości kodów powrotnych

0 (sukces) lub 1 (brak)

Remarks

sp_update_job musi być uruchamiane msdb bazy danych.

sp_update_job zmienia się tylko te ustawienia, które parametru wartości są dostarczane.Jeśli parametr zostanie pominięty, bieżące ustawienie jest zachowywane.

Uprawnienia

Domyślnie członkowie sysadmin stała rola serwera możliwość wykonać tej procedura przechowywana.Inni użytkownicy klastrowa musi mieć jedną z następujących czynności SQL Server Agent stałe role bazy danych w msdb bazy danych:

  • SQLAgentUserRole

  • SQLAgentReaderRole

  • SQLAgentOperatorRole

Aby uzyskać szczegółowe informacje o uprawnieniach z tych ról zobacz SQL Server Agent Fixed Database Roles.

Tylko członkowie sysadmin można użyć tej procedura przechowywana edytować atrybuty zadań, które są własnością innych użytkowników.

Przykłady

W poniższym przykładzie 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