URL_ENCODE encode une chaîne au format MIME application/x-www-form-urlencoded et renvoie le résultat. Elle renvoie NULL si l'entrée contient des valeurs invalides ou si l'encodage n'est pas pris en charge.
Limites
Cette fonction est uniquement prise en charge dans Realtime Compute for Apache Flink avec Ververica Runtime (VVR) 8.0.8 ou version ultérieure.
Syntaxe
VARCHAR URL_ENCODE(VARCHAR input)
VARCHAR URL_ENCODE(VARCHAR input, VARCHAR encoding)Paramètres
| Paramètre | Type de données | Obligatoire | Par défaut | Description |
|---|---|---|---|---|
input |
VARCHAR | Oui | — | Chaîne à encoder. |
encoding |
VARCHAR | Non | UTF-8 | Encodage de caractères à utiliser. Valeurs valides : GBK, UTF-8. |
Type de retour
VARCHAR
Exemples
Encodage avec l'encodage UTF-8 par défaut
Données de test (T1)
| id (INT) | input (VARCHAR) |
|---|---|
| 1 | http://calcite.apache.org |
| 2 | http://test?a=b&c=d |
| 3 | http://Hello |
| 4 | test |
Instruction de test
SELECT
id,
URL_ENCODE(input) AS `value`
FROM
T1;Résultat du test
| id (INT) | value (VARCHAR) |
|---|---|
| 1 | https%3A%2F%2Fcalcite.apache.org |
| 2 | http%3A%2F%2Ftest%3Fa%3Db%26c%3Dd |
| 3 | http%3A%2F%2F%E4%BD%A0%E5%A5%BD |
| 4 | test |
Encodage avec un encodage personnalisé
Données de test (T2)
| id (INT) | input (VARCHAR) | encoding (VARCHAR) |
|---|---|---|
| 1 | http://Hello | gb2312 |
| 2 | http://test?a=b&c=d | UNKNOWN |
Instruction de test
SELECT
id,
URL_ENCODE(input, encoding) AS `value`
FROM
T2;Résultat du test
| id (INT) | value (VARCHAR) |
|---|---|
| 1 | http%3A%2F%2F%C4%E3%BA%C3 |
| 2 | NULL |
La ligne 2 renvoie NULL car UNKNOWN n'est pas un format d'encodage pris en charge.
Étapes suivantes
Pour la liste complète des fonctions intégrées prises en charge dans Realtime Compute for Apache Flink, consultez la rubrique Fonctions prises en charge.
Pour étendre Flink SQL avec une logique personnalisée, consultez les rubriques UDF et Gérer les UDF.