You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Breaking changes can impact your Elastic applications, potentially disrupting normal operations. Before you upgrade, carefully review the Elasticsearch .NET Client breaking changes and take the necessary steps to mitigate any issues. To learn how to upgrade, check [Upgrade](docs-content://deploy-manage/upgrade.md).
9
10
10
-
% ## Next version [elasticsearch-nett-client-nextversion-breaking-changes]
11
+
% ## Next version [elasticsearch-net-client-nextversion-breaking-changes]
11
12
12
13
% ::::{dropdown} Title of breaking change
14
+
%
15
+
% **Impact**: High/Low.
16
+
%
13
17
% Description of the breaking change.
14
18
% For more information, check [PR #](PR link).
15
-
% **Impact**<br> Impact of the breaking change.
16
-
% **Action**<br> Steps for mitigating deprecation impact.
Container types now use regular properties for their variants instead of static factory methods ([read more](index.md#7-improved-container-design)).
44
+
45
+
This change primarily affects the `Query` and `Aggregation` types.
46
+
47
+
```csharp
48
+
// 8.x
49
+
newSearchRequest
50
+
{
51
+
Query=Query.MatchAll(
52
+
newMatchAllQuery
53
+
{
54
+
}
55
+
)
56
+
};
57
+
58
+
// 9.0
59
+
newSearchRequest
60
+
{
61
+
Query=newQuery
62
+
{
63
+
MatchAll=newMatchAllQuery
64
+
{
65
+
}
66
+
}
67
+
};
68
+
```
69
+
70
+
#### 2. Removal of certain generic request descriptors
71
+
72
+
**Impact**: High.
73
+
74
+
Removed the generic version of some request descriptors for which the corresponding requests do not contain inferrable properties.
75
+
76
+
These descriptors were generated unintentionally.
77
+
78
+
When migrating, the generic type parameter must be removed from the type, e.g., `AsyncSearchStatusRequestDescriptor<TDocument>` should become just `AsyncSearchStatusRequestDescriptor`.
Replaced by `ExtendedBounds<T>`, `ExtendedBoundsOfFieldDateMathDescriptor`, and `ExtendedBoundsOfDoubleDescriptor`.
175
+
176
+
#### 6. `Field.Format`
177
+
178
+
**Impact**: Low.
179
+
180
+
Removed `Field.Format` property and corresponding constructor and inferrer overloads.
181
+
182
+
This property has not been used for some time (replaced by the `FieldAndFormat` type).
183
+
184
+
#### 7. `Field`/`Fields` semantics
185
+
186
+
**Impact**: Low.
187
+
188
+
`Field`/`Fields` static factory methods and conversion operators no longer return nullable references but throw exceptions instead (`Field`) if the input `string`/`Expression`/`PropertyInfo` argument is `null`.
189
+
190
+
This makes implicit conversions to `Field` more user-friendly without requiring the null-forgiveness operator (`!`) ([read more](index.md#field-name-inference)).
191
+
192
+
#### 8. `FieldValue`
193
+
194
+
**Impact**: Low.
195
+
196
+
Removed `FieldValue.IsLazyDocument`, `FieldValue.IsComposite`, and the corresponding members in the `FieldValue.ValueKind` enum.
197
+
198
+
These values have not been used for some time.
199
+
200
+
#### 9. `FieldSort`
201
+
202
+
**Impact**: Low.
203
+
204
+
Removed static `FieldSort.Empty` member.
205
+
206
+
Sorting got reworked which makes this member obsolete ([read more](index.md#sorting)).
207
+
208
+
#### 10. Descriptor types `class` -> `struct`
209
+
210
+
**Impact**: Low.
211
+
212
+
All descriptor types are now implemented as `struct` instead of `class`.
0 commit comments