Click here to view and discuss this page in DocCommentXchange. In the future, you will be sent there automatically.
メッセージ番号/メッセージ文字列のペアを作成します。このメッセージ番号は PRINT 文と RAISERROR 文で使用できます。
CREATE MESSAGE message-number AS message-text
message-number : integer
message-text : string
message-number 追加するメッセージのメッセージ番号。ユーザ定義メッセージのメッセージ番号は 20000 以上にしてください。
message-text 追加するメッセージのテキスト。最大長は、255 バイトです。PRINT と RAISERROR は、メッセージテキストのプレースホルダを認識します。1 つのメッセージには、ユニークなプレースホルダを任意の順序で 20 個まで含めることができます。これらのプレースホルダは、メッセージのテキストをクライアントに送信するときにメッセージの後に付けた任意の引数のフォーマット文字列に置換されます。
メッセージを文法的構文が異なる言語に翻訳するときに順番を変えられるように、プレースホルダには番号が付けられます。引数のプレースホルダの形式は "%nn!" です。パーセント記号 (%)、nn (1 ~ 20 の整数)、感嘆符 (!) の順になります。整数は引数の引数リスト内の位置を表します。"%1!" が最初の引数で、2 番目の引数は "%2!"、のようになります。
sp_addmessage の language 引数に対応するパラメータはありません。
PRINT 文と RAISERROR 文によって使用される、ユーザ定義メッセージをシステムテーブル ISYSUSERMESSAGE に追加します。
CREATE MESSAGE または CREATE ANY OBJECT システム権限が必要です。
オートコミット。
SQL/2008 ベンダー拡張。
Transact-SQL CREATE MESSAGE には、Adaptive Server Enterprise の sp_addmessage システムプロシージャで提供される機能が備えられています。
次の例は新しいメッセージを作成します。
CREATE MESSAGE 20000 AS 'End of line reached';