sp_delete_job (Transact-SQL)
Elimina un processo.
Sintassi
sp_delete_job { [ @job_id = ] job_id | [ @job_name = ] 'job_name' } ,
[ , [ @originating_server = ] 'server' ]
[ , [ @delete_history = ] delete_history ]
[ , [ @delete_unused_schedule = ] delete_unused_schedule ]
Argomenti
- [ @job_id= ] job_id
Numero di identificazione del processo da eliminare. job_idè di tipo uniqueidentifier e il valore predefinito è NULL.
[ @job_name= ] 'job_name'
Nome del processo da eliminare. job_name è di tipo sysname e il valore predefinito è NULL.[!NOTA] È necessario specificare l'argomento job_id oppure l'argomento job_namema non è possibile specificarli entrambi.
- [ @originating_server= ] 'server'
Per uso interno.
[ @delete_history= ] delete_history
Specifica se eliminare la cronologia per il processo. delete_history è di tipo bit e il valore predefinito è 1. Quando il valore di delete_history è 1 la cronologia del processo viene eliminata. Quando il valore di delete_history è 0 la cronologia del processo non viene eliminata.Si noti che quando viene eliminato un processo senza eliminare la cronologia, le informazioni cronologiche per il processo non verranno visualizzate nella cronologia del processo di interfaccia utente grafica di SQL Server Agent ma continueranno comunque a risiedere nella tabella sysjobhistory nel database msdb.
- [ @delete_unused_schedule= ] delete_unused_schedule
Specifica se eliminare le pianificazioni associate a questo processo se non sono associate a nessun altro processo. delete_unused_schedule è di tipo bit e il valore predefinito è 1. Quando il valore di delete_unused_schedule è 1, le pianificazioni associate a questo processo vengono eliminate se nessun altro processo vi fa riferimento. Quando il valore di delete_unused_schedule è 0, le pianificazioni non vengono eliminate.
Set di risultati
Nessuno
Osservazioni
L'argomento @originating_server è riservato per uso interno.
L'argomento @delete_unused_schedule assicura la compatibilità con versioni precedenti di SQL Server eliminando automaticamente le pianificazioni che non sono associate ad alcun processo. Si noti che per impostazione predefinita questo parametro assume una funzionalità compatibile con le versioni precedenti. Per mantenere le pianificazioni che non sono associate al processo, è necessario specificare il valore 0 per l'argomento @delete_unused_schedule.
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 non può eliminare i piani di manutenzione né i processi facenti parti dei piani di manutenzione. Per eliminare i piani di manutenzione, utilizzare invece SQL Server Management Studio.
Autorizzazioni
Per impostazione predefinita, questa stored procedure può essere eseguita dai membri del ruolo predefinito del server sysadmin. Gli altri utenti devono appartenere a uno dei seguenti ruoli predefiniti del database di SQL Server Agent nel database msdb:
- SQLAgentUserRole
- SQLAgentReaderRole
- SQLAgentOperatorRole
Per informazioni sulle autorizzazioni di questi ruoli, vedere Ruoli di database predefiniti di SQL Server Agent.
I membri del ruolo predefinito del server sysadmin possono eseguire sp_delete_job per l'eliminazione di qualsiasi processo. Un utente che non appartiene al ruolo predefinito del server sysadmin può eliminare soltanto i processi di sua proprietà.
Valori restituiti
0 (esito positivo) o 1 (esito negativo)
Esempi
Nell'esempio seguente viene eliminato il processo NightlyBackups.
USE msdb ;
GO
EXEC sp_delete_job
@job_name = N'NightlyBackups' ;
GO
Vedere anche
Riferimento
sp_add_job (Transact-SQL)
sp_help_job (Transact-SQL)
sp_update_job (Transact-SQL)
Stored procedure di sistema (Transact-SQL)