문서를 영문으로 보려면 영문 확인란을 선택하세요. 마우스 포인터를 텍스트 위로 이동시켜 팝업 창에서 영문 텍스트를 표시할 수도 있습니다.
번역
영문

sysmail_add_account_sp(Transact-SQL)

SMTP 계정에 대한 정보를 저장할 새로운 데이터베이스 메일 계정을 만듭니다.

항목 링크 아이콘 Transact-SQL 구문 표기 규칙

sysmail_add_account_sp  [ @account_name = ] 'account_name',
    [ @email_address = ] 'email_address' ,
    [ [ @display_name = ] 'display_name' , ]
    [ [ @replyto_address = ] 'replyto_address' , ]
    [ [ @description = ] 'description' , ]
    [ @mailserver_name = ] 'server_name' 
    [ , [ @mailserver_type = ] 'server_type' ]
    [ , [ @port = ] port_number ]
    [ , [ @username = ] 'username' ]
    [ , [ @password = ] 'password' ]
    [ , [ @use_default_credentials = ] use_default_credentials ]
    [ , [ @enable_ssl = ] enable_ssl ]
    [ , [ @account_id = ] account_id OUTPUT ]

[ @account_name = ] 'account_name'

추가할 계정의 이름입니다. account_namesysname이며 기본값은 없습니다.

[ @email_address = ] 'email_address'

메시지를 보낼 전자 메일 주소입니다. 이 주소는 인터넷 전자 메일 주소여야 합니다. email_addressnvarchar(128)이며 기본값은 없습니다. 예를 들어 SQL Server 에이전트의 계정은 SqlAgent@Adventure-Works.com 주소에서 전자 메일을 보낼 수 있습니다.

[ @display_name = ] 'display_name'

이 계정에서 보내는 전자 메일 메시지에 사용할 표시 이름입니다. display_namenvarchar(128)이며 기본값은 NULL입니다. 예를 들어 SQL Server 에이전트 계정은 전자 메일 메시지에 SQL Server Agent Automated Mailer라는 이름을 표시할 수 있습니다.

[ @replyto_address = ] 'replyto_address'

이 계정에서 보낸 메시지에 대한 응답이 전달되는 주소입니다. replyto_addressnvarchar(128)이며 기본값은 NULL입니다. 예를 들어 SQL Server 에이전트 계정에 대한 회신은 데이터베이스 관리자인 danw@Adventure-Works.com으로 이동할 수 있습니다.

[ @description = ] 'description'

계정에 대한 설명입니다. descriptionnvarchar(256)이며 기본값은 NULL입니다.

[ @mailserver_name = ] 'server_name'

이 계정에 사용할 SMTP 메일 서버의 이름 또는 IP 주소입니다. SQL Server를 실행하는 컴퓨터는 server_name을 IP 주소로 확인할 수 있어야 합니다. server_namesysname이며 기본값은 없습니다.

[ @mailserver_type = ] 'server_type'

전자 메일 서버의 유형입니다. server_typesysname이며 기본값은 'SMTP'입니다.

[ @port = ] port_number

전자 메일 서버의 포트 번호입니다. port_numberint이며 기본값은 25입니다.

[ @username = ] 'username'

전자 메일 서버에 로그온하는 데 사용할 사용자 이름입니다. usernamenvarchar(128)이며 기본값은 NULL입니다. 이 매개 변수가 NULL이면 데이터베이스 메일은 이 계정에 대한 인증을 사용하지 않습니다. 메일 서버에 인증이 필요하지 않은 경우 username에 NULL을 사용합니다.

[ @password = ] 'password'

전자 메일 서버에 로그온하는 데 사용할 암호입니다. passwordnvarchar(128)이며 기본값은 NULL입니다. username을 지정하지 않으면 암호를 제공할 필요가 없습니다.

[ @use_default_credentials = ] use_default_credentials

SQL Server 데이터베이스 엔진의 자격 증명을 사용하여 메일을 SMTP 서버로 보낼지 여부를 지정합니다. use_default_credentials는 bit이며 기본값은 0입니다. 이 매개 변수가 1이면 데이터베이스 메일은 데이터베이스 엔진의 자격 증명을 사용합니다. 이 매개 변수가 0이면 데이터베이스 메일에서는 @username@password 매개 변수를 보냅니다(있는 경우). 그렇지 않은 경우 @username@password 매개 변수 없이 메일을 보냅니다.

[ @enable_ssl = ] enable_ssl

데이터베이스 메일에서 SSL(Secure Sockets Layer)을 사용하여 통신을 암호화할지 여부를 지정합니다. Enable_ssl은 bit이며 기본값은 0입니다.

[ @account_id = ] account_id OUTPUT

새 계정의 계정 ID를 반환합니다. account_idint이며 기본값은 NULL입니다.

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

데이터베이스 메일은 @email_address, @display_name@replyto_address에 별도의 매개 변수를 제공합니다. @email_address 매개 변수는 메시지를 보낸 주소입니다. @display_name 매개 변수는 전자 메일 메시지의 보낸 사람: 필드에 표시되는 이름입니다. @replyto_address 매개 변수는 전자 메일 메시지에 대한 회신이 전달될 주소입니다. 예를 들어 SQL Server 에이전트에 사용된 계정은 SQL Server 에이전트에만 사용되는 전자 메일 주소에서 전자 메일 메시지를 보낼 수 있습니다. 해당 주소에서 보낸 메시지는 쉽게 알아 볼 수 있는 이름으로 표시되므로 수신자는 SQL Server 에이전트가 메시지를 보냈는지를 쉽게 확인할 수 있습니다. 수신자가 메시지에 회신하면 회신은 SQL Server 에이전트에서 사용하는 주소가 아니라 데이터베이스 관리자에게 전달되어야 합니다. 이 시나리오에서 계정은 전자 메일 주소로 SqlAgent@Adventure-Works.com을 사용합니다. 표시 이름은 SQL Server Agent Automated Mailer로 설정됩니다. 계정은 주소에 대한 회신으로 danw@Adventure-Works.com을 사용하므로 이 계정에서 보낸 메시지에 대한 회신은 SQL Server 에이전트의 전자 메일 주소가 아니라 데이터베이스 관리자에게 전달됩니다. 이 세 매개 변수에 독립된 설정을 제공하면 데이터베이스 메일에서 사용자 요구 사항에 맞게 메시지를 구성할 수 있습니다.

@mailserver_type 매개 변수는 다음 릴리스에서의 유연성을 위해 제공됩니다. SQL Server 2005 이상에서는 @mailserver_type으로 'SMTP' 값을 지원합니다.

@use_default_credentials가 1이면 메일이 SQL Server 데이터베이스 엔진의 자격 증명을 사용하여 SMTP 서버로 전달됩니다. @use_default_credentials가 0이고 계정에 @username@password를 지정하면 이 계정에서는 SMTP 인증을 사용합니다. @username@password는 SQL Server 또는 컴퓨터가 설정되어 있는 네트워크에 대한 자격 증명이 아니라 계정이 SMTP 서버에 사용하는 자격 증명입니다.

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

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

다음 예에서는 AdventureWorks Administrator라는 계정을 만듭니다. 이 계정은 dba@Adventure-Works.com이라는 전자 메일 주소를 사용하고 SMTP 메일 서버 smtp.Adventure-Works.com으로 메일을 보냅니다. 이 계정에서 보낸 전자 메일 메시지의 보낸 사람: 줄에는 AdventureWorks Automated Mailer가 표시됩니다. 메시지에 대한 회신은 danw@Adventure-Works.com으로 전달됩니다.

EXECUTE msdb.dbo.sysmail_add_account_sp
    @account_name = 'AdventureWorks Administrator',
    @description = 'Mail account for administrative e-mail.',
    @email_address = 'dba@Adventure-Works.com',
    @display_name = 'AdventureWorks Automated Mailer',
    @mailserver_name = 'smtp.Adventure-Works.com' ;

커뮤니티 추가 항목

추가
표시: