Udostępnij za pomocą

sp_delete_jobstep (Transact-SQL)

Dotyczy:SQL ServerAzure SQL Managed Instance

Usuwa krok zadania z zadania w usłudze SQL Server Agent.

Transact-SQL konwencje składni

Składnia

sp_delete_jobstep
    [ [ @job_id = ] 'job_id' ]
    [ , [ @job_name = ] N'job_name' ]
    , [ @step_id = ] step_id
[ ; ]

Arguments

[ @job_id = ] 'job_id'

Numer identyfikacyjny zadania, z którego zostanie usunięty ten krok. @job_id jest unikalnym identyfikatorem, z domyślnym .NULL

Należy określić @job_id lub @job_name ; Nie da się tego określić.

[ @job_name = ] N'job_name'

Nazwa stanowiska, z którego ten krok zostanie usunięty. @job_name to nazwa systemu, z domyślnym .NULL

Należy określić @job_id lub @job_name ; Nie da się tego określić.

[ @step_id = ] step_id

Numer identyfikacyjny stopnia usuwanego. @step_id jest inteligencją, bez domyślnego stanowczego.

Zwracanie wartości kodu

0 (powodzenie) lub 1 (niepowodzenie).

Zestaw wyników

Żaden.

Uwagi

Usunięcie kroku zadania automatycznie aktualizuje pozostałe kroki zadania, które odwołują się do usuniętego kroku.

Aby uzyskać więcej informacji o krokach związanych z konkretnym zadaniem, użyj .sp_help_jobstep

Uwaga / Notatka

Połączenie sp_delete_jobstep z wartością @step_id zero usuwa wszystkie kroki zadania dla tego zadania.

Program SQL Server Management Studio zapewnia łatwy, graficzny sposób zarządzania zadaniami i jest zalecanym sposobem tworzenia infrastruktury zadań i zarządzania nią.

Ta procedura przechowywana dzieli nazwę z podobnym sp_delete_jobstep obiektem dla usługi Azure Elastic Jobs dla Azure SQL Database. Aby uzyskać informacje o wersji zadań elastycznych, zobacz jobs.sp_delete_jobstep (Azure Elastic Jobs).

Permissions

Możesz przyznać EXECUTE uprawnienia tej procedurze, ale mogą one zostać nadpisane podczas aktualizacji SQL Server.

Inni użytkownicy muszą otrzymać jedną z następujących stałych ról msdb bazy danych SQL Server Agent:

  • SQLAgentUserRole
  • SQLAgentReaderRole
  • SQLAgentOperatorRole

Szczegóły dotyczące uprawnień tych ról można znaleźć w sekcji SQL Server Agent Fixed Database Roles.

Tylko członkowie administratora systemu mogą usuwać krok zadania, który należy do innego użytkownika.

Przykłady

Poniższy przykład usuwa krok 1 zadania z zadania Weekly Sales Data Backup.

USE msdb;
GO

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

Treści powiązane

  • Last updated on