更新时间:2026-07-03 GMT+08:00
分享

parse_url

返回给定URL的指定部分。partToExtract的有效值包括HOST、PATH、QUERY、REF、PROTOCOL、AUTHORITY、FILE和USERINFO。当第二个参数为QUERY时,可以使用第三个参数提取特定参数的值。

命令格式

parse_url(string <urlString>, string <partToExtract [, string <keyToExtract>]) 

参数说明

参数

是否必选

参数类型

说明

urlString

STRING

URL链接。

partToExtract

STRING

取值包含:HOST、PATH、QUERY、REF、PROTOCOL、AUTHORITY、FILE和USERINFO,不区分大小写。

keyToExtract

STRING

当partToExtract取值为QUERY时,根据key值取出对应的Value值。

返回值说明

返回STRING类型的值。

  • urlString、partToExtract或keyToExtract值为NULL时,返回NULL。
  • partToExtract取值不符合要求时,返回NULL。

示例代码

返回example.com。

select parse_url('file://username@example.com:666/over/there/index.dtb?type=animal&name=narwhal#nose', 'HOST'); 

返回/over/there/index.dtb。

select parse_url('file://username@example.com:666/over/there/index.dtb?type=animal&name=narwhal#nose', 'PATH'); 

返回animal。

select parse_url('file://username@example.com:666/over/there/index.dtb?type=animal&name=narwhal#nose', 'QUERY', 'type'); 

返回nose。

select parse_url('file://username@example.com:666/over/there/index.dtb?type=animal&name=narwhal#nose', 'REF'); 

返回file。

select parse_url('file://username@example.com:666/over/there/index.dtb?type=animal&name=narwhal#nose', 'PROTOCOL'); 

返回username@example.com:666。

select parse_url('file://username@example.com:666/over/there/index.dtb?type=animal&name=narwhal#nose', 'AUTHORITY'); 

返回username。

select parse_url('file://username@example.com:666/over/there/index.dtb?type=animal&name=narwhal#nose', 'USERINFO');

相关文档