url_decode function

Applies to: Databricks SQL Databricks Runtime 11.3 LTS and above

Translates a string back from application/x-www-form-urlencoded format.

Syntax

url_decode(str)

Arguments

• str: A STRING expression to decode.

Returns

A STRING.

If the string does not comply with the application/x-www-form-urlencoded format, Azure Databricks raises CANNOT_DECODE_URL. To return NULL instead, use the try_url_decode() function.

Common error conditions

• CANNOT_DECODE_URL

Examples

> SELECT url_encode('http://spark.apache.org/path?query=1');
 http%3A%2F%2Fspark.apache.org%2Fpath%3Fquery%3D1

> SELECT url_decode('http%3A%2F%2Fspark.apache.org%2Fpath%3Fquery%3D1');
 http://spark.apache.org/path?query=1

> SELECT url_decode('http%3A%2F%2spark.apache.org');
 Error: CANNOT_DECODE_URL

> SELECT try_url_decode('http%3A%2F%2spark.apache.org');
 NULL

> SELECT parse_url('http://spark.apache.org/path?query=1', 'QUERY', 'query');
 1

> SELECT parse_url('http%3A%2F%2Fspark.apache.org%2Fpath%3Fquery%3D1', 'QUERY', 'query');
 1

Related functions

• parse_url function
• try_url_decode function
• url_encode function