jobs.sp_purge_jobhistory (processi elastici di Azure) (Transact-SQL)

  • Articolo

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 (Transact-SQL).

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

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 entrambi non possono essere specificati.

@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 entrambi non possono essere specificati.

@oldest_date

Il record meno recente da conservare nella cronologia. oldest_date è DATETIME2, con un 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 (operazione completata) o 1 (operazione non riuscita)

Osservazioni:

La cronologia dei processi elastici viene eliminata automaticamente se più di 45 giorni fa.

Autorizzazioni

Per impostazione predefinita, i membri del ruolo predefinito del server sysadmin possono eseguire questa stored procedure. Solo i membri del ruolo sysadmin possono usare questa stored procedure per modificare gli attributi dei processi di proprietà di altri utenti.

Esempi

Eliminare la cronologia dei processi meno recente

L'esempio seguente mostra come eliminare la cronologia dei processi precedente a 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

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';

Contenuto correlato