Skip to content

Adds "Querying semantic_text fields" section #136076

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 14 commits into from
Oct 8, 2025
+29 −0
Merged

Adds "Querying semantic_text fields" section #136076

Changes from 4 commits
Commits
Show all changes
14 commits
Select commit Hold shift + click to select a range
f126b9b
Adds Querying semantic_text fields section
kosabogi Oct 7, 2025
6cfaf35
Update docs/reference/elasticsearch/mapping-reference/semantic-text.md
kosabogi Oct 7, 2025
50a5e24
Comment out links temporarily
kosabogi Oct 7, 2025
64446ef
Merge branch 'main' into query-semantic-text
kosabogi Oct 7, 2025
67d9f5c
Update docs/reference/elasticsearch/mapping-reference/semantic-text.md
kosabogi Oct 7, 2025
11089a7
Update docs/reference/elasticsearch/mapping-reference/semantic-text.md
kosabogi Oct 7, 2025
38a79de
Update docs/reference/elasticsearch/mapping-reference/semantic-text.md
kosabogi Oct 7, 2025
a8435b6
Update docs/reference/elasticsearch/mapping-reference/semantic-text.md
kosabogi Oct 7, 2025
1cdabcb
Adds ESQL link to match query
kosabogi Oct 8, 2025
30b9341
Fixes link
kosabogi Oct 8, 2025
f525152
Merge branch 'main' into query-semantic-text
kosabogi Oct 8, 2025
964aec6
Adds note to the Semantic query page
kosabogi Oct 8, 2025
206a3cd
Merge branch 'query-semantic-text' of github.com:kosabogi/elasticsear…
kosabogi Oct 8, 2025
b718123
Merge branch 'main' into query-semantic-text
kosabogi Oct 8, 2025
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
25 changes: 25 additions & 0 deletions docs/reference/elasticsearch/mapping-reference/semantic-text.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -611,6 +611,31 @@ PUT test-index
}
```

## Querying `semantic_text` fields [querying-semantic-text-fields]

You can query `semantic_text` fields using the following query types:

- [Match query](/reference/query-languages/query-dsl/query-dsl-match-query.md) - The recommended method for querying `semantic_text` fields.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
- [Match query](/reference/query-languages/query-dsl/query-dsl-match-query.md) - The recommended method for querying `semantic_text` fields.
- [Match query](/reference/query-languages/query-dsl/query-dsl-match-query.md): The recommended method for querying `semantic_text` fields.

You can perform match queries in query DSL or ESQL, so we should use tabs here (like we do in this doc) and mention https://www.elastic.co/docs/reference/query-languages/esql/functions-operators/search-functions#esql-match

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think this should be included in the query examples section (the one we link to from here), right?
cc @charlotte-hoblik

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

right but if you're linking to query DSL here, then you should link to ESQL too for symmetry, but it doesn't necessarily have to be tabs if that's too heavy-handed

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

You could just do something like:

  • Match query: The recommended method for querying semantic_text fields. You can use Query DSL or ES|QL syntax.

<!--
Refer to examples of match queries on `semantic_text` fields.
-->

- [kNN query](/reference/query-languages/query-dsl/query-dsl-knn-query.md) - Finds the nearest vectors to a query vector using a similarity metric, mainly for advanced or combined search use cases.
<!--
Refer to examples of kNN queries on `semantic_text` fields.
-->

- [Sparse vector query](/reference/query-languages/query-dsl/query-dsl-sparse-vector-query.md) - Executes searches using sparse vectors generated by a sparse retrieval model.
<!--
Refer to examples of sparse vector queries on `semantic_text` fields.
-->

- [Semantic query](/reference/query-languages/query-dsl/query-dsl-semantic-query.md) - A legacy option that was introduced earlier and is no longer recommended, but it remains supported for existing implementations.
<!--
Refer to examples of semantic queries on `semantic_text` fields.
-->


## Troubleshooting semantic_text fields [troubleshooting-semantic-text-fields]

If you want to verify that your embeddings look correct, you can view the
Expand Down
Loading