Skip to content

Commit c24d431

Browse files
authored
Document Semantic Text CCS Support (#135798)
1 parent ee6cda4 commit c24d431

File tree

2 files changed

+28
-2
lines changed

2 files changed

+28
-2
lines changed

docs/reference/elasticsearch/mapping-reference/semantic-text.md

Lines changed: 24 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -658,6 +658,27 @@ POST test-index/_search
658658
This will return verbose chunked embeddings content that is used to perform
659659
semantic search for `semantic_text` fields.
660660

661+
## Cross-cluster search (CCS) [ccs]
662+
```{applies_to}
663+
stack: ga 9.2
664+
serverless: unavailable
665+
```
666+
667+
`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)
668+
when [`ccs_minimize_roundtrips`](docs-content://solutions/search/cross-cluster-search.md#ccs-network-delays) is set to `true`.
669+
This is the default value for `ccs_minimize_roundtrips`, so most CCS queries should work automatically:
670+
671+
```console
672+
POST local-index,remote-cluster:remote-index/_search
673+
{
674+
"query": {
675+
"match": {
676+
"my_semantic_field": "Which country is Paris in?"
677+
}
678+
}
679+
}
680+
```
681+
661682
## Limitations [limitations]
662683

663684
`semantic_text` field types have the following limitations:
@@ -666,5 +687,6 @@ semantic search for `semantic_text` fields.
666687
of [nested fields](/reference/elasticsearch/mapping-reference/nested.md).
667688
* `semantic_text` fields can’t currently be set as part
668689
of [dynamic templates](docs-content://manage-data/data-store/mapping/dynamic-templates.md).
669-
* `semantic_text` fields are not supported with Cross-Cluster Search (CCS) or
670-
Cross-Cluster Replication (CCR).
690+
* `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`.
691+
* `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).
692+
* `semantic_text` fields do not support [Cross-Cluster Replication (CCR)](docs-content://deploy-manage/tools/cross-cluster-replication.md).

docs/reference/query-languages/esql/limitations.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -260,6 +260,10 @@ Also, [`INLINE STATS`](/reference/query-languages/esql/commands/inlinestats-by.m
260260
* 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.
261261
* 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.
262262

263+
## Cross-cluster search limitations [esql-ccs-limitations]
264+
265+
{{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).
266+
263267
## Known issues [esql-known-issues]
264268

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

0 commit comments

Comments
 (0)