First search query in Elasticsearch - Step-by-Step Execution

Concept Flow - First search query

Start

↓

Build Query JSON

↓

Send Query to Elasticsearch

↓

Elasticsearch Processes Query

↓

Receive Search Results

↓

Display Results

↓

End

This flow shows how a search query is created, sent to Elasticsearch, processed, and results are returned.

Execution Sample

Elasticsearch

{
  "query": {
    "match": { "message": "error" }
  }
}

This JSON query searches for documents where the 'message' field contains the word 'error'.

Execution Table

Step	Action	Input/Condition	Output/Result
1	Build Query JSON	Create match query for 'message' with 'error'	{"query":{"match":{"message":"error"}}}
2	Send Query	Send JSON to Elasticsearch search API	Request sent to Elasticsearch cluster
3	Process Query	Elasticsearch parses and executes query	Search executed on index
4	Return Results	Elasticsearch returns matching documents	List of documents with 'error' in 'message'
5	Display Results	Client receives and shows documents	User sees search results
6	End	No more steps	Search complete

💡 Search completes after results are returned and displayed.

Variable Tracker

Variable	Start	After Step 1	After Step 2	After Step 4	Final
query_json	empty	{"query":{"match":{"message":"error"}}}	{"query":{"match":{"message":"error"}}}	{"query":{"match":{"message":"error"}}}	{"query":{"match":{"message":"error"}}}
response	none	none	pending	{"hits":{"total":{"value":3,"relation":"eq"},"hits":[...documents...]}}	{"hits":{"total":{"value":3,"relation":"eq"},"hits":[...documents...]}}

Key Moments - 3 Insights

Why do we need to build the query JSON before sending it?

The execution_table row 1 shows that the query must be in JSON format so Elasticsearch understands what to search for.

What happens if the query JSON is malformed?

At step 3, Elasticsearch will fail to process the query and return an error instead of results.

How do we know when the search is complete?

Step 6 marks the end after results are received and displayed, meaning the search cycle is finished.

Visual Quiz - 3 Questions

Look at the execution_table, what is the output after Step 1?

A A JSON query matching 'message' with 'error'

B A list of documents

C An error message

D Empty query

💡 Hint

Check the Output/Result column in row 1 of execution_table

At which step does Elasticsearch actually search the index?

A Step 2

B Step 3

C Step 4

D Step 5

💡 Hint

Look at the Action and Output columns in execution_table row 3

If the query JSON was empty, what would change in the execution_table?

A Step 5 would not display anything

B Step 4 would return documents anyway

C Step 1 output would be empty or invalid JSON

D Step 3 would be skipped

💡 Hint

Refer to Step 1 output in execution_table and how query_json variable changes

Concept Snapshot

First search query in Elasticsearch:
- Build a JSON query with 'query' key
- Use 'match' to find text in a field
- Send query JSON to Elasticsearch search API
- Elasticsearch processes and returns matching documents
- Display results to user
- Search ends after results are shown

Full Transcript

This visual execution shows how to perform a first search query in Elasticsearch. We start by building a JSON query that matches the word 'error' in the 'message' field. Then we send this query to Elasticsearch's search API. Elasticsearch processes the query and searches the index for matching documents. It returns the results, which the client displays to the user. The search completes after displaying results. Key moments include understanding why the query must be JSON, what happens if the query is malformed, and how to know when the search finishes.

Practice

1.

What does a match query do in an Elasticsearch search?

easy

A. It finds documents where the specified field contains the search text.

B. It deletes documents matching the search text.

C. It updates documents with the search text.

D. It creates a new index with the search text.

Solution

1. Step 1: Understand the purpose of match query

   The match query is used to find documents where a field contains the given text.

2. Step 2: Differentiate from other operations

   Deleting, updating, or creating indexes are different Elasticsearch operations, not done by match.

3. Final Answer:

   It finds documents where the specified field contains the search text. -> Option A

4. Quick Check:

   match query = find documents [OK]

Hint: Match query searches text in fields, not modify data [OK]

Common Mistakes:

• Confusing search with delete or update operations
• Thinking match creates or modifies indexes
• Assuming match returns all documents regardless of content

2.

Which of the following is the correct syntax for a basic Elasticsearch match query to search for "apple" in the field "fruit"?

{
  "query": {
    "match": {
      "fruit": "apple"
    }
  }
}

easy

A. { "query": { "match": { "fruit": "apple" } } }

B. { "match": { "query": { "fruit": "apple" } } }

C. { "query": { "fruit": { "match": "apple" } } }

D. { "query": { "match": { "apple": "fruit" } } }

Solution

1. Step 1: Identify the correct JSON structure for a match query

   The correct structure places match inside query, with the field name as key and search text as value.

2. Step 2: Compare options to this structure

   { "query": { "match": { "fruit": "apple" } } } matches the correct syntax exactly. Others misplace keys or swap field and text.

3. Final Answer:

   { "query": { "match": { "fruit": "apple" } } } -> Option A

4. Quick Check:

   Correct JSON structure = { "query": { "match": { "fruit": "apple" } } } [OK]

Hint: Match query is inside query, field name as key, text as value [OK]

Common Mistakes:

• Swapping field name and search text
• Placing match outside query
• Using wrong nesting of JSON keys

3.

Given this Elasticsearch query, what will it search for?

{
  "query": {
    "match": {
      "title": "quick brown fox"
    }
  }
}

medium

A. Documents where the title field contains the exact phrase "quick brown fox".

B. Documents where the title field contains only the word "fox".

C. Documents where the title field is empty.

D. Documents where the title field contains any of the words "quick", "brown", or "fox".

Solution

1. Step 1: Understand how match query works with multiple words

   The match query analyzes the text and searches for documents containing any of the words, not necessarily the exact phrase.

2. Step 2: Compare options with this behavior

   Documents where the title field contains any of the words "quick", "brown", or "fox". correctly states it searches for any of the words. Documents where the title field contains the exact phrase "quick brown fox". is phrase match, which requires a different query type.

3. Final Answer:

   Documents where the title field contains any of the words "quick", "brown", or "fox". -> Option D

4. Quick Check:

   match = any word match [OK]

Hint: Match finds any word in text, not exact phrase [OK]

Common Mistakes:

• Thinking match does exact phrase search
• Assuming match finds only one word
• Confusing match with match_phrase query

4.

Identify the error in this Elasticsearch query:

{
  "query": {
    "match": {
      "content": apple
    }
  }
}

medium

A. The match query should be outside the query object.

B. The field name content should be in quotes.

C. The search text apple should be in quotes.

D. The query object is missing a closing brace.

Solution

1. Step 1: Check JSON syntax for values

   In JSON, string values must be enclosed in double quotes. Here, apple is unquoted.

2. Step 2: Verify other parts of the query

   The field name and braces are correctly quoted and closed. The match query is correctly inside query.

3. Final Answer:

   The search text apple should be in quotes. -> Option C

4. Quick Check:

   Strings need quotes in JSON [OK]

Hint: Always quote string values in JSON queries [OK]

Common Mistakes:

• Leaving string values unquoted
• Misplacing match outside query
• Forgetting closing braces

5.

You want to find documents where the field "description" contains the word "fresh" but only if the field "category" equals "fruit". Which Elasticsearch query correctly combines these conditions?

hard

A. { "query": { "match": { "description": "fresh" }, "match": { "category": "fruit" } } }

B. { "query": { "bool": { "must": [ { "match": { "description": "fresh" } }, { "match": { "category": "fruit" } } ] } } }

C. { "query": { "term": { "description": "fresh" }, "term": { "category": "fruit" } } }

D. { "query": { "match": { "description": "fresh fruit" } } }

Solution

1. Step 1: Understand combining multiple conditions in Elasticsearch

   To require both conditions, use a bool query with must array containing each match query.

2. Step 2: Evaluate each option's structure

   { "query": { "bool": { "must": [ { "match": { "description": "fresh" } }, { "match": { "category": "fruit" } } ] } } } correctly uses bool with must for both matches. { "query": { "match": { "description": "fresh fruit" } } } searches combined text in one field. Options A and C have invalid JSON or incorrect query structure.

3. Final Answer:

   { "query": { "bool": { "must": [ { "match": { "description": "fresh" } }, { "match": { "category": "fruit" } } ] } } } -> Option B

4. Quick Check:

   Use bool must to combine queries [OK]

Hint: Use bool must array to combine multiple match queries [OK]

Common Mistakes:

• Combining terms incorrectly in one match
• Using invalid JSON with repeated keys
• Not using bool query for multiple conditions