PRINT (Transact-SQL) -SQL Server – Choisir le bon serveur d'impression – Serveur d’impression

<! – ->
le

Applicable à: Serveur SQL Base de données SQL Azure Azure SQL Data Warehouse Entrepôt de données parallèleS'APPLIQUE À: Serveur SQL Base de données SQL Azure Azure SQL Data Warehouse Entrepôt de données parallèle

Renvoie un message défini par l'utilisateur au client.Renvoie un message défini par l'utilisateur au client.

Conventions de syntaxe Transact-SQL Conventions de syntaxe Transact-SQL

syntaxeSyntaxe

PRINT msg_str | @local_variable | string_expr  

argumentCas

msg_strmsg_str
Une constante pour une chaîne Unicode ou une chaîne.Est une chaîne de caractères ou une constante de chaîne Unicode. Pour plus d'informations, consultez Constantes (Transact-SQL).Pour plus d'informations, consultez Constantes (Transact-SQL).

@ variable locale@ variable locale
Spécifiez toute variable de caractère valide.Est une variable de tout type de données de caractères valides. @ variable locale estcarboniser,nchar,VarcharOu Nvarchar Ou bien il doit pouvoir être implicitement converti en ces types de données.@variable locale doit être carboniser, nchar, Varchar, ou Nvarcharou il doit être implicitement converti en ces types de données.

string_exprstring_expr
Spécifie une expression qui retourne une chaîne.Est une expression qui retourne une chaîne. Peut contenir des valeurs littérales, des fonctions et des variables concaténées.Peut inclure des valeurs littérales concaténées, des fonctions et des variables. Pour plus d'informations, consultez Expressions (Transact-SQL).Pour plus d'informations, consultez Expressions (Transact-SQL).

La chaîne de message peut contenir jusqu'à 8 000 octets pour les chaînes non Unicode et jusqu'à 4 000 octets pour les chaînes Unicode.Une chaîne de message peut contenir jusqu'à 8 000 caractères s'il s'agit d'une chaîne non Unicode et 4 000 caractères s'il s'agit d'une chaîne Unicode. Les chaînes plus longues sont tronquées.Les chaînes plus longues sont tronquées. Varchar (max) Quand nvarchar (max) Le type de données estvarchar (8000) et nvarchar (4000) Est tronqué à un type de données qui n'est plusle varchar (max) et nvarchar (max) les types de données sont tronqués en types de données qui ne sont pas plus gros que varchar (8000) et nvarchar (4000).

Vous pouvez également utiliser RAISERROR pour renvoyer un message.RAISERROR peut également être utilisé pour renvoyer des messages. RAISERROR présente les avantages suivants par rapport à PRINT:RAISERROR présente ces avantages par rapport à PRINT:

• RAISERROR prend en charge la substitution d'arguments par des chaînes de message d'erreur. Ce remplacement utilise un mécanisme inspiré de la fonction printf de la bibliothèque de langage C standard.RAISERROR prend en charge le remplacement des arguments dans une chaîne de message d'erreur à l'aide d'un mécanisme modelé sur la fonction printf de la bibliothèque de langage C standard.

• RAISERROR vous permet de spécifier un numéro d'erreur unique, une gravité et un code d'état en plus des messages texte.RAISERROR peut spécifier un numéro d'erreur unique, une gravité et un code d'état en plus du message texte.

• RAISERROR peut être utilisé pour renvoyer un message défini par l'utilisateur créé à l'aide de la procédure stockée système sp_addmessage.RAISERROR peut être utilisé pour renvoyer des messages définis par l'utilisateur créés à l'aide de la procédure stockée système sp_addmessage.

Exemple d'utilisationExemples

UNE.UNE. Exécution conditionnelle PRINT (SI EXISTS)Exécution conditionnelle de l'impression (SI EXISTE)

Dans l'exemple suivant:IMPRESSION Utilisez les instructions pour renvoyer des messages en fonction de conditions.L'exemple suivant utilise le IMPRESSION instruction de retourner conditionnellement un message.

IF @@ OPTIONS & 512 <> 0
IMPRIMER Cet utilisateur a SET NOCOUNT activé. & # 39 ;;
AUTRE
IMPRIMER Cet utilisateur a SET NOCOUNT désactivé. & # 39 ;;
ALLER  

B.B. Construire et afficher une chaîneConstruire et afficher une chaîne

Dans l'exemple suivant,AVOIR UNE RÉUNION Le résultat de la fonction Nvarchar Conversion en type de données et concaténation avec du texte littéral IMPRESSION Retourne dans.L'exemple suivant convertit les résultats de la AVOIR UNE RÉUNION opérer à Nvarchar type de données et concatène avec un texte littéral à retourner par IMPRESSION.

-Construire le texte du message concaténant
-chains et expressions.
N ° IMPRIMER Ce message a été imprimé sur & # 39;
+ RTRIM (CAST (GETDATE () AS nvarchar (30)))
+ N / # 39; & # 39 ;;
ALLER
-Cet exemple montre comment construire le texte du message
-dans une variable puis en la passant à PRINT.
-Cela était requis dans SQL Server 7.0 ou version antérieure.
DECLARE @PrintMessage nvarchar (50);
SET @PrintMessage = N & # 39; Ce message a été imprimé sur & # 39;
+ RTRIM (CAST (GETDATE () AS nvarchar (30)))
+ N / # 39; & # 39 ;;
PRINT @PrintMessage;
ALLER  

Exemple: Azure SQL Data WarehouseAzure SQL Data Warehouse et Entrepôt de données parallèleEntrepôt de données parallèleExemples: Azure SQL Data WarehouseAzure SQL Data Warehouse et Entrepôt de données parallèleEntrepôt de données parallèle

contre.contre. Exécution conditionnelleExécution conditionnelle de l'impression

Dans l'exemple suivant,IMPRESSION Utilisez les instructions pour renvoyer des messages en fonction de conditions.L'exemple suivant utilise le IMPRESSION instruction de retourner conditionnellement un message.

IF DB_ID () = 1
La base de données actuelle est la base de données master. & # 39 ;;
AUTRE
PRINT No. La base de données actuelle n'est pas maître. & # 39 ;;
ALLER  

référenceVoir également

Type de données (Transact-SQL) Types de données (Transact-SQL)
DECLARE @ variable_local (Transact-SQL) DECLARE @ variable_local (Transact-SQL)
RAISERROR (Transact-SQL)RAISERROR (Transact-SQL)

le