メインコンテンツまでスキップ
バージョン: 26.2 Preview

url_decode

application/x-www-form-urlencoded 形式から文字列を元に戻します。この関数は url_encode の逆の機能を持ちます。

この関数は v3.2 からサポートされています。

構文​

VARCHAR url_decode(VARCHAR str)

パラメータ​

  • str: デコードする文字列。str が文字列でない場合、システムはまず暗黙的なキャストを試みます。

戻り値​

デコードされた文字列を返します。

デコードエラーの処理​

url_decode は、不正または不完全なパーセントエンコーディングに対してエラーを返します。代わりに try_url_decode(str) を使用すると、これらの入力に対して NULL を返します。有効な入力のデコード規則は url_decode と同じで、NULL 入力は NULL を返します。

sql_dialect = 'trino' の場合、直接の TRY(url_decode(str)) 呼び出しは try_url_decode(str) に変換されます。たとえば、COALESCE(TRY(url_decode('bad%_n')), 'bad%_n') は bad%_n を返します。

この変換が処理するのはデコードエラーのみです。他の関数や、デコーダーに渡される前に評価される引数式に対する汎用的な TRY エラー処理は実装しません。リテラルの + 文字を保持するなど、既存のデコード規則も維持します。

例​

mysql> select url_decode('https%3A%2F%2Fdocs.starrocks.io%2Fdocs%2Fintroduction%2FStarRocks_intro%2F');
+------------------------------------------------------------------------------------------+
| url_decode('https%3A%2F%2Fdocs.starrocks.io%2Fdocs%2Fintroduction%2FStarRocks_intro%2F') |
+------------------------------------------------------------------------------------------+
| https://docs.starrocks.io/docs/introduction/StarRocks_intro/ |
+------------------------------------------------------------------------------------------+