Skip to content
Merged
Show file tree
Hide file tree
Changes from 4 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
@@ -1,10 +1,12 @@
* [`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)
* [`TO_DATEPERIOD`](../../functions-operators/type-conversion-functions.md#esql-to_dateperiod)
* [`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`
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -22,6 +22,9 @@ mapped_pages:
:::


:::{include} ../_snippets/functions/layout/to_aggregate_metric_double.md
:::

:::{include} ../_snippets/functions/layout/to_boolean.md
:::

Expand All @@ -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
:::

Expand Down
22 changes: 12 additions & 10 deletions docs/reference/query-languages/esql/limitations.md
Original file line number Diff line number Diff line change
Expand Up @@ -32,40 +32,41 @@
* 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

* `geo_point`
* `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
* `dense_vector`
* TSDB metrics
* `counter`
* `gauge`
* `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
Expand Down Expand Up @@ -106,9 +107,10 @@

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: 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.

Check failure on line 111 in docs/reference/query-languages/esql/limitations.md

View workflow job for this annotation

GitHub Actions / docs-preview / build

'reference/query-languages/esql/functions-operators/type-conversion-functions' is not a valid link in the 'elasticsearch' cross link index: https://elastic-docs-link-index.s3.us-east-2.amazonaws.com/elastic/elasticsearch/main/links.json

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]
Expand Down
Loading