SUBSTRING

Renvoie une partie d'une expression de type caractère ou binaire. SUBSTR est un alias de SUBSTRING.

Voir aussi :
[SELECT] [ Types de données ]

---

info

Pour extraire un champ d'un objet JSON, utilisez la fonction JSON_EXTRACT.

Syntaxe

SELECT SUBSTRING(expression, start[, length]) FROM <multipartIdentifier>;
SELECT SUBSTR(expression, start[, length]) FROM <multipartIdentifier>;

Arguments

expression
Une chaîne de caractères ASCII ou un BLOB.

Si expression est une chaîne, les indices de caractères désignent de véritables caractères UTF-8. Si expression est un BLOB, les indices désignent des octets.

start
Un entier représentant le premier caractère ou octet de la sous-séquence de l'expression d'entrée à renvoyer. Si start est négatif, le premier caractère de la sous-chaîne est déterminé en comptant à partir de la droite plutôt que de la gauche.

Le caractère le plus à gauche de expression porte le numéro 1.

length
Une valeur entière facultative représentant la longueur de la sous-séquence à renvoyer après la valeur start. Si length est omis, tous les caractères jusqu'à la fin de la chaîne ou du BLOB désigné par expression sont renvoyés.

Si length est négatif, la valeur absolue de length est utilisée.

Valeur(s) renvoyée(s)

Renvoie une valeur de type chaîne ou BLOB selon le type de expression.

---

Exemples

Renvoyer les n premiers caractères d'une colonne

SELECT SUBSTRING(name, 1, 5) as "first five chars" 
FROM google.compute.instances 
WHERE project = 'stackql-demo' 
AND zone = 'australia-southeast1-a';

Tronquer les n premiers caractères d'une colonne

SELECT SUBSTR(name, 5) as "from char 5" 
FROM google.compute.instances 
WHERE project = 'stackql-demo' 
AND zone = 'australia-southeast1-a';

Renvoyer les n derniers caractères d'une colonne

SELECT SUBSTRING(name, -5) as "last five chars" 
FROM google.compute.instances 
WHERE project = 'stackql-demo' 
AND zone = 'australia-southeast1-a';

Pour plus d'informations, consultez https://www.sqlite.org/lang_corefunc.html#substr