PRINT (Transact-SQL) – SQL Server – Bien choisir son serveur d impression
<! –
SQL Server (à partir de 2008)
Base de données SQL Azure
Azure SQL Data Warehouse
Stockage parallèle de données
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.
Conventions de syntaxe Transact-SQL
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
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