URL_ENCODE codifica una cadena en el formato MIME application/x-www-form-urlencoded y devuelve el resultado codificado. Devuelve NULL si la entrada contiene valores no válidos o si la codificación no es compatible.
Límites
Solo es compatible con Realtime Compute for Apache Flink que usa Ververica Runtime (VVR) 8.0.8 o versiones posteriores.
Sintaxis
VARCHAR URL_ENCODE(VARCHAR input)
VARCHAR URL_ENCODE(VARCHAR input, VARCHAR encoding)Parámetros
|
Parámetro |
Tipo de dato |
Obligatorio |
Predeterminado |
Descripción |
|
|
VARCHAR |
Sí |
— |
Cadena por codificar. |
|
|
VARCHAR |
No |
UTF-8 |
Codificación de caracteres por usar. Valores válidos: |
Tipo de retorno
VARCHAR
Ejemplos
Codificación con la codificación UTF-8 predeterminada
Datos de prueba (T1)
|
id (INT) |
input (VARCHAR) |
|
1 |
http://calcite.apache.org |
|
2 |
http://test?a=b&c=d |
|
3 |
http://Hello |
|
4 |
test |
Instrucción de prueba
SELECT
id,
URL_ENCODE(input) AS `value`
FROM
T1;Resultado de la prueba
|
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 |
Codificación con una codificación personalizada
Datos de prueba (T2)
|
id (INT) |
input (VARCHAR) |
encoding (VARCHAR) |
|
1 |
http://Hello |
gb2312 |
|
2 |
http://test?a=b&c=d |
UNKNOWN |
Instrucción de prueba
SELECT
id,
URL_ENCODE(input, encoding) AS `value`
FROM
T2;Resultado de la prueba
|
id (INT) |
value (VARCHAR) |
|
1 |
http%3A%2F%2F%C4%E3%BA%C3 |
|
2 |
NULL |
La fila 2 devuelve NULL porque UNKNOWN no es un formato de codificación compatible.
Pasos siguientes
Para consultar todas las funciones integradas compatibles con Realtime Compute for Apache Flink, consulte Supported functions.
Para ampliar Flink SQL con lógica personalizada, consulte UDFs y Manage UDFs.