From 60397d08e9916cdc9c9d794ee1e1f14c2e6a7dec Mon Sep 17 00:00:00 2001 From: Carlos Delgado <6339205+carlosdelest@users.noreply.github.com> Date: Mon, 20 Oct 2025 12:50:38 +0200 Subject: [PATCH] Update limitations on 'dense_vector' field type support Clarify the support status of the 'dense_vector' field type in ESQL queries. --- docs/reference/query-languages/esql/limitations.md | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/docs/reference/query-languages/esql/limitations.md b/docs/reference/query-languages/esql/limitations.md index c4ad16f3d0e29..c098dbaff985e 100644 --- a/docs/reference/query-languages/esql/limitations.md +++ b/docs/reference/query-languages/esql/limitations.md @@ -67,7 +67,6 @@ By default, an {{esql}} query returns up to 1,000 rows. You can increase the num * `binary` * `completion` - * `dense_vector` * `double_range` * `flattened` * `float_range` @@ -98,6 +97,10 @@ Some [field types](/reference/elasticsearch/mapping-reference/field-data-types.m In addition, when [querying multiple indexes](/reference/query-languages/esql/esql-multi-index.md), it’s possible for the same field to be mapped to multiple types. These fields cannot be directly used in queries or returned in results, unless they’re [explicitly converted to a single type](/reference/query-languages/esql/esql-multi-index.md#esql-multi-index-union-types). +* `dense_vector` field type is partially supported. [`KNN` function](elasticsearch://reference/query-languages/esql/functions-operators/dense-vector-functions.md#esql-knn) queries will work and any field data will be retrieved as part of the results. However, the type will appear as `unsupported` when the `KNN` function is not used. + +This means that `FROM test` will not retrieve `dense_vector` data. But, `FROM test WHERE KNN("dense_vector_field", [0, 1, 2, ...])` will retrieve data. + ## _source availability [esql-_source-availability]