ZincSearch搜索语法基础

发布时间: 2025-04-08 10:46

↑

# ZincSearch搜索语法基础

本文将详细介绍ZincSearch的搜索语法，帮助您掌握如何构建高效的搜索查询。

## 查询类型

### 1. 全文搜索

```json
{
  "search_type": "match",
  "query": {
    "term": "搜索关键词",
    "field": "content"
  }
}
```

### 2. 精确匹配

```json
{
  "search_type": "term",
  "query": {
    "term": "精确值",
    "field": "category"
  }
}
```

### 3. 范围查询

```json
{
  "search_type": "range",
  "query": {
    "field": "price",
    "gte": 100,
    "lte": 200
  }
}
```

### 4. 前缀查询

```json
{
  "search_type": "prefix",
  "query": {
    "prefix": "test",
    "field": "title"
  }
}
```

### 5. 通配符查询

```json
{
  "search_type": "wildcard",
  "query": {
    "wildcard": "te*t",
    "field": "title"
  }
}
```

## 复合查询

### 1. 布尔查询

```json
{
  "search_type": "bool",
  "query": {
    "must": [
      {
        "term": "关键词1",
        "field": "title"
      }
    ],
    "should": [
      {
        "term": "关键词2",
        "field": "content"
      }
    ],
    "must_not": [
      {
        "term": "排除词",
        "field": "tags"
      }
    ]
  }
}
```

### 2. 多字段查询

```json
{
  "search_type": "multi_match",
  "query": {
    "term": "搜索词",
    "fields": ["title", "content", "tags"]
  }
}
```

## 查询参数

### 1. 分页

```json
{
  "from": 0,    // 起始位置
  "size": 10,   // 返回数量
  "search_type": "match",
  "query": {
    "term": "搜索词"
  }
}
```

### 2. 排序

```json
{
  "sort": [
    {
      "field": "timestamp",
      "order": "desc"
    }
  ],
  "search_type": "match",
  "query": {
    "term": "搜索词"
  }
}
```

### 3. 高亮

```json
{
  "highlight": {
    "fields": ["content"],
    "pre_tags": ["<em>"],
    "post_tags": ["</em>"]
  },
  "search_type": "match",
  "query": {
    "term": "搜索词"
  }
}
```

## 聚合查询

### 1. 基础聚合

```json
{
  "aggs": {
    "categories": {
      "terms": {
        "field": "category"
      }
    }
  }
}
```

### 2. 指标聚合

```json
{
  "aggs": {
    "avg_price": {
      "avg": {
        "field": "price"
      }
    }
  }
}
```

## 查询优化

### 1. 性能优化

- 使用合适的查询类型
- 避免过深的嵌套
- 合理设置分页大小

### 2. 相关性优化

- 字段权重设置
- 同义词配置
- 停用词处理

## 常见查询示例

### 1. 模糊匹配

```json
{
  "search_type": "fuzzy",
  "query": {
    "term": "测试",
    "field": "content",
    "fuzziness": 1
  }
}
```

### 2. 短语匹配

```json
{
  "search_type": "phrase",
  "query": {
    "term": "完整短语",
    "field": "content"
  }
}
```

### 3. 地理位置查询

```json
{
  "search_type": "geo_distance",
  "query": {
    "field": "location",
    "lat": 40.7128,
    "lon": -74.0060,
    "distance": "10km"
  }
}
```

## 错误处理

### 1. 常见错误

- 语法错误
- 字段不存在
- 类型不匹配

### 2. 调试技巧

- 使用explain参数
- 检查响应码
- 查看错误信息

## 最佳实践

1. 查询设计
   - 选择合适的查询类型
   - 优化查询结构
   - 注意性能影响

2. 结果处理
   - 合理分页
   - 结果缓存
   - 错误重试

3. 性能优化
   - 索引优化
   - 查询优化
   - 缓存利用

元素码农