Fonction QUOTE_LITERAL - Amazon Redshift
SyntaxeArgumentType de retourExemples

Amazon Redshift ne prendra plus en charge la création de nouveaux Python UDFs à compter du 1er novembre 2025. Si vous souhaitez utiliser Python UDFs, créez la version UDFs antérieure à cette date. Le Python existant UDFs continuera à fonctionner normalement. Pour plus d'informations, consultez le billet de blog.

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Fonction QUOTE_LITERAL

La fonction QUOTE_LITERAL renvoie la chaîne spécifiée sous forme de chaîne entre guillemets simples pour qu’elle puisse être utilisée comme littéral de chaîne dans une instruction SQL. Si le paramètre d’entrée est un nombre, QUOTE_LITERAL le traite comme une chaîne. Double de manière appropriée les barres obliques inverses et les guillemets simples imbriqués.

Syntaxe

QUOTE_LITERAL(string)

Argument

string

Chaîne CHAR ou VARCHAR.

Type de retour

La fonction QUOTE_LITERAL renvoie une chaîne CHAR ou VARCHAR qui est du même type de données que l’argument string en entrée.

Exemples

Pour renvoyer la chaîne ''CAT'' avec des guillemets SIMPLES, utilisez l’exemple suivant.

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

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

Les exemples suivants utilisent les données de la table CATEGORY de l’exemple de base de données TICKIT. Pour de plus amples informations, veuillez consulter Exemple de base de données.

Pour renvoyer la colonne CATNAME entourée de guillemets simples, utilisez l’exemple suivant.

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'   |
+-------+---------------+

Pour renvoyer la colonne CATID entourée de guillemets simples, utilisez l’exemple suivant.

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       |
+---------------+-----------+