Compartir a través de

jobs.sp_purge_jobhistory (trabajos elásticos de Azure) (Transact-SQL)

  • Artículo

Se aplica a: Azure SQL Database

Quita los registros de historial de un trabajo en el servicio Trabajos elásticos de Azure para Azure SQL Database.

Este procedimiento almacenado comparte el nombre de sp_purge_jobhistory con un objeto similar en SQL Server para el servicio Agente SQL Server. Para obtener información sobre la versión de Agente SQL Server, consulte sp_purge_jobhistory.

Convenciones de sintaxis de Transact-SQL

Sintaxis

[jobs].sp_purge_jobhistory [ @job_name = ] 'job_name'
      [ , [ @job_id = ] job_id ]
      [ , [ @oldest_date = ] oldest_date ]

Argumentos

[ @job_name = ] N'job_name'

Nombre del trabajo del que se van a eliminar registros de historial. @job_name es nvarchar(128), con un valor predeterminado de NULL.

Se deben especificar @job_id o @job_name , pero no se pueden especificar ambos.

[ @job_id = ] job_id

Número de identificación del trabajo para los registros que se van a eliminar. @job_id es uniqueidentifier, con un valor predeterminado de NULL.

Se deben especificar @job_id o @job_name , pero no se pueden especificar ambos.

[ @oldest_date = ] oldest_date

Registro más antiguo que se mantendrá en el historial. @oldest_date es datetime2, con un valor predeterminado de NULL. Cuando se especifica @oldest_date , sp_purge_jobhistory solo quita los registros anteriores al valor especificado.

Todas las horas de los trabajos elásticos se encuentran en la zona horaria UTC.

Valores de código de retorno

0 (correcto) o 1 (erróneo).

Comentarios

El historial de trabajos elásticos se elimina automáticamente si tiene más de 45 días de antigüedad.

Permisos

De forma predeterminada, los miembros del rol fijo de servidor sysadmin pueden ejecutar este procedimiento almacenado. Solo los miembros de sysadmin pueden usar este procedimiento almacenado para editar los atributos de los trabajos que pertenecen a otros usuarios.

Ejemplos

A Eliminación del historial de trabajos antiguos

En el ejemplo siguiente se muestra cómo eliminar el historial de trabajos antes de una fecha específica.

Conéctese a la job_database y ejecute el siguiente comando:

--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. Eliminación de un trabajo y de todo el historial de trabajos

En el ejemplo siguiente se muestra cómo eliminar un trabajo mediante jobs.sp_delete_job y todo el historial de trabajos relacionado.

Conéctese a la job_database y ejecute el siguiente comando:

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

Contenido relacionado