Skip to content
Open
Show file tree
Hide file tree
Changes from all 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
26 changes: 24 additions & 2 deletions docs/reference/elasticsearch/mapping-reference/semantic-text.md
Original file line number Diff line number Diff line change
Expand Up @@ -633,6 +633,27 @@ POST test-index/_search
This will return verbose chunked embeddings content that is used to perform
semantic search for `semantic_text` fields.

## Cross-cluster search (CCS) [ccs]
```{applies_to}
stack: ga 9.2
serverless: unavailable
```

`semantic_text` supports [Cross-Cluster Search (CCS)](docs-content://solutions/search/cross-cluster-search.md) through the [`_search` endpoint](https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-search)
when [`ccs_minimize_roundtrips`](docs-content://solutions/search/cross-cluster-search.md#ccs-network-delays) is set to `true`.
This is the default value for `ccs_minimize_roundtrips`, so most CCS queries should work automatically:

```console
POST local-index,remote-cluster:remote-index/_search
{
"query": {
"match": {
"my_semantic_field": "Which country is Paris in?"
}
}
}
```

## Limitations [limitations]

`semantic_text` field types have the following limitations:
Expand All @@ -641,5 +662,6 @@ semantic search for `semantic_text` fields.
of [nested fields](/reference/elasticsearch/mapping-reference/nested.md).
* `semantic_text` fields can’t currently be set as part
of [dynamic templates](docs-content://manage-data/data-store/mapping/dynamic-templates.md).
* `semantic_text` fields are not supported with Cross-Cluster Search (CCS) or
Cross-Cluster Replication (CCR).
* `semantic_text` fields do not support [Cross-Cluster Search (CCS)](docs-content://solutions/search/cross-cluster-search.md) when [`ccs_minimize_roundtrips`](docs-content://solutions/search/cross-cluster-search.md#ccs-network-delays) is set to `false`.
* `semantic_text` fields do not support [Cross-Cluster Search (CCS)](docs-content://solutions/search/cross-cluster-search.md) in [ES|QL](/reference/query-languages/esql.md).
* `semantic_text` fields do not support Cross-Cluster Replication (CCR).
4 changes: 4 additions & 0 deletions docs/reference/query-languages/esql/limitations.md
Original file line number Diff line number Diff line change
Expand Up @@ -260,6 +260,10 @@ Also, [`INLINE STATS`](/reference/query-languages/esql/commands/inlinestats-by.m
* CSV export from Discover shows no more than 10,000 rows. This limit only applies to the number of rows that are retrieved by the query and displayed in Discover. Queries and aggregations run on the full data set.
* Querying many indices at once without any filters can cause an error in kibana which looks like `[esql] > Unexpected error from Elasticsearch: The content length (536885793) is bigger than the maximum allowed string (536870888)`. The response from {{esql}} is too long. Use [`DROP`](/reference/query-languages/esql/commands/drop.md) or [`KEEP`](/reference/query-languages/esql/commands/keep.md) to limit the number of fields returned.

## Cross-cluster search limitations [esql-ccs-limitations]

{{esql}} does not support [Cross-Cluster Search (CCS)](docs-content://solutions/search/cross-cluster-search.md) on [`semantic_text` fields](/reference/elasticsearch/mapping-reference/semantic-text.md).

## Known issues [esql-known-issues]

Refer to [Known issues](/release-notes/known-issues.md) for a list of known issues for {{esql}}.
Loading