sp_delete_jobstep (Transact-SQL)

  • Articolo

Si applica a: SQL Server Istanza gestita di SQL di Azure

Rimuove un passaggio di processo da un processo nel servizio SQL Server Agent.

Convenzioni relative alla sintassi Transact-SQL

Sintassi

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

Argomenti

[ @job_id = ] 'job_id'

Numero di identificazione del processo da cui si desidera rimuovere il passaggio. @job_id è uniqueidentifier, con un valore predefinito .NULL

È necessario specificare @job_id o @job_name . Non è possibile specificare entrambi.

[ @job_name = ] N'job_name'

Nome del processo da cui si desidera rimuovere il passaggio. @job_name è sysname, con il valore predefinito NULL.

È necessario specificare @job_id o @job_name . Non è possibile specificare entrambi.

[ @step_id = ] step_id

Numero di identificazione del passaggio da rimuovere. @step_id è int, senza impostazione predefinita.

Valori del codice restituito

0 (esito positivo) o 1 (errore).

Set di risultati

Nessuno.

Osservazioni:

Se si rimuove un passaggio di un processo, gli altri passaggi del processo che fanno riferimento al passaggio eliminato vengono aggiornati automaticamente.

Per altre informazioni sui passaggi associati a un determinato processo, eseguire sp_help_jobstep.

Nota

La chiamata sp_delete_jobstep con un valore @step_id pari a zero elimina tutti i passaggi del processo.

SQL Server Management Studio include un semplice strumento grafico per la gestione dei processi ed è lo strumento consigliato per la creazione e gestione dell'infrastruttura dei processi.

Questa stored procedure condivide il nome di con un oggetto simile per il servizio Processi elastici di sp_delete_jobstep Azure per database SQL di Azure. Per informazioni sulla versione dei processi elastici, vedere jobs.sp_delete_jobstep (processi elastici di Azure).

Autorizzazioni

Questa stored procedure è di proprietà del ruolo db_owner . È possibile concedere EXECUTE autorizzazioni per qualsiasi utente, ma queste autorizzazioni possono essere sottoposte a override durante un aggiornamento di SQL Server.

È necessario concedere ad altri utenti uno dei ruoli predefiniti del database di SQL Server Agent seguenti:msdb

  • SQLAgentUserRole
  • SQLAgentReaderRole
  • SQLAgentOperatorRole

Per informazioni dettagliate sulle autorizzazioni di questi ruoli, vedere Ruoli di database predefiniti di SQL Server Agent.

Solo i membri di sysadmin possono eliminare un passaggio di processo di proprietà di un altro utente.

Esempi

Nell'esempio seguente il passaggio di processo 1 viene rimosso dal processo Weekly Sales Data Backup.

USE msdb;
GO

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

Contenuto correlato