9.1.8

What's Changed

• Regenerate client by @flobernd in #8707
• Regenerate client by @flobernd in #8711
  • Improves usability of CompositeAggregation (see #8704)

Breaking Changes

The type of the Sources property has been changed from ICollection<IDictionary<string, CompositeAggregationSource>> to ICollection<KeyValuePair<string, CompositeAggregationSource>>. This corresponds to the Elasticsearch standard for modeling ordered dictionaries in the REST API.

CompositeAggregationSource is now also a container (similar to Aggregation, Query, etc.). This change improves usability due to specialized code generation. For example, implicit conversion operators from all existing variants (CompositeTermsAggregation, CompositeHistogramAggregation, etc.) to CompositeAggregationSource are now generated.

As a consequence, the object initializer syntax changes as follows:

// 9.1.7 and below

var request = new SearchRequest
{
    Aggregations = new Dictionary<string, Aggregation>
    {
        { "my_composite", new CompositeAggregation
        {
            Sources =
            [
                new Dictionary<string, CompositeAggregationSource>
                {
                    { "my_terms", new CompositeAggregationSource
                    {
                        Terms = new CompositeTermsAggregation
                        {
                            // ...
                        }
                    }}
                },
                new Dictionary<string, CompositeAggregationSource>
                {
                    { "my_histo", new CompositeAggregationSource
                    {
                        Histogram = new CompositeHistogramAggregation(0.5)
                        {
                            // ...
                        }
                    }}
                }
            ]
        }}
    }
};

// 9.1.8 and above

var request = new SearchRequest
{
    Aggregations = new Dictionary<string, Aggregation>
    {
        { "my_composite", new CompositeAggregation
        {
            Sources =
            [
                new KeyValuePair<string, CompositeAggregationSource>(
                    "my_terms",
                    // Implicit conversion from `CompositeTermsAggregation` to `CompositeAggregationSource`.
                    new CompositeTermsAggregation
                    {
                        // ...
                    }
                ),
                new KeyValuePair<string, CompositeAggregationSource>(
                    "my_histo",
                    // Implicit conversion from `CompositeHistogramAggregation` to `CompositeAggregationSource`.
                    new CompositeHistogramAggregation(0.5) <2>
                    {
                        // ...
                    }
                )
            ]
        }}
    }
};

In addition, this change allows optimized Fluent syntax to be generated, which ultimately avoids a previously existing ambiguity:

// 9.1.7 and below

var descriptor = new SearchRequestDescriptor()
    .Aggregations(aggs => aggs
        .Add("my_composize", agg => agg
            .Composite(composite => composite
                // This is the `params` overload that initializes the `Sources` collection with multiple entries.
                .Sources(
                    // Add dictionary item 1 that contains a single `Terms` aggregation entry.
                    x => x.Add("my_terms", x => x.Terms(/* ... */)),
                    // Add dictionary item 2 that contains a single `Histogram` aggregation entry.
                    x => x.Add("my_histo", x => x.Histogram(/* ... */)) <3>
                )
            )
        )
    );

// 9.1.8 and above

var descriptor = new SearchRequestDescriptor()
    .Aggregations(aggs => aggs
        .Add("my_composize", agg => agg
            .Composite(composite => composite
                .Sources(sources => sources
                    .Add("my_terms", x => x.Terms(/* ... */))
                    .Add("my_histo", x => x.Histogram(/* ... */))
                )
            )
        )
    );

The old syntax was tricky because the 9.1.8 example also compiled successfully, but the .Add referred to the first dictionary both times. This ultimately resulted in a list with only one dictionary, which had multiple entries, and thus an invalid request.

---

Full Changelog: 9.1.7...9.1.8

8.19.7

What's Changed

• Regenerate client by @flobernd in #8706
• Regenerate client by @flobernd in #8710
  • Improves usability of CompositeAggregation (see #8704)
• Regenerate client by @flobernd in #8715
  • Fixes (de-)serialization of TermQuery (see #8713)

Breaking Changes

See https://github.com/elastic/elasticsearch-net/releases/tag/9.1.8.

---

Full Changelog: 8.19.6...8.19.7

9.1.7

What's Changed

• BulkResponseItemConverter: Continue after skipping unmapped json member by @MindaugasButkus in #8698

New Contributors

• @MindaugasButkus made their first contribution in #8698

Full Changelog: 9.1.6...9.1.7

8.19.6

What's Changed

• BulkResponseItemConverter: Continue after skipping unmapped json member by @MindaugasButkus in #8698

New Contributors

• @MindaugasButkus made their first contribution in #8698

Full Changelog: 8.19.5...8.19.6

9.1.6

What's Changed

• Fix deserialization of Context by @flobernd in #8688

Full Changelog: 9.1.5...9.1.6

8.19.5

What's Changed

• Fix deserialization of Context by @flobernd in #8688

Full Changelog: 8.19.4...8.19.5

9.1.5

What's Changed

• Introduce RequestResponseConverter<T> and make all non-generated JsonConverters public by @flobernd in #8669
  • Greatly simplifies use of Elastic.Clients.Elasticsearch types in documents (e.g. for percolation; see #8003)
• Regenerate client by @flobernd in #8679
• Update Elastic.Transport to 0.10.1 by @flobernd in #8681
  • Fixes a race condition (see #8671)

Full Changelog: 9.1.4...9.1.5

8.19.4

What's Changed

• Introduce RequestResponseConverter<T> and make all non-generated JsonConverters public by @flobernd in #8669
  • Greatly simplifies use of Elastic.Clients.Elasticsearch types in documents (e.g. for percolation; see #8003)
• Regenerate client by @flobernd in #8679
• Update Elastic.Transport to 0.10.1 by @flobernd in #8681
  • Fixes a race condition (see #8671)

Full Changelog: 8.19.3...8.19.4

9.1.4

What's Changed

• More AOT annotations by @Mpdreamz in #8661
• Regenerate client by @flobernd in #8668
  • Fixes deserialization of PercentilesItem (#8570)

Full Changelog: 9.1.3...9.1.4

8.19.3

What's Changed

• More AOT annotations by @Mpdreamz in #8661
• Regenerate client by @flobernd in #8668
  • Fixes deserialization of PercentilesItem (#8570)

Full Changelog: 8.19.2...8.19.3