Elasticsearch Go客户端使用指南：核心功能示例解析-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00165/article/details/148488664

Elasticsearch Go客户端使用指南：核心功能示例解析

go-elasticsearch The official Go client for Elasticsearch 项目地址: https://gitcode.com/gh_mirrors/go/go-elasticsearch

前言

本文主要介绍如何使用Elasticsearch官方Go客户端库进行常见的搜索和索引操作。作为Elasticsearch生态中的重要组成部分，该客户端库提供了与Elasticsearch服务交互的完整功能集。

准备工作

在开始之前，请确保已经正确安装并配置了Go开发环境，同时已经通过以下命令获取了客户端库：

go get github.com/elastic/go-elasticsearch/v8

索引操作

创建索引

创建索引是使用Elasticsearch的第一步。以下示例展示了如何创建一个名为test-index的索引，并为其定义字段映射：

res, err := es.Indices.Create("test-index").
    Request(&create.Request{
        Mappings: &types.TypeMapping{
            Properties: map[string]types.Property{
                "price": types.NewIntegerNumberProperty(),
                // 可以继续添加其他字段
                "name":  types.NewKeywordProperty(),
            },
        },
    }).
    Do(context.Background())

关键点说明：

NewIntegerNumberProperty()会自动设置字段类型为integer
映射定义支持多种字段类型，如keyword、text、date等
创建索引时可以同时设置分片数、副本数等参数

文档操作

索引文档

索引文档有两种主要方式：

方法一：使用结构体

type Product struct {
    ID    int    `json:"id"`
    Name  string `json:"name"`
    Price int    `json:"price"`
}

product := Product{
    ID:    1,
    Name:  "高性能笔记本电脑",
    Price: 8999,
}

res, err := es.Index("products").
    Request(product).
    Do(context.Background())

方法二：使用原始JSON

jsonDoc := `{
    "id": 2,
    "name": "无线蓝牙耳机",
    "price": 599
}`

res, err := es.Index("products").
    Raw([]byte(jsonDoc)).
    Do(context.Background())

检索文档

检索文档非常简单：

res, err := es.Get("products", "1").Do(context.Background())

返回的res对象包含文档内容和元数据，可以通过res.Source_获取原始文档内容。

检查文档存在性

如果只需要检查文档是否存在而不需要内容：

exists, err := es.Exists("products", "1").IsSuccess(nil)
if exists {
    fmt.Println("文档存在")
} else if err != nil {
    fmt.Printf("检查出错: %v", err)
} else {
    fmt.Println("文档不存在")
}

搜索功能

基本搜索

构建搜索查询可以使用结构体或构建器模式。以下是使用结构体的示例：

res, err := es.Search().
    Index("products").
    Request(&search.Request{
        Query: &types.Query{
            Match: map[string]types.MatchQuery{
                "name": {Query: "笔记本电脑"},
            },
        },
    }).
    Do(context.Background())

等效的JSON查询：

{
  "query": {
    "match": {
      "name": {
        "query": "笔记本电脑"
      }
    }
  }
}

聚合查询

聚合是Elasticsearch的强大功能之一。以下示例计算所有商品价格的总和：

res, err := es.Search().
    Index("products").
    Request(
        &search.Request{
            Size: some.Int(0), // 不返回具体文档
            Aggregations: map[string]types.Aggregations{
                "total_price": {
                    Sum: &types.SumAggregation{
                        Field: some.String("price"),
                    },
                },
                // 可以添加更多聚合
                "avg_price": {
                    Avg: &types.AvgAggregation{
                        Field: some.String("price"),
                    },
                },
            },
        },
    ).Do(context.Background())