# Funções SQL
<a name="s3-select-sql-reference-sql-functions"></a>

**Importante**  
O Amazon S3 Select não está mais disponível para novos clientes. Os clientes existentes do Amazon S3 Select podem continuar usando o recurso normalmente. [Saiba mais](https://aws.amazon.com/blogs/storage/how-to-optimize-querying-your-data-in-amazon-s3/) 

O Amazon S3 Select é compatível com as funções SQL a seguir.

**Topics**
+ [Funções agregadas](s3-select-sql-reference-aggregate.md)
+ [Funções condicionais](s3-select-sql-reference-conditional.md)
+ [Funções de conversão](s3-select-sql-reference-conversion.md)
+ [Funções de data](s3-select-sql-reference-date.md)
+ [Funções de string](s3-select-sql-reference-string.md)

# Funções agregadas
<a name="s3-select-sql-reference-aggregate"></a>

**Importante**  
O Amazon S3 Select não está mais disponível para novos clientes. Os clientes existentes do Amazon S3 Select podem continuar usando o recurso normalmente. [Saiba mais](https://aws.amazon.com/blogs/storage/how-to-optimize-querying-your-data-in-amazon-s3/) 

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


| Função | Tipo de argumento | Tipo de retorno | 
| --- | --- | --- | 
| `AVG(expression)` | `INT`, `FLOAT`, `DECIMAL` | `DECIMAL` para um argumento `INT`, `FLOAT` para um argumento de ponto flutuante, caso contrário, é igual ao tipo de dados do argumento. | 
| `COUNT` |  `-`  | `INT` | 
| `MAX(expression)` | `INT`, `DECIMAL` | O mesmo que o tipo de argumento. | 
| `MIN(expression)` | `INT`, `DECIMAL` | O mesmo que o tipo de argumento. | 
| `SUM(expression)` | `INT`, `FLOAT`, `DOUBLE`, `DECIMAL` | `INT` para um argumento `INT`, `FLOAT` para um argumento de ponto flutuante; do contrário, é igual ao tipo de dados do argumento. | 

## SUMExemplo de
<a name="s3-select-sql-reference-aggregate-case-examples"></a>

Para agregar os tamanhos totais de objetos de uma pasta em um [relatório do S3 Inventory](https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage-inventory.html), use uma expressão `SUM`.

O relatório do S3 Inventory a seguir é um arquivo CSV compactado com GZIP. Existem três colunas.
+ A primeira coluna é o nome do bucket do S3 (*`DOC-EXAMPLE-BUCKET`*) para o qual o relatório do S3 Inventory se destina.
+ A segunda coluna é o nome da chave do objeto que identifica exclusivamente o objeto no bucket.

  O valor `example-folder/` na primeira linha é para a pasta `example-folder`. No Amazon S3, quando você cria uma pasta no bucket, o S3 cria um objeto de 0 byte com uma chave definida como o nome da pasta que você forneceu.

  O valor `example-folder/object1` na segunda linha é para o objeto `object1` na pasta `example-folder`.

  O valor `example-folder/object2` na terceira linha é para o objeto `object2` na pasta `example-folder`.

  Para obter mais informações sobre pastas do S3, consulte [Organizar objetos no console do Amazon S3 usando pastas](using-folders.md).
+ A terceira coluna é o tamanho do objeto em bytes.

```
"DOC-EXAMPLE-BUCKET","example-folder/","0"
"DOC-EXAMPLE-BUCKET","example-folder/object1","2011267"
"DOC-EXAMPLE-BUCKET","example-folder/object2","1570024"
```

Para usar uma expressão `SUM` para calcular o tamanho total da pasta `example-folder`, execute a consulta SQL com o Amazon S3 Select.

```
SELECT SUM(CAST(_3 as INT)) FROM s3object s WHERE _2 LIKE 'example-folder/%' AND _2 != 'example-folder/';
```

Resultado da consulta: 

```
3581291
```

# Funções condicionais
<a name="s3-select-sql-reference-conditional"></a>

**Importante**  
O Amazon S3 Select não está mais disponível para novos clientes. Os clientes existentes do Amazon S3 Select podem continuar usando o recurso normalmente. [Saiba mais](https://aws.amazon.com/blogs/storage/how-to-optimize-querying-your-data-in-amazon-s3/) 

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

**Topics**
+ [CASE](#s3-select-sql-reference-case)
+ [COALESCE](#s3-select-sql-reference-coalesce)
+ [NULLIF](#s3-select-sql-reference-nullif)

## CASE
<a name="s3-select-sql-reference-case"></a>

A expressão `CASE` é uma expressão condicional, semelhante às instruções `if/then/else` encontradas em outras linguagens. `CASE` é usado para especificar um resultado com várias condições. Há dois tipos de expressões `CASE`: simples e pesquisada.

Em expressões `CASE` simples, uma expressão é comparada a um valor. Quando uma correspondência é encontrada, a ação especificada na cláusula `THEN` é aplicada. Se nenhuma correspondência é encontrada, a ação especificada na cláusula `ELSE` é aplicada.

Em expressões `CASE` pesquisadas, cada `CASE` é avaliado com base em uma expressão booliana e a instrução `CASE` retorna o primeiro `CASE` correspondente. Se nenhuma correspondência de `CASE` for encontrada entre as cláusulas `WHEN`, a ação na cláusula `ELSE` será retornada.

### Sintaxe
<a name="s3-select-sql-reference-case-syntax"></a>

**nota**  
Atualmente, o Amazon S3 Select não é compatível com `ORDER BY` ou consultas que contenham novas linhas. Use consultas sem quebras de linha.

A seguir está uma declaração `CASE` simples usada para corresponder às condições:

```
CASE expression WHEN value THEN result [WHEN...] [ELSE result] END					
```

Veja a seguir uma declaração `CASE` pesquisada usada para avaliar cada condição:

```
CASE WHEN boolean condition THEN result [WHEN ...] [ELSE result] END					
```

### Exemplos
<a name="s3-select-sql-reference-case-examples"></a>

**nota**  
Se você usar o console do Amazon S3 para executar os exemplos a seguir e o arquivo CSV tiver uma linha de cabeçalho, selecione **Excluir a primeira linha de dados do CSV**. 

**Exemplo 1:** use uma expressão `CASE` simples para substituir `New York City` por `Big Apple` em uma consulta. Substitua todos os outros nomes de cidade por `other`.

```
SELECT venuecity, CASE venuecity WHEN 'New York City' THEN 'Big Apple' ELSE 'other' END FROM S3Object;
```

Resultado da consulta: 

```
venuecity        |   case
-----------------+-----------
Los Angeles      | other
New York City    | Big Apple
San Francisco    | other
Baltimore        | other
...
```

**Exemplo 2:** use uma expressão `CASE` pesquisada para atribuir números de grupo com base no valor `pricepaid` para vendas individuais de ingresso:

```
SELECT pricepaid, CASE WHEN CAST(pricepaid as FLOAT) < 10000 THEN 'group 1' WHEN CAST(pricepaid as FLOAT) > 10000 THEN 'group 2' ELSE 'group 3' END FROM S3Object;					
```

Resultado da consulta: 

```
pricepaid |  case
-----------+---------
12624.00 | group 2
10000.00 | group 3
10000.00 | group 3
9996.00 | group 1
9988.00 | group 1
...
```

## COALESCE
<a name="s3-select-sql-reference-coalesce"></a>

`COALESCE` avalia os argumentos na ordem e retorna o primeiro valor não desconhecido, ou seja, o primeiro valor que não for nulo ou ausente. Essa função não propaga valores nulos e ausentes.

### Sintaxe
<a name="s3-select-sql-reference-coalesce-syntax"></a>

```
COALESCE ( expression, expression, ... )
```

### Parâmetros
<a name="s3-select-sql-reference-coalesce-parameters"></a>

 *`expression`*   
A expressão de destino na qual a função opera.

### Exemplos
<a name="s3-select-sql-reference-coalesce-examples"></a>

```
COALESCE(1)                -- 1
COALESCE(null)             -- null
COALESCE(null, null)       -- null
COALESCE(missing)          -- null
COALESCE(missing, missing) -- null
COALESCE(1, null)          -- 1
COALESCE(null, null, 1)    -- 1
COALESCE(null, 'string')   -- 'string'
COALESCE(missing, 1)       -- 1
```

## NULLIF
<a name="s3-select-sql-reference-nullif"></a>

Dadas as duas expressões, `NULLIF` retorna `NULL` se as duas forem avaliadas para o mesmo valor. Caso contrário, `NULLIF` retorna o resultado da avaliação da primeira expressão.

### Sintaxe
<a name="s3-select-sql-reference-nullif-syntax"></a>

```
NULLIF ( expression1, expression2 )
```

### Parâmetros
<a name="s3-select-sql-reference-nullif-parameters"></a>

 `expression1, expression2`   
As expressões de destino nas quais a função opera.

### Exemplos
<a name="s3-select-sql-reference-nullif-examples"></a>

```
NULLIF(1, 1)             -- null
NULLIF(1, 2)             -- 1
NULLIF(1.0, 1)           -- null
NULLIF(1, '1')           -- 1
NULLIF([1], [1])         -- null
NULLIF(1, NULL)          -- 1
NULLIF(NULL, 1)          -- null
NULLIF(null, null)       -- null
NULLIF(missing, null)    -- null
NULLIF(missing, missing) -- null
```

# Funções de conversão
<a name="s3-select-sql-reference-conversion"></a>

**Importante**  
O Amazon S3 Select não está mais disponível para novos clientes. Os clientes existentes do Amazon S3 Select podem continuar usando o recurso normalmente. [Saiba mais](https://aws.amazon.com/blogs/storage/how-to-optimize-querying-your-data-in-amazon-s3/) 

O Amazon S3 Select é compatível com a seguinte função de conversão.

**Topics**
+ [CAST](#s3-select-sql-reference-cast)

## CAST
<a name="s3-select-sql-reference-cast"></a>

A função `CAST` converte uma entidade, como uma expressão que retorna um único valor, de um tipo em outro. 

### Sintaxe
<a name="s3-select-sql-reference-cast-syntax"></a>

```
CAST ( expression AS data_type )
```

### Parâmetros
<a name="s3-select-sql-reference-cast-parameters"></a>

 *`expression`*   
Uma combinação de um ou mais valores, operadores e funções SQL que retornam um valor.

 *`data_type`*   
O tipo de dados de destino, como `INT`, no qual a expressão será convertida. Para obter uma lista dos tipos de dados compatíveis, consulte [Tipos de dados](s3-select-sql-reference-data-types.md).

### Exemplos
<a name="s3-select-sql-reference-cast-examples"></a>

```
CAST('2007-04-05T14:30Z' AS TIMESTAMP)
CAST(0.456 AS FLOAT)
```

# Funções de data
<a name="s3-select-sql-reference-date"></a>

**Importante**  
O Amazon S3 Select não está mais disponível para novos clientes. Os clientes existentes do Amazon S3 Select podem continuar usando o recurso normalmente. [Saiba mais](https://aws.amazon.com/blogs/storage/how-to-optimize-querying-your-data-in-amazon-s3/) 

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

**Topics**
+ [DATE\$1ADD](#s3-select-sql-reference-date-add)
+ [DATE\$1DIFF](#s3-select-sql-reference-date-diff)
+ [EXTRACT](#s3-select-sql-reference-extract)
+ [TO\$1STRING](#s3-select-sql-reference-to-string)
+ [TO\$1TIMESTAMP](#s3-select-sql-reference-to-timestamp)
+ [UTCNOW](#s3-select-sql-reference-utcnow)

## DATE\$1ADD
<a name="s3-select-sql-reference-date-add"></a>

Dada uma parte da data, uma quantidade e um carimbo de data/hora, `DATE_ADD` retorna um carimbo de data/hora atualizado, alterando a parte da data pela quantidade.

### Sintaxe
<a name="s3-select-sql-reference-date-add-syntax"></a>

```
DATE_ADD( date_part, quantity, timestamp )
```

### Parâmetros
<a name="s3-select-sql-reference-date-add-parameters"></a>

*`date_part`*   
Especifica que parte da data deve ser modificada. Pode ser uma das partes a seguir:  
+ year
+ mês
+ dia
+ hora
+ minuto
+ segundos

 *`quantity`*   
O valor a ser aplicado a um carimbo de data/hora atualizado. Os valores positivos para a `quantity` são adicionados à date\$1part do carimbo de data/hora e os valores negativos são subtraídos.

 *`timestamp`*   
O carimbo de data/hora de destino no qual a função opera.

### Exemplos
<a name="s3-select-sql-reference-date-add-examples"></a>

```
DATE_ADD(year, 5, `2010-01-01T`)                -- 2015-01-01 (equivalent to 2015-01-01T)
DATE_ADD(month, 1, `2010T`)                     -- 2010-02T (result will add precision as necessary)
DATE_ADD(month, 13, `2010T`)                    -- 2011-02T
DATE_ADD(day, -1, `2017-01-10T`)                -- 2017-01-09 (equivalent to 2017-01-09T)
DATE_ADD(hour, 1, `2017T`)                      -- 2017-01-01T01:00-00:00
DATE_ADD(hour, 1, `2017-01-02T03:04Z`)          -- 2017-01-02T04:04Z
DATE_ADD(minute, 1, `2017-01-02T03:04:05.006Z`) -- 2017-01-02T03:05:05.006Z
DATE_ADD(second, 1, `2017-01-02T03:04:05.006Z`) -- 2017-01-02T03:04:06.006Z
```

## DATE\$1DIFF
<a name="s3-select-sql-reference-date-diff"></a>

Dada uma parte da data e dois carimbos de data/hora válidos, `DATE_DIFF` retorna a diferença nas partes da data. O valor de retorno é um inteiro negativo quando o valor `date_part` do `timestamp1` for maior que o valor `date_part` do `timestamp2`. O valor de retorno é um inteiro positivo quando o valor `date_part` do `timestamp1` for menor que o valor `date_part` do `timestamp2`.

### Sintaxe
<a name="s3-select-sql-reference-date-diff-syntax"></a>

```
DATE_DIFF( date_part, timestamp1, timestamp2 )
```

### Parâmetros
<a name="s3-select-sql-reference-date-diff-parameters"></a>

 **`date_part`**   
Especifica que parte dos carimbos de data/hora deve ser comparada. Para a definição de `date_part`, consulte [DATE\$1ADD](#s3-select-sql-reference-date-add).

 **`timestamp1`**   
O primeiro carimbo de data/hora a ser comparado.

 **`timestamp2`**   
O segundo carimbo de data/hora a ser comparado.

### Exemplos
<a name="s3-select-sql-reference-date-diff-examples"></a>

```
DATE_DIFF(year, `2010-01-01T`, `2011-01-01T`)            -- 1
DATE_DIFF(year, `2010T`, `2010-05T`)                     -- 4 (2010T is equivalent to 2010-01-01T00:00:00.000Z)
DATE_DIFF(month, `2010T`, `2011T`)                       -- 12
DATE_DIFF(month, `2011T`, `2010T`)                       -- -12
DATE_DIFF(day, `2010-01-01T23:00`, `2010-01-02T01:00`) -- 0 (need to be at least 24h apart to be 1 day apart)
```

## EXTRACT
<a name="s3-select-sql-reference-extract"></a>

Dada uma parte da data e um carimbo de data/hora, `EXTRACT` retorna o valor da parte da data do carimbo de data/hora.

### Sintaxe
<a name="s3-select-sql-reference-extract-syntax"></a>

```
EXTRACT( date_part FROM timestamp )
```

### Parâmetros
<a name="s3-select-sql-reference-extract-parameters"></a>

 **`date_part`**   
Especifica que parte dos carimbos de data/hora deve ser extraída. Pode ser uma das partes a seguir:  
+ `YEAR`
+ `MONTH`
+ `DAY`
+ `HOUR`
+ `MINUTE`
+ `SECOND`
+ `TIMEZONE_HOUR`
+ `TIMEZONE_MINUTE`

 **`timestamp`**   
O carimbo de data/hora de destino no qual a função opera.

### Exemplos
<a name="s3-select-sql-reference-extract-examples"></a>

```
EXTRACT(YEAR FROM `2010-01-01T`)                           -- 2010
EXTRACT(MONTH FROM `2010T`)                                -- 1 (equivalent to 2010-01-01T00:00:00.000Z)
EXTRACT(MONTH FROM `2010-10T`)                             -- 10
EXTRACT(HOUR FROM `2017-01-02T03:04:05+07:08`)             -- 3
EXTRACT(MINUTE FROM `2017-01-02T03:04:05+07:08`)           -- 4
EXTRACT(TIMEZONE_HOUR FROM `2017-01-02T03:04:05+07:08`)    -- 7
EXTRACT(TIMEZONE_MINUTE FROM `2017-01-02T03:04:05+07:08`)  -- 8
```

## TO\$1STRING
<a name="s3-select-sql-reference-to-string"></a>

Dado um carimbo de data/hora e um padrão de formato, `TO_STRING` retorna uma representação de string do carimbo de data/hora no formato especificado.

### Sintaxe
<a name="s3-select-sql-reference-size-syntax"></a>

```
TO_STRING ( timestamp time_format_pattern )
```

### Parâmetros
<a name="s3-select-sql-reference-size-parameters"></a>

 *`timestamp`*   
O carimbo de data/hora de destino no qual a função opera.

 *`time_format_pattern`*   
Uma string que possui as seguintes interpretações de caracteres especiais:      
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AmazonS3/latest/userguide/s3-select-sql-reference-date.html)

### Exemplos
<a name="s3-select-sql-reference-size-examples"></a>

```
TO_STRING(`1969-07-20T20:18Z`,  'MMMM d, y')                    -- "July 20, 1969"
TO_STRING(`1969-07-20T20:18Z`, 'MMM d, yyyy')                   -- "Jul 20, 1969"
TO_STRING(`1969-07-20T20:18Z`, 'M-d-yy')                        -- "7-20-69"
TO_STRING(`1969-07-20T20:18Z`, 'MM-d-y')                        -- "07-20-1969"
TO_STRING(`1969-07-20T20:18Z`, 'MMMM d, y h:m a')               -- "July 20, 1969 8:18 PM"
TO_STRING(`1969-07-20T20:18Z`, 'y-MM-dd''T''H:m:ssX')           -- "1969-07-20T20:18:00Z"
TO_STRING(`1969-07-20T20:18+08:00Z`, 'y-MM-dd''T''H:m:ssX')     -- "1969-07-20T20:18:00Z"
TO_STRING(`1969-07-20T20:18+08:00`, 'y-MM-dd''T''H:m:ssXXXX')   -- "1969-07-20T20:18:00+0800"
TO_STRING(`1969-07-20T20:18+08:00`, 'y-MM-dd''T''H:m:ssXXXXX')  -- "1969-07-20T20:18:00+08:00"
```

## TO\$1TIMESTAMP
<a name="s3-select-sql-reference-to-timestamp"></a>

Dada uma string, `TO_TIMESTAMP` converte-se em um carimbo de data/hora. `TO_TIMESTAMP` é a operação inversa de `TO_STRING`.

### Sintaxe
<a name="s3-select-sql-reference-to-timestamp-syntax"></a>

```
TO_TIMESTAMP ( string )
```

### Parâmetros
<a name="s3-select-sql-reference-to-timestamp-parameters"></a>

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

### Exemplos
<a name="s3-select-sql-reference-to-timestamp-examples"></a>

```
TO_TIMESTAMP('2007T')                         -- `2007T`
TO_TIMESTAMP('2007-02-23T12:14:33.079-08:00') -- `2007-02-23T12:14:33.079-08:00`
```

## UTCNOW
<a name="s3-select-sql-reference-utcnow"></a>

`UTCNOW` retorna o tempo atual em UTC como um carimbo de data/hora.

### Sintaxe
<a name="s3-select-sql-reference-utcnow-syntax"></a>

```
UTCNOW()
```

### Parâmetros
<a name="s3-select-sql-reference-utcnow-parameters"></a>

`UTCNOW` não aceita parâmetros.

### Exemplos
<a name="s3-select-sql-reference-utcnow-examples"></a>

```
UTCNOW() -- 2017-10-13T16:02:11.123Z
```

# Funções de string
<a name="s3-select-sql-reference-string"></a>

**Importante**  
O Amazon S3 Select não está mais disponível para novos clientes. Os clientes existentes do Amazon S3 Select podem continuar usando o recurso normalmente. [Saiba mais](https://aws.amazon.com/blogs/storage/how-to-optimize-querying-your-data-in-amazon-s3/) 

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

**Topics**
+ [CHAR\$1LENGTH, CHARACTER\$1LENGTH](#s3-select-sql-reference-char-length)
+ [LOWER](#s3-select-sql-reference-lower)
+ [SUBSTRING](#s3-select-sql-reference-substring)
+ [TRIM](#s3-select-sql-reference-trim)
+ [UPPER](#s3-select-sql-reference-upper)

## CHAR\$1LENGTH, CHARACTER\$1LENGTH
<a name="s3-select-sql-reference-char-length"></a>

`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
<a name="s3-select-sql-reference-char-length-syntax"></a>

```
CHAR_LENGTH ( string )
```

### Parâmetros
<a name="s3-select-sql-reference-char-length-parameters"></a>

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

### Exemplos
<a name="s3-select-sql-reference-char-length-examples"></a>

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

## LOWER
<a name="s3-select-sql-reference-lower"></a>

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

### Sintaxe
<a name="s3-select-sql-reference-lower-syntax"></a>

```
LOWER ( string )
```

### Parâmetros
<a name="s3-select-sql-reference-lower-parameters"></a>

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

### Exemplos
<a name="s3-select-sql-reference-lower-examples"></a>

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

## SUBSTRING
<a name="s3-select-sql-reference-substring"></a>

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
<a name="s3-select-sql-reference-substring-syntax"></a>

```
SUBSTRING( string FROM start [ FOR length ] )
```

### Parâmetros
<a name="s3-select-sql-reference-substring-parameters"></a>

 **`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
<a name="s3-select-sql-reference-substring-examples"></a>

```
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
<a name="s3-select-sql-reference-trim"></a>

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

### Sintaxe
<a name="s3-select-sql-reference-trim-syntax"></a>

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

### Parâmetros
<a name="s3-select-sql-reference-trim-parameters"></a>

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

 `LEADING` \$1 `TRAILING` \$1 `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
<a name="s3-select-sql-reference-trim-examples"></a>

```
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
<a name="s3-select-sql-reference-upper"></a>

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

### Sintaxe
<a name="s3-select-sql-reference-upper-syntax"></a>

```
UPPER ( string )
```

### Parâmetros
<a name="s3-select-sql-reference-upper-parameters"></a>

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

### Exemplos
<a name="s3-select-sql-reference-upper-examples"></a>

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