文字列関数
重要
新規のお客様への Amazon S3 Select の提供は終了しました。Amazon S3 Select をご利用の既存のお客様は、今後も通常どおり使用できます。詳細はこちら
Amazon S3 Select では、以下の文字列関数がサポートされています。
CHAR_LENGTH, CHARACTER_LENGTH
CHAR_LENGTH (または CHARACTER_LENGTH) は、指定された文字列の文字数をカウントします。
注記
CHAR_LENGTH と CHARACTER_LENGTH はシノニムです。
構文
CHAR_LENGTH (string)
パラメータ
-
string -
関数の対象となる文字列。
例
CHAR_LENGTH('') -- 0 CHAR_LENGTH('abcdefg') -- 7
LOWER
文字列を指定すると、LOWER はすべての大文字を小文字に変換します。大文字以外の文字は変更されません。
構文
LOWER (string)
パラメータ
-
string -
関数の対象となる文字列。
例
LOWER('AbCdEfG!@#$') -- 'abcdefg!@#$'
SUBSTRING
文字列、起動インデックス、長さ (オプション) を指定すると、SUBSTRING は開始インデックスから文字列の末尾、または指定された長さまでの部分文字列を返します。
注記
入力文字列の先頭文字は、インデックス位置が 1 になります。
-
startが 1 未満で、長さを指定しない場合、インデックス位置は 1 に設定されます。 -
startが 1 未満で、長さを指定した場合、インデックス位置はstart + length -1に設定されます。 -
start + length -1が 0 未満の場合は、空の文字列が返されます。 -
start + length -1が 0 以上の場合は、インデックス位置 1 から始まる長さstart + length - 1の部分文字列が返されます。
構文
SUBSTRING(stringFROMstart[ FORlength] )
パラメータ
-
string -
関数の対象となる文字列。
-
start -
文字列の開始位置。
-
length -
返す部分文字列の長さ。存在しない場合は、文字列の末尾に進みます。
例
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
文字列の先頭または末尾の文字を切り捨てます。削除するデフォルトの文字はスペース (' ') です。
構文
TRIM ( [[LEADING | TRAILING | BOTHremove_chars] FROM]string)
パラメータ
-
string -
関数の対象となる文字列。
-
LEADING|TRAILING|BOTH -
このパラメータは、先頭または末尾の文字、またはその両方を切り捨てるかどうかを指定します。
-
remove_chars -
削除する文字のセット。
remove_charsremove_chars
例
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
文字列を指定すると、UPPER はすべての小文字を大文字に変換します。小文字以外の文字は変更されません。
構文
UPPER (string)
パラメータ
-
string -
関数の対象となる文字列。
例
UPPER('AbCdEfG!@#$') -- 'ABCDEFG!@#$'
