From 858c1f01b6581d1eeee6f54a17650e433937532c Mon Sep 17 00:00:00 2001 From: Nik Everett Date: Tue, 8 Oct 2024 12:17:56 -0400 Subject: [PATCH 1/2] Docs: ESQL doesn't preserve `null`s in a list (#114335) The doc values don't preserve `null`s in a list so ESQL doesn't either. Closes #114324 --- .../esql/multivalued-fields.asciidoc | 31 +++++++++++++++++++ 1 file changed, 31 insertions(+) diff --git a/docs/reference/esql/multivalued-fields.asciidoc b/docs/reference/esql/multivalued-fields.asciidoc index 8ff645bba863e..c6c299241a52c 100644 --- a/docs/reference/esql/multivalued-fields.asciidoc +++ b/docs/reference/esql/multivalued-fields.asciidoc @@ -166,6 +166,37 @@ POST /_query } ---- +[discrete] +[[esql-multivalued-nulls]] +==== `null` in a list + +`null` values in a list are not preserved at the storage layer: + +[source,console,id=esql-multivalued-fields-multivalued-nulls] +---- +POST /mv/_doc?refresh +{ "a": [2, null, 1] } + +POST /_query +{ + "query": "FROM mv | LIMIT 1" +} +---- + +[source,console-result] +---- +{ + "took": 28, + "columns": [ + { "name": "a", "type": "long"}, + ], + "values": [ + [[1, 2]], + ] +} +---- +// TESTRESPONSE[s/"took": 28/"took": "$body.took"/] + [discrete] [[esql-multivalued-fields-functions]] ==== Functions From b8e36459014fc1a9c6ccd95a4eb5d833f324ea24 Mon Sep 17 00:00:00 2001 From: Nik Everett Date: Tue, 8 Oct 2024 13:34:25 -0400 Subject: [PATCH 2/2] Update --- docs/reference/esql/multivalued-fields.asciidoc | 2 -- 1 file changed, 2 deletions(-) diff --git a/docs/reference/esql/multivalued-fields.asciidoc b/docs/reference/esql/multivalued-fields.asciidoc index c6c299241a52c..00f441fcee0ff 100644 --- a/docs/reference/esql/multivalued-fields.asciidoc +++ b/docs/reference/esql/multivalued-fields.asciidoc @@ -186,7 +186,6 @@ POST /_query [source,console-result] ---- { - "took": 28, "columns": [ { "name": "a", "type": "long"}, ], @@ -195,7 +194,6 @@ POST /_query ] } ---- -// TESTRESPONSE[s/"took": 28/"took": "$body.took"/] [discrete] [[esql-multivalued-fields-functions]]