Condividi tramite


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)

Guida in linea e informazioni

Assistenza su SQL Server 2005