Docs: ESQL doesn't preserve nulls in a list (#114335) (#114338)

* 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

* Update

Author: nik9000

docs/reference/esql/multivalued-fields.asciidoc

@@ -166,6 +166,35 @@ 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]
+----
+{
+  "columns": [
+    { "name": "a", "type": "long"},
+  ],
+  "values": [
+    [[1, 2]],
+  ]
+}
+----
+
 [discrete]
 [[esql-multivalued-fields-functions]]
 ==== Functions