sysmail_delete_profile_sp(Transact-SQL)

아티클
12/15/2008

업데이트: 2006년 12월 12일

데이터베이스 메일에서 사용하는 메일 프로필을 삭제합니다.

구문

sysmail_delete_profile_sp  { [ @profile_id = ] profile_id | [    
        @profile_name = ] 'profile_name' } 
    [, [ @force_delete = ] force_delete ]

인수

[ @profile_id= ] profile_id
삭제할 프로필의 ID입니다. profile_id는 int이며 기본값은 NULL입니다. profile_id 또는 profile_name을 지정해야 합니다.

[ @profile_name= ] 'profile_name'
삭제할 프로필의 이름입니다. profile_name은 sysname이며 기본값은 NULL입니다. profile_id 또는 profile_name을 지정해야 합니다.

[ @force_delete= ] force_delete
force_delete는 bit입니다. 기본값은 1입니다. force_delete가 1인 경우 unsent 또는 retrying 상태인 모든 전자 메일 메시지의 상태가 failed로 업데이트됩니다.

force_delete가 0이고 모든 전자 메일 메시지의 상태가 unsent 또는 retrying인 경우 오류가 발생하거나, 관련된 메시지가 없을 경우 프로필이 삭제됩니다.

반환 코드 값

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

결과 집합

없음

주의

프로필을 삭제해도 프로필에서 사용하는 계정은 삭제되지 않습니다.

이 저장 프로시저는 사용자가 프로필에 액세스할 수 있는지 여부에 관계없이 프로필을 삭제합니다. 사용자에 대한 기본 개인 프로필이나 msdb 데이터베이스에 대한 기본 공개 프로필을 삭제할 때는 주의해야 합니다. 기본 프로필을 사용할 수 없는 경우 sp_send_dbmail에는 인수로 프로필 이름이 필요합니다. 따라서 기본 프로필을 제거하면 sp_send_dbmail 호출이 실패할 수 있습니다. 자세한 내용은 sp_send_dbmail(Transact-SQL)을 참조하십시오.

sysmail_delete_profileaccount_sp 저장 프로시저는 msdb 데이터베이스에 있으며 dbo 스키마가 소유합니다. 현재 데이터베이스가 msdb가 아닐 경우 이 프로시저를 세 부분으로 구성된 이름으로 실행해야 합니다.

사용 권한

이 프로시저에 대한 실행 권한은 기본적으로 sysadmin 고정 서버 역할의 멤버로 설정됩니다.

예

다음 예에서는 AdventureWorks Administrator라는 프로필을 삭제합니다. 이 프로필과 관련된 보내지 않은 메시지가 있을 경우 오류가 발생하며 해당 프로필은 삭제되지 않습니다.

EXECUTE msdb.dbo.sysmail_delete_profile_sp
    @profile_name = N'AdventureWorks Administrator' 
    ,@force_delete = 0;

참고 항목

참조

데이터베이스 메일 및 SQL 메일 저장 프로시저(Transact-SQL)

도움말 및 정보

SQL Server 2005 지원 받기

변경 내역

릴리스	내역
2006년 12월 12일	새로운 내용 구문, 인수 및 예 섹션에 새 매개 변수 @force_delete를 추가했습니다.

다음을 통해 공유