Преглед на файлове

Docs: ESQL doesn't preserve `null`s in a list (#114335) (#114339)

The doc values don't preserve `null`s in a list so ESQL doesn't either.

Closes #114324
Nik Everett преди 1 година
родител
ревизия
a9d2aec73e
променени са 1 файла, в които са добавени 31 реда и са изтрити 0 реда
  1. 31 0
      docs/reference/esql/multivalued-fields.asciidoc

+ 31 - 0
docs/reference/esql/multivalued-fields.asciidoc

@@ -177,6 +177,37 @@ POST /_query
 ----
 // TESTRESPONSE[s/"took": 28/"took": "$body.took"/]
 
+[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