Udostępnij za pośrednictwem

  • Artykuł

sp_delete_jobstep (języka Transact-SQL)

Krok zadanie powoduje usunięcie zadanie.

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

Składnia

sp_delete_jobstep { [ @job_id = ] job_id | [ @job_name = ] 'job_name' } , 
     [ @step_id = ] step_id

Argumenty

  • [ @job_id= ] job_id
    Numer identyfikacyjny zadanie , z którego zostanie usunięty krok.job_idjest uniqueidentifier, domyślna wartość NULL.

  • [ @job_name= ] 'job_name'
    Nazwa zadanie , z którego zostanie usunięty krok.job_namejest sysname, domyślna wartość NULL.

    Ostrzeżenie

    Albo job_id lub job_name muszą być określone; nie może być jednocześnie określone.

  • [ @step_id= ] step_id
    Numer identyfikacyjny kroku usuwana.step_idjest int, z braku domyślne.

Wartości kodów powrotnych

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

Zestawy wyników

Brak

Uwagi

Usuwanie kroku zadanie automatycznie aktualizuje inne kroki zadanie , odwołujące się do usuniętego kroku.

Aby uzyskać więcej informacji o kroki związane z określonego zadanie, należy uruchomić sp_help_jobstep.

Ostrzeżenie

Wywołanie sp_delete_jobstep z step_id o wartości zero powoduje usunięcie wszystkich czynności zadanie dla zadanie.

Microsoft SQL Server Management Studio zapewnia łatwe, graficzny sposób Zarządzanie zadaniami i jest zalecanym sposobem tworzenia i zarządzania infrastrukturą 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 usunąć kroku zadanie , która jest właścicielem przez innego użytkownika.

Przykłady

W poniższym przykładzie usuwane zadanie krok 1 z zadanie Weekly Sales Data Backup.

USE msdb ;
GO

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