parse_url 函数

适用于:勾选“是” Databricks SQL 勾选“是” Databricks Runtime

url 中提取一部分。

语法

parse_url(url, partToExtract [, key] )

参数

  • url:一个 STRING 表达式。
  • partToExtract:一个 STRING 表达式。
  • key:一个 STRING 表达式。

返回

字符串。

partToExtract 必须是以下各项之一:

  • 'HOST'
  • 'PATH'
  • 'QUERY'
  • 'REF'
  • 'PROTOCOL'
  • 'FILE'
  • 'AUTHORITY'
  • 'USERINFO'

key 区分大小写。

如果未找到请求的 partToExtractkey,则返回 NULL。

如果 url 字符串无效,Azure Databricks 会返回错误。

注意

在 Databricks Runtime 中,如果 spark.sql.ansi.enabledfalse,则 parse_url 返回 NULL(如果 url 字符串无效)。

示例

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

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

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

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