jobs.sp_purge_jobhistory (trabajos elásticos de Azure) (Transact-SQL)
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 (Transact-SQL).
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
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
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
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 (error)
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
Eliminación del historial de trabajos antiguos
En el ejemplo siguiente se muestra cómo eliminar el historial de trabajos anteriores a una fecha concreta.
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
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';