Elasticsearch 全文检索与过滤

一、本地或云端集群

# 一条命令拉起 ES + Kibana（8.x 以上）
curl -fsSL https://elastic.co/start-local | sh

浏览器打开 http://localhost:5601，进入 Kibana → DevTools → Console，后续 JSON 请求直接粘贴即可执行。

云端 / Serverless 用户：只要有 superuser 或开发者角色，同样复制即可。

二、映射与嵌套字段

2.1.创建索引 cooking_blog

PUT /cooking_blog

2.3.完整映射（含嵌套 ingredients）

PUT /cooking_blog/_mapping
{
  "properties": {
    "title":       { "type": "text", "fields": {"keyword": {"type": "keyword","ignore_above":256 }}},
    "description": { "type": "text", "fields": {"keyword": {"type": "keyword"}}},
    "author":      { "type": "text", "fields": {"keyword": {"type": "keyword"}}},
    "date":        { "type": "date", "format": "yyyy-MM-dd"},
    "category":    { "type": "text", "fields": {"keyword": {"type": "keyword"}}},
    "tags":        { "type": "text", "fields": {"keyword": {"type": "keyword"}}},
    "rating":      { "type": "float"},

    "ingredients": {                         # ⬅︎ 配料表
      "type": "nested",
      "properties": {
        "name":     { "type": "text", "fields": {"keyword": {"type": "keyword"}}},
        "quantity": { "type": "float"},
        "unit":     { "type": "keyword"}
      }
    }
  }
}

• text + keyword 多字段：同时支持分词检索与精确过滤
• nested：让配料成为独立文档，便于高精度查询

三、批量导入示例数据

POST /cooking_blog/_bulk?refresh=wait_for
{ "index": { "_id": "1" } }
{"title":"Perfect Pancakes: A Fluffy Breakfast Delight","description":"Learn the secrets…","author":"Maria Rodriguez","date":"2023-05-01","category":"Breakfast","tags":["pancakes","breakfast","easy recipes"],"rating":4.8,"ingredients":[{"name":"flour","quantity":200,"unit":"g"},{"name":"buttermilk","quantity":250,"unit":"ml"}]}
{ "index": { "_id": "2" } }
{"title":"Spicy Thai Green Curry: A Vegetarian Adventure","description":"Dive into the flavors…","author":"Liam Chen","date":"2023-05-05","category":"Main Course","tags":["thai","vegetarian","curry","spicy"],"rating":4.6}
{ "index": { "_id": "3" } }
{"title":"Vegan Chocolate Avocado Mousse","description":"Discover the magic of avocado…","author":"Alex Green","date":"2023-05-15","category":"Dessert","tags":["vegan","chocolate","avocado"],"rating":4.5}

四、match / match_phrase / multi_match

4.1. match —— 标准全文搜索

GET /cooking_blog/_search
{
  "_source": ["title","description"],
  "query": {
    "match": {
      "description": "fluffy pancakes"
    }
  }
}

• 默认 OR：任一 term 命中即可
• 可加 "operator": "and" 强制全部出现

4.2. match_phrase —— 顺序与距离

GET /cooking_blog/_search
{
  "query": {
    "match_phrase": {
      "description": {
        "query": "Thai green curry",
        "slop": 2            # 允许错位 2 个 term
      }
    }
  }
}

4.3. multi_match —— 多字段一次搞定

GET /cooking_blog/_search
{
  "query": {
    "multi_match": {
      "query":  "vegetarian curry",
      "type":   "cross_fields",
      "fields": ["title^3", "description^2", "tags"]
    }
  }
}

• cross_fields：把多个字段视作一个大字段，适合多 field 同义词
• ^ 权重：标题 > 描述 > 标签

4.4. simple_query_string —— 用户友好语法

GET /cooking_blog/_search
{
  "query": {
    "simple_query_string": {
      "query": "\"green curry\" | \"thai curry\" -spicy",
      "fields": ["title","description"]
    }
  }
}

五、精准过滤：term / range / exists

5.1. 类别等值

GET /cooking_blog/_search
{
  "query": {
    "term": {
      "category.keyword": "Dessert"
    }
  }
}

5.2. 评分区间

GET /cooking_blog/_search
{
  "query": {
    "range": {
      "rating": { "gte": 4.7 }
    }
  }
}

5.3. 最近 30 天

GET /cooking_blog/_search
{
  "query": {
    "range": {
      "date": { "gte": "now-30d/d" }
    }
  }
}

过滤不会计分，执行更快，可被缓存。

六、bool、boosting、function_score

6.1. bool——最常用的组合

GET /cooking_blog/_search
{
  "_source": ["title","tags","rating","date"],
  "query": {
    "bool": {
      "must": [
        { "term":  { "tags.keyword": "vegetarian" } },
        { "range": { "rating": { "gte": 4.5 } } }
      ],
      "should": [
        { "term":  { "category.keyword": "Main Course" } },
        { "range": { "date": { "gte": "now-1M/d" } } }
      ],
      "must_not": [
        { "term": { "category.keyword": "Dessert" } }
      ],
      "minimum_should_match": 1
    }
  }
}

6.2. boosting——惩罚不想要的命中

GET /cooking_blog/_search
{
  "query": {
    "boosting": {
      "positive": { "match": { "tags": "chocolate" } },
      "negative": { "term":  { "tags.keyword": "vegan" } },
      "negative_boost": 0.3
    }
  }
}

6.3. function_score——按时间、评分衰减

GET /cooking_blog/_search
{
  "query": {
    "function_score": {
      "query": { "match": { "description": "curry" } },
      "functions": [
        {
          "gauss": {
            "date": { "origin": "now", "scale": "30d", "decay": 0.5 }
          }
        },
        {
          "field_value_factor": {
            "field": "rating",
            "modifier": "sqrt"
          }
        }
      ],
      "boost_mode": "sum"
    }
  }
}

七、高亮、排序与分页

GET /cooking_blog/_search
{
  "from": 0, "size": 5,
  "sort": [
    { "rating": { "order": "desc" } },
    { "date":   { "order": "desc" } }
  ],
  "query": { "match": { "description": "chocolate" } },
  "highlight": {
    "pre_tags": ["<em>"], "post_tags": ["</em>"],
    "fields": { "description": {} }
  }
}

• 深分页：改用 search_after 或 scroll
• 高亮：默认使用字段分析器，需原文保护可用 term_vector 或 stored_fields

八、为前端做 Facet

GET /cooking_blog/_search
{
  "size": 0,
  "aggs": {
    "by_category": {          "terms": { "field": "category.keyword" } },
    "tag_top10":   {          "terms": { "field": "tags.keyword", "size": 10 } },
    "rating_stats":{          "stats": { "field": "rating" } },
    "monthly":     {
      "date_histogram": {
        "field": "date", "calendar_interval": "month"
      }
    }
  }
}

• 用于显示“分类计数”“热门标签”“评分分布”“月活跃度”等

九、ingredients 配料表

GET /cooking_blog/_search
{
  "query": {
    "nested": {
      "path": "ingredients",
      "query": {
        "bool": {
          "must": [
            { "match": { "ingredients.name": "flour" } },
            { "term":  { "ingredients.unit": "g" } }
          ]
        }
      },
      "inner_hits": { "size": 3 }
    }
  }
}

十、性能 & 相关性调优清单