parse_url 函数

  • 项目

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

从 url 中提取一部分。

语法

parse_url(url, partToExtract [, key] )

参数

  • url：一个 STRING 表达式。
  • partToExtract：字符串表达式。
  • key：一个 STRING 表达式。

返回

一个 STRING。

partToExtract 必须是以下各项之一：

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

key 区分大小写。

如果未找到请求的 partToExtract 或 key，则返回 NULL。

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

注意

在 Databricks Runtime 中，如果 spark.sql.ansi.enabled 为 false，则 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