Share via

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)를 참조하세요.

Transact-SQL 구문 표기 규칙

구문

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

인수

@job_name

기록 레코드를 삭제할 작업의 이름입니다. job_name 기본값NULL인 nvarchar(128)입니다. job_id 또는 job_name 지정해야 하지만 둘 다 지정할 수는 없습니다.

@job_id

레코드를 삭제할 작업의 ID입니다. job_id 기본값NULL인 uniqueidentifier입니다. job_id 또는 job_name 지정해야 하지만 둘 다 지정할 수는 없습니다.

@oldest_date

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

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

반환 코드 값

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

설명

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

사용 권한

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

예제

이전 작업 기록 삭제

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

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

작업 및 관련된 모든 작업 기록 삭제

다음 예제에서는 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';

관련 콘텐츠