Funções de string

O Amazon S3 Select é compatível com as seguintes funções de string.

CHAR_LENGTH, CHARACTER_LENGTH

CHAR_LENGTH (ou CHARACTER_LENGTH) conta o número de caracteres na string especificada.

nota

CHAR_LENGTH e CHARACTER_LENGTH são sinônimos.

Sintaxe

CHAR_LENGTH ( string )

Parâmetros

string

A string de destino na qual a função opera.

Exemplos

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

LOWER

Dada uma string, LOWER converte todos os caracteres maiúsculos em minúsculos. Todos os caracteres minúsculos permanecem inalterados.

Sintaxe

LOWER ( string )

Parâmetros

string

A string de destino na qual a função opera.

Exemplos

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

SUBSTRING

Dada uma string, um índice inicial e, opcionalmente, um tamanho, SUBSTRING retorna a substring do índice inicial até o final da string ou até o tamanho fornecido.

nota

O primeiro caractere da string de entrada tem uma posição de índice de 1.

• Se start < 1, sem comprimento especificado, a posição do índice será definida como 1.

• Se start for < 1, sem comprimento especificado, a posição do índice será definida como start + length -1.

• Se start + length -1 < 0, uma string vazia será retornada.

• Se start + length -1 > = 0, a substring começando na posição de índice 1 de comprimento start + length - 1 será retornada.

Sintaxe

SUBSTRING( string FROM start [ FOR length ] )

Parâmetros

string

A string de destino na qual a função opera.

start

A posição inicial da string.

length

O tamanho da substring a ser retornada. Se não estiver presente, prossiga para o final da string.

Exemplos

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

Corta os caracteres iniciais ou finais de uma string. O caractere padrão a ser removido é um espaço (' ').

Sintaxe

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

Parâmetros

string

A string de destino na qual a função opera.

LEADING | TRAILING | BOTH

Esse parâmetro indica se é necessário cortar os caracteres iniciais ou finais, ou ambos.

remove_chars

O conjunto de caracteres a ser removido. remove_chars pode ser uma string com tamanho > 1. Essa função retorna a string com qualquer caractere de remove_chars encontrado no início ou final da string que foi removida.

Exemplos

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

Dada uma string, UPPER converte todos os caracteres minúsculos em maiúsculos. Todos os caracteres maiúsculos permanecem inalterados.

Sintaxe

UPPER ( string )

Parâmetros

string

A string de destino na qual a função opera.

Exemplos

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