Regexp 查询 #

使用 regexp 查询来搜索符合正则表达式的词项。有关编写正则表达式的更多信息，请参见正则表达式语法。

相关指南（先读这些） #

• 部分匹配
• 结构化搜索

以下查询搜索以任何大写或小写字母开头的任何词项 amlet ：

GET shakespeare/_search
{
  "query": {
    "regexp": {
      "play_name": "[a-zA-Z]amlet"
    }
  }
}

重要注意事项：

• 正则表达式应用于字段中的词条（即，标记/token），而不是整个字段。
• 默认情况下，正则表达式的最大长度为 1,000 个字符。要更改最大长度，请更新 index.max_regex_length 设置。
• 正则表达式使用 Lucene 语法，这与更标准的实现有所不同。请充分测试以确保获得预期的结果。
• 为了提高正则表达式查询的性能，避免使用没有前缀或后缀的通配符模式，例如 .* 或 .*?+ 。
• regexp 查询可能会非常耗时，并且需要将 search.allow_expensive_queries 设置为 true 。在频繁执行 regexp 查询之前，请测试其对集群性能的影响，并考虑使用其他可能达到类似效果的查询。更多性能优化建议，请参考 部分匹配章节。

参数说明 #

查询接受字段名称（ <field> ）作为顶级参数：

GET _search
{
  "query": {
    "regexp": {
      "<field>": {
        "value": "[Ss]ample",
        ...
      }
    }
  }
}

<field> 接受以下参数。除了 value 之外，所有参数都是可选的。

如果 search.allow_expensive_queries 设置为 false ，则 regexp 查询将不被执行。

支持的正则语法 #

Easysearch 使用 Lucene 正则表达式语法，与标准正则语法（PCRE）有所不同。以下是常用元素速查：

注意：Lucene 不支持 \d、\w、\s 等快捷方式。需要用 [0-9]、[a-zA-Z0-9_] 等字符类来代替。

在分析过的字段上使用 #

regexp 查询作用于倒排索引中的 单个词项，而不是原始字段值。例如：

• 字段值 "Quick brown fox" → 分词后为词项 quick、brown、fox
• regexp: "br.*" → ✅ 匹配（匹配词项 brown）
• regexp: "Qu.*" → ❌ 不匹配（词项是小写 quick，不是 Quick）
• regexp: "quick br.*" → ❌ 不匹配（正则表达式不会跨越多个词项）

因此，如果需要对原始完整字段值做正则匹配，应使用 keyword 类型的字段。

替代方案 #

对于常见的部分匹配需求，下面这些方案往往性能更优：