sysmail_add_account_sp(Transact-SQL)

  • 아티클

적용 대상:SQL ServerAzure SQL Managed Instance

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_name 기본값이 없는 sysname입니다.

[ @email_address = ] 'email_address'

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

[ @display_name = ] 'display_name'

이 계정의 전자 메일 메시지에 사용할 표시 이름입니다. @display_name 기본값NULL인 nvarchar(128)입니다. 예를 들어 SQL Server 에이전트 계정은 전자 메일 메시지에 이름을 SQL Server Agent Automated Mailer 표시할 수 있습니다.

[ @replyto_address = ] 'replyto_address'

이 계정의 메시지에 대한 응답이 전송되는 주소입니다. @replyto_address 기본값NULL인 nvarchar(128)입니다. 예를 들어 SQL Server 에이전트 계정에 대한 회신은 데이터베이스 관리자danw@adventure-works.com에게 돌아갈 수 있습니다.

[ @description = ] 'description'

계정에 대한 설명입니다. @description 기본값NULL인 nvarchar(256)입니다.

[ @mailserver_name = ] 'server_name'

이 계정에 사용할 SMTP 메일 서버의 이름 또는 IP 주소입니다. SQL Server를 실행하는 컴퓨터는 IP 주소에 대한 @mailserver_name 확인할 수 있어야 합니다. @mailserver_name 기본값이 없는 sysname입니다.

[ @mailserver_type = ] 'server_type'

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

[ @port = ] port_number

전자 메일 서버의 포트 번호입니다. @port 기본값25인 int입니다.

[ @username = ] 'username'

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

[ @password = ] 'password'

전자 메일 서버에 로그온하는 데 사용할 암호입니다. @password 기본값NULL인 nvarchar(128)입니다. 사용자 이름을 지정하지 않는 한 암호를 제공할 필요가 없습니다.

[ @use_default_credentials = ] use_default_credentials

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

[ @enable_ssl = ] enable_ssl

데이터베이스 메일 Secure Sockets Layer를 사용하여 통신을 암호화할지 여부를 지정합니다. @enable_ssl 비트이며 기본값은 .입니다0.

[ @account_id = ] account_id OUTPUT

새 계정의 계정 ID를 반환합니다. @account_id 기본값NULL인 int입니다.

반환 코드 값

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

설명

데이터베이스 메일 @email_address, @display_name 및 @replyto_address 별도의 매개 변수를 제공합니다. @email_address 매개 변수는 메시지가 전송되는 주소입니다. @display_name 매개 변수는 전자 메일 메시지 필드에 표시된 From: 이름입니다. @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 매개 변수는 값을 SMTP지원합니다.

@use_default_credentials1경우 SQL Server 데이터베이스 엔진 자격 증명을 사용하여 메일이 SMTP 서버로 전송됩니다. @use_default_credentials0계정에 대해 @username 및 @password 지정된 경우 계정은 SMTP 인증을 사용합니다. @username 및 @password SQL Server 또는 컴퓨터가 있는 네트워크에 대한 자격 증명이 아니라 계정이 SMTP 서버에 사용하는 자격 증명입니다.

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

사용 권한

이 저장 프로시저는 db_owner 역할이 소유합니다. 모든 사용자에 대한 사용 권한을 부여 EXECUTE 할 수 있지만 SQL Server 업그레이드 중에 이러한 권한이 재정의될 수 있습니다.

예제

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

EXEC 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';

관련 콘텐츠