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 QUOTE\$1LITERAL
<a name="r_QUOTE_LITERAL"></a>

A função QUOTE\$1LITERAL retorna a string especificada como uma string entre aspas únicas para que ela possa ser usada como um literal de string em uma instrução SQL. Se o parâmetro de entrada for um número, QUOTE\$1LITERAL o tratará como uma string. Duplica apropriadamente quaisquer aspas simples e barras invertidas incorporadas. 

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

```
QUOTE_LITERAL(string)
```

## Argumento
<a name="r_QUOTE_LITERAL-argument"></a>

 *string*   
Uma string `CHAR` ou `VARCHAR`. 

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

A função QUOTE\$1LITERAL retorna uma string `CHAR` ou `VARCHAR` do mesmo tipo de dados que a entrada *string*. 

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

Para retornar a string `''CAT''` com aspas SIMPLES, use o exemplo a seguir.

```
SELECT QUOTE_LITERAL('''CAT''');

+---------------+
| quote_literal |
+---------------+
| '''CAT'''     |
+---------------+
```

Os exemplos a seguir usam dados da tabela CATEGORY do banco de dados de amostra TICKIT. Para obter mais informações, consulte [Banco de dados de exemplo](c_sampledb.md). 

Para retornar a coluna CATNAME entre aspas únicas, use o exemplo a seguir.

```
SELECT catid, QUOTE_LITERAL(catname)
FROM category
ORDER BY 1,2;

+-------+---------------+
| catid | quote_literal |
+-------+---------------+
|     1 | 'MLB'         |
|     2 | 'NHL'         |
|     3 | 'NFL'         |
|     4 | 'NBA'         |
|     5 | 'MLS'         |
|     6 | 'Musicals'    |
|     7 | 'Plays'       |
|     8 | 'Opera'       |
|     9 | 'Pop'         |
|    10 | 'Jazz'        |
|    11 | 'Classical'   |
+-------+---------------+
```

Para retornar a coluna CATID entre aspas únicas, use o exemplo a seguir.

```
SELECT QUOTE_LITERAL(catid), catname
FROM category
ORDER BY 1,2;

+---------------+-----------+
| quote_literal |  catname  |
+---------------+-----------+
| '1'           | MLB       |
| '10'          | Jazz      |
| '11'          | Classical |
| '2'           | NHL       |
| '3'           | NFL       |
| '4'           | NBA       |
| '5'           | MLS       |
| '6'           | Musicals  |
| '7'           | Plays     |
| '8'           | Opera     |
| '9'           | Pop       |
+---------------+-----------+
```