FORMATMESSAGE(Transact-SQL)

아티클
10/16/2024

적용 대상: SQL Server Azure SQL 데이터베이스 Azure SQL Managed Instance

sys.messages의 기존 메시지 또는 제공된 문자열에서 메시지를 작성합니다. FORMATMESSAGE의 기능은 RAISERROR 문의 기능과 유사합니다. 단, RAISERROR는 메시지를 즉시 인쇄하는 반면 FORMATMESSAGE는 추가 처리를 위해 서식이 지정된 메시지를 반환합니다.

Transact-SQL 구문 표기 규칙

구문

FORMATMESSAGE ( { msg_number  | ' msg_string ' | @msg_variable} , [ param_value [ ,...n ] ] )

인수

msg_number
sys.messages에 저장된 메시지의 ID입니다. msg_number가 <= 13000이거나 메시지가 sys.messages에 없는 경우 NULL을 반환합니다.

msg_string
적용 대상: SQL Server (SQL Server 2016(13.x) ~ 현재 버전).

작은 따옴표로 묶고 매개 변수 값 자리 표시자가 포함된 문자열입니다. 오류 메시지는 최대 2,047자까지 지정할 수 있습니다. 메시지의 문자가 2,048자 이상이면 처음 2,044자만 표시되고 메시지가 잘렸음을 나타내기 위해 줄임표가 추가됩니다. 내부 스토리지 방식의 특성상 대체 매개 변수는 출력에 표시되는 것보다 더 많은 수의 문자를 사용합니다. 메시지 문자열의 구조 및 문자열의 매개 변수 사용에 대한 자세한 내용은 RAISERROR(Transact-SQL)에서 msg_str 인수에 대한 설명을 참조하세요.

@msg_variable
적용 대상: SQL Server (SQL Server 2016(13.x) ~ 현재 버전).

위의 msg_string 조건을 준수하는 문자열이 포함된 nvarchar 또는 varchar 변수입니다.

param_value
메시지에 사용할 매개 변수 값입니다. 둘 이상의 매개 변수 값을 사용할 수 있습니다. 메시지에 자리 표시자 변수가 표시되는 순서대로 값을 지정해야 합니다. 값의 최대 개수는 20개입니다.

반환 형식

nvarchar

설명

FORMATMESSAGE는 RAISERROR 문과 유사하게 메시지의 자리 표시자 변수를 제공된 매개 변수 값으로 대체하여 메시지를 편집합니다. 오류 메시지에서 허용되는 자리 표시자와 편집 프로세스에 대한 자세한 내용은 RAISERROR(Transact-SQL)를 참조하세요.

FORMATMESSAGE는 사용자의 현재 언어로 된 메시지를 찾습니다. 시스템 메시지(msg_number<=50000)의 경우 지역화된 버전의 메시지가 없으면 OS 언어 버전이 사용됩니다. 사용자 메시지(msg_number>50000)의 경우 지역화된 버전의 메시지가 없으면 영어 버전이 사용됩니다.

지역화된 메시지의 경우 제공된 매개 변수 값은 미국 영어 버전의 매개 변수 자리 표시자와 일치해야 합니다. 즉, 지역화된 버전의 매개 변수 1은 미국 영어 버전의 매개 변수 1과 일치해야 하며 매개 변수 2는 매개 변수 2와 일치해야 합니다.

예제

A. 메시지 번호 사용 예

다음 예는 sys.messages에 "아티클 '%s'을(를) 게시 '%s'에 추가할 수 없습니다."로 저장된 복제 메시지 20009를 사용합니다. FORMATMESSAGE는 First Variable 및 Second Variable 값을 매개 변수 자리 표시자로 대체합니다. 결과 문자열 "아티클 '첫 번째 변수'를 게시 '두 번째 변수'에 추가할 수 없습니다."는 지역 변수 @var1에 저장됩니다.

SELECT text FROM sys.messages WHERE message_id = 20009 AND language_id = 1033;  
DECLARE @var1 VARCHAR(200);   
SELECT @var1 = FORMATMESSAGE(20009, 'First Variable', 'Second Variable');   
SELECT @var1;

B. 메시지 문자열 사용 예

적용 대상: SQL Server (SQL Server 2016(13.x) ~ 현재 버전).

다음 예는 입력으로 문자열을 사용합니다.

SELECT FORMATMESSAGE('This is the %s and this is the %s.', 'first variable', 'second variable') AS Result;

반환 값: This is the first variable and this is the second variable.

C. 추가 메시지 문자열 서식 지정 예

다음 예는 다양한 서식 지정 옵션을 보여줍니다.

SELECT FORMATMESSAGE('Signed int %i, %d %i, %d, %+i, %+d, %+i, %+d', 5, -5, 50, -50, -11, -11, 11, 11);
SELECT FORMATMESSAGE('Signed int with up to 3 leading zeros %03i', 5);  
SELECT FORMATMESSAGE('Signed int with up to 20 leading zeros %020i', 5);  
SELECT FORMATMESSAGE('Signed int with leading zero 0 %020i', -55);  
SELECT FORMATMESSAGE('Bigint %I64d', 3000000000);
SELECT FORMATMESSAGE('Unsigned int %u, %u', 50, -50);  
SELECT FORMATMESSAGE('Unsigned octal %o, %o', 50, -50);  
SELECT FORMATMESSAGE('Unsigned hexadecimal %x, %X, %X, %X, %x', 11, 11, -11, 50, -50);  
SELECT FORMATMESSAGE('Unsigned octal with prefix: %#o, %#o', 50, -50);  
SELECT FORMATMESSAGE('Unsigned hexadecimal with prefix: %#x, %#X, %#X, %X, %x', 11, 11, -11, 50, -50);  
SELECT FORMATMESSAGE('Hello %s!', 'TEST');  
SELECT FORMATMESSAGE('Hello %20s!', 'TEST');  
SELECT FORMATMESSAGE('Hello %-20s!', 'TEST');

참고 항목

RAISERROR(Transact-SQL)
THROW(Transact-SQL)
sp_addmessage(Transact-SQL)
sys.messages(Transact-SQL)
CONCAT(Transact-SQL)
CONCAT_WS(Transact-SQL)
QUOTENAME(Transact-SQL)
REPLACE(Transact-SQL)
REVERSE(Transact-SQL)
STRING_AGG(Transact-SQL)
STRING_ESCAPE(Transact-SQL)
STUFF(Transact-SQL)
TRANSLATE(Transact-SQL)
시스템 함수(Transact-SQL)

다음을 통해 공유