diff --git a/docs/reference/elasticsearch/mapping-reference/semantic-text.md b/docs/reference/elasticsearch/mapping-reference/semantic-text.md index 8588b946b0f62..52d49ab685365 100644 --- a/docs/reference/elasticsearch/mapping-reference/semantic-text.md +++ b/docs/reference/elasticsearch/mapping-reference/semantic-text.md @@ -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: @@ -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). diff --git a/docs/reference/query-languages/esql/limitations.md b/docs/reference/query-languages/esql/limitations.md index 7a667c16a8856..c4ad16f3d0e29 100644 --- a/docs/reference/query-languages/esql/limitations.md +++ b/docs/reference/query-languages/esql/limitations.md @@ -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}}.