sysmail_help_account_sp(Transact-SQL)
암호를 제외하고 데이터베이스 메일 계정에 대한 정보를 나열합니다.
.gif "항목 링크 아이콘")
구문
sysmail_help_account_sp [ [ @account_id = ] account_id | [ @account_name = ] 'account_name' ]
인수
[ @account_id = ] account_id
정보를 나열할 계정의 ID입니다. account_id는 int이며 기본값은 NULL입니다.[ @account_name = ] 'account_name'
정보를 나열할 계정의 이름입니다. account_name은 sysname이며 기본값은 NULL입니다.
반환 코드 값
0(성공) 또는 1(실패)
결과 집합
아래에 나열된 열을 포함한 결과 집합을 반환합니다.
열 이름 |
데이터 형식 |
설명 |
account_id |
int |
계정의 ID입니다. |
name |
sysname |
계정의 이름입니다. |
description |
nvarchar(256) |
계정에 대한 설명입니다. |
email_address |
nvarchar(128) |
메시지를 보내는 전자 메일 주소입니다. |
display_name |
nvarchar(128) |
계정의 표시 이름입니다. |
replyto_address |
nvarchar(128) |
이 계정에서 보낸 메시지에 회신하는 주소입니다. |
servertype |
sysname |
계정에 대한 전자 메일 서버의 유형입니다. |
servername |
sysname |
계정에 대한 전자 메일 서버의 이름입니다. |
port |
int |
사용되는 전자 메일 서버의 포트 번호입니다. |
username |
nvarchar(128) |
전자 메일 서버에서 인증을 사용하는 경우 전자 메일 서버 로그인에 사용할 사용자 이름입니다. username이 NULL이면 데이터베이스 메일은 이 계정에 인증을 사용하지 않습니다. |
use_default_credentials |
bit |
SQL Server 데이터베이스 엔진의 자격 증명을 사용하여 메일을 SMTP 서버로 보낼지 여부를 지정합니다. use_default_credentials는 bit이며 기본값은 없습니다. 이 매개 변수가 1이면 데이터베이스 메일에서는 SQL Server 데이터베이스 엔진 서비스의 자격 증명을 사용합니다. 이 매개 변수가 0이면 데이터베이스 메일에서는 SMTP 서버 인증을 위해 @username 및 @password를 사용합니다. @username 및 @password가 NULL이면 데이터베이스 메일에서는 익명 인증을 사용합니다. 이 매개 변수를 지정하기 전에 해당 SMTP 관리자에게 문의하십시오. |
enable_ssl |
bit |
데이터베이스 메일에서 SSL(Secure Sockets Layer)을 사용하여 통신을 암호화할지 여부를 지정합니다. SMTP 서버에 SSL이 필요한 경우 이 옵션을 사용합니다. enable_ssl은 bit이며 기본값은 없습니다. 1은 데이터베이스 메일에서 SSL을 사용하여 통신을 암호화함을 나타냅니다. 0은 데이터베이스 메일에서 SSL 암호화 없이 메일을 보냄을 나타냅니다. |
주의
account_id 또는 account_name을 지정하지 않으면 sysmail_help_account에서는 Microsoft SQL Server 인스턴스의 모든 데이터베이스 메일 계정에 대한 정보를 나열합니다.
sysmail_help_account_sp 저장 프로시저는 msdb 데이터베이스에 있으며 dbo 스키마가 소유합니다. 현재 데이터베이스가 msdb가 아닐 경우 이 프로시저를 세 부분으로 구성된 이름으로 실행해야 합니다.
사용 권한
이 프로시저에 대한 실행 권한은 기본적으로 sysadmin 고정 서버 역할의 멤버로 설정됩니다.
예
1. 모든 계정에 대한 정보 나열
다음 예에서는 인스턴스의 모든 계정에 대한 계정 정보를 나열합니다.
EXECUTE msdb.dbo.sysmail_help_account_sp ;
다음은 줄 길이에 맞추어 편집된 결과 집합 예입니다.
account_id name description email_address display_name replyto_address servertype servername port username use_default_credentials enable_ssl
----------- ---------------------------- --------------------------------------- ------------------------- -------------------------------- --------------- ---------- ------------------------- ----------- -------- ----------------------- ----------
148 AdventureWorks Administrator Mail account for administrative e-mail. dba@Adventure-Works.com AdventureWorks Automated Mailer NULL SMTP smtp.Adventure-Works.com 25 NULL 0 0
149 Audit Account Account for audit e-mail. audit@Adventure-Works.com Automated Mailer (Audit) NULL SMTP smtp.Adventure-Works.com 25 NULL 0 0
2. 특정 계정에 대한 정보 나열
다음 예에서는 AdventureWorks Administrator라는 계정에 대해 계정 정보를 나열합니다.
EXECUTE msdb.dbo.sysmail_help_account_sp
@account_name = 'AdventureWorks Administrator' ;
다음은 줄 길이에 맞추어 편집된 결과 집합 예입니다.
account_id name description email_address display_name replyto_address servertype servername port username use_default_credentials enable_ssl
----------- ---------------------------- ------------------------------------------------------ ------------------------- ---------------- ---------- ------------------------- ----------- -------- ----------------------- ----------
148 AdventureWorks Administrator Mail account for administrative e-mail. dba@Adventure-Works.com AdventureWorks Automated Mailer NULL SMTP smtp.Adventure-Works.com 25 NULL 0 0