Serveur d'impression

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

Le 3 mai 2019 - 5 minutes de lecture

<! – ->

IL S'APPLIQUE À: OuiSQL Server (à partir de 2008) OuiBase de données SQL Azure OuiAzure SQL Data Warehouse OuiStockage parallèle de données S'APPLIQUE À: Et c'estSQL Server (à partir de 2008) Et c'estBase de données SQL Azure Et c'estAzure SQL Data Warehouse Et c'estEntrepô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èmeConventions de syntaxe Transact-SQLIcône de lien de sujetConventions 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

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

<! – ->

Commentaires

Laisser un commentaire

Votre commentaire sera révisé par les administrateurs si besoin.