아티클
04/01/2012

PRINT(Transact-SQL)

사용자 정의 메시지를 클라이언트에게 반환합니다.

구문

PRINT msg_str | @local_variable | string_expr

인수

msg_str
문자열 또는 유니코드 문자열 상수입니다. 자세한 내용은 상수(Transact-SQL)을 참조하십시오.
**@**local_variable
유효한 문자 데이터 형식의 변수입니다. **@**local_variable은 char, nchar, varchar 또는 nvarchar이거나 암시적으로 이러한 데이터 형식으로 변환될 수 있어야 합니다.
string_expr
문자열을 반환하는 식입니다. 연결된 리터럴 값, 함수 및 변수를 포함할 수 있습니다. 자세한 내용은 식(Transact-SQL)을 참조하십시오.

주의

메시지 문자열은 비유니코드 문자열일 경우 최대 8,000자까지 가능하며 유니코드 문자열일 경우 최대 4,000자까지 가능합니다. 이보다 긴 문자열은 잘립니다. varchar(max) 및 nvarchar(max) 데이터 형식은 varchar(8000) 및 nvarchar(4000)보다 크지 않은 데이터 형식으로 잘립니다.

PRINT 문이 반환한 메시지를 응용 프로그램에서 처리하는 방법은 응용 프로그램 오류 및 메시지 처리를 참조하십시오.

RAISERROR를 사용하여 메시지를 반환할 수도 있습니다. RAISERROR는 PRINT에 비해 3가지 장점이 있습니다.

RAISERROR는 C 언어 표준 라이브러리의 printf 함수를 바탕으로 모델링된 메커니즘을 사용하여 인수를 오류 메시지 문자열로 대체할 수 있습니다.
RAISERROR는 텍스트 메시지와 별도로 고유 오류 번호, 심각도 및 상태 코드를 지정할 수 있습니다.
RAISERROR는 sp_addmessage 시스템 저장 프로시저를 사용하여 생성된 사용자 정의 메시지를 반환하는 데 사용할 수 있습니다.

예

1. 조건에 따라 실행되는 PRINT 문(IF EXISTS)

다음 예에서는 PRINT 문을 사용하여 조건에 따라 메시지를 반환합니다.

IF @@OPTIONS & 512 <> 0
    PRINT N'This user has SET NOCOUNT turned ON.';
ELSE
    PRINT N'This user has SET NOCOUNT turned OFF.';
GO

2. 문자열 만들기 및 표시

다음 예에서는 GETDATE 함수의 결과를 nvarchar 데이터 형식으로 변환하고 PRINT에서 반환되도록 리터럴 텍스트와 연결합니다.

-- Build the message text by concatenating
-- strings and expressions.
PRINT N'This message was printed on '
    + RTRIM(CAST(GETDATE() AS nvarchar(30)))
    + N'.';
GO
-- This example shows building the message text
-- in a variable and then passing it to PRINT.
-- This was required in SQL Server 7.0 or earlier.
DECLARE @PrintMessage nvarchar(50);
SET @PrintMessage = N'This message was printed on '
    + RTRIM(CAST(GETDATE() AS nvarchar(30)))
    + N'.';
PRINT @PrintMessage;
GO