You need to enable JavaScript to run this app.
导航
URL 函数
最近更新时间:2024.01.30 10:05:14首次发布时间:2024.01.22 17:18:38

本文介绍日志服务支持的 URL 函数语法及常见场景的使用示例。

注意

日志服务产品架构升级,支持更丰富的检索分析功能。

  • 如果控制台提示新一代架构正式发布信息,表示您使用的是 2.0 架构,可参考本文档使用相关功能。
  • 如果控制台未提示新一代架构正式发布信息,表示您使用的是 1.0 架构,可参考检索分析(1.0 架构)中的检索概述等文档使用相关功能。

关于 1.0 架构与 2.0 架构的具体说明,请参考日志服务架构升级通知

函数列表

说明

在日志服务分析语句(SQL 语句)中,需要使用单引号('')包裹代表字符串的字符,无符号包裹或被双引号("")包裹的字符为字段名或列名。例如'time' 代表字符串,time"time" 代表字段名或列名。

函数名称

函数语法

说明

URL_ENCODE 函数

URL_ENCODE(KEY)

对 URL 进行编码。

URL_DECODE 函数

URL_DECODE(KEY)

对 URL 进行解码。

URL_EXTRACT_FRAGMENT 函数

URL_EXTRACT_FRAGMENT(KEY)

从 URL 中提取 Fragment 信息。

URL_EXTRACT_HOST 函数

URL_EXTRACT_HOST(KEY)

从 URL 中提取 Host 信息。

URL_EXTRACT_PARAMETER 函数

URL_EXTRACT_PARAMETER(KEY, parameter ** name)

从 URL 的 Query 部分提取指定参数的值。

URL_EXTRACT_PATH 函数

URL_EXTRACT_PATH(KEY)

从 URL 中提取访问路径信息。

URL_EXTRACT_PORT 函数

URL_EXTRACT_PORT(KEY)

从 URL 中提取端口信息。

URL_EXTRACT_PROTOCOL 函数

URL_EXTRACT_PROTOCOL(KEY)

从 URL 中提取协议信息。

URL_EXTRACT_QUERY 函数

URL_EXTRACT_QUERY(KEY)

从 URL 中提取完整的 Query 部分。

URL_ENCODE 函数

URL_ENCODE 函数用于对 URL 进行编码。

函数语法

  • 语法格式

    URL_ENCODE(KEY)
    
  • 参数说明

    参数

    说明

    KEY

    字段、表达式,其值为 URL 地址。

  • 返回值说明
    返回值为 Varchar 类型。

函数示例

  • 场景
    test_url_text 字段的值进行编码。

  • 日志样例

  • 检索和分析语句

    * | SELECT URL_ENCODE(test_url_text)
    
  • 检索和分析结果

URL_DECODE 函数

URL_DECODE 函数对 URL 进行解码。

函数语法

  • 语法格式

    URL_DECODE(KEY)
    
  • 参数说明

    参数

    说明

    KEY

    字段、表达式,其值为编码过的 URL 地址。

  • 返回值说明
    返回值为 Varchar 类型。

函数示例

  • 场景

    test_url_text 字段的值进行解码。

  • 日志样例

  • 检索和分析语句

    * | SELECT URL_DECODE(test_url_text)
    
  • 检索和分析结果

URL_EXTRACT_FRAGMENT 函数

URL_EXTRACT_FRAGMENT 函数用于从 URL 中提取 Fragment 信息。

函数语法

  • 语法格式

    URL_EXTRACT_FRAGMENT(KEY)
    
  • 参数说明

    参数

    说明

    KEY

    字段、表达式,其值为 URL 地址。

  • 返回值说明
    返回值为 Varchar 类型。

函数示例

  • 场景
    test_url_text 字段值中提取 Fragment 信息。

  • 日志样例

  • 检索和分析语句

    * | SELECT URL_EXTRACT_FRAGMENT(test_url_text) 
    
  • 检索和分析结果

URL_EXTRACT_HOST 函数

URL_EXTRACT_HOST 函数用于从 URL 地址中提取 Host 信息。

函数语法

  • 语法格式

    URL_ENCODE_HOST(KEY)
    
  • 参数说明

    参数

    说明

    KEY

    字段、表达式,其值为 URL 地址。

  • 返回值说明
    返回值为 Varchar 类型。

函数示例

  • 场景
    test_url_text 字段中提取 Host 信息。

  • 日志样例

  • 检索和分析语句

    * | SELECT URL_EXTRACT_HOST(test_url_text)
    
  • 检索和分析结果

URL_EXTRACT_PARAMETER 函数

URL_EXTRACT_PARAMETER 函数用于从 URL 的 Query 部分提取指定参数的值。

函数语法

  • 语法格式

    URL_EXTRACT_PARAMETER(KEY, parameter name)
    
  • 参数说明

    参数

    说明

    KEY

    字段、表达式,其值为 URL 地址。

    parameter name

    URL 的 Query 部分中的参数名称。

  • 返回值说明
    返回值为 Varchar 类型。

函数示例

  • 场景
    url 字段值中提取 region 参数的值。

  • 日志样例
    图片

  • 检索和分析语句

    * | SELECT URL_EXTRACT_PARAMETER(url,'region') AS region
    
  • 检索和分析结果
    图片

URL_EXTRACT_PATH 函数

URL_EXTRACT_PATH 函数用于从 URL 中提取访问路径信息。

函数语法

  • 语法格式

    URL_EXTRACT_PATH(KEY)
    
  • 参数说明

    参数

    说明

    KEY

    字段、表达式,其值为 URL 地址。

  • 返回值说明
    返回值为 Varchar 类型。

函数示例

  • 场景
    url 字段值中提取访问路径信息。

  • 日志样例
    图片

  • 检索和分析语句

    * | SELECT URL_EXTRACT_PATH(url) AS path
    
  • 检索和分析结果
    图片

URL_EXTRACT_PORT 函数

URL_EXTRACT_PORT 函数用于从 URL 中提取端口信息。

函数语法

  • 语法格式

    URL_EXTRACT_PORT(KEY)
    
  • 参数说明

    参数

    说明

    KEY

    字段、表达式,其值为 URL 地址。

  • 返回值说明
    返回值为 Varchar 类型。

函数示例

  • 场景
    url 字段值中提取端口信息。

  • 日志样例

    url:http://localhost:8080
    
  • 检索和分析语句

    * | SELECT URL_EXTRACT_PORT(url) AS port
    
  • 检索和分析结果
    图片

URL_EXTRACT_PROTOCOL 函数

URL_EXTRACT_PROTOCOL 函数用于从 URL 中提取协议信息。

函数语法

  • 语法格式

    URL_EXTRACT_PROTOCOL(KEY)
    
  • 参数说明

    参数

    说明

    KEY

    字段、表达式,其值为 URL 地址。

  • 返回值说明
    返回值为 Varchar 类型。

函数示例

  • 场景
    url 字段值中提取协议信息。

  • 日志样例

    url:http://localhost:8080
    
  • 检索和分析语句

    * | SELECT URL_EXTRACT_PROTOCOL(url) AS protocol
    
  • 检索和分析结果
    图片

URL_EXTRACT_QUERY 函数

URL_EXTRACT_QUERY 函数用于从 URL 中提取完整的 Query 部分。

函数语法

  • 语法格式

    URL_EXTRACT_QUERY(KEY)
    
  • 参数说明

    参数

    说明

    KEY

    字段、表达式,其值为 URL 地址。

  • 返回值说明
    返回值为 Varchar 类型。

函数示例

  • 场景
    url 字段值中提取查询部分的信息。

  • 日志样例

    url:http://localhost:8080/query?name=regan
    
  • 检索和分析语句

    * | SELECT URL_EXTRACT_QUERY(url) AS query
    
  • 检索和分析结果
    图片