このトピックでは、入力文字列を application/x-www-form-urlencoded MIME 形式でエンコードし、エンコードされた文字列を返す方法について説明します。
制限事項
この関数は、Ververica Runtime (VVR) 8.0.8 以降を使用する Realtime Compute for Apache Flink でのみサポートされています。
構文
VARCHAR URL_ENCODE(VARCHAR input)
VARCHAR URL_ENCODE(VARCHAR input, VARCHAR encoding)入力パラメーター
パラメーター | データ型 | 説明 |
input | VARCHAR | 入力文字列。 |
encoding | VARCHAR | エンコード形式。値は GBK または UTF-8 を指定できます。このパラメーターを設定しない場合、デフォルト値の UTF-8 が使用されます。このパラメーターはオプションです。 |
入力パラメーターに無効な値が含まれている場合、または入力パラメーターのエンコード形式が無効な場合、NULL が返されます。
例 1
テストデータ
表 1 T1
input
input(VARCHAR)
1
http://calcite.apache.org
2
http://test?a=b&c=d
3
http://Hello
4
test
テストステートメント
SELECT id, URL_ENCODE(input) AS `value` FROM T1;テスト結果
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
例 2
テストデータ
表 1. T2
id (INT)
input(VARCHAR)
encoding(VARCHAR)
1
http://Hello
gb2312
2
http://test?a=b&c=d
UNKNOWN
テストステートメント
SELECT id, URL_ENCODE(input, encoding) AS `value` FROM T2;テスト結果
id (INT)
value (VARCHAR)
1
http%3A%2F%2F%C4%E3%BA%C3
2
NULL
参照
フルマネージド Flink でサポートされている組み込み関数の詳細については、「サポートされている関数」をご参照ください。