jobs.sp_purge_jobhistory (processi elastici di Azure) (Transact-SQL)
Si applica a: 
Database SQL di Azure
Rimuove i record di cronologia per un processo nel servizio Processi elastici di Azure per database SQL di Azure.
Questa stored procedure condivide il nome di sp_purge_jobhistory con un oggetto simile in SQL Server per il servizio SQL Server Agent. Per informazioni sulla versione di SQL Server Agent, vedere sp_purge_jobhistory.
Convenzioni relative alla sintassi Transact-SQL
Sintassi
[jobs].sp_purge_jobhistory [ @job_name = ] 'job_name'
[ , [ @job_id = ] job_id ]
[ , [ @oldest_date = ] oldest_date ]
Argomenti
[ @job_name = ] N'job_name'
Nome del processo di cui si desidera eliminare i record della cronologia. @job_name è nvarchar(128), con il valore predefinito NULL.
È necessario specificare @job_id o @job_name , ma non è possibile specificare entrambi.
[ @job_id = ] job_id
Numero di identificazione del processo dei record da eliminare. @job_id è uniqueidentifier, con un valore predefinito .NULL
È necessario specificare @job_id o @job_name , ma non è possibile specificare entrambi.
[ @oldest_date = ] oldest_date
Il record meno recente da conservare nella cronologia. @oldest_date è datetime2, con il valore predefinito NULL. Quando si specifica @oldest_date , sp_purge_jobhistory rimuove solo i record meno recenti del valore specificato.
Tutti gli orari nei processi elastici sono espressi nel fuso orario UTC.
Valori del codice restituito
0 (esito positivo) o 1 (errore).
Osservazioni:
La cronologia dei processi elastici viene eliminata automaticamente se più di 45 giorni fa.
Autorizzazioni
Per impostazione predefinita, questa stored procedure può essere eseguita dai membri del ruolo predefinito del server sysadmin . Solo i membri di sysadmin possono utilizzare questa stored procedure per modificare gli attributi dei processi di proprietà di altri utenti.
Esempi
R. Eliminare la cronologia dei processi meno recente
Nell'esempio seguente viene illustrato come eliminare la cronologia dei processi prima di una data specifica.
Connettersi al database job_database ed eseguire il comando seguente:
--Connect to the job database specified when creating the job agent
-- Delete history of a specific job's executions older than the specified date
EXEC jobs.sp_purge_jobhistory
@job_name = 'ResultPoolsJob',
@oldest_date = '2016-07-01 00:00:00';
GO
B. Eliminare un processo e tutta la relativa cronologia
Nell'esempio seguente viene illustrato come eliminare un processo usando jobs.sp_delete_job e tutta la cronologia dei processi correlata.
Connettersi al database job_database ed eseguire il comando seguente:
--Connect to the job database specified when creating the job agent
--Delete a job and all its history
EXEC jobs.sp_delete_job @job_name = 'ResultsPoolsJob';