Serveur d'impression

PRINT (Transact-SQL) – SQL Server – Bien choisir son serveur d impression

Le 3 mai 2019 - 5 minutes de lecture

16/03/2017
Temps de lecture: 2 minutes
Contributeurs

<! – ->

IL S'APPLIQUE À: Oui SQL Server (à partir de 2008) Oui Base de données SQL Azure Oui Azure SQL Data Warehouse Oui Stockage parallèle de données S'APPLIQUE À: Et c'est SQL Server (à partir de 2008) 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 le message défini par l'utilisateur au client.

Icône de lien de thème Conventions de syntaxe Transact-SQL Icône de lien de sujet Conventions de syntaxe Transact-SQL

SyntaxeSyntaxe

PRINT msg_str | @local_variable | string_expr

ArgumentsArguments

msg_strmsg_str
C'est une chaîne de caractères ou une constante de chaîne Unicode.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
C'est une variable de tout type de données de caractères valides.Est une variable de tout type de données de caractère valide. @variable locale doit être carboniser, nchar, varchar ou Nvarchar, ou il devrait être implicitement converti en ces types de données.@variable locale doit être carboniser, nchar, varchar, ou Nvarchar, ou il doit pouvoir être implicitement traduit en ces types de données.

string_exprstring_expr
C'est une expression qui retourne une chaîne.Est une expression qui retourne à chaîne. Il peut inclure 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).

RemarquesRemarques

Une chaîne de message peut avoir une longueur maximale de 8 000 caractères s'il s'agit d'une chaîne non Unicode et de 4 000 caractères s'il s'agit d'une chaîne Unicode.Une chaîne de message peut comporter 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 les plus longues seront tronquées.Les chaînes plus longues sont tronquées. Les types de données varchar (max) Y nvarchar (max) sont tronqués dans des types de données qui ne sont pas supérieurs à varchar (8000) Y nvarchar (4000).le varchar (max) et nvarchar (max) les types de données sont tronqués aux types de données qui ne sont pas plus grands que varchar (8000) et nvarchar (4000).

RAISERROR peut également être utilisé pour renvoyer des messages.RAISERROR peut également être utilisé pour renvoyer des messages. RAISERROR offre une série d’avantages par rapport à PRINT:RAISERROR présente ces avantages par rapport à PRINT:

RAISERROR prend en charge les arguments de substitution dans une chaîne de message d'erreur avec un mécanisme modélisé dans la fonction printf de la bibliothèque de langage C standard.RAISERROR prend en charge la substitution des arguments dans une chaîne de message d'erreur à l'aide d'un mécanisme modelé sur la fonction d'impression de la bibliothèque standard du langage C.
RAISERROR peut spécifier un numéro d'erreur unique, un niveau de gravité et un code d'état pour le message 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 des messages définis par l'utilisateur et créé à l'aide de la procédure 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.

ExemplesExemples

À.À. Exécuter conditionnellement une impression (SI EXISTE)Exécution conditionnelle de print (IF EXISTS)

Dans l'exemple suivant, l'instruction est utilisée IMPRESSION pour renvoyer un message sous condition.L'exemple suivant utilise le IMPRESSION instruction à retourner conditionnellement au message.

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

B.B. Générer et afficher une chaîneConstruire et afficher une chaîne

Dans l'exemple suivant, le résultat de la fonction est converti. AVOIR UN RENDEZ-VOUS à un type de données Nvarchar et il est concaténé avec le texte littéral qui renvoie IMPRESSION.L'exemple suivant convertit les résultats de la AVOIR UN RENDEZ-VOUS fonctionner à un Nvarchar type de données et le concatène avec un texte littéral à renvoyer par IMPRESSION.

- Construire le texte du message en concaténant
- des chaînes et des expressions.
N ° IMPRESSION Ce message a été imprimé sur & # 39;
+ RTRIM (CAST (GETDATE () AS nvarchar (30)))
+ N & # 39;. & # 39 ;;
ALLER
- Cet exemple montre la construction du texte du message
- dans une variable puis en le 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

Exemples: Stockage de données SQL AzureAzure SQL Data Warehouse Y Stockage parallèle de donnéesEntrepôt de données parallèleExemples: Stockage de données SQL AzureAzure SQL Data Warehouse et Stockage parallèle de donnéesEntrepôt de données parallèle

C.C. Exécuter conditionnellement une impressionExécution conditionnelle de print

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

Voir égalementVoir également

Types 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)