4 JSONPath 功能

概述

本节概述了监控项值预处理步骤中支持的 JSONPath 功能。

JSONPath 由以点号分隔的段组成。 一个段可以是简单单词的形式，表示 JSON 值名称；也可以是通配符字符（*）；或者是包含在方括号内的更复杂结构。 方括号段前面的点号是可选的，可以省略。

另请参见：在 JSONPath 中转义 LLD 宏值中的特殊字符。

支持的段

要在忽略其祖先的情况下查找匹配的段（分离段），必须在其前面加上两个点（..）。 例如，$..name 或 $..['name'] 会返回所有 name 属性的值。

可以通过在 JSONPath 后添加波浪号（~）后缀来提取匹配元素的名称。 它会返回匹配对象的名称，或匹配数组项的字符串格式索引。 输出格式遵循与其他 JSONPath 查询相同的规则——确定路径的结果按原样返回，而不确定路径的结果则以数组形式返回。 不过，提取匹配确定路径的元素名称意义不大，因为该名称本身已经是已知的。

过滤表达式

过滤表达式是一个中缀表示法中的算术表达式。

支持的操作数：

支持的运算符：

函数

函数可用于 JSONPath 的末尾。 如果前一个函数返回的值可被后一个函数接受，则可以链式调用多个函数。

支持的函数：

JSONPath 聚合函数接受带引号的数值。 当需要聚合时，这些值会自动从字符串转换为数值类型。 不兼容的输入将导致函数生成错误。

输出值

JSONPath 可以分为确定路径和不确定路径。 确定路径只能返回 null 或单个匹配项。 不确定路径可以返回多个匹配项：具有分离的、多个名称/索引列表、数组切片或表达式段的 JSONPath。 但是，当使用函数时，JSONPath 变为确定，因为函数始终输出单个值。

确定路径返回它引用的对象/数组/值。 相反，不确定路径返回匹配对象/数组/值的数组。

路径格式化规则

在方括号表示法的段和表达式中可以使用空格（空格、制表符），例如：$[ 'a' ][ 0 ][ ?( $.b == 'c' ) ][ : -1 ].first( )。

字符串应该用单引号（'）或双引号（"）括起来。 在字符串内部，单引号或双引号（取决于用哪个来括起来）和反斜杠（\）需要用反斜杠（\）进行转义。

示例

{
  "books": [
    {
      "category": "reference",
      "author": "Nigel Rees",
      "title": "Sayings of the Century",
      "price": 8.95,
      "id": 1
    },
    {
      "category": "fiction",
      "author": "Evelyn Waugh",
      "title": "Sword of Honour",
      "price": 12.99,
      "id": 2
    },
    {
      "category": "fiction",
      "author": "Herman Melville",
      "title": "Moby Dick",
      "isbn": "0-553-21311-3",
      "price": 8.99,
      "id": 3
    },
    {
      "category": "fiction",
      "author": "J. R. R. Tolkien",
      "title": "The Lord of the Rings",
      "isbn": "0-395-19395-8",
      "price": 22.99,
      "id": 4
    }
  ],
  "services": {
    "delivery": {
      "servicegroup": 1000,
      "description": "Next day delivery in local town",
      "active": true,
      "price": 5
    },
    "bookbinding": {
      "servicegroup": 1001,
      "description": "Printing and assembling book in A5 format",
      "active": true,
      "price": 154.99
    },
    "restoration": {
      "servicegroup": 1002,
      "description": "Various restoration methods",
      "active": false,
      "methods": [
        {
          "description": "Chemical cleaning",
          "price": 46
        },
        {
          "description": "Pressing pages damaged by moisture",
          "price": 24.5
        },
        {
          "description": "Rebinding torn book",
          "price": 99.49
        }
      ]
    }
  },
  "filters": {
    "price": 10,
    "category": "fiction",
    "no filters": "no \"filters\""
  },
  "closed message": "Store is closed",
  "tags": [
    "a",
    "b",
    "c",
    "d",
    "e"
  ]
}