다음을 통해 공유


jobs.sp_purge_jobhistory(Azure 탄력적 작업)(Transact-SQL)

적용 대상: Azure SQL Database

Azure SQL Database용 Azure Elastic Jobs 서비스에서 작업에 대한 기록 레코드를 제거합니다.

이 저장 프로시저는 SQL Server 에이전트 서비스의 SQL Server에서 유사한 개체와 이름을 sp_purge_jobhistory 공유합니다. SQL Server 에이전트 버전에 대한 자세한 내용은 sp_purge_jobhistory 참조하세요.

Transact-SQL 구문 표기 규칙

구문

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

인수

[ @job_name = ] N'job_name'

기록 레코드를 삭제할 작업의 이름입니다. @job_name 기본값NULL인 nvarchar(128)입니다.

@job_id 또는 @job_name 지정해야 하지만 둘 다 지정할 수는 없습니다.

[ @job_id = ] job_id

레코드를 삭제할 작업의 ID입니다. @job_id 기본값NULLuniqueidentifier입니다.

@job_id 또는 @job_name 지정해야 하지만 둘 다 지정할 수는 없습니다.

[ @oldest_date = ] oldest_date

기록에 보존할 가장 오래된 레코드입니다. @oldest_date 기본값NULLdatetime2입니다. @oldest_date 지정되면 지정된 sp_purge_jobhistory 값보다 오래된 레코드만 제거합니다.

탄력적 작업의 모든 시간은 UTC 표준 시간대를 따릅니다.

반환 코드 값

0(성공) 또는 1(실패).

설명

탄력적 작업 기록은 45일이 넘으면 자동으로 삭제됩니다.

사용 권한

sysadmin 고정 서버 역할의 멤버는 기본적으로 이 저장 프로시저를 실행할 수 있습니다. sysadmin멤버만 이 저장 프로시저를 사용하여 다른 사용자가 소유한 작업의 특성을 편집할 수 있습니다.

예제

A. 이전 작업 기록 삭제

다음 예제에서는 특정 날짜 이전에 작업 기록을 삭제하는 방법을 보여 줍니다.

job_database에 연결하고 다음 명령을 실행합니다:

--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. 작업 및 관련된 모든 작업 기록 삭제

다음 예제에서는 jobs.sp_delete_job 및 모든 관련 작업 기록을 사용하여 작업을 삭제하는 방법을 보여 줍니다.

job_database에 연결하고 다음 명령을 실행합니다:

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