PRINT の使用
アプリケーションにメッセージを返すには、PRINT ステートメントを使用します。PRINT は、文字式または Unicode 文字列式のいずれかをパラメータとして受け取り、その文字列をメッセージとしてアプリケーションに返します。SQLClient 名前空間、または ADO (ActiveX Data Object)、OLE DB、および ODBC (Open Database Connectivity) アプリケーション プログラミング インターフェイス (API) を使用して、メッセージが情報エラーとしてアプリケーションに返されます。SQLSTATE は 01000 に、ネイティブ エラーは 0 に設定され、エラー メッセージ文字列は PRINT ステートメントに指定された文字列に設定されます。DB-Library アプリケーションではこの文字列がメッセージ ハンドラ コールバック関数に返されます。
PRINT ステートメントには、文字定数や Unicode 定数、文字や Unicode のローカル変数名、文字列や Unicode 文字列を返す関数など、任意の文字列式を指定できます。PRINT には複数の定数、ローカル変数、または関数を連結して作成した複合文字列も指定できます。
PRINT を使用して Transact-SQL コードのトラブルシューティングを行い、データ値を確認したりレポートを生成します。
次の例では、IF ステートメント内で PRINT を使用して、Hex Nut 17 製品の数が 1,100 未満まで減少したときにメッセージを返します。
USE AdventureWorks;
GO
IF (SELECT SUM(i.Quantity)
FROM Production.ProductInventory i
JOIN Production.Product p
ON i.ProductID = p.ProductID
WHERE Name = 'Hex Nut 17'
) < 1100
PRINT N'There are less than 1100 units of Hex Nut 17 in stock.'
GO
次の例では、ローカル変数、システム関数、およびテキスト文字列を連結して出力します。
USE AdventureWorks;
GO
DECLARE @MyObject NVARCHAR(257);
SET @MyObject = N'Production.Product';
PRINT N'Object Name: ' + @MyObject
PRINT N' Object ID: ' + STR(OBJECT_ID(@MyObject))
GO
次の例では、文字列を連結して出力メッセージを作成する 2 つの方法を示します。
-- Build a print message by concatenating strings in a PRINT
-- statement.
PRINT N'The Database Engine instance '
+ RTRIM(@@SERVERNAME)
+ N' is running SQL Server build '
+ RTRIM(CAST(SERVERPROPERTY(N'ProductVersion ') AS NVARCHAR(128)));
GO
-- This shows building a character variable that is used to
-- print a message.
DECLARE @Msg NVARCHAR(300);
SELECT @Msg = N'The Database Engine instance '
+ RTRIM(@@SERVERNAME)
+ N' is running SQL Server build '
+ RTRIM(CAST(SERVERPROPERTY(N'ProductVersion') AS NVARCHAR(128)));
PRINT @Msg;
GO