char et varchar (Transact-SQL)

S’applique à :SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)Point de terminaison analytique SQL dans Microsoft FabricEntrepôt dans Microsoft Fabric

Les types de données de caractères qui sont soit de taille fixe, char, soit de taille variable, varchar. À partir de SQL Server 2019 (15.x), quand un classement prenant en charge UTF-8 est utilisé, ces types de données stockent la plage complète des données caractères Unicode et utilisent le codage de caractères UTF-8. Si un classement non-UTF-8 est spécifié, ces types de données stockent uniquement un sous-ensemble de caractères pris en charge par la page de codes correspondante de ce classement.

Arguments

char [ ( n ) ]

Données de type chaîne de taille fixe. n définit la taille de chaîne en octets et doit être une valeur comprise entre 1 et 8 000. Pour l’encodage de jeux de caractères sur un octet, par exemple Latin, la taille de stockage est n octets et le nombre de caractères pouvant être stockés est également n. Pour les jeux de caractères codés sur plusieurs octets, la taille de stockage est toujours n octets, mais le nombre de caractères pouvant être stockés peut être inférieur à n. Le synonyme ISO de char est character. Pour plus d’informations sur les jeux de caractères, consultez Jeux de caractères codés sur un octet et multioctets.

varchar [ ( n | max ) ]

Données de type chaîne de taille variable. Utilisez n pour définir la taille de la chaîne en octets (comprise entre 1 et 8 000) ou utilisez max pour indiquer une taille de contrainte de colonne maximale de 2^31-1 octets (2 Go). Pour l’encodage de jeux de caractères sur un octet, par exemple Latin, la taille de stockage est n octets + 2 octets et le nombre de caractères pouvant être stockés est également n. Pour les jeux de caractères codés sur plusieurs octets, la taille de stockage est toujours n octets + 2 octets, mais le nombre de caractères pouvant être stockés peut être inférieur à n. Les synonymes ISO de varchar sont char variant ou caractère variant. Pour plus d’informations sur les jeux de caractères, consultez Jeux de caractères codés sur un octet et multioctets.

Notes

Contrairement au malentendu concernant char(n) et varchar(n), n ne définit pas le nombre de caractères. Toutefois, dans char(n) et varchar(n), n définit la longueur de la chaîne en octets (0 à 8 000). n ne définit jamais des nombres de caractères pouvant être stockés. Ceci est similaire à la définition de nchar(n) et nvarchar(n).

En fait, lors de l’utilisation de l’encodage sur un octet, la taille de stockage de char et varchar est de n octets, et le nombre de caractères est également de n, d’où ce malentendu. Toutefois, pour l’encodage multioctet, par exemple UTF-8, les plages Unicode plus élevées (128 à 1,114,111) génèrent un caractère utilisant deux octets ou plus. Par exemple, dans une colonne définie en tant que char(10), le Moteur de base de données peut stocker 10 caractères qui utilisent l’encodage sur un octet (plage Unicode 0 à 127), mais moins de 10 caractères lors de l’utilisation de l’encodage multioctet (plage Unicode 128 à 1,114,111). Pour plus d’informations sur le stockage Unicode et les plages de caractères, consultez Différences de stockage entre UTF-8 et UTF-16.

Quand la valeur de n n’est spécifiée ni dans une définition de données ni dans une instruction de déclaration de variable, la longueur par défaut est 1. Si la valeur de n n’est pas précisée avec les fonctions CAST et CONVERT, la longueur par défaut est de 30.

Les objets qui utilisent char ou varchar reçoivent le classement par défaut de la base de données, sauf si un classement spécifique est affecté à l’aide de la clause COLLATE. Le classement contrôle la page de codes utilisée pour stocker les données de caractères.

Les encodages multioctets dans SQL Server sont les suivants :

• Les jeux de caractères codés sur deux octets (DBCS) pour certaines langues d’Extrême-Orient à l’aide des pages de codes 936 et 950 (chinois), 932 (japonais) ou 949 (coréen).

• UTF-8 avec la page de codes 65001.

  S’applique à : SQL Server 2019 (15.x) et versions ultérieures.

Si vous avez de sites qui prennent en charge plusieurs langues :

• À partir de SQL Server 2019 (15.x), utilisez un classement UTF-8 prenant en charge Unicode pour limiter les problèmes de conversion de caractères.
• Si vous utilisez une version antérieure du Moteur de base de données, utilisez les types de données Unicode nchar ou nvarchar afin de limiter les problèmes de conversion de caractères.

Si vous utilisez char ou varchar, nous vous recommandons de procéder ainsi :

• Utilisez char quand les tailles des entrées de données de la colonne sont cohérentes.
• Utilisez varchar quand les tailles des entrées de données de la colonne varient considérablement.
• Utilisez varchar(max) quand les tailles des entrées de données de la colonne varient considérablement et que la longueur de chaîne peut dépasser 8 000 octets.

Si SET ANSI_PADDING est OFF quand CREATE TABLE ou ALTER TABLE est exécuté, une colonne char définie comme NULL est traitée comme une varchar.

Convertir des données de type caractères

Lorsque des expressions de caractères sont converties en type caractère de taille différente, les valeurs trop longues pour le nouveau type de données sont tronquées. Le type uniqueidentifier est considéré comme un type caractères pour la conversion d’une expression de type caractères. Il est donc soumis aux règles de troncation pour la conversion en un type caractères. Consultez la section Exemples.

Quand une expression de caractères est convertie en une expression de caractères de taille ou de type de données différent (par exemple, de char(5) en varchar(5) , ou char(20) en char(15) ), le classement de la valeur d’entrée est affecté à la valeur convertie. Si une expression de type non caractère est convertie en un type de données caractère, le classement par défaut de la base de données active est affecté à la valeur convertie. Dans les deux cas, vous pouvez affecter un classement spécifique à l’aide de la clause COLLATE.

Les expressions de type caractères qui sont converties en un type de données numeric approximatif peuvent inclure une notation exponentielle facultative. Cette notation est un e minuscule ou E majuscule, suivi d’un signe facultatif plus (+) ou moins (-) et d’un nombre.

Les expressions de caractères converties en un type de données numeric exact doivent être composées de chiffres, d’une virgule décimale et éventuellement d’un plus (+) ou d’un moins (-). Les espaces à gauche sont ignorés. Les séparateurs virgule (séparateurs de milliers en notation anglaise comme dans 123,456.00) ne sont pas autorisés dans la chaîne.

Les expressions de caractères converties en types de données money ou smallmoney peuvent également comprendre une virgule décimale et le symbole du dollar ($). Les séparateurs virgule (comme dans $123,456.00) sont autorisés.

Quand une chaîne vide est convertie en int, sa valeur devient 0. Quand une chaîne vide est convertie en date, sa valeur devient la valeur par défaut de la date, en l’occurrence 1900-01-01.

Exemples

R. Affichage de la valeur par défaut de n utilisée dans une déclaration de variable

L’exemple suivant montre que la valeur par défaut de n est 1 pour les types de données char et varchar quand ils sont utilisés dans une déclaration de variable.

DECLARE @myVariable AS VARCHAR = 'abc';
DECLARE @myNextVariable AS CHAR = 'abc';
--The following returns 1
SELECT DATALENGTH(@myVariable), DATALENGTH(@myNextVariable);
GO

B. Affiche la valeur par défaut de n quand varchar est utilisé dans CAST et CONVERT

L’exemple suivant montre que la valeur par défaut de n est 30 quand les types de données char ou varchar sont utilisés avec les fonctions CAST et CONVERT.

DECLARE @myVariable AS VARCHAR(40);
SET @myVariable = 'This string is longer than thirty characters';
SELECT CAST(@myVariable AS VARCHAR);
SELECT DATALENGTH(CAST(@myVariable AS VARCHAR)) AS 'VarcharDefaultLength';
SELECT CONVERT(CHAR, @myVariable);
SELECT DATALENGTH(CONVERT(CHAR, @myVariable)) AS 'VarcharDefaultLength';

C. Convertir des données à des fins d’affichage

L'exemple suivant convertit deux colonnes en types caractères et applique un style qui applique un format spécifique aux données affichées. Un type money est converti en données caractères et le style 1 est appliqué, ce qui affiche les valeurs avec une virgule tous les trois chiffres à gauche de la virgule décimale et deux chiffres à droite de la virgule décimale. Un type datetime est converti en données caractères et le style 3 est appliqué, ce qui affiche les données au format dd/mm/yy. Dans la clause WHERE, un type money est converti en un type caractère pour effectuer une opération de comparaison de chaînes.

USE AdventureWorks2022;
GO
SELECT BusinessEntityID,
   SalesYTD,
   CONVERT (VARCHAR(12),SalesYTD,1) AS MoneyDisplayStyle1,
   GETDATE() AS CurrentDate,
   CONVERT(VARCHAR(12), GETDATE(), 3) AS DateDisplayStyle3
FROM Sales.SalesPerson
WHERE CAST(SalesYTD AS VARCHAR(20) ) LIKE '1%';

Voici le jeu de résultats obtenu.

BusinessEntityID SalesYTD              DisplayFormat CurrentDate             DisplayDateFormat
---------------- --------------------- ------------- ----------------------- -----------------
278              1453719.4653          1,453,719.47  2011-05-07 14:29:01.193 07/05/11
280              1352577.1325          1,352,577.13  2011-05-07 14:29:01.193 07/05/11
283              1573012.9383          1,573,012.94  2011-05-07 14:29:01.193 07/05/11
284              1576562.1966          1,576,562.20  2011-05-07 14:29:01.193 07/05/11
285              172524.4512           172,524.45    2011-05-07 14:29:01.193 07/05/11
286              1421810.9242          1,421,810.92  2011-05-07 14:29:01.193 07/05/11
288              1827066.7118          1,827,066.71  2011-05-07 14:29:01.193 07/05/11

D. Convertir des données uniqueidentifier

L’exemple suivant convertit une valeur uniqueidentifier en type de données char.

DECLARE @myid uniqueidentifier = NEWID();
SELECT CONVERT(CHAR(255), @myid) AS 'char';

L'exemple suivant illustre la troncation des données lorsque la valeur est trop longue pour le type de données vers lequel la conversion est effectuée. Étant donné que le type uniqueidentifier est limité à 36 caractères, les caractères qui dépassent cette longueur sont tronqués.

DECLARE @ID NVARCHAR(max) = N'0E984725-C51C-4BF4-9960-E1C80E27ABA0wrong';
SELECT @ID, CONVERT(uniqueidentifier, @ID) AS TruncatedValue;

Voici le jeu de résultats obtenu.

String                                       TruncatedValue
-------------------------------------------- ------------------------------------
0E984725-C51C-4BF4-9960-E1C80E27ABA0wrong    0E984725-C51C-4BF4-9960-E1C80E27ABA0

(1 row(s) affected)

Voir aussi

• nchar et nvarchar (Transact-SQL)
• CAST et CONVERT (Transact-SQL)
• COLLATE (Transact-SQL)
• Conversion de types de données (Moteur de base de données)
• Types de données (Transact-SQL)
• Estimer la taille d'une base de données
• Prise en charge d'Unicode et du classement
• Jeux de caractères codés sur un octet et multioctets