mirror of
https://github.com/honeymoose/OpenSearch.git
synced 2025-02-08 22:14:59 +00:00
50a8779c94
**Goal** Create a top-level search section. This will let us clean up our search API reference docs, particularly content from [`Request body search`][0]. **Changes** * Creates a top-level `Search your data` page. This page is designed to house concept and tutorial docs related to search. * Creates a `Run a search` page under `Search your data`. For now, This contains a basic search tutorial. The goal is to add content from [`Request body search`][0] to this in the future. * Relocates `Long-running searches` and `Search across clusters` under `Search your data`. Increments several headings in that content. * Reorders the top-level TOC to move `Search your data` higher. Also moves the `Query DSL`, `EQL`, and `SQL access` chapters immediately after. Relates to #48194 [0]: https://www.elastic.co/guide/en/elasticsearch/reference/master/search-request-body.html
39 lines
1.2 KiB
Plaintext
39 lines
1.2 KiB
Plaintext
[[search-your-data]]
|
|
= Search your data
|
|
|
|
[partintro]
|
|
--
|
|
|
|
[[search-query]]
|
|
A _search query_, or _query_, is a request for information about data in one or
|
|
more {es} indices.
|
|
|
|
You can think of a query as a question, written in a way {es} understands.
|
|
Depending on your data, you can use a query to get answers to questions like:
|
|
|
|
* What pages on my website contain a specific word or phrase?
|
|
* What processes on my server take longer than 500 milliseconds to respond?
|
|
* What users on my network ran `regsvr32.exe` within the last week?
|
|
* How many of my products have a price greater than $20?
|
|
|
|
A _search_ consists of one or more queries that are combined and sent to {es}.
|
|
Documents that match the a search's queries are returned in the _hits_, or
|
|
_search results_, of the response.
|
|
|
|
A search may also contain additional information used to better process its
|
|
queries. For example, a search may be limited to a specific index or only return
|
|
a specific number of results.
|
|
|
|
[discrete]
|
|
[[search-toc]]
|
|
=== In this section
|
|
|
|
* <<run-a-search>>
|
|
* <<modules-cross-cluster-search>>
|
|
* <<async-search-intro>>
|
|
|
|
--
|
|
|
|
include::run-a-search.asciidoc[]
|
|
include::{es-repo-dir}/async-search.asciidoc[]
|
|
include::{es-repo-dir}/modules/cross-cluster-search.asciidoc[] |