// Copyright 2012-2015 Oliver Eilhard. All rights reserved. // Use of this source code is governed by a MIT-license. // See http://olivere.mit-license.org/license.txt for details. package elastic // TermsAggregation is a multi-bucket value source based aggregation // where buckets are dynamically built - one per unique value. // See: http://www.elasticsearch.org/guide/en/elasticsearch/reference/current/search-aggregations-bucket-terms-aggregation.html type TermsAggregation struct { field string script string scriptFile string lang string params map[string]interface{} subAggregations map[string]Aggregation size *int shardSize *int requiredSize *int minDocCount *int shardMinDocCount *int valueType string order string orderAsc bool includePattern string includeFlags *int excludePattern string excludeFlags *int executionHint string collectionMode string showTermDocCountError *bool includeTerms []string excludeTerms []string } func NewTermsAggregation() TermsAggregation { a := TermsAggregation{ params: make(map[string]interface{}), subAggregations: make(map[string]Aggregation, 0), includeTerms: make([]string, 0), excludeTerms: make([]string, 0), } return a } func (a TermsAggregation) Field(field string) TermsAggregation { a.field = field return a } func (a TermsAggregation) Script(script string) TermsAggregation { a.script = script return a } func (a TermsAggregation) ScriptFile(scriptFile string) TermsAggregation { a.scriptFile = scriptFile return a } func (a TermsAggregation) Lang(lang string) TermsAggregation { a.lang = lang return a } func (a TermsAggregation) Param(name string, value interface{}) TermsAggregation { a.params[name] = value return a } func (a TermsAggregation) SubAggregation(name string, subAggregation Aggregation) TermsAggregation { a.subAggregations[name] = subAggregation return a } func (a TermsAggregation) Size(size int) TermsAggregation { a.size = &size return a } func (a TermsAggregation) RequiredSize(requiredSize int) TermsAggregation { a.requiredSize = &requiredSize return a } func (a TermsAggregation) ShardSize(shardSize int) TermsAggregation { a.shardSize = &shardSize return a } func (a TermsAggregation) MinDocCount(minDocCount int) TermsAggregation { a.minDocCount = &minDocCount return a } func (a TermsAggregation) ShardMinDocCount(shardMinDocCount int) TermsAggregation { a.shardMinDocCount = &shardMinDocCount return a } func (a TermsAggregation) Include(regexp string) TermsAggregation { a.includePattern = regexp return a } func (a TermsAggregation) IncludeWithFlags(regexp string, flags int) TermsAggregation { a.includePattern = regexp a.includeFlags = &flags return a } func (a TermsAggregation) Exclude(regexp string) TermsAggregation { a.excludePattern = regexp return a } func (a TermsAggregation) ExcludeWithFlags(regexp string, flags int) TermsAggregation { a.excludePattern = regexp a.excludeFlags = &flags return a } // ValueType can be string, long, or double. func (a TermsAggregation) ValueType(valueType string) TermsAggregation { a.valueType = valueType return a } func (a TermsAggregation) Order(order string, asc bool) TermsAggregation { a.order = order a.orderAsc = asc return a } func (a TermsAggregation) OrderByCount(asc bool) TermsAggregation { // "order" : { "_count" : "asc" } a.order = "_count" a.orderAsc = asc return a } func (a TermsAggregation) OrderByCountAsc() TermsAggregation { return a.OrderByCount(true) } func (a TermsAggregation) OrderByCountDesc() TermsAggregation { return a.OrderByCount(false) } func (a TermsAggregation) OrderByTerm(asc bool) TermsAggregation { // "order" : { "_term" : "asc" } a.order = "_term" a.orderAsc = asc return a } func (a TermsAggregation) OrderByTermAsc() TermsAggregation { return a.OrderByTerm(true) } func (a TermsAggregation) OrderByTermDesc() TermsAggregation { return a.OrderByTerm(false) } // OrderByAggregation creates a bucket ordering strategy which sorts buckets // based on a single-valued calc get. func (a TermsAggregation) OrderByAggregation(aggName string, asc bool) TermsAggregation { // { // "aggs" : { // "genders" : { // "terms" : { // "field" : "gender", // "order" : { "avg_height" : "desc" } // }, // "aggs" : { // "avg_height" : { "avg" : { "field" : "height" } } // } // } // } // } a.order = aggName a.orderAsc = asc return a } // OrderByAggregationAndMetric creates a bucket ordering strategy which // sorts buckets based on a multi-valued calc get. func (a TermsAggregation) OrderByAggregationAndMetric(aggName, metric string, asc bool) TermsAggregation { // { // "aggs" : { // "genders" : { // "terms" : { // "field" : "gender", // "order" : { "height_stats.avg" : "desc" } // }, // "aggs" : { // "height_stats" : { "stats" : { "field" : "height" } } // } // } // } // } a.order = aggName + "." + metric a.orderAsc = asc return a } func (a TermsAggregation) ExecutionHint(hint string) TermsAggregation { a.executionHint = hint return a } // Collection mode can be depth_first or breadth_first as of 1.4.0. func (a TermsAggregation) CollectionMode(collectionMode string) TermsAggregation { a.collectionMode = collectionMode return a } func (a TermsAggregation) ShowTermDocCountError(showTermDocCountError bool) TermsAggregation { a.showTermDocCountError = &showTermDocCountError return a } func (a TermsAggregation) IncludeTerms(terms ...string) TermsAggregation { a.includeTerms = append(a.includeTerms, terms...) return a } func (a TermsAggregation) ExcludeTerms(terms ...string) TermsAggregation { a.excludeTerms = append(a.excludeTerms, terms...) return a } func (a TermsAggregation) Source() interface{} { // Example: // { // "aggs" : { // "genders" : { // "terms" : { "field" : "gender" } // } // } // } // This method returns only the { "terms" : { "field" : "gender" } } part. source := make(map[string]interface{}) opts := make(map[string]interface{}) source["terms"] = opts // ValuesSourceAggregationBuilder if a.field != "" { opts["field"] = a.field } if a.script != "" { opts["script"] = a.script } if a.scriptFile != "" { opts["script_file"] = a.scriptFile } if a.lang != "" { opts["lang"] = a.lang } if len(a.params) > 0 { opts["params"] = a.params } // AggregationBuilder (SubAggregations) if len(a.subAggregations) > 0 { aggsMap := make(map[string]interface{}) source["aggregations"] = aggsMap for name, aggregate := range a.subAggregations { aggsMap[name] = aggregate.Source() } } // TermsBuilder if a.size != nil && *a.size >= 0 { opts["size"] = *a.size } if a.shardSize != nil && *a.shardSize >= 0 { opts["shard_size"] = *a.shardSize } if a.requiredSize != nil && *a.requiredSize >= 0 { opts["required_size"] = *a.requiredSize } if a.minDocCount != nil && *a.minDocCount >= 0 { opts["min_doc_count"] = *a.minDocCount } if a.shardMinDocCount != nil && *a.shardMinDocCount >= 0 { opts["shard_min_doc_count"] = *a.shardMinDocCount } if a.showTermDocCountError != nil { opts["show_term_doc_count_error"] = *a.showTermDocCountError } if a.collectionMode != "" { opts["collect_mode"] = a.collectionMode } if a.valueType != "" { opts["value_type"] = a.valueType } if a.order != "" { o := make(map[string]interface{}) if a.orderAsc { o[a.order] = "asc" } else { o[a.order] = "desc" } opts["order"] = o } if len(a.includeTerms) > 0 { opts["include"] = a.includeTerms } if a.includePattern != "" { if a.includeFlags == nil || *a.includeFlags == 0 { opts["include"] = a.includePattern } else { p := make(map[string]interface{}) p["pattern"] = a.includePattern p["flags"] = *a.includeFlags opts["include"] = p } } if len(a.excludeTerms) > 0 { opts["exclude"] = a.excludeTerms } if a.excludePattern != "" { if a.excludeFlags == nil || *a.excludeFlags == 0 { opts["exclude"] = a.excludePattern } else { p := make(map[string]interface{}) p["pattern"] = a.excludePattern p["flags"] = *a.excludeFlags opts["exclude"] = p } } if a.executionHint != "" { opts["execution_hint"] = a.executionHint } return source }