REPEAT |
Répétition |
| BigQuery |
Syntaxe
|
REPEAT(original_value, repetitions)
|
Paramètres
| Nom |
Description |
| original_value |
Ce paramètre permet de spécifier la chaîne de caractères (STRING) ou la séquence d'octets (BYTES) que vous souhaitez répéter. |
| repetitions |
Ce paramètre permet de définir le nombre de fois que la original_value doit être répétée. Il doit s'agir d'une valeur entière non négative. Si repetitions est 0, la fonction renvoie une chaîne vide. |
Description
Cette fonction permet de retourner la répétition d'une expression le nombre de fois spécifié.
Remarques
- Répète une chaîne sans utiliser de boucle : La fonction REPEAT permet de dupliquer facilement une chaîne ou une séquence d'octets sans avoir
recours à des structures de contrôle comme des boucles. Cela simplifie la génération de motifs ou la création de séparateurs dans des requêtes SQL.
- Renvoie une chaîne vide si la répétition est nulle : Si le paramètre repetitions est égal à 0, la fonction retourne une chaîne vide. C'est un
comportement utile pour éviter les erreurs tout en permettant de contrôler dynamiquement le contenu retourné selon des conditions.
- Utile pour le formatage et le remplissage de données : On peut utiliser REPEAT pour générer des indentations, des séparateurs visuels ('------'), ou des
rembourrages personnalisés dans des chaînes. Cela permet d'adapter dynamiquement l'affichage ou la structure des résultats.
- Fonctionne avec les chaînes de type BYTES également : La fonction prend en charge aussi bien les chaînes de type STRING que BYTES. Cela permet de
répéter des séquences binaires, ce qui peut être utile pour le traitement de données encodées ou des formats bruts.
- Ne modifie pas la casse de la chaîne source : La fonction REPEAT ne transforme pas la casse ou le contenu de la chaîne d'origine. Elle se contente de
la dupliquer telle quelle, ce qui garantit que la répétition est exacte et fidèle à l'entrée.
- Attention à la longueur totale générée : Si la valeur d'origine est longue et que repetitions est élevé, cela peut générer une chaîne très
volumineuse. Il est donc important de surveiller les limites de taille des champs ou d'éviter les répétitions excessives.
- Peut être combinée avec d'autres fonctions de texte : REPEAT peut être utilisée avec CONCAT,
LPAD, RPAD, ou REPLACE pour construire des chaînes plus complexes, comme
des barres de progression, des modèles, ou des structures de formatage personnalisées.
- Fonction déterministe et simple à anticiper : Le résultat de REPEAT est entièrement prévisible et déterministe : il suffit de multiplier le
contenu original par le nombre demandé. Cela en fait une fonction stable et sans effets de bord, utile dans des requêtes de transformation ou de génération.
Dernière mise à jour : Jeudi, le 18 Juin 2020
