search_request.go 10 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446
  1. package es
  2. import (
  3. "strings"
  4. )
  5. // SearchRequestBuilder represents a builder which can build a search request
  6. type SearchRequestBuilder struct {
  7. version int
  8. index string
  9. size int
  10. sort map[string]interface{}
  11. queryBuilder *QueryBuilder
  12. aggBuilders []AggBuilder
  13. customProps map[string]interface{}
  14. }
  15. // NewSearchRequestBuilder create a new search request builder
  16. func NewSearchRequestBuilder(version int) *SearchRequestBuilder {
  17. builder := &SearchRequestBuilder{
  18. version: version,
  19. sort: make(map[string]interface{}),
  20. customProps: make(map[string]interface{}),
  21. aggBuilders: make([]AggBuilder, 0),
  22. }
  23. return builder
  24. }
  25. // Build builds and return a search request
  26. func (b *SearchRequestBuilder) Build() (*SearchRequest, error) {
  27. sr := SearchRequest{
  28. Index: b.index,
  29. Size: b.size,
  30. Sort: b.sort,
  31. CustomProps: b.customProps,
  32. }
  33. if b.queryBuilder != nil {
  34. q, err := b.queryBuilder.Build()
  35. if err != nil {
  36. return nil, err
  37. }
  38. sr.Query = q
  39. }
  40. if len(b.aggBuilders) > 0 {
  41. sr.Aggs = make(AggArray, 0)
  42. for _, ab := range b.aggBuilders {
  43. aggArray, err := ab.Build()
  44. if err != nil {
  45. return nil, err
  46. }
  47. for _, agg := range aggArray {
  48. sr.Aggs = append(sr.Aggs, agg)
  49. }
  50. }
  51. }
  52. return &sr, nil
  53. }
  54. // Size sets the size of the search request
  55. func (b *SearchRequestBuilder) Size(size int) *SearchRequestBuilder {
  56. b.size = size
  57. return b
  58. }
  59. // SortDesc adds a sort to the search request
  60. func (b *SearchRequestBuilder) SortDesc(field, unmappedType string) *SearchRequestBuilder {
  61. props := map[string]string{
  62. "order": "desc",
  63. }
  64. if unmappedType != "" {
  65. props["unmapped_type"] = unmappedType
  66. }
  67. b.sort[field] = props
  68. return b
  69. }
  70. // AddDocValueField adds a doc value field to the search request
  71. func (b *SearchRequestBuilder) AddDocValueField(field string) *SearchRequestBuilder {
  72. // fields field not supported on version >= 5
  73. if b.version < 5 {
  74. b.customProps["fields"] = []string{"*", "_source"}
  75. }
  76. b.customProps["script_fields"] = make(map[string]interface{})
  77. if b.version < 5 {
  78. b.customProps["fielddata_fields"] = []string{field}
  79. } else {
  80. b.customProps["docvalue_fields"] = []string{field}
  81. }
  82. return b
  83. }
  84. // Query creates and return a query builder
  85. func (b *SearchRequestBuilder) Query() *QueryBuilder {
  86. if b.queryBuilder == nil {
  87. b.queryBuilder = NewQueryBuilder()
  88. }
  89. return b.queryBuilder
  90. }
  91. // Agg initaite and returns a new aggregation builder
  92. func (b *SearchRequestBuilder) Agg() AggBuilder {
  93. aggBuilder := newAggBuilder()
  94. b.aggBuilders = append(b.aggBuilders, aggBuilder)
  95. return aggBuilder
  96. }
  97. // MultiSearchRequestBuilder represents a builder which can build a multi search request
  98. type MultiSearchRequestBuilder struct {
  99. version int
  100. requestBuilders []*SearchRequestBuilder
  101. }
  102. // NewMultiSearchRequestBuilder creates a new multi search request builder
  103. func NewMultiSearchRequestBuilder(version int) *MultiSearchRequestBuilder {
  104. return &MultiSearchRequestBuilder{
  105. version: version,
  106. }
  107. }
  108. // Search initiates and returns a new search request builder
  109. func (m *MultiSearchRequestBuilder) Search() *SearchRequestBuilder {
  110. b := NewSearchRequestBuilder(m.version)
  111. m.requestBuilders = append(m.requestBuilders, b)
  112. return b
  113. }
  114. // Build builds and return a multi search request
  115. func (m *MultiSearchRequestBuilder) Build() (*MultiSearchRequest, error) {
  116. requests := []*SearchRequest{}
  117. for _, sb := range m.requestBuilders {
  118. searchRequest, err := sb.Build()
  119. if err != nil {
  120. return nil, err
  121. }
  122. requests = append(requests, searchRequest)
  123. }
  124. return &MultiSearchRequest{
  125. Requests: requests,
  126. }, nil
  127. }
  128. // QueryBuilder represents a query builder
  129. type QueryBuilder struct {
  130. boolQueryBuilder *BoolQueryBuilder
  131. }
  132. // NewQueryBuilder create a new query builder
  133. func NewQueryBuilder() *QueryBuilder {
  134. return &QueryBuilder{}
  135. }
  136. // Build builds and return a query builder
  137. func (b *QueryBuilder) Build() (*Query, error) {
  138. q := Query{}
  139. if b.boolQueryBuilder != nil {
  140. b, err := b.boolQueryBuilder.Build()
  141. if err != nil {
  142. return nil, err
  143. }
  144. q.Bool = b
  145. }
  146. return &q, nil
  147. }
  148. // Bool creates and return a query builder
  149. func (b *QueryBuilder) Bool() *BoolQueryBuilder {
  150. if b.boolQueryBuilder == nil {
  151. b.boolQueryBuilder = NewBoolQueryBuilder()
  152. }
  153. return b.boolQueryBuilder
  154. }
  155. // BoolQueryBuilder represents a bool query builder
  156. type BoolQueryBuilder struct {
  157. filterQueryBuilder *FilterQueryBuilder
  158. }
  159. // NewBoolQueryBuilder create a new bool query builder
  160. func NewBoolQueryBuilder() *BoolQueryBuilder {
  161. return &BoolQueryBuilder{}
  162. }
  163. // Filter creates and return a filter query builder
  164. func (b *BoolQueryBuilder) Filter() *FilterQueryBuilder {
  165. if b.filterQueryBuilder == nil {
  166. b.filterQueryBuilder = NewFilterQueryBuilder()
  167. }
  168. return b.filterQueryBuilder
  169. }
  170. // Build builds and return a bool query builder
  171. func (b *BoolQueryBuilder) Build() (*BoolQuery, error) {
  172. boolQuery := BoolQuery{}
  173. if b.filterQueryBuilder != nil {
  174. filters, err := b.filterQueryBuilder.Build()
  175. if err != nil {
  176. return nil, err
  177. }
  178. boolQuery.Filters = filters
  179. }
  180. return &boolQuery, nil
  181. }
  182. // FilterQueryBuilder represents a filter query builder
  183. type FilterQueryBuilder struct {
  184. filters []Filter
  185. }
  186. // NewFilterQueryBuilder creates a new filter query builder
  187. func NewFilterQueryBuilder() *FilterQueryBuilder {
  188. return &FilterQueryBuilder{
  189. filters: make([]Filter, 0),
  190. }
  191. }
  192. // Build builds and return a filter query builder
  193. func (b *FilterQueryBuilder) Build() ([]Filter, error) {
  194. return b.filters, nil
  195. }
  196. // AddDateRangeFilter adds a new time range filter
  197. func (b *FilterQueryBuilder) AddDateRangeFilter(timeField, lte, gte, format string) *FilterQueryBuilder {
  198. b.filters = append(b.filters, &RangeFilter{
  199. Key: timeField,
  200. Lte: lte,
  201. Gte: gte,
  202. Format: format,
  203. })
  204. return b
  205. }
  206. // AddQueryStringFilter adds a new query string filter
  207. func (b *FilterQueryBuilder) AddQueryStringFilter(querystring string, analyseWildcard bool) *FilterQueryBuilder {
  208. if len(strings.TrimSpace(querystring)) == 0 {
  209. return b
  210. }
  211. b.filters = append(b.filters, &QueryStringFilter{
  212. Query: querystring,
  213. AnalyzeWildcard: analyseWildcard,
  214. })
  215. return b
  216. }
  217. // AggBuilder represents an aggregation builder
  218. type AggBuilder interface {
  219. Histogram(key, field string, fn func(a *HistogramAgg, b AggBuilder)) AggBuilder
  220. DateHistogram(key, field string, fn func(a *DateHistogramAgg, b AggBuilder)) AggBuilder
  221. Terms(key, field string, fn func(a *TermsAggregation, b AggBuilder)) AggBuilder
  222. Filters(key string, fn func(a *FiltersAggregation, b AggBuilder)) AggBuilder
  223. GeoHashGrid(key, field string, fn func(a *GeoHashGridAggregation, b AggBuilder)) AggBuilder
  224. Metric(key, metricType, field string, fn func(a *MetricAggregation)) AggBuilder
  225. Pipeline(key, pipelineType, bucketPath string, fn func(a *PipelineAggregation)) AggBuilder
  226. Build() (AggArray, error)
  227. }
  228. type aggBuilderImpl struct {
  229. AggBuilder
  230. aggDefs []*aggDef
  231. }
  232. func newAggBuilder() *aggBuilderImpl {
  233. return &aggBuilderImpl{
  234. aggDefs: make([]*aggDef, 0),
  235. }
  236. }
  237. func (b *aggBuilderImpl) Build() (AggArray, error) {
  238. aggs := make(AggArray, 0)
  239. for _, aggDef := range b.aggDefs {
  240. agg := &Agg{
  241. Key: aggDef.key,
  242. Aggregation: aggDef.aggregation,
  243. }
  244. for _, cb := range aggDef.builders {
  245. childAggs, err := cb.Build()
  246. if err != nil {
  247. return nil, err
  248. }
  249. for _, childAgg := range childAggs {
  250. agg.Aggregation.Aggs = append(agg.Aggregation.Aggs, childAgg)
  251. }
  252. }
  253. aggs = append(aggs, agg)
  254. }
  255. return aggs, nil
  256. }
  257. func (b *aggBuilderImpl) Histogram(key, field string, fn func(a *HistogramAgg, b AggBuilder)) AggBuilder {
  258. innerAgg := &HistogramAgg{
  259. Field: field,
  260. }
  261. aggDef := newAggDef(key, &aggContainer{
  262. Type: "histogram",
  263. Aggregation: innerAgg,
  264. })
  265. if fn != nil {
  266. builder := newAggBuilder()
  267. aggDef.builders = append(aggDef.builders, builder)
  268. fn(innerAgg, builder)
  269. }
  270. b.aggDefs = append(b.aggDefs, aggDef)
  271. return b
  272. }
  273. func (b *aggBuilderImpl) DateHistogram(key, field string, fn func(a *DateHistogramAgg, b AggBuilder)) AggBuilder {
  274. innerAgg := &DateHistogramAgg{
  275. Field: field,
  276. }
  277. aggDef := newAggDef(key, &aggContainer{
  278. Type: "date_histogram",
  279. Aggregation: innerAgg,
  280. })
  281. if fn != nil {
  282. builder := newAggBuilder()
  283. aggDef.builders = append(aggDef.builders, builder)
  284. fn(innerAgg, builder)
  285. }
  286. b.aggDefs = append(b.aggDefs, aggDef)
  287. return b
  288. }
  289. func (b *aggBuilderImpl) Terms(key, field string, fn func(a *TermsAggregation, b AggBuilder)) AggBuilder {
  290. innerAgg := &TermsAggregation{
  291. Field: field,
  292. Order: make(map[string]interface{}),
  293. }
  294. aggDef := newAggDef(key, &aggContainer{
  295. Type: "terms",
  296. Aggregation: innerAgg,
  297. })
  298. if fn != nil {
  299. builder := newAggBuilder()
  300. aggDef.builders = append(aggDef.builders, builder)
  301. fn(innerAgg, builder)
  302. }
  303. b.aggDefs = append(b.aggDefs, aggDef)
  304. return b
  305. }
  306. func (b *aggBuilderImpl) Filters(key string, fn func(a *FiltersAggregation, b AggBuilder)) AggBuilder {
  307. innerAgg := &FiltersAggregation{
  308. Filters: make(map[string]interface{}),
  309. }
  310. aggDef := newAggDef(key, &aggContainer{
  311. Type: "filters",
  312. Aggregation: innerAgg,
  313. })
  314. if fn != nil {
  315. builder := newAggBuilder()
  316. aggDef.builders = append(aggDef.builders, builder)
  317. fn(innerAgg, builder)
  318. }
  319. b.aggDefs = append(b.aggDefs, aggDef)
  320. return b
  321. }
  322. func (b *aggBuilderImpl) GeoHashGrid(key, field string, fn func(a *GeoHashGridAggregation, b AggBuilder)) AggBuilder {
  323. innerAgg := &GeoHashGridAggregation{
  324. Field: field,
  325. Precision: 5,
  326. }
  327. aggDef := newAggDef(key, &aggContainer{
  328. Type: "geohash_grid",
  329. Aggregation: innerAgg,
  330. })
  331. if fn != nil {
  332. builder := newAggBuilder()
  333. aggDef.builders = append(aggDef.builders, builder)
  334. fn(innerAgg, builder)
  335. }
  336. b.aggDefs = append(b.aggDefs, aggDef)
  337. return b
  338. }
  339. func (b *aggBuilderImpl) Metric(key, metricType, field string, fn func(a *MetricAggregation)) AggBuilder {
  340. innerAgg := &MetricAggregation{
  341. Field: field,
  342. Settings: make(map[string]interface{}),
  343. }
  344. aggDef := newAggDef(key, &aggContainer{
  345. Type: metricType,
  346. Aggregation: innerAgg,
  347. })
  348. if fn != nil {
  349. fn(innerAgg)
  350. }
  351. b.aggDefs = append(b.aggDefs, aggDef)
  352. return b
  353. }
  354. func (b *aggBuilderImpl) Pipeline(key, pipelineType, bucketPath string, fn func(a *PipelineAggregation)) AggBuilder {
  355. innerAgg := &PipelineAggregation{
  356. BucketPath: bucketPath,
  357. Settings: make(map[string]interface{}),
  358. }
  359. aggDef := newAggDef(key, &aggContainer{
  360. Type: pipelineType,
  361. Aggregation: innerAgg,
  362. })
  363. if fn != nil {
  364. fn(innerAgg)
  365. }
  366. b.aggDefs = append(b.aggDefs, aggDef)
  367. return b
  368. }