Fonctions de chaîne - Amazon Simple Storage Service
CHAR_LENGTH, CHARACTER_LENGTHLOWERSUBSTRINGTRIMUPPER

Fonctions de chaîne

Important

Amazon S3 Select n’est plus disponible pour les nouveaux clients. Les clients existants d’Amazon S3 Select peuvent continuer à utiliser cette fonctionnalité comme d’habitude. En savoir plus

Amazon S3 Select prend en charge les fonctions de chaîne suivantes.

CHAR_LENGTH, CHARACTER_LENGTH

CHAR_LENGTH (ou CHARACTER_LENGTH) compte le nombre de caractères dans la chaîne spécifiée.

Note

CHAR_LENGTH et CHARACTER_LENGTH sont synonymes.

Syntaxe

CHAR_LENGTH ( string )

Paramètres

string

Chaîne cible sur laquelle la fonction opère.

Exemples

CHAR_LENGTH('')          -- 0
CHAR_LENGTH('abcdefg')   -- 7

LOWER

À partir d’une chaîne donnée, LOWER convertit tous les caractères majuscules en minuscules. Les caractères qui ne sont pas en majuscules restent inchangés.

Syntaxe

LOWER ( string )

Paramètres

string

Chaîne cible sur laquelle la fonction opère.

Exemples

LOWER('AbCdEfG!@#$') -- 'abcdefg!@#$'

SUBSTRING

À partir d’une chaîne, d’un index de début et éventuellement d’une longueur donnés, SUBSTRING renvoie la sous-chaîne de l’index de début à la fin de la chaîne ou à la fin de la longueur précisée.

Note

Le premier caractère de la chaîne d’entrée possède la position d’index 1.

  • Si start est < 1, sans longueur spécifiée, la position d’index est définie sur 1.

  • Si start est < 1, avec une longueur spécifiée, la position d’index est définie sur start + length -1.

  • Si start + length -1 est < 0, une chaîne vide est renvoyée.

  • Si start + length -1 est > = 0, la sous-chaîne commençant à la position d’index 1 dont la longueur est start + length - 1 est renvoyée.

Syntaxe

SUBSTRING( string FROM start [ FOR length ] )

Paramètres

string

Chaîne cible sur laquelle la fonction opère.

start

Position de début de la chaîne.

length

Longueur de la sous-chaîne à renvoyer. En cas d’absence du paramètre, le traitement s’effectue jusqu’à la fin de la chaîne.

Exemples

SUBSTRING("123456789", 0)      -- "123456789"
SUBSTRING("123456789", 1)      -- "123456789"
SUBSTRING("123456789", 2)      -- "23456789"
SUBSTRING("123456789", -4)     -- "123456789"
SUBSTRING("123456789", 0, 999) -- "123456789" 
SUBSTRING("123456789", 1, 5)   -- "12345"

TRIM

Supprime les caractères de tête ou de fin d’une chaîne. Le caractère par défaut à supprimer est un espace (' ').

Syntaxe

TRIM ( [[LEADING | TRAILING | BOTH remove_chars] FROM] string )

Paramètres

string

Chaîne cible sur laquelle la fonction opère.

LEADING | TRAILING | BOTH

Ce paramètre indique s’il faut supprimer les caractères de tête ou de fin ou les deux.

remove_chars

Jeu de caractères à supprimer. remove_chars peut être une chaîne de longueur > 1. Cette fonction renvoie la chaîne avec n’importe quel caractère de remove_chars se trouvant au début ou à la fin de la chaîne qui a été supprimée.

Exemples

TRIM('       foobar         ')               -- 'foobar'
TRIM('      \tfoobar\t         ')            -- '\tfoobar\t'
TRIM(LEADING FROM '       foobar         ')  -- 'foobar         '
TRIM(TRAILING FROM '       foobar         ') -- '       foobar'
TRIM(BOTH FROM '       foobar         ')     -- 'foobar'
TRIM(BOTH '12' FROM '1112211foobar22211122') -- 'foobar'

UPPER

À partir d’une chaîne donnée, UPPER convertit tous les caractères minuscules en majuscules. Les caractères qui ne sont pas en minuscules restent inchangés.

Syntaxe

UPPER ( string )

Paramètres

string

Chaîne cible sur laquelle la fonction opère.

Exemples

UPPER('AbCdEfG!@#$') -- 'ABCDEFG!@#$'