WARNING: Version 5.x has passed its EOL date.
This documentation is no longer being maintained and may be removed. If you are running this version, we strongly advise you to upgrade. For the latest information, see the current release documentation.
Terms Aggregation Usageedit
A multi-bucket value source based aggregation where buckets are dynamically built - one per unique value.
See the Elasticsearch documentation on terms aggregation for more detail.
Fluent DSL exampleedit
s => s
.Aggregations(a => a
.Terms("states", st => st
.Field(p => p.State)
.MinimumDocumentCount(2)
.Size(5)
.ShardSize(100)
.ShowTermDocumentCountError()
.ExecutionHint(TermsAggregationExecutionHint.Map)
.Missing("n/a")
.Script("'State of Being: '+_value")
.Order(TermsOrder.TermAscending)
.Order(TermsOrder.CountDescending)
.Meta(m => m
.Add("foo", "bar")
)
)
)
Object Initializer syntax exampleedit
new SearchRequest<Project>
{
Aggregations = new TermsAggregation("states")
{
Field = Field<Project>(p => p.State),
MinimumDocumentCount = 2,
Size = 5,
ShardSize = 100,
ShowTermDocumentCountError = true,
ExecutionHint = TermsAggregationExecutionHint.Map,
Missing = "n/a",
Script = new InlineScript("'State of Being: '+_value"),
Order = new List<TermsOrder>
{
TermsOrder.TermAscending,
TermsOrder.CountDescending
},
Meta = new Dictionary<string, object>
{
{ "foo", "bar" }
}
}
}
Example json output.
{
"aggs": {
"states": {
"meta": {
"foo": "bar"
},
"terms": {
"field": "state",
"min_doc_count": 2,
"size": 5,
"shard_size": 100,
"show_term_doc_error_count": true,
"execution_hint": "map",
"missing": "n/a",
"script": {
"inline": "'State of Being: '+_value"
},
"order": [
{
"_term": "asc"
},
{
"_count": "desc"
}
]
}
}
}
}
Handling Responsesedit
response.IsValid.Should().BeTrue();
var states = response.Aggs.Terms("states");
states.Should().NotBeNull();
states.DocCountErrorUpperBound.Should().HaveValue();
states.SumOtherDocCount.Should().HaveValue();
foreach (var item in states.Buckets)
{
item.Key.Should().NotBeNullOrEmpty();
item.DocCount.Should().BeGreaterOrEqualTo(1);
}
states.Meta.Should().NotBeNull().And.HaveCount(1);
states.Meta["foo"].Should().Be("bar");
Filtering with exact valuesedit
Using terms aggregation with filtering to include only specific values
Fluent DSL exampleedit
s => s
.Size(0)
.Aggregations(a => a
.Terms("states", st => st
.Field(p => p.State.Suffix("raw"))
.MinimumDocumentCount(2)
.Size(5)
.ShardSize(100)
.ExecutionHint(TermsAggregationExecutionHint.Map)
.Missing("n/a")
.Include(new [] { StateOfBeing.Stable.ToString(), StateOfBeing.VeryActive.ToString() })
.Order(TermsOrder.TermAscending)
.Order(TermsOrder.CountDescending)
.Meta(m => m
.Add("foo", "bar")
)
)
)
Object Initializer syntax exampleedit
new SearchRequest<Project>
{
Size = 0,
Aggregations = new TermsAggregation("states")
{
Field = Field<Project>(p => p.State.Suffix("raw")),
MinimumDocumentCount = 2,
Size = 5,
ShardSize = 100,
ExecutionHint = TermsAggregationExecutionHint.Map,
Missing = "n/a",
Include = new TermsIncludeExclude { Values = new[] { StateOfBeing.Stable.ToString(), StateOfBeing.VeryActive.ToString() } },
Order = new List<TermsOrder>
{
TermsOrder.TermAscending,
TermsOrder.CountDescending
},
Meta = new Dictionary<string, object>
{
{ "foo", "bar" }
}
}
}
Example json output.
{
"size": 0,
"aggs": {
"states": {
"meta": {
"foo": "bar"
},
"terms": {
"field": "state.raw",
"min_doc_count": 2,
"size": 5,
"shard_size": 100,
"execution_hint": "map",
"missing": "n/a",
"include": [
"Stable",
"VeryActive"
],
"order": [
{
"_term": "asc"
},
{
"_count": "desc"
}
]
}
}
}
}
Handling Responsesedit
response.IsValid.Should().BeTrue();
var states = response.Aggs.Terms("states");
states.Should().NotBeNull();
states.DocCountErrorUpperBound.Should().HaveValue();
states.SumOtherDocCount.Should().HaveValue();
states.Buckets.Should().NotBeNull();
states.Buckets.Count.Should().BeGreaterThan(0);
foreach (var item in states.Buckets)
{
item.Key.Should().NotBeNullOrEmpty();
item.DocCount.Should().BeGreaterOrEqualTo(1);
}
states.Meta.Should().NotBeNull().And.HaveCount(1);
states.Meta["foo"].Should().Be("bar");
Filtering with a regular expression patternedit
Using terms aggregation with filtering to include values using a regular expression pattern
Fluent DSL exampleedit
s => s
.Size(0)
.Aggregations(a => a
.Terms("states", st => st
.Field(p => p.State.Suffix("raw"))
.MinimumDocumentCount(2)
.Size(5)
.ShardSize(100)
.ExecutionHint(TermsAggregationExecutionHint.Map)
.Missing("n/a")
.Include("(Stable|VeryActive)")
.Order(TermsOrder.TermAscending)
.Order(TermsOrder.CountDescending)
.Meta(m => m
.Add("foo", "bar")
)
)
)
Object Initializer syntax exampleedit
new SearchRequest<Project>
{
Size = 0,
Aggregations = new TermsAggregation("states")
{
Field = Field<Project>(p => p.State.Suffix("raw")),
MinimumDocumentCount = 2,
Size = 5,
ShardSize = 100,
ExecutionHint = TermsAggregationExecutionHint.Map,
Missing = "n/a",
Include = new TermsIncludeExclude { Pattern = "(Stable|VeryActive)" },
Order = new List<TermsOrder>
{
TermsOrder.TermAscending,
TermsOrder.CountDescending
},
Meta = new Dictionary<string, object>
{
{ "foo", "bar" }
}
}
}
Example json output.
{
"size": 0,
"aggs": {
"states": {
"meta": {
"foo": "bar"
},
"terms": {
"field": "state.raw",
"min_doc_count": 2,
"size": 5,
"shard_size": 100,
"execution_hint": "map",
"missing": "n/a",
"include": "(Stable|VeryActive)",
"order": [
{
"_term": "asc"
},
{
"_count": "desc"
}
]
}
}
}
}
Handling Responsesedit
response.IsValid.Should().BeTrue();
var states = response.Aggs.Terms("states");
states.Should().NotBeNull();
states.DocCountErrorUpperBound.Should().HaveValue();
states.SumOtherDocCount.Should().HaveValue();
states.Buckets.Should().NotBeNull();
states.Buckets.Count.Should().BeGreaterThan(0);
foreach (var item in states.Buckets)
{
item.Key.Should().NotBeNullOrEmpty();
item.DocCount.Should().BeGreaterOrEqualTo(1);
}
states.Meta.Should().NotBeNull().And.HaveCount(1);
states.Meta["foo"].Should().Be("bar");