sp_update_jobstep (języka Transact-SQL)

Składnia

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
  Numer identyfikacyjny zadanie , do której należy dany etap.job_idjest uniqueidentifier, domyślna wartość NULL.Albo job_id lub job_name musi być określony, ale nie może być jednocześnie określone.

• [ @ job_name =] 'job_name"
  Nazwa zadanie , do której należy dany etap.job_namejest sysname, domyślna wartość NULL.Albo job_id lub job_name musi być określony, ale nie może być jednocześnie określone.

• [ @ step_id =] step_id
  Numer identyfikacyjny dla kroku zadanie ma zostać zmodyfikowana.Nie można zmienić tego numeru.step_idjest int, z braku domyślne.

• [ @ step_name =] 'step_name"
  To nowa nazwa dla etapu.step_namejest sysname, domyślna wartość NULL.

• [ @ podsystemu =] 'subsystem"
  Podsystem używany przez Microsoft SQL Server agenta w celu wykonać command.subsystemjest nvarchar(40), domyślna wartość NULL.

• [ polecenie @ =] 'command"
  Command(s), które mają być wykonane przez subsystem.commandjest nvarchar(max), domyślna wartość NULL.

• [ @ additional_parameters =] 'parameters"
  Określone tylko w celach informacyjnych. Nieobsługiwane. Przyszła zgodność nie jest gwarantowana.

• [ @ cmdexec_success_code = ] success_code
  Wartość zwracana przez CmdExec polecenia podsystemu, aby wskazać, że command została wykonana pomyślnie.success_codejest int, domyślna wartość NULL.

• [ @ on_success_action =] success_action
  akcja Aby wykonać krok powiedzie się.success_action jest tinyint, domyślna wartość NULL, i może być jedną z tych wartości.

  Wartość	Opis (akcja)
  1	Zakończyć pracę z powodzeniem.
  2	Zakończyć pracę z błędem.
  3	Przejdź do następnego kroku.
  4	Przejdź do krokusuccess_step_id.

• [ @ on_success_step_id = ] success_step_id
  Numer identyfikacyjny krok to zadanie , aby wykonać , jeśli krok i success_action jest 4.success_step_idjest int, domyślna wartość NULL.

• [ @ on_fail_action =] fail_action
  akcja Aby wykonać krok nie powiedzie się.fail_actionjest tinyint, z domyślnej wartości NULL i może mieć jeden z tych wartości.

  Wartość	Opis (akcja)
  1	Zakończyć pracę z powodzeniem.
  2	Zakończyć pracę z błędem.
  3	Przejdź do następnego kroku.
  4	Przejdź do kroku fail_step_id.

• [ @ on_fail_step_id =] fail_step_id
  Numer identyfikacyjny krok to zadanie , aby wykonać Jeśli krok nie powiedzie się i fail_action jest 4.fail_step_idjest int, domyślna wartość NULL.

• [ @ Serwer = ] 'server"
  Określone tylko w celach informacyjnych. Nieobsługiwane. Przyszła zgodność nie jest gwarantowana. serverjest nvarchar(128), domyślna wartość NULL.

• [ @ nazwa_bazy_danych =] 'database"
  Nazwa bazy danych, w którym wykonać Transact-SQL krok.database* *is sysname.Nazwy, które są ujęte w nawiasy kwadratowe ([]) nie są dozwolone.Wartością domyślną jest NULL.

• [ @ database_user_name =] 'user"
  Nazwa konta użytkownika, należy użyć podczas wykonywania Transact-SQL krok.user* *jest sysname, domyślna wartość NULL.

• [ @ retry_attempts =] retry_attempts
  Liczba ponownych prób próbuje użyć, jeśli ten krok nie powiedzie się.retry_attemptsjest int, domyślna wartość NULL.

• [ @ retry_interval =] retry_interval
  Ilość czas w minutach między ponownych prób.retry_intervaljest int, domyślna wartość NULL.

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

• [ @ output_file_name =] 'file_name"
  Nazwa pliku, w którym jest zapisane dane wyjściowe tego kroku.file_namejest nvarchar(200), domyślna wartość NULL.Ten parametr jest prawidłowy tylko za pomocą poleceń w Transact-SQL lub CmdExec podsystemów.

  Aby output_file_name zestaw na NULL należy zestaw output_file_name na pusty ciąg (" ') lub ciąg spacji, ale nie można używać CHAR(32) funkcja.Na przykład ten argument pusty ciąg jak zestaw następująco:

  @ output_file_name = " "

• [ @ flags =] flags
  Opcja, która kontroluje zachowanie.flagsjest int, i może być jedną z tych wartości.

  Wartość	Opis
  0 (wartość domyślna)	Zastąpienie pliku wyjściowego.
  2	Dołącz do pliku wyjściowego
  4	Zapisywanie danych wyjściowych krokzadanie języka Transact -SQLdo historia
  8	Zapis dziennika do tabela (Zastąp istniejący historia)
  16	Zapis dziennika do tabela (dodawaj do istniejącego historia)

• [ @ proxy_id=] proxy_id
  Numer identyfikacyjny krok zadanie działającą jako serwer proxy.proxy_idTyp int, domyślna wartość NULL.Jeśli nie proxy_id jest określony, nie proxy_name jest określona i nie user_name jest określony krok zadanie jest uruchamiane jako konto usługa dla SQL Server agenta.

• [ @ proxy_name=] 'proxy_name"
  Nazwa serwera proxy, który krok zadanie jest uruchamiane jako.proxy_nameTyp sysname, domyślna wartość NULL.Jeśli nie proxy_id jest określony, nie proxy_name jest określona i nie user_name jest określony krok zadanie jest uruchamiane jako konto usługa dla SQL Server agenta.

Wartości kodów powrotnych

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

Uwagi

sp_update_jobstep należy uruchomić z msdb bazy danych.

Aktualizowanie krok zadanie zwiększa numerwersja 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.

Tylko członkowie sysadmin można aktualizować krok zadanie posiadane przez innego użytkownika.

Jeśli krok zadanie wymaga dostępu do serwera proxy, twórca krok zadanie musi mieć dostęp do serwera proxy dla kroku zadanie .Wszystkie podsystemy, z wyjątkiem języka Transact -SQL, wymaga konto proxy.Członkowie sysadmin mają dostęp do wszystkich serwerów proxy i za pomocą SQL Server konta usługa Agent proxy.

Przykłady

Poniższy przykład powoduje zmianę liczby ponownych prób dla pierwszego kroku Weekly Sales Data Backup zadanie.Po uruchomieniu w tym przykładzie, liczba ponownych prób jest 10.

USE msdb ;
GO

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

Zobacz także

Odwołanie

Koncepcje