sp_send_dbmail(Transact-SQL)
업데이트: 2005년 12월 5일
지정된 수신자에게 전자 메일 메시지를 보냅니다. 이 메시지에는 쿼리 결과 집합, 첨부 파일 등이 포함될 수 있습니다. 메일이 성공적으로 데이터베이스 메일 큐에 배치되면 sp_send_dbmail은 메시지의 mailitem_id를 반환합니다. 이 저장 프로시저는 msdb 데이터베이스에 저장됩니다.
.gif "항목 링크 아이콘")
구문
sp_send_dbmail [ [ @profile_name = ] 'profile_name' ]
[ , [ @recipients = ] 'recipients [ ; ...n ]' ]
[ , [ @copy_recipients = ] 'copy_recipient [ ; ...n ]' ]
[ , [ @blind_copy_recipients = ] 'blind_copy_recipient [ ; ...n ]' ]
[ , [ @subject = ] 'subject' ]
[ , [ @body = ] 'body' ]
[ , [ @body_format = ] 'body_format' ]
[ , [ @importance = ] 'importance' ]
[ , [ @sensitivity = ] 'sensitivity' ]
[ , [ @file_attachments = ] 'attachment [ ; ...n ]' ]
[ , [ @query = ] 'query' ]
[ , [ @execute_query_database = ] 'execute_query_database' ]
[ , [ @attach_query_result_as_file = ] attach_query_result_as_file ]
[ , [ @query_attachment_filename = ] query_attachment_filename ]
[ , [ @query_result_header = ] query_result_header ]
[ , [ @query_result_width = ] query_result_width ]
[ , [ @query_result_separator = ] 'query_result_separator' ]
[ , [ @exclude_query_output = ] exclude_query_output ]
[ , [ @append_query_error = ] append_query_error ]
[ , [ @query_no_truncate = ] query_no_truncate ]
[ , [ @query_result_no_padding = ] query_result_no_padding ]
[ , [ @mailitem_id = ] mailitem_id ] [ OUTPUT ]
인수
- [ @profile_name= ] 'profile_name'
메시지를 보내는 프로필의 이름입니다. profile_name은 sysname 유형이며 기본값은 NULL입니다. profile_name은 기존 데이터베이스 메일 프로필의 이름이어야 합니다. profile_name을 지정하지 않으면 sp_send_dbmail은 현재 사용자의 기본 개인 프로필을 사용합니다. 사용자에게 기본 개인 프로필이 없을 경우 sp_send_dbmail은 msdb 데이터베이스의 기본 공개 프로필을 사용합니다. 사용자에게 기본 개인 프로필이 없고 데이터베이스의 기본 공개 프로필도 없을 경우에는 @profile_name을 지정해야 합니다.
- [ @recipients= ] 'recipients'
메시지를 받을 전자 메일 주소 목록으로, 각 주소는 세미콜론으로 구분되어 있습니다. 수신자 목록은 varchar(max) 유형입니다. 이 매개 변수는 옵션이지만 @recipients, @copy_recipients 또는 @blind_copy_recipients 중 하나를 지정해야 합니다. 그렇지 않으면 sp_send_dbmail에서 오류를 반환합니다.
- [ @copy_recipients= ] 'copy_recipients'
참조로 메시지를 받을 전자 메일 주소 목록으로, 각 주소는 세미콜론으로 구분되어 있습니다. 참조 수신자의 목록은 varchar(max) 유형입니다. 이 매개 변수는 옵션이지만 @recipients, @copy_recipients 또는 @blind_copy_recipients 중 하나를 지정해야 합니다. 그렇지 않으면 sp_send_dbmail에서 오류를 반환합니다.
- [ @blind_copy_recipients= ] 'blind_copy_recipients'
숨은 참조로 메시지를 받을 전자 메일 주소 목록으로, 각 주소는 세미콜론으로 구분되어 있습니다. 숨은 참조 수신자의 목록은 varchar(max) 유형입니다. 이 매개 변수는 옵션이지만 @recipients, @copy_recipients 또는 @blind_copy_recipients 중 하나를 지정해야 합니다. 그렇지 않으면 sp_send_dbmail에서 오류를 반환합니다.
- [ @subject= ] 'subject'
전자 메일 메시지의 제목입니다. 제목은 nvarchar(255) 유형입니다. 제목을 지정하지 않으면 기본값은 'SQL Server Message'입니다.
- [ @body= ] 'body'
전자 메일 메시지의 본문입니다. 메시지 본문은 nvarchar(max) 유형이며 기본값은 NULL입니다.
[ @body_format= ] 'body_format'
메시지 본문의 형식입니다. 매개 변수는 varchar(20) 유형이며 기본값은 NULL입니다. 이 매개 변수를 지정할 경우 나가는 메시지의 헤더가 보내져 메시지 본문이 지정된 형식임을 나타냅니다. 매개 변수에 포함할 수 있는 값은 다음과 같습니다.- TEXT
- HTML
기본값은 TEXT입니다.
[ @importance= ] 'importance'
메시지의 중요도입니다. 매개 변수는 varchar(6) 유형입니다. 매개 변수에 포함할 수 있는 값은 다음과 같습니다.- Low
- Normal
- High
기본값은 Normal입니다.
[ @sensitivity= ] 'sensitivity'
메시지의 기밀성입니다. 매개 변수는 varchar(12) 유형입니다. 매개 변수에 포함할 수 있는 값은 다음과 같습니다.- Normal
- Personal
- Private
- Confidential
기본값은 Normal입니다.
- [ @file_attachments= ] 'file_attachments'
전자 메일 메시지에 첨부되는 파일 이름 목록으로, 각 파일 이름은 세미콜론으로 구분되어 있습니다. 목록의 파일은 절대 경로로 지정해야 합니다. 첨부 파일 목록은 nvarchar(max) 유형입니다.
- [ @query= ] 'query'
실행할 쿼리입니다. 쿼리 결과를 파일로 첨부할 수도 있고 전자 메일 메시지의 본문에 포함할 수도 있습니다. 쿼리는 nvarchar(max) 유형이며 유효한 Transact-SQL 문을 포함할 수 있습니다. 별도의 세션에서 쿼리가 실행되므로 sp_send_dbmail을 호출하는 스크립트의 로컬 변수를 쿼리에 사용할 수 없습니다.
- [ @execute_query_database= ] 'execute_query_database'
저장 프로시저가 쿼리를 실행하는 데이터베이스 컨텍스트입니다. 매개 변수는 sysname 유형이며 기본값은 현재 데이터베이스입니다. 이 매개 변수는 @query가 지정된 경우에만 적용됩니다.
[ @attach_query_result_as_file= ] attach_query_result_as_file
쿼리의 결과 집합이 첨부 파일로 반환되는지 여부를 지정합니다. attach_query_result_as_file은 bit 유형이며 기본값은 0입니다.값이 0이면 쿼리 결과가 전자 메일 메시지 본문의 @body 매개 변수 내용 뒤에 포함됩니다. 값이 1이면 결과가 첨부 파일로 반환됩니다. 이 매개 변수는 @query가 지정된 경우에만 적용됩니다.
- [ @query_attachment_filename= ] query_attachment_filename
쿼리 결과 집합 첨부 파일에 사용할 파일 이름을 지정합니다. query_attachment_filename은 nvarchar(255) 유형이며 기본값은 NULL입니다. attach_query_result가 0이면 이 매개 변수는 무시됩니다. attach_query_result가 1이고 이 매개 변수가 NULL이면 데이터베이스 메일에서 임의로 파일 이름을 만듭니다.
- [ @query_result_header= ] query_result_header
쿼리 결과에 열 머리글을 포함할 것인지 여부를 지정합니다. query_result_header 값은 bit 유형입니다. 값이 1이면 쿼리 결과에 열 머리글이 포함됩니다. 값이 0이면 쿼리 결과에 열 머리글이 포함되지 않습니다. 이 매개 변수의 기본값은 1입니다. 이 매개 변수는 @query가 지정된 경우에만 적용됩니다.
- [ @query_result_width = ] query_result_width
쿼리 결과에 서식을 지정할 때 사용하는 문자 줄 너비입니다. query_result_width는 int 유형이며 기본값은 256입니다. 10에서 32767 사이의 값을 지정해야 합니다. 이 매개 변수는 @query를 지정한 경우에만 적용됩니다.
- [ @query_result_separator= ] 'query_result_separator'
쿼리 출력에서 열을 구분하는 데 사용되는 문자입니다. 구분 기호는 char(1) 유형입니다. 기본값은 ' '(공백)입니다.
- [ @exclude_query_output= ] exclude_query_output
쿼리 실행 출력을 전자 메일 메시지로 반환할지 여부를 지정합니다. exclude_query_output은 bit이며 기본값은 0입니다. 이 매개 변수가 0인 경우 sp_send_dbmail 저장 프로시저를 실행하면 쿼리 실행 결과로 반환되는 메시지가 콘솔에 인쇄됩니다. 이 매개 변수가 1인 경우에는 sp_send_dbmail 저장 프로시저를 실행해도 쿼리 실행 메시지가 콘솔에 인쇄되지 않습니다.
- [ @append_query_error= ] append_query_error
@query 인수에 지정된 쿼리에서 오류가 반환될 때 전자 메일을 보낼지 여부를 지정합니다. append_query_error는 bit이며 기본값은 0입니다. 이 매개 변수가 1이면 데이터베이스 메일에서 전자 메일 메시지의 본문에 쿼리 오류 메시지를 포함하여 전자 메일 메시지를 보냅니다. 이 매개 변수가 0이면 데이터베이스 메일에서 전자 메일 메시지를 보내지 않으며 sp_send_dbmail이 실패를 나타내는 반환 코드 1을 표시하고 종료됩니다.
[ @query_no_truncate= ] query_no_truncate
큰 가변 길이 데이터 형식(varchar(max), nvarchar(max), varbinary(max), xml, text, ntext, image 및 사용자 정의 데이터 형식)의 잘림을 방지하는 옵션을 사용하여 쿼리를 실행할지 여부를 지정합니다. 설정된 경우 쿼리 결과에 열 머리글이 포함되지 않습니다. query_no_truncate 값은 bit 유형입니다. 값이 0이거나 지정되지 않은 경우에는 쿼리의 열이 256자로 잘립니다. 값이 1이면 쿼리의 열이 잘리지 않습니다. 이 매개 변수의 기본값은 0입니다.[!참고] 많은 데이터와 함께 사용하면 @query_no_truncate 옵션은 추가 리소스를 사용하므로 서버 성능이 느려질 수 있습니다.
[ @query_result_no_padding= ] query_result_no_padding ]
형식은 비트입니다. 기본값은 0입니다. 1로 설정하면 쿼리 결과가 채워지지 않으므로 파일 크기가 줄어들 수 있습니다.@query\_result\_no\_padding을 1로 설정하고 @query\_result\_width 매개 변수를 설정하면 @query\_result\_no\_padding 매개 변수가 @query\_result\_width 매개 변수를 덮어씁니다. 이 경우에 오류는 발생하지 않습니다.
@query\_result\_no\_padding을 1로 설정하고 @query\_no\_truncate 매개 변수를 설정하면 오류가 발생합니다.
- [ @mailitem_id= ] mailitem_id [ OUTPUT ]
선택적 출력 매개 변수는 메시지의 mailitem_id를 반환합니다. mailitem_id의 유형은 int입니다.
반환 코드 값
0(성공) 또는 1(실패)
결과 집합
성공 시 "Mail queued" 메시지를 반환합니다.
주의
사용하기 전에 데이터베이스 메일 구성 마법사, SQL Server Surface Area Configuration 도구 또는 sp_configure를 사용하여 데이터베이스 메일을 설정해야 합니다.
sysmail_stop_sp는 외부 프로그램이 사용하는 Service Broker 개체를 중지하여 데이터베이스 메일을 중지합니다. sysmail_stop_sp를 사용하여 데이터베이스 메일이 중지되어도 sp_send_dbmail은 여전히 메일을 받습니다. 데이터베이스 메일을 시작하려면 sysmail_start_sp를 사용합니다.
@profile을 지정하지 않으면 sp_send_dbmail은 기본 프로필을 사용합니다. 전자 메일 메시지를 보내는 사용자에게 기본 개인 프로필이 있을 경우 이 프로필이 사용됩니다. 사용자에게 기본 개인 프로필이 없을 경우 sp_send_dbmail은 기본 공개 프로필을 사용합니다. 사용자의 기본 개인 프로필과 기본 공개 프로필이 둘 다 없을 경우 sp_send_dbmail은 오류를 반환합니다.
sp_send_dbmail은 내용이 없는 전자 메일 메시지를 지원하지 않습니다. 전자 메일 메시지를 보내려면 적어도 @body, @query, @file_attachments, @subject 중 하나 이상을 지정해야 합니다. 그렇지 않으면 sp_send_dbmail은 오류를 반환합니다.
데이터베이스 메일에서는 현재 사용자의 Microsoft Windows 보안 컨텍스트를 사용하여 파일에 대한 액세스를 제어합니다. 그러므로 SQL Server 인증 방식으로 인증된 사용자는 @file_attachments를 사용하여 파일을 첨부할 수 없습니다. Windows에서는 SQL Server를 사용하여 원격 컴퓨터에서 다른 원격 컴퓨터로 자격 증명을 제공할 수 없습니다. 그러므로 SQL Server를 실행하는 컴퓨터가 아닌 컴퓨터에서 명령을 실행할 경우 데이터베이스 메일은 네트워크 공유 위치에서 파일을 첨부할 수 없습니다.
@query와 @file_attachments를 둘 다 지정한 경우 파일을 찾을 수 없으면 쿼리가 여전히 실행되지만 전자 메일은 전송되지 않습니다.
쿼리를 지정한 경우 결과 집합의 서식은 인라인 텍스트로 지정됩니다. 결과 내 이진 데이터는 16진수 형식으로 전송됩니다.
매개 변수 @recipients, @copy_recipients 및 @blind_copy_recipients는 세미콜론으로 구분된 전자 메일 주소 목록입니다. 적어도 이 매개 변수 중 하나 이상을 지정해야 합니다. 그렇지 않으면 sp_send_dbmail은 오류를 반환합니다.
트랜잭션 컨텍스트 없이 sp_send_dbmail을 실행하면 데이터베이스 메일이 암시적 트랜잭션을 시작하고 커밋합니다. 기존 트랜잭션 내에서 sp_send_dbmail을 실행하는 경우 사용자가 데이터베이스 메일에서 변경 내용을 커밋 또는 롤백할지를 결정합니다. 내부 트랜잭션은 시작되지 않습니다.
사용 권한
sp_send_dbmail을 실행할 수 있는 권한은 기본적으로 msdb 데이터베이스에서 DatabaseMailUser 데이터베이스 역할의 모든 멤버로 설정됩니다. 그러나 메시지를 보내는 사용자에게 요청하기 위해 프로필을 사용할 수 있는 권한이 없을 경우 sp_send_dbmail은 오류를 반환하고 메시지를 보내지 않습니다.
예
1. 전자 메일 메시지 보내기
다음 예에서는 전자 메일 주소 danw@Adventure-Works.com을 사용하여 Dan Wilson에게 전자 메일 메시지를 보냅니다. 메시지의 제목은 Automated Success Message입니다. 메시지의 본문에는 'The stored procedure finished successfully'라는 문장이 포함되어 있습니다.
EXEC msdb.dbo.sp_send_dbmail
@profile_name = 'AdventureWorks Administrator',
@recipients = 'danw@Adventure-Works.com',
@body = 'The stored procedure finished successfully.',
@subject = 'Automated Success Message' ;
2. 쿼리 결과를 포함하여 전자 메일 메시지 보내기
다음 예에서는 전자 메일 주소 danw@Adventure-Works.com을 사용하여 Dan Wilson에게 전자 메일 메시지를 보냅니다. 메시지의 제목은 Work Order Count이며 이 메시지는 DueDate가 2004년 4월 30일부터 2일 내인 작업 주문 번호를 표시하는 쿼리를 실행합니다. 데이터베이스 메일은 결과를 텍스트 파일로 첨부합니다.
EXEC msdb.dbo.sp_send_dbmail
@profile_name = 'AdventureWorks Administrator',
@recipients = 'danw@Adventure-Works.com',
@query = 'SELECT COUNT(*) FROM AdventureWorks.Production.WorkOrder
WHERE DueDate > ''2004-04-30''
AND DATEDIFF(dd, ''2004-04-30'', DueDate) < 2' ,
@subject = 'Work Order Count',
@attach_query_result_as_file = 1 ;
3. HTML 전자 메일 메시지 보내기
다음 예에서는 전자 메일 주소 danw@Adventure-Works.com을 사용하여 Dan Wilson에게 전자 메일 메시지를 보냅니다. 메시지의 제목은 Work Order List이며 이 메시지에는 DueDate가 2004년 4월 30일부터 2일 내인 작업 주문을 보여 주는 HTML 문서가 포함되어 있습니다. 데이터베이스 메일은 메시지를 HTML 형식으로 보냅니다.
DECLARE @tableHTML NVARCHAR(MAX) ;
SET @tableHTML =
N'<H1>Work Order Report</H1>' +
N'<table border="1">' +
N'<tr><th>Work Order ID</th><th>Product ID</th>' +
N'<th>Name</th><th>Order Qty</th><th>Due Date</th>' +
N'<th>Expected Revenue</th></tr>' +
CAST ( ( SELECT td = wo.WorkOrderID, '',
td = p.ProductID, '',
td = p.Name, '',
td = wo.OrderQty, '',
td = wo.DueDate, '',
td = (p.ListPrice - p.StandardCost) * wo.OrderQty
FROM AdventureWorks.Production.WorkOrder as wo
JOIN AdventureWorks.Production.Product AS p
ON wo.ProductID = p.ProductID
WHERE DueDate > '2004-04-30'
AND DATEDIFF(dd, '2004-04-30', DueDate) < 2
ORDER BY DueDate ASC,
(p.ListPrice - p.StandardCost) * wo.OrderQty DESC
FOR XML PATH('tr'), TYPE
) AS NVARCHAR(MAX) ) +
N'</table>' ;
EXEC msdb.dbo.sp_send_dbmail @recipients='danw@Adventure-Works.com',
@subject = 'Work Order List',
@body = @tableHTML,
@body_format = 'HTML' ;
참고 항목
참조
데이터베이스 메일 및 SQL 메일 저장 프로시저(Transact-SQL)
sp_addrolemember(Transact-SQL)
관련 자료
데이터베이스 메일
데이터베이스 메일 프로필
데이터베이스 메일 구성 마법사
SQL Server 노출 영역 구성
도움말 및 정보
변경 내역
| 릴리스 | 내역 |
|---|---|
2005년 12월 5일 |
|