From d677c22b410c3a5215265187cb782875f5083650 Mon Sep 17 00:00:00 2001 From: Alexander Spies Date: Fri, 7 Nov 2025 14:00:12 +0100 Subject: [PATCH 1/8] Update docs for new types aggregate_metric_double and dense_vector --- .../lists/type-conversion-functions.md | 2 ++ .../type-conversion-functions.md | 6 +++++ .../query-languages/esql/limitations.md | 24 ++++++++++--------- 3 files changed, 21 insertions(+), 11 deletions(-) diff --git a/docs/reference/query-languages/esql/_snippets/lists/type-conversion-functions.md b/docs/reference/query-languages/esql/_snippets/lists/type-conversion-functions.md index 3cfe7e8d0b96c..5efefef110fbf 100644 --- a/docs/reference/query-languages/esql/_snippets/lists/type-conversion-functions.md +++ b/docs/reference/query-languages/esql/_snippets/lists/type-conversion-functions.md @@ -1,3 +1,4 @@ +* [`TO_AGGREGATE_METRIC_DOUBLE`](../../functions-operators/type-conversion-functions.md#esql-to_aggregate_metric_double) * [`TO_BOOLEAN`](../../functions-operators/type-conversion-functions.md#esql-to_boolean) * [`TO_CARTESIANPOINT`](../../functions-operators/type-conversion-functions.md#esql-to_cartesianpoint) * [`TO_CARTESIANSHAPE`](../../functions-operators/type-conversion-functions.md#esql-to_cartesianshape) @@ -5,6 +6,7 @@ * [`TO_DATETIME`](../../functions-operators/type-conversion-functions.md#esql-to_datetime) * [`TO_DATE_NANOS`](../../functions-operators/type-conversion-functions.md#esql-to_date_nanos) * [`TO_DEGREES`](../../functions-operators/type-conversion-functions.md#esql-to_degrees) +* [`TO_DENSE_VECTOR`](../../functions-operators/type-conversion-functions.md#esql-to_dense_vector) * [`TO_DOUBLE`](../../functions-operators/type-conversion-functions.md#esql-to_double) * [`TO_GEOHASH`](../../functions-operators/type-conversion-functions.md#esql-to_geohash) {applies_to}`stack: preview` {applies_to}`serverless: preview` * [`TO_GEOHEX`](../../functions-operators/type-conversion-functions.md#esql-to_geohex) {applies_to}`stack: preview` {applies_to}`serverless: preview` diff --git a/docs/reference/query-languages/esql/functions-operators/type-conversion-functions.md b/docs/reference/query-languages/esql/functions-operators/type-conversion-functions.md index 4d635241d4e26..e0cfbd0c25181 100644 --- a/docs/reference/query-languages/esql/functions-operators/type-conversion-functions.md +++ b/docs/reference/query-languages/esql/functions-operators/type-conversion-functions.md @@ -22,6 +22,9 @@ mapped_pages: ::: +:::{include} ../_snippets/functions/layout/to_aggregate_metric_double.md +::: + :::{include} ../_snippets/functions/layout/to_boolean.md ::: @@ -43,6 +46,9 @@ mapped_pages: :::{include} ../_snippets/functions/layout/to_degrees.md ::: +:::{include} ../_snippets/functions/layout/to_dense_vector.md +::: + :::{include} ../_snippets/functions/layout/to_double.md ::: diff --git a/docs/reference/query-languages/esql/limitations.md b/docs/reference/query-languages/esql/limitations.md index 412a253638b86..dde408936df8b 100644 --- a/docs/reference/query-languages/esql/limitations.md +++ b/docs/reference/query-languages/esql/limitations.md @@ -32,13 +32,14 @@ By default, an {{esql}} query returns up to 1,000 rows. You can increase the num * You can use `to_datetime` to cast to millisecond dates to use unsupported functions * `double` (`float`, `half_float`, `scaled_float` are represented as `double`) +* `dense_vector` {applies_to}`stack: preview 9.2` {applies_to}`serverless: preview` * `ip` * `keyword` [family](/reference/elasticsearch/mapping-reference/keyword.md) including `keyword`, `constant_keyword`, and `wildcard` * `int` (`short` and `byte` are represented as `int`) * `long` * `null` * `text` [family](/reference/elasticsearch/mapping-reference/text.md) including `text`, `semantic_text` and `match_only_text` -* {applies_to}`stack: preview` {applies_to}`serverless: preview` `unsigned_long` +* `unsigned_long` {applies_to}`stack: preview` {applies_to}`serverless: preview` * `version` * Spatial types @@ -46,26 +47,26 @@ By default, an {{esql}} query returns up to 1,000 rows. You can increase the num * `geo_shape` * `point` * `shape` -* TSDB metrics {preview}`9.2` - * `counter` - * `gauge` +* TSDB metrics {applies_to}`stack: preview 9.2` {applies_to}`serverless: preview` + * `counter` + * `gauge` * `aggregate_metric_double` - ### Unsupported types [_unsupported_types] {{esql}} does not yet support the following field types: ::::{tab-set} :::{tab-item} 9.0-9.1 -* TSDB metrics - * `counter` - * `gauge` + `dense_vector` + metrics + * `counter` + * `gauge` * `aggregate_metric_double` ::: :::{tab-item} 9.2+ -This limitation no longer exists and TSDB metrics are now supported (preview). +This limitation no longer exists and TSDB metrics and `dense_vector` are now supported (preview). ::: :::: * Date/time @@ -106,9 +107,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. +* {applies_to}`stack: 9.2.0` `dense_vector` field type is only partially supported on this patch version (fixed in {applies_to}`stac: 9.2.1`). [`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. +* {applies_to}`stack: 9.2.0` `aggregate_metric_double` field type is only partially supported on this patch version (fixed in {applies_to}`stac: 9.2.1`). Using the [`TO_AGGREGATE_METRIC_DOUBLE` function](elasticsearch://reference/query-languages/esql/functions-operators/dense-vector-functions.md#esql-knn) will work and any field data will be retrieved as part of the results. However, the type will appear as `unsupported` if this 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. +This means that `FROM test` will not retrieve `dense_vector` or `aggregate_metric_double` data. But, `FROM test WHERE KNN("dense_vector_field", [0, 1, 2, ...])` or `FROM test | EVAL agm_data = TO_AGGREGATE_METRIC_DOUBLE(aggregate_metric_double_field)` will. ## _source availability [esql-_source-availability] From 2c954567d0f4121b94a6b950da732fab71cb4b49 Mon Sep 17 00:00:00 2001 From: Alexander Spies Date: Fri, 7 Nov 2025 14:09:05 +0100 Subject: [PATCH 2/8] Fix typos --- docs/reference/query-languages/esql/limitations.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/reference/query-languages/esql/limitations.md b/docs/reference/query-languages/esql/limitations.md index dde408936df8b..2521a49b12dde 100644 --- a/docs/reference/query-languages/esql/limitations.md +++ b/docs/reference/query-languages/esql/limitations.md @@ -107,8 +107,8 @@ 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). -* {applies_to}`stack: 9.2.0` `dense_vector` field type is only partially supported on this patch version (fixed in {applies_to}`stac: 9.2.1`). [`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. -* {applies_to}`stack: 9.2.0` `aggregate_metric_double` field type is only partially supported on this patch version (fixed in {applies_to}`stac: 9.2.1`). Using the [`TO_AGGREGATE_METRIC_DOUBLE` function](elasticsearch://reference/query-languages/esql/functions-operators/dense-vector-functions.md#esql-knn) will work and any field data will be retrieved as part of the results. However, the type will appear as `unsupported` if this function is not used. +* {applies_to}`stack: 9.2.0` `dense_vector` field type is only partially supported on this patch version (fixed in {applies_to}`stack: 9.2.1`). [`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. +* {applies_to}`stack: 9.2.0` `aggregate_metric_double` field type is only partially supported on this patch version (fixed in {applies_to}`stack: 9.2.1`). Using the [`TO_AGGREGATE_METRIC_DOUBLE` function](elasticsearch://reference/query-languages/esql/functions-operators/dense-vector-functions.md#esql-knn) will work and any field data will be retrieved as part of the results. However, the type will appear as `unsupported` if this function is not used. This means that `FROM test` will not retrieve `dense_vector` or `aggregate_metric_double` data. But, `FROM test WHERE KNN("dense_vector_field", [0, 1, 2, ...])` or `FROM test | EVAL agm_data = TO_AGGREGATE_METRIC_DOUBLE(aggregate_metric_double_field)` will. From 9e35b877be8aae327bfb4105475215467d7197b6 Mon Sep 17 00:00:00 2001 From: Alexander Spies Date: Fri, 7 Nov 2025 14:15:12 +0100 Subject: [PATCH 3/8] Try to fix applies_to markers --- docs/reference/query-languages/esql/limitations.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/reference/query-languages/esql/limitations.md b/docs/reference/query-languages/esql/limitations.md index 2521a49b12dde..a1ab6d3b68ebb 100644 --- a/docs/reference/query-languages/esql/limitations.md +++ b/docs/reference/query-languages/esql/limitations.md @@ -107,8 +107,8 @@ 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). -* {applies_to}`stack: 9.2.0` `dense_vector` field type is only partially supported on this patch version (fixed in {applies_to}`stack: 9.2.1`). [`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. -* {applies_to}`stack: 9.2.0` `aggregate_metric_double` field type is only partially supported on this patch version (fixed in {applies_to}`stack: 9.2.1`). Using the [`TO_AGGREGATE_METRIC_DOUBLE` function](elasticsearch://reference/query-languages/esql/functions-operators/dense-vector-functions.md#esql-knn) will work and any field data will be retrieved as part of the results. However, the type will appear as `unsupported` if this function is not used. +* {applies_to}`stack: preview 9.2.0` `dense_vector` field type is only partially supported on this patch version (fixed in {applies_to}`stack: preview 9.2.1`). [`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. +* {applies_to}`stack: preview 9.2.0` `aggregate_metric_double` field type is only partially supported on this patch version (fixed in {applies_to}`stack: preview 9.2.1`). Using the [`TO_AGGREGATE_METRIC_DOUBLE` function](elasticsearch://reference/query-languages/esql/functions-operators/dense-vector-functions.md#esql-knn) will work and any field data will be retrieved as part of the results. However, the type will appear as `unsupported` if this function is not used. This means that `FROM test` will not retrieve `dense_vector` or `aggregate_metric_double` data. But, `FROM test WHERE KNN("dense_vector_field", [0, 1, 2, ...])` or `FROM test | EVAL agm_data = TO_AGGREGATE_METRIC_DOUBLE(aggregate_metric_double_field)` will. From b95d95925e75b992af7164add2e19bcb4d3d723b Mon Sep 17 00:00:00 2001 From: Alexander Spies Date: Fri, 7 Nov 2025 14:42:04 +0100 Subject: [PATCH 4/8] Fixes --- docs/reference/query-languages/esql/limitations.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/reference/query-languages/esql/limitations.md b/docs/reference/query-languages/esql/limitations.md index a1ab6d3b68ebb..de466bbd744a3 100644 --- a/docs/reference/query-languages/esql/limitations.md +++ b/docs/reference/query-languages/esql/limitations.md @@ -59,8 +59,8 @@ By default, an {{esql}} query returns up to 1,000 rows. You can increase the num ::::{tab-set} :::{tab-item} 9.0-9.1 - `dense_vector` - metrics +* `dense_vector` +* TSDB metrics * `counter` * `gauge` * `aggregate_metric_double` @@ -108,7 +108,7 @@ 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). * {applies_to}`stack: preview 9.2.0` `dense_vector` field type is only partially supported on this patch version (fixed in {applies_to}`stack: preview 9.2.1`). [`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. -* {applies_to}`stack: preview 9.2.0` `aggregate_metric_double` field type is only partially supported on this patch version (fixed in {applies_to}`stack: preview 9.2.1`). Using the [`TO_AGGREGATE_METRIC_DOUBLE` function](elasticsearch://reference/query-languages/esql/functions-operators/dense-vector-functions.md#esql-knn) will work and any field data will be retrieved as part of the results. However, the type will appear as `unsupported` if this function is not used. +* {applies_to}`stack: preview 9.2.0` `aggregate_metric_double` field type is only partially supported on this patch version (fixed in {applies_to}`stack: preview 9.2.1`). Using the [`TO_AGGREGATE_METRIC_DOUBLE` function](elasticsearch://reference/query-languages/esql/functions-operators/type-conversion-functions#esql-to_aggregate_metric_double) will work and any field data will be retrieved as part of the results. However, the type will appear as `unsupported` if this function is not used. This means that `FROM test` will not retrieve `dense_vector` or `aggregate_metric_double` data. But, `FROM test WHERE KNN("dense_vector_field", [0, 1, 2, ...])` or `FROM test | EVAL agm_data = TO_AGGREGATE_METRIC_DOUBLE(aggregate_metric_double_field)` will. From 6087e15acbd915d54ce4c53e6210739df720dc9b Mon Sep 17 00:00:00 2001 From: Alexander Spies Date: Fri, 7 Nov 2025 14:45:30 +0100 Subject: [PATCH 5/8] Mark conversion functions as preview --- .../esql/_snippets/lists/type-conversion-functions.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/reference/query-languages/esql/_snippets/lists/type-conversion-functions.md b/docs/reference/query-languages/esql/_snippets/lists/type-conversion-functions.md index 5efefef110fbf..e2a76222a784a 100644 --- a/docs/reference/query-languages/esql/_snippets/lists/type-conversion-functions.md +++ b/docs/reference/query-languages/esql/_snippets/lists/type-conversion-functions.md @@ -1,4 +1,4 @@ -* [`TO_AGGREGATE_METRIC_DOUBLE`](../../functions-operators/type-conversion-functions.md#esql-to_aggregate_metric_double) +* [`TO_AGGREGATE_METRIC_DOUBLE`](../../functions-operators/type-conversion-functions.md#esql-to_aggregate_metric_double) {applies_to}`stack: preview 9.2` {applies_to}`serverless: preview` * [`TO_BOOLEAN`](../../functions-operators/type-conversion-functions.md#esql-to_boolean) * [`TO_CARTESIANPOINT`](../../functions-operators/type-conversion-functions.md#esql-to_cartesianpoint) * [`TO_CARTESIANSHAPE`](../../functions-operators/type-conversion-functions.md#esql-to_cartesianshape) @@ -6,7 +6,7 @@ * [`TO_DATETIME`](../../functions-operators/type-conversion-functions.md#esql-to_datetime) * [`TO_DATE_NANOS`](../../functions-operators/type-conversion-functions.md#esql-to_date_nanos) * [`TO_DEGREES`](../../functions-operators/type-conversion-functions.md#esql-to_degrees) -* [`TO_DENSE_VECTOR`](../../functions-operators/type-conversion-functions.md#esql-to_dense_vector) +* [`TO_DENSE_VECTOR`](../../functions-operators/type-conversion-functions.md#esql-to_dense_vector) {applies_to}`stack: preview 9.2` {applies_to}`serverless: preview` * [`TO_DOUBLE`](../../functions-operators/type-conversion-functions.md#esql-to_double) * [`TO_GEOHASH`](../../functions-operators/type-conversion-functions.md#esql-to_geohash) {applies_to}`stack: preview` {applies_to}`serverless: preview` * [`TO_GEOHEX`](../../functions-operators/type-conversion-functions.md#esql-to_geohex) {applies_to}`stack: preview` {applies_to}`serverless: preview` From 07ff28c5cd3c1dea5e55044484cb63ce062b8b60 Mon Sep 17 00:00:00 2001 From: Alexander Spies Date: Fri, 7 Nov 2025 14:47:16 +0100 Subject: [PATCH 6/8] Use consistent links --- docs/reference/query-languages/esql/limitations.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/reference/query-languages/esql/limitations.md b/docs/reference/query-languages/esql/limitations.md index de466bbd744a3..56d5de97c5d1d 100644 --- a/docs/reference/query-languages/esql/limitations.md +++ b/docs/reference/query-languages/esql/limitations.md @@ -108,7 +108,7 @@ 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). * {applies_to}`stack: preview 9.2.0` `dense_vector` field type is only partially supported on this patch version (fixed in {applies_to}`stack: preview 9.2.1`). [`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. -* {applies_to}`stack: preview 9.2.0` `aggregate_metric_double` field type is only partially supported on this patch version (fixed in {applies_to}`stack: preview 9.2.1`). Using the [`TO_AGGREGATE_METRIC_DOUBLE` function](elasticsearch://reference/query-languages/esql/functions-operators/type-conversion-functions#esql-to_aggregate_metric_double) will work and any field data will be retrieved as part of the results. However, the type will appear as `unsupported` if this function is not used. +* {applies_to}`stack: preview 9.2.0` `aggregate_metric_double` field type is only partially supported on this patch version (fixed in {applies_to}`stack: preview 9.2.1`). Using the [`TO_AGGREGATE_METRIC_DOUBLE` function](elasticsearch://reference/query-languages/esql/functions-operators/type-conversion-functions.md#esql-to_aggregate_metric_double) will work and any field data will be retrieved as part of the results. However, the type will appear as `unsupported` if this function is not used. This means that `FROM test` will not retrieve `dense_vector` or `aggregate_metric_double` data. But, `FROM test WHERE KNN("dense_vector_field", [0, 1, 2, ...])` or `FROM test | EVAL agm_data = TO_AGGREGATE_METRIC_DOUBLE(aggregate_metric_double_field)` will. From 7eb2043e7c1c3039400bd78e40de77098b4bd670 Mon Sep 17 00:00:00 2001 From: Alexander Spies Date: Fri, 7 Nov 2025 14:56:51 +0100 Subject: [PATCH 7/8] Mention TO_DENSE_VECTOR --- docs/reference/query-languages/esql/limitations.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/reference/query-languages/esql/limitations.md b/docs/reference/query-languages/esql/limitations.md index 56d5de97c5d1d..8b48f7199415a 100644 --- a/docs/reference/query-languages/esql/limitations.md +++ b/docs/reference/query-languages/esql/limitations.md @@ -107,7 +107,7 @@ 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). -* {applies_to}`stack: preview 9.2.0` `dense_vector` field type is only partially supported on this patch version (fixed in {applies_to}`stack: preview 9.2.1`). [`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. +* {applies_to}`stack: preview 9.2.0` `dense_vector` field type is only partially supported on this patch version (fixed in {applies_to}`stack: preview 9.2.1`). The [`KNN` function](elasticsearch://reference/query-languages/esql/functions-operators/dense-vector-functions.md#esql-knn) and the [`TO_DENSE_VECTOR` function](elasticsearch://reference/query-languages/esql/functions-operators/type-conversion-functions.md#esql-to_dense_vector) will work and any field data will be retrieved as part of the results. However, the type will appear as `unsupported` when these functions are not used. * {applies_to}`stack: preview 9.2.0` `aggregate_metric_double` field type is only partially supported on this patch version (fixed in {applies_to}`stack: preview 9.2.1`). Using the [`TO_AGGREGATE_METRIC_DOUBLE` function](elasticsearch://reference/query-languages/esql/functions-operators/type-conversion-functions.md#esql-to_aggregate_metric_double) will work and any field data will be retrieved as part of the results. However, the type will appear as `unsupported` if this function is not used. This means that `FROM test` will not retrieve `dense_vector` or `aggregate_metric_double` data. But, `FROM test WHERE KNN("dense_vector_field", [0, 1, 2, ...])` or `FROM test | EVAL agm_data = TO_AGGREGATE_METRIC_DOUBLE(aggregate_metric_double_field)` will. From f7d186b9fff1b5edc69e4dbaf6054aa486995e1d Mon Sep 17 00:00:00 2001 From: Liam Thompson Date: Fri, 7 Nov 2025 15:51:30 +0100 Subject: [PATCH 8/8] Refactor 9.2.0 type limitations and fix cross-repo links Grouped dense_vector and aggregate_metric_double limitations under single bullet with sub-bullets Added subheading "Partial support in 9.2.0" Fixed broken elasticsearch:// cross-repo links to /reference/ format Converted multi-index paragraph to bullet point Wrapped explanation in note block with bulleted examples --- docs/reference/query-languages/esql/limitations.md | 14 ++++++++++---- 1 file changed, 10 insertions(+), 4 deletions(-) diff --git a/docs/reference/query-languages/esql/limitations.md b/docs/reference/query-languages/esql/limitations.md index 8b48f7199415a..7d469e63897ff 100644 --- a/docs/reference/query-languages/esql/limitations.md +++ b/docs/reference/query-languages/esql/limitations.md @@ -105,13 +105,19 @@ Some [field types](/reference/elasticsearch/mapping-reference/field-data-types.m * `cartesian_shape` -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). +- 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). -* {applies_to}`stack: preview 9.2.0` `dense_vector` field type is only partially supported on this patch version (fixed in {applies_to}`stack: preview 9.2.1`). The [`KNN` function](elasticsearch://reference/query-languages/esql/functions-operators/dense-vector-functions.md#esql-knn) and the [`TO_DENSE_VECTOR` function](elasticsearch://reference/query-languages/esql/functions-operators/type-conversion-functions.md#esql-to_dense_vector) will work and any field data will be retrieved as part of the results. However, the type will appear as `unsupported` when these functions are not used. -* {applies_to}`stack: preview 9.2.0` `aggregate_metric_double` field type is only partially supported on this patch version (fixed in {applies_to}`stack: preview 9.2.1`). Using the [`TO_AGGREGATE_METRIC_DOUBLE` function](elasticsearch://reference/query-languages/esql/functions-operators/type-conversion-functions.md#esql-to_aggregate_metric_double) will work and any field data will be retrieved as part of the results. However, the type will appear as `unsupported` if this function is not used. +#### Partial support in 9.2.0 -This means that `FROM test` will not retrieve `dense_vector` or `aggregate_metric_double` data. But, `FROM test WHERE KNN("dense_vector_field", [0, 1, 2, ...])` or `FROM test | EVAL agm_data = TO_AGGREGATE_METRIC_DOUBLE(aggregate_metric_double_field)` will. +* {applies_to}`stack: preview 9.2.0` The following types are only partially supported on 9.2.0. This is fixed in 9.2.1: + * `dense_vector`: The [`KNN` function](/reference/query-languages/esql/functions-operators/dense-vector-functions.md#esql-knn) and the [`TO_DENSE_VECTOR` function](/reference/query-languages/esql/functions-operators/type-conversion-functions.md#esql-to_dense_vector) will work and any field data will be retrieved as part of the results. However, the type will appear as `unsupported` when these functions are not used. + * `aggregate_metric_double`: Using the [`TO_AGGREGATE_METRIC_DOUBLE` function](/reference/query-languages/esql/functions-operators/type-conversion-functions.md#esql-to_aggregate_metric_double) will work and any field data will be retrieved as part of the results. However, the type will appear as `unsupported` if this function is not used. + :::{note} + This means that a simple query like `FROM test` will not retrieve `dense_vector` or `aggregate_metric_double` data. However, using the appropriate functions will work: + * `FROM test WHERE KNN("dense_vector_field", [0, 1, 2, ...])` + * `FROM test | EVAL agm_data = TO_AGGREGATE_METRIC_DOUBLE(aggregate_metric_double_field)` + ::: ## _source availability [esql-_source-availability]