CHARACTER_LENGTH

Syntaxe

Paramètres

Description

Cette fonction permet de demander la longueur, en caractères, de la chaîne de caractères spécifié. Cette fonction est un alias de la fonction CHAR_LENGTH.

Remarques

• Fonction de mesure de la longueur textuelle réelle : CHARACTER_LENGTH retourne le nombre de caractères Unicode dans une chaîne de texte, peu importe le nombre d'octets nécessaires pour les représenter. Cela permet d'obtenir une mesure fidèle de ce que l'utilisateur voit à l'écran, notamment pour les chaînes multilingues.
• Alias complet de CHAR_LENGTH : CHARACTER_LENGTH est synonyme exact de CHAR_LENGTH dans BigQuery. Les deux produisent le même résultat, mais CHARACTER_LENGTH est souvent préféré pour sa clarté, notamment dans des requêtes SQL documentées ou pédagogiques.
• Différence essentielle avec BYTE_LENGTH : Contrairement à BYTE_LENGTH, qui mesure la taille mémoire en octets, CHARACTER_LENGTH mesure la quantité de symboles lisibles, même si certains occupent plusieurs octets. Par exemple, un emoji ou un caractère accentué peut être codé sur plusieurs octets mais compte pour un seul caractère.
• Pratique pour valider des champs de saisie utilisateur : Cette fonction est souvent utilisée pour vérifier la taille logique d'un champ. Par exemple, si un nom ne doit pas dépasser 50 caractères (peu importe les octets), on utilise CHARACTER_LENGTH(nom) pour faire le contrôle, ce qui garantit une évaluation visuellement cohérente.
• Prend en charge pleinement l'encodage UTF-8 : CHARACTER_LENGTH traite correctement les chaînes en UTF-8, ce qui est essentiel pour travailler avec des alphabets non latins (comme le chinois, le japonais ou l'arabe) ou avec des symboles spéciaux. Cela assure une compatibilité linguistique universelle.
• Renvoie 0 pour les chaînes vides : Si la chaîne est vide (''), la fonction retourne 0. Cela peut être utile pour détecter des champs remplis uniquement par des chaînes vides ou pour exclure des valeurs nulles ou inutilisables dans des filtres ou rapports.
• Fonction non applicable directement aux types BYTES : CHARACTER_LENGTH ne s'applique qu'aux chaînes de type STRING. Pour les séquences binaires (BYTES), il faut utiliser BYTE_LENGTH à la place. Toute tentative sur des types non textuels entraîne une erreur ou nécessite une conversion préalable.
• Utile dans des calculs dynamiques de découpage : Elle peut être utilisée en conjonction avec des fonctions comme SUBSTR ou LEFT pour travailler dynamiquement sur les portions de texte. Par exemple, extraire les 5 derniers caractères d'une chaîne nécessite de connaître d'abord sa CHARACTER_LENGTH.