LPAD

Syntaxe

Paramètres

Description

Cette fonction permet d'ajouter le caractère spécifié au début de façon à se que la chaîne de caractères atteint la longueur spécifié.

Remarques

• Fonction utile pour formater les chaînes à gauche : La fonction LPAD permet de compléter une chaîne de caractères par la gauche afin qu'elle atteigne une longueur donnée. Elle est particulièrement utile pour uniformiser la taille des chaînes, par exemple pour l'affichage de numéros, d'identifiants ou de codes formatés.
• Le rembourrage est effectué uniquement si nécessaire : Si la chaîne originale (original_value) est plus courte que la longueur cible (return_length), LPAD ajoute les caractères définis dans pattern. En revanche, si la chaîne est déjà plus longue, elle est tronquée à la taille indiquée, ce qui permet de contrôler précisément la longueur finale.
• Le caractère de remplissage est personnalisable : Le paramètre pattern permet d'utiliser un caractère ou une séquence personnalisée pour le rembourrage. Par défaut, un espace est utilisé, mais on peut choisir par exemple "0", "*" ou tout autre motif, ce qui est utile pour générer des formats normalisés ou esthétiques.
• Utile pour les alignements dans les exports ou rapports : Lorsqu'on exporte des données dans un fichier texte, CSV ou affichage brut, LPAD permet de garantir que toutes les valeurs ont la même largeur, ce qui améliore la lisibilité. Cela permet aussi de créer des tableaux pseudo-alignés sans tableur.
• Idéal pour générer des codes à longueur fixe : On utilise souvent LPAD pour formater des numéros avec des zéros en tête, comme dans les références clients (00042), les numéros de facture ou les numéros de lot. Cela assure la cohérence visuelle dans les bases de données et les interfaces utilisateur.
• Fonction inverse possible avec RPAD : LPAD ajoute les caractères à gauche, tandis que RPAD les ajoute à droite. Ces deux fonctions permettent de contrôler la position du rembourrage, ce qui est essentiel lorsqu'on aligne des données selon différentes règles de présentation ou d'analyse.
• Attention aux chaînes multicaractères dans le pattern : Si le pattern contient plusieurs caractères, BigQuery répète ce motif pour combler l'espace manquant, et le tronque au besoin. Cela permet des effets intéressants (ex. : LPAD("42", 7, "-=") donne "-=-=42"), mais peut mener à des résultats inattendus sans tests préalables.
• Peut altérer les données si la longueur est trop courte : Si return_length est inférieur à la taille de original_value, la chaîne sera coupée, ce qui peut entraîner une perte d'information. Il faut donc s'assurer que la valeur spécifiée est toujours supérieure ou égale à la longueur réelle des données que l'on souhaite conserver.