sysmail_configure_sp(Transact-SQL)sysmail_configure_sp (Transact-SQL)

이 항목은 다음에 적용됩니다.예SQL Server(2008부터)아니요Azure SQL Database아니요Azure SQL Data Warehouse 아니요병렬 데이터 웨어하우스 THIS TOPIC APPLIES TO:yesSQL Server (starting with 2008)noAzure SQL DatabasenoAzure SQL Data Warehouse noParallel Data Warehouse

데이터베이스 메일의 구성 설정을 변경합니다.Changes configuration settings for Database Mail. 로 지정한 구성 설정은 sysmail_configure_sp 전체에 적용 SQL ServerSQL Server 인스턴스.The configuration settings specified with sysmail_configure_sp apply to the entire SQL ServerSQL Server instance.

항목 링크 아이콘 Transact-SQL 구문 규칙Topic link icon Transact-SQL Syntax Conventions

구문Syntax


sysmail_configure_sp [ [ @parameter_name = ] 'parameter_name' ]  
    [ , [ @parameter_value = ] 'parameter_value' ]  
    [ , [ @description = ] 'description' ]  

인수Arguments

[@parameter_name = ] 'parameter_name'[@parameter_name = ] 'parameter_name'
변경할 매개 변수의 이름입니다.The name of the parameter to change.

[@parameter_value =] 'parameter_value'[@parameter_value = ] 'parameter_value'
매개 변수의 새 값입니다.The new value of the parameter.

[@description =] '설명'[@description = ] 'description'
매개 변수에 대한 설명입니다.A description of the parameter.

반환 코드 값Return Code Values

0 (성공) 또는 1 (실패)0 (success) or 1 (failure)

결과 집합Result Sets

InclusionThresholdSettingNone

주의Remarks

데이터베이스 메일은 다음과 같은 매개 변수를 사용합니다.Database Mail uses the following parameters:

매개 변수 이름Parameter name DescriptionDescription 기본값Default Value
AccountRetryAttemptsAccountRetryAttempts 외부 메일 프로세스에서 지정된 프로필의 각 계정을 사용하여 전자 메일 메시지를 보내려고 시도하는 횟수입니다.The number of times that the external mail process attempts to send the e-mail message using each account in the specified profile. 11
AccountRetryDelayAccountRetryDelay 외부 메일 프로세스가 메시지 보내기를 시도하는 사이에 대기하는 시간(초)입니다.The amount of time, in seconds, for the external mail process to wait between attempts to send a message. 50005000
DatabaseMailExeMinimumLifeTimeDatabaseMailExeMinimumLifeTime 외부 메일 프로세스가 활성 상태로 유지되는 최소 시간(초)입니다.The minimum amount of time, in seconds, that the external mail process remains active. 데이터베이스 메일에서 많은 메시지를 보내려면 이 값을 늘려 데이터베이스 메일을 활성 상태로 유지하고 자주 시작하고 중지하는 오버헤드를 방지합니다.When Database Mail is sending many messages, increase this value to keep Database Mail active and avoid the overhead of frequent starts and stops. 600600
DefaultAttachmentEncodingDefaultAttachmentEncoding 전자 메일 첨부 파일의 기본 인코딩입니다.The default encoding for e-mail attachments. MIMEMIME
MaxFileSizeMaxFileSize 첨부 파일의 최대 크기(바이트)입니다.The maximum size of an attachment, in bytes. 10000001000000
ProhibitedExtensionsProhibitedExtensions 전자 메일 메시지에 대한 첨부 파일로 보낼 수 없는 쉼표로 구분된 확장명 목록입니다.A comma-separated list of extensions which cannot be sent as an attachment to an e-mail message. exe,dll,vbs,jsexe,dll,vbs,js
LoggingLevelLoggingLevel 데이터베이스 메일 로그에 기록할 메시지를 지정합니다.Specify which messages are recorded in the Database Mail log. 다음 숫자 값 중 하나입니다.One of the following numeric values:

1 - 표준 모드입니다.1 - This is normal mode. 오류만 기록합니다.Logs only errors.

2 - 확장 모드입니다.2 - This is extended mode. 오류, 경고 및 정보 메시지를 기록합니다.Logs errors, warnings, and informational messages.

3 - 세부 정보 표시 모드입니다.3 - This is verbose mode. 오류, 경고, 정보 메시지, 성공 메시지 및 추가 내부 메시지를 기록합니다.Logs errors, warnings, informational messages, success messages, and additional internal messages. 이 모드는 문제 해결을 위해 사용합니다.Use this mode for troubleshooting.
22

저장된 프로시저 sysmail_configure_spmsdb 데이터베이스에 있으며가 소유 하 고는 dbo 스키마입니다.The stored procedure sysmail_configure_sp is in the msdb database and is owned by the dbo schema. 현재 데이터베이스 없는 경우 세 부분으로 이루어진 이름으로 프로시저를 실행 해야 msdb합니다.The procedure must be executed with a three-part name if the current database is not msdb.

PermissionsPermissions

실행의 구성원에 게이 프로시저 기본값에 대 한 권한을 sysadmin 고정된 서버 역할입니다.Execute permissions for this procedure default to members of the sysadmin fixed server role.

Examples

A. 각 계정을 10 번씩 다시 시도 하도록 데이터베이스 메일 설정A. Setting Database Mail to retry each account 10 times

다음 예에서는 계정에 연결할 수 없는 것으로 간주하기 전에 각 계정을 10번씩 다시 시도하도록 데이터베이스 메일을 설정합니다.The following example shows setting Database Mail to retry each account ten times before considering the account to be unreachable.

EXECUTE msdb.dbo.sysmail_configure_sp  
    'AccountRetryAttempts', '10' ;  

B. 최대 첨부 파일 크기를 2mb로 설정B. Setting the maximum attachment size to two megabytes

다음 예에서는 최대 첨부 파일 크기를 2MB로 설정합니다.The following example shows setting the maximum attachment size to 2 megabytes.

EXECUTE msdb.dbo.sysmail_configure_sp  
    'MaxFileSize', '2097152' ;  

관련 항목:See Also

데이터베이스 메일 Database Mail
sysmail_help_configure_sp (TRANSACT-SQL) sysmail_help_configure_sp (Transact-SQL)
데이터베이스 메일 저장 프로시저 (Transact SQL)Database Mail Stored Procedures (Transact-SQL)