简单字符串查询 #

使用 simple_query_string 类型在查询字符串中直接指定由正则表达式分隔的多个参数。简单查询字符串的语法比查询字符串宽松，因为它会丢弃字符串中的任何无效部分，并且不会因无效语法而返回错误。

此查询使用简单语法根据特殊运算符解析查询字符串，并将字符串拆分为词项。解析后，查询会独立分析每个词项，然后返回匹配的文档。

以下查询对 title 字段执行模糊搜索：

GET _search
{
  "query": {
    "simple_query_string": {
      "query": "\"rises wind the\"~4 | *ising~2",
      "fields": ["title"]
    }
  }
}

简单字符串语法 #

查询字符串由词项和运算符组成。词项是一个单词（例如，在查询 wind rises 中，词项是 wind 和 rises ）。如果多个词项被引号包围，它们被视为一个短语，其中单词按出现的顺序匹配（例如， “wind rises” ）。 + 、 | 和 - 等运算符指定用于解释查询字符串中文本的布尔逻辑。

操作符 #

简单查询字符串语法支持以下运算符。

所有前面的操作符都是保留字符。要将其作为原始字符而不是操作符引用，用反斜杠转义它们中的任何一个。在发送 JSON 请求时，使用 \\ 转义保留字符（因为反斜杠字符本身也是保留的，你必须用另一个反斜杠转义反斜杠）。

默认操作符 #

默认操作符是 OR （除非你将 default_operator 设置为 AND ）。默认操作符决定了整体查询行为。例如，考虑一个包含以下文档的索引：

PUT /customers/_doc/1
{
  "first_name":"Amber",
  "last_name":"Duke",
  "address":"880 Holmes Lane"
}

PUT /customers/_doc/2
{
  "first_name":"Hattie",
  "last_name":"Bond",
  "address":"671 Bristol Street"
}

PUT /customers/_doc/3
{
  "first_name":"Nanette",
  "last_name":"Bates",
  "address":"789 Madison St"
}


PUT /customers/_doc/4
{
  "first_name":"Dale",
  "last_name":"Amber",
  "address":"467 Hutchinson Court"
}

以下查询试图找到地址中包含 street 或 st 且不包含 madison 的文档：

GET /customers/_search
{
  "query": {
    "simple_query_string": {
      "fields": [ "address" ],
      "query": "street st -madison"
    }
  }
}

然而，结果不仅包括预期的文档，还包括所有四个文档：

{
  "took": 3,
  "timed_out": false,
  "_shards": {
    "total": 1,
    "successful": 1,
    "skipped": 0,
    "failed": 0
  },
  "hits": {
    "total": {
      "value": 4,
      "relation": "eq"
    },
    "max_score": 2.2039728,
    "hits": [
      {
        "_index": "customers",
        "_id": "2",
        "_score": 2.2039728,
        "_source": {
          "first_name": "Hattie",
          "last_name": "Bond",
          "address": "671 Bristol Street"
        }
      },
      {
        "_index": "customers",
        "_id": "3",
        "_score": 1.2039728,
        "_source": {
          "first_name": "Nanette",
          "last_name": "Bates",
          "address": "789 Madison St"
        }
      },
      {
        "_index": "customers",
        "_id": "1",
        "_score": 1,
        "_source": {
          "first_name": "Amber",
          "last_name": "Duke",
          "address": "880 Holmes Lane"
        }
      },
      {
        "_index": "customers",
        "_id": "4",
        "_score": 1,
        "_source": {
          "first_name": "Dale",
          "last_name": "Amber",
          "address": "467 Hutchinson Court"
        }
      }
    ]
  }
}

因为默认操作符是 OR ，这个查询包括包含 street 或 st 的文档（文档 2 和 3）以及不包含 madison 的文档（文档 1 和 4）。

要正确表达查询意图，请在 -madison 前面加上 + ：

GET /customers/_search
{
  "query": {
    "simple_query_string": {
      "fields": [ "address" ],
      "query": "street st +-madison"
    }
  }
}

或者，将 AND 指定为默认操作符，并使用 street 和 st 的析取操作：

GET /customers/_search
{
  "query": {
    "simple_query_string": {
      "fields": [ "address" ],
      "query": "st|street -madison",
      "default_operator": "AND"
    }
  }
}

前面的查询返回文档 2：

{
  "took": 2,
  "timed_out": false,
  "_shards": {
    "total": 1,
    "successful": 1,
    "skipped": 0,
    "failed": 0
  },
  "hits": {
    "total": {
      "value": 1,
      "relation": "eq"
    },
    "max_score": 2.2039728,
    "hits": [
      {
        "_index": "customers",
        "_id": "2",
        "_score": 2.2039728,
        "_source": {
          "first_name": "Hattie",
          "last_name": "Bond",
          "address": "671 Bristol Street"
        }
      }
    ]
  }
}

限制操作符 #

要限制简单查询字符串解析器支持的操作符，请在 flags 参数中包含您想要支持的操作符，操作符之间用 | 分隔。例如，以下查询仅启用 OR 、 AND 和 FUZZY 操作符：

GET /customers/_search
{
  "query": {
    "simple_query_string": {
      "fields": [ "address" ],
      "query": "bristol | madison +stre~2",
      "flags": "OR|AND|FUZZY"
    }
  }
}

下列表格列出了所有可用的操作符标志。

通配符表达式 #

您可以使用 * 特殊字符指定通配符表达式，该字符替换零个或多个字符。例如，以下查询搜索所有以 name 结尾的字段：

GET /customers/_search
{
  "query": {
    "simple_query_string" : {
      "query":    "Amber Bond",
      "fields": [ "*name" ]
    }
  }
}

加权 #

使用尖号（^）提升运算符来提升字段的相关性得分。[0, 1)范围内的值会降低相关性，而大于 1 的值会增加相关性。默认值为 1。

例如，以下查询搜索 first_name 和 last_name 字段，并将 first_name 字段的匹配项提升 2 倍：

GET /customers/_search
{
  "query": {
    "simple_query_string" : {
      "query":    "Amber",
      "fields": [ "first_name^2", "last_name" ]
    }
  }
}

多位置词元 #

对于多位置词元，简单查询字符串会创建一个匹配短语查询。因此，如果你指定 ml, machine learning 作为同义词并搜索 ml ，Easysearch 会搜索 ml OR "machine learning" 。

或者，您可以使用连词来匹配多位置词元。如果您将 auto_generate_synonyms_phrase_query 设置为 false ，Easysearch 将搜索 ml OR (machine AND learning) 。

例如，以下查询搜索文本 ml models 并指定不针对每个同义词自动生成匹配短语查询：

GET /testindex/_search
{
  "query": {
    "simple_query_string": {
      "fields": ["title"],
      "query": "ml models",
      "auto_generate_synonyms_phrase_query": false
    }
  }
}

对于此查询，Easysearch 创建以下布尔查询： (ml OR (machine AND learning)) models 。

参数说明 #

以下表格列出了 simple_query_string 查询支持的一级参数。除了 query 之外的所有参数都是可选的。