sysmail_delete_mailitems_sp(Transact-SQL)

업데이트: 2006년 4월 14일

데이터베이스 메일의 내부 테이블에서 전자 메일 메시지를 영구 삭제합니다.

Transact-SQL 구문 표기 규칙

구문

sysmail_delete_mailitems_sp  [ [ @sent_before = ] 'sent_before' ]
    [ , [ @sent_status = ] 'sent_status' ]

인수

• [ @sent_before= ] 'sent_before'
  sent_before 인수로 지정한 날짜와 시간까지의 전자 메일을 삭제합니다. sent_before는 datetime이며 기본값은 NULL입니다. NULL은 모든 날짜를 나타냅니다.

• [ @sent_status= ] 'sent_status'
  sent_status 인수로 지정한 유형의 전자 메일을 삭제합니다. sent_status는 **varchar(8)**이며 기본값은 없습니다. 유효한 항목은 sent, unsent, retrying 및 failed입니다. NULL은 모든 상태를 나타냅니다.

반환 코드 값

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

주의

데이터베이스 메일의 메시지 및 첨부 파일은 msdb 데이터베이스에 저장됩니다. msdb가 예상보다 커지는 것을 방지하고 조직의 문서 보관 정책을 준수하기 위해서는 메시지를 주기적으로 삭제해야 합니다. sysmail_delete_mailitems_sp 저장 프로시저를 사용하여 데이터베이스 메일 테이블에서 전자 메일 메시지를 영구 삭제할 수 있습니다. 옵션 인수를 사용하여 특정 날짜 및 시간보다 오래된 전자 메일만 삭제할 수 있습니다. 이 인수에 지정된 날짜 및 시간보다 오래된 전자 메일은 삭제됩니다. 다른 옵션 인수인 sent_status를 사용하여 지정한 특정 유형의 전자 메일만 삭제할 수 있습니다. SQL Server 2005 서비스 팩 1부터 시작하여 @sent_before 또는 @sent_status에 인수를 제공해야 합니다. 두 인수는 NULL이 될 수 없습니다.

전자 메일을 삭제하면 해당 메시지와 관련된 첨부 파일도 삭제됩니다. 전자 메일을 삭제해도 sysmail_event_log의 해당 항목은 삭제되지 않습니다. 로그에서 항목을 삭제하려면 sysmail_delete_log_sp를 사용합니다.

사용 권한

기본적으로 sysadmin 고정 서버 역할 및 DatabaseMailUserRole의 멤버만 이 저장 프로시저를 실행하도록 허용됩니다. sysadmin 고정 서버 역할의 멤버는 이 프로시저를 사용하여 모든 사용자가 보낸 전자 메일을 삭제할 수 있습니다. DatabaseMailUserRole의 멤버는 자신이 보낸 전자 메일만 삭제할 수 있습니다.

예

1. 모든 전자 메일 삭제

다음 예에서는 데이터베이스 메일 시스템의 모든 전자 메일을 삭제합니다.

DECLARE @GETDATE datetime
SET @GETDATE = GETDATE()
EXECUTE msdb.dbo.sysmail_delete_mailitems_sp  @sent_before = @GETDATE;
GO

2. 오래된 전자 메일 삭제

다음 예에서는 데이터베이스 메일 로그에서 October 9, 2005 이전의 전자 메일을 삭제합니다.

EXECUTE msdb.dbo.sysmail_delete_mailitems_sp 
    @sent_before = 'October 9, 2005' ;
GO

3. 특정 유형의 모든 전자 메일 삭제

다음 예에서는 데이터베이스 메일 시스템에서 모든 실패한 전자 메일을 삭제합니다.

EXECUTE msdb.dbo.sysmail_delete_mailitems_sp 
    @sent_status = 'failed' ;
GO

참고 항목

참조

sysmail_allitems(Transact-SQL)
sysmail_event_log(Transact-SQL)
sysmail_mailattachments(Transact-SQL)

관련 자료

방법: 데이터베이스 메일 메시지 및 이벤트 로그 보관을 처리하는 SQL Server 에이전트 작업 만들기
데이터베이스 메일 문제 해결

도움말 및 정보

SQL Server 2005 지원 받기

변경 내역