O Amazon Redshift não permitirá mais a criação de UDFs do Python a partir do Patch 198. As UDFs do Python existentes continuarão a funcionar normalmente até 30 de junho de 2026. Para ter mais informações, consulte a [publicação de blog ](https://aws.amazon.com/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/). 

# Função TRIM
<a name="r_TRIM"></a>

Corta da string os espaços em branco ou caracteres especificados.

## Sintaxe
<a name="r_TRIM-synopsis"></a>

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

## Argumentos
<a name="r_TRIM-arguments"></a>

 BOTH \| LEADING \| TRAILING   
(Opcional) Especifica de onde cortar os caracteres. Use BOTH para remover caracteres iniciais e finais, use LEADING para remover somente caracteres iniciais e use TRAILING para remover somente caracteres finais. Se esse parâmetro for omitido, os caracteres iniciais e finais serão cortados.

 *trim\_chars*   
(Opcional) Os caracteres a serem aparados da string. Se este parâmetro for omitido, espaços em branco serão aparados.

 *string*   
A string a ser aparada. 

## Tipo de retorno
<a name="r_TRIM-return-type"></a>

A função TRIM retorna uma string `VARCHAR` ou `CHAR`. Se você usar a função TRIM com um comando SQL, o Amazon Redshift converterá implicitamente os resultados em `VARCHAR`. Se você usar a função TRIM na lista SELECT para uma função SQL, o Amazon Redshift não converterá implicitamente os resultados e poderá ser necessário realizar uma conversão explícita para evitar um erro de incompatibilidade de tipo de dados. Consulte as funções [Função CAST](r_CAST_function.md) e [Função CONVERT](r_CONVERT_function.md) para obter informações sobre conversões explícitas.

## Exemplos
<a name="r_TRIM-example"></a>

Para remover espaços em branco inicias e finais da string ` dog `, use o exemplo a seguir. 

```
SELECT TRIM('    dog    ');

+-------+
| btrim |
+-------+
| dog   |
+-------+
```

Para remover espaços em branco inicias e finais da string ` dog `, use o exemplo a seguir. 

```
SELECT TRIM(BOTH FROM '    dog    ');

+-------+
| btrim |
+-------+
| dog   |
+-------+
```

Para remover as aspas duplas iniciais da string `"dog"`, use o exemplo a seguir.

```
SELECT TRIM(LEADING '"' FROM'"dog"');

+-------+
| ltrim |
+-------+
| dog"  |
+-------+
```

Para remover as aspas duplas finais da string `"dog"`, use o exemplo a seguir. 

```
SELECT TRIM(TRAILING '"' FROM'"dog"');

+-------+
| rtrim |
+-------+
| "dog  |
+-------+
```

TRIM remove qualquer um dos caracteres em *trim\_chars* quando eles aparecem no início ou no final da *string*. O exemplo a seguir apara os caracteres “C”, “D” e “G” quando eles aparecem no início de VENUENAME, que é uma coluna `VARCHAR`. Para obter mais informações, consulte [Banco de dados de exemplo](c_sampledb.md).

```
SELECT venueid, venuename, TRIM('CDG' FROM venuename)
FROM venue
WHERE venuename LIKE '%Park'
ORDER BY 2
LIMIT 7;

+---------+----------------------------+---------------------------+
| venueid |         venuename          |           btrim           |
+---------+----------------------------+---------------------------+
|     121 | AT&T Park                  | AT&T Park                 |
|     109 | Citizens Bank Park         | itizens Bank Park         |
|     102 | Comerica Park              | omerica Park              |
|       9 | Dick's Sporting Goods Park | ick's Sporting Goods Park |
|      97 | Fenway Park                | Fenway Park               |
|     112 | Great American Ball Park   | reat American Ball Park   |
|     114 | Miller Park                | Miller Park               |
+---------+----------------------------+---------------------------+
```