Skip to content

Commit 858c1f0

Browse files
committed
Docs: ESQL doesn't preserve nulls in a list (elastic#114335)
The doc values don't preserve `null`s in a list so ESQL doesn't either. Closes elastic#114324
1 parent 20d56d0 commit 858c1f0

File tree

1 file changed

+31
-0
lines changed

1 file changed

+31
-0
lines changed

docs/reference/esql/multivalued-fields.asciidoc

Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -166,6 +166,37 @@ POST /_query
166166
}
167167
----
168168

169+
[discrete]
170+
[[esql-multivalued-nulls]]
171+
==== `null` in a list
172+
173+
`null` values in a list are not preserved at the storage layer:
174+
175+
[source,console,id=esql-multivalued-fields-multivalued-nulls]
176+
----
177+
POST /mv/_doc?refresh
178+
{ "a": [2, null, 1] }
179+
180+
POST /_query
181+
{
182+
"query": "FROM mv | LIMIT 1"
183+
}
184+
----
185+
186+
[source,console-result]
187+
----
188+
{
189+
"took": 28,
190+
"columns": [
191+
{ "name": "a", "type": "long"},
192+
],
193+
"values": [
194+
[[1, 2]],
195+
]
196+
}
197+
----
198+
// TESTRESPONSE[s/"took": 28/"took": "$body.took"/]
199+
169200
[discrete]
170201
[[esql-multivalued-fields-functions]]
171202
==== Functions

0 commit comments

Comments
 (0)