Udostępnij za pośrednictwem

  • Artykuł

sp_update_jobstep (Transact-SQL)

Zmienia ustawienie krok w zadaniu jest używana do wykonywania automatycznych działań.

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

sp_update_jobstep 
     {   [@job_id =] job_id 
       | [@job_name =] 'job_name' } ,
     [@step_id =] step_id
     [ , [@step_name =] 'step_name' ]
     [ , [@subsystem =] 'subsystem' ] 
     [ , [@command =] 'command' ]
     [ , [@additional_parameters =] 'parameters' ]
     [ , [@cmdexec_success_code =] success_code ]
     [ , [@on_success_action =] success_action ] 
     [ , [@on_success_step_id =] success_step_id ]
          [ , [@on_fail_action =] fail_action ] 
          [ , [@on_fail_step_id =] fail_step_id ]
     [ , [@server =] 'server' ] 
     [ , [@database_name =] 'database' ]
     [ , [@database_user_name =] 'user' ] 
     [ , [@retry_attempts =] retry_attempts ]
     [ , [@retry_interval =] retry_interval ] 
     [ , [@os_run_priority =] run_priority ]
     [ , [@output_file_name =] 'file_name' ] 
     [ , [@flags =] flags ]
     [ ,  {   [ @proxy_id = ] proxy_id 
            | [ @proxy_name = ] 'proxy_name' }

Argumenty

  • [ @job_id =] job_id
    The identification number of the job to which the step belongs.job_idis uniqueidentifier, with a default of NULL.Albo job_id lub job_name musi być określona, ale nie może być jednocześnie określone.

  • [ @job_name =] 'job_name'
    The name of the job to which the step belongs.job_nameis sysname, with a default of NULL.Albo job_id lub job_name musi być określona, ale nie może być jednocześnie określone.

  • [ @step_id =] step_id
    Numer identyfikacyjny dla kroku zadanie ma zostać zmodyfikowany.This number cannot be changed.step_idis int, with no default.

  • [ @step_name =] 'step_name'
    Is a new name for the step.step_nameis sysname, with a default of NULL.

  • [ @subsystem =] 'subsystem'
    The subsystem used by Microsoft SQL Server Agent to execute command.subsystem is nvarchar(40), with a default of NULL.

  • [ @command =] 'command'
    The command(s) to be executed through subsystem.command is nvarchar(max), with a default of NULL.

  • [ @additional_parameters =] 'parameters'
    Identified for informational purposes only. Not supported. Future compatibility is not guaranteed.

  • [ @cmdexec_success_code =] success_code
    The value returned by a CmdExec subsystem command to indicate that command executed successfully.success_code is int, with a default of NULL.

  • [ @on_success_action =] success_action
    Akcja do wykonania, jeśli w kroku powiedzie się. success_action jest tinyint, z domyślną wartość NULL, i może być jedną z następujących wartości.

    Wartość

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

    1

    Zakończ pracę z sukcesu.

    2

    Zakończ pracę z błędem.

    3

    Przejdź do następnego kroku.

    4

    Przejdź do krokusuccess_step_id.

  • [ @on_success_step_id =] success_step_id
    The identification number of the step in this job to execute if step succeeds and success_action is 4.success_step_id is int, with a default of NULL.

  • [ @on_fail_action =] fail_action
    The action to perform if the step fails.fail_action is tinyint, with a default of NULL and can have one of these values.

    Wartość

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

    1

    Zakończ pracę z sukcesu.

    2

    Zakończ pracę z błędem.

    3

    Przejdź do następnego kroku.

    4

    Przejdź do kroku fail_step_id.

  • [ @on_fail_step_id =] fail_step_id
    The identification number of the step in this job to execute if the step fails and fail_action is 4.fail_step_id is int, with a default of NULL.

  • [ @server =] 'server'
    Identified for informational purposes only. Not supported. Future compatibility is not guaranteed.server jest nvarchar(128), z domyślną wartość NULL.

  • [ @database_name =] 'database'
    The name of the database in which to execute a Transact-SQL step.databaseis sysname.Zmiana ochrony przedDomyślną wartością jest NULL.

  • [ @database_user_name =] 'user'
    The name of the user account to use when executing a Transact-SQL step.useris sysname, with a default of NULL.

  • [ @retry_attempts =] retry_attempts
    The number of retry attempts to use if this step fails.retry_attemptsis int, with a default of NULL.

  • [ @retry_interval =] retry_interval
    The amount of time in minutes between retry attempts.retry_interval is int, with a default of NULL.

  • [ @os_run_priority =] run_priority
    Identified for informational purposes only. Not supported. Future compatibility is not guaranteed.

  • [ @output_file_name =] 'file_name'
    The name of the file in which the output of this step is saved.file_name is nvarchar(200), with a default of NULL.Ten parametr jest prawidłowy tylko za pomocą poleceń w Transact-SQL lub CmdExec podsystemów.

    Aby ustawić output_file_name wartość NULL, należy ustawić output_file_name ciąg pusty ("") lub na ciąg znaków puste, ale nie można używać CHAR(32) Funkcja. Należy na przykład ustawić ten argument na ciąg pusty w następujący sposób:

    @ output_file_name = ""

  • [ @flags =] flags
    An option that controls behavior.flags is int, and can be one of these values.

    Wartość

    Description

    0 (domyślnie)

    Zastąpienie pliku wyjściowego.

    2

    Dołącz do pliku wyjściowego

    4

    Zapisać dane wyjściowe języka Transact-SQL zadanie krok historia krok

    8

    Zapisz dziennik w tabeli (zastąp istniejącą historię)

    16

    BucketID

  • [ @ proxy_id= ] proxy_id
    The ID number of the proxy that the job step runs as.proxy_id is type int, with a default of NULL.Jeśli nie proxy_id jest określony, nie proxy_name jest określony, a nie user_name jest określony, krok zadanie jest uruchamiane jako konto dla SQL Server Agent.

  • [ @ proxy_name= ] "proxy_name'
    The name of the proxy that the job step runs as.proxy_name is type sysname, with a default of NULL.Jeśli nie proxy_id jest określony, nie proxy_name jest określony, a nie user_name jest określony, krok zadanie jest uruchamiane jako konto dla SQL Server Agent.

Wartości kodów powrotnych

0 (sukces) lub 1 (brak)

Remarks

sp_update_jobstep musi być uruchamiane msdb bazy danych.

Aktualizowanie zadanie numer wersja zwiększa krok do zadania.

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 aktualizować zadanie krok posiadanych przez innego użytkownika.

Jeśli krok zadanie wymaga dostępu do serwer proxy, twórca kroku zadanie musi mieć dostęp do serwera proxy dla kroku zadania.Wszystkich podsystemów, oprócz języka Transact-SQL, wymaga konto proxy.Członkowie sysadmin mają dostęp do wszystkich serwerów proxy i może używać SQL Server Konto usługa agenta serwera proxy.

Przykłady

Liczba prób ponawiania dla pierwszego kroku zmieni się w następującym przykładzie Weekly Sales Data Backup zadanie. Po uruchomieniu w tym przykładzie, to liczba prób ponawiania prób 10.

USE msdb ;
GO

EXEC dbo.sp_update_jobstep
    @job_name = N'Weekly Sales Data Backup',
    @step_id = 1,
    @retry_attempts = 10 ;
GO