parse_url 関数

  • [アーティクル]

適用対象:「はい」のチェック マーク Databricks SQL 「はい」のチェック マーク Databricks Runtime

url からパーツを抽出します。

構文

parse_url(url, partToExtract [, key] )

引数

  • url: STRING 式。
  • partToExtract: STRING 式。
  • 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 の場合、url 文字列が無効であれば parse_url では NULL を返します。

例

> 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