文字列関数

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( string FROM start [ FOR length ] )

パラメータ

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 | BOTH remove_chars] FROM] string )

パラメータ

string

関数の対象となる文字列。

LEADING | TRAILING | BOTH

このパラメータは、先頭または末尾の文字、またはその両方を切り捨てるかどうかを指定します。

remove_chars

削除する文字のセット。remove_chars は、長さが 1 より大きい文字列とすることができます。この関数は、削除された文字列の先頭または末尾で見つかった remove_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!@#$'