Why mappings define document structure in Elasticsearch - Visual Breakdown

Concept Flow - Why mappings define document structure

Define Mapping

↓

Set Field Types

↓

Index Document

↓

Elasticsearch Uses Mapping

↓

Store & Search Data Correctly

↓

Return Accurate Search Results

Mapping sets rules for fields before adding data, so Elasticsearch knows how to store and search documents.

Execution Sample

Elasticsearch

PUT /my_index
{
  "mappings": {
    "properties": {
      "name": {"type": "text"},
      "age": {"type": "integer"}
    }
  }
}

This code creates an index with a mapping that defines 'name' as text and 'age' as integer.

Execution Table

Step	Action	Mapping State	Document Indexed	Effect
1	Create index with mapping	{"name":"text", "age":"integer"}	No	Mapping defines field types
2	Index document {"name":"Alice", "age":30}	{"name":"text", "age":"integer"}	{"name":"Alice", "age":30}	Fields stored with correct types
3	Search for age > 25	{"name":"text", "age":"integer"}	{"name":"Alice", "age":30}	Search uses mapping to compare numbers
4	Index document {"name":"Bob", "age":"thirty"}	{"name":"text", "age":"integer"}	Error	Mapping rejects wrong type
5	End	{"name":"text", "age":"integer"}	N/A	Mapping ensures data consistency

💡 Execution stops because mapping enforces field types and rejects wrong data.

Variable Tracker

Variable	Start	After Step 1	After Step 2	After Step 3	After Step 4	Final
mapping	{}	{"name":"text", "age":"integer"}	{"name":"text", "age":"integer"}	{"name":"text", "age":"integer"}	{"name":"text", "age":"integer"}	{"name":"text", "age":"integer"}
document	N/A	N/A	{"name":"Alice", "age":30}	{"name":"Alice", "age":30}	Error (invalid age type)	N/A

Key Moments - 2 Insights

Why does indexing a document with wrong field type cause an error?

Because the mapping defines the expected type (e.g., integer for 'age'), and Elasticsearch rejects data that doesn't match, as shown in step 4 of the execution_table.

How does mapping affect searching documents?

Mapping tells Elasticsearch how to interpret fields (like numbers or text), so searches like 'age > 25' work correctly, as seen in step 3.

Visual Quiz - 3 Questions

Look at the execution_table, what is the mapping type for the 'name' field after step 1?

A keyword

B integer

C text

D date

💡 Hint

Check the 'Mapping State' column in row for step 1.

At which step does Elasticsearch reject a document due to wrong field type?

A Step 4

B Step 2

C Step 3

D Step 5

💡 Hint

Look for 'Error' in the 'Document Indexed' column.

If the mapping did not define 'age' as integer, what would happen when searching 'age > 25'?

A Search would work correctly

B Search might fail or give wrong results

C Documents would be rejected on indexing

D Mapping would auto-correct the type

💡 Hint

Refer to step 3 where mapping guides search behavior.

Concept Snapshot

Mapping in Elasticsearch:
- Defines field names and types before indexing
- Ensures data consistency and correct storage
- Guides search and query behavior
- Rejects documents with wrong field types
- Essential for accurate and efficient search

Full Transcript

In Elasticsearch, mappings define the structure of documents by specifying field names and their data types before any data is added. This helps Elasticsearch know how to store and search the data correctly. For example, if 'age' is defined as an integer, Elasticsearch expects numbers for that field. When a document with the wrong type is indexed, Elasticsearch rejects it to keep data consistent. Mappings also help searches work properly, like comparing numbers for queries. This step-by-step trace shows how mapping is created, documents are indexed, and how mapping enforces rules and guides searching.

Practice

1. Why do mappings define the structure of documents in Elasticsearch?

easy

A. Because they specify the data types and field properties for each document field

B. Because they store the actual data of the documents

C. Because they control the network settings of Elasticsearch nodes

D. Because they define the user access permissions

Solution

1. Step 1: Understand the role of mappings

   Mappings tell Elasticsearch how to interpret each field in a document, like whether a field is text, number, date, etc.

2. Step 2: Differentiate mappings from other settings

   Mappings do not store data or control network or permissions; they only define the structure and data types.

3. Final Answer:

   Because they specify the data types and field properties for each document field -> Option A

4. Quick Check:

   Mappings = Define document structure [OK]

Hint: Mappings define field types, not data or permissions [OK]

Common Mistakes:

• Thinking mappings store the actual document data
• Confusing mappings with network or security settings
• Assuming mappings are optional for document structure

2. Which of the following is the correct way to define a mapping for a field named age as an integer in Elasticsearch?

easy

A. { "age": { "datatype": "int" } }

B. { "age": "integer" }

C. { "age": { "type": "integer" } }

D. { "age": { "type": "text" } }

Solution

1. Step 1: Check the correct syntax for field type

   Elasticsearch mapping requires the field name with a nested object specifying type and its value, e.g., integer.

2. Step 2: Validate the options

   { "age": { "type": "integer" } } uses correct JSON with type: integer. { "age": "integer" } misses the nested object. { "age": { "datatype": "int" } } uses wrong key datatype. { "age": { "type": "text" } } sets type to text, not integer.

3. Final Answer:

   { "age": { "type": "integer" } } -> Option C

4. Quick Check:

   Correct mapping syntax = { "age": { "type": "integer" } } [OK]

Hint: Use {field: {type: datatype}} format for mappings [OK]

Common Mistakes:

• Using wrong keys like 'datatype' instead of 'type'
• Not nesting the type inside an object
• Confusing 'text' type with 'integer'

3. Given this mapping for a field price as float:

{
  "properties": {
    "price": { "type": "float" }
  }
}

What will happen if you index a document with "price": "cheap"?

medium

A. Elasticsearch will store the string 'cheap' as is without error

B. Elasticsearch will index the document but ignore the price field

C. Elasticsearch will convert 'cheap' to 0.0 automatically

D. Elasticsearch will reject the document with a mapping type conflict error

Solution

1. Step 1: Understand type enforcement in mappings

   Elasticsearch enforces the data type defined in mappings. If a field is float, it expects a number.

2. Step 2: Analyze the input value

   The value 'cheap' is a string, not a float, so Elasticsearch will raise a type conflict error when indexing.

3. Final Answer:

   Elasticsearch will reject the document with a mapping type conflict error -> Option D

4. Quick Check:

   Type mismatch causes error = Elasticsearch will reject the document with a mapping type conflict error [OK]

Hint: Data must match mapping type or indexing fails [OK]

Common Mistakes:

• Assuming Elasticsearch auto-converts strings to numbers
• Thinking Elasticsearch silently ignores wrong types
• Believing string values are stored despite float mapping

4. You defined a mapping for a field date as date type, but your documents have dates in the format "dd-MM-yyyy". What is the likely problem and how to fix it?

medium

A. Elasticsearch will parse dates correctly by default; no fix needed

B. Elasticsearch will fail to parse dates; fix by specifying the correct date format in the mapping

C. Elasticsearch will store dates as strings; fix by changing type to text

D. Elasticsearch will ignore the date field; fix by removing the field from documents

Solution

1. Step 1: Recognize default date format

   Elasticsearch expects dates in ISO 8601 format by default, not 'dd-MM-yyyy'.

2. Step 2: Fix by specifying format in mapping

   To parse custom date formats, you must add a format property in the mapping with the correct pattern.

3. Final Answer:

   Elasticsearch will fail to parse dates; fix by specifying the correct date format in the mapping -> Option B

4. Quick Check:

   Date format mismatch = specify format in mapping [OK]

Hint: Set date format in mapping to match document dates [OK]

Common Mistakes:

• Assuming Elasticsearch auto-detects all date formats
• Changing type to text instead of fixing format
• Ignoring parsing errors and expecting correct search

5. You want to optimize search speed on a large text field description. How can defining the mapping help achieve this?

hard

A. By setting the field type to text with a custom analyzer for better indexing

B. By setting the field type to keyword to avoid full-text analysis

C. By omitting the field from the mapping so Elasticsearch guesses the type

D. By setting the field type to integer to speed up searches

Solution

1. Step 1: Understand field types for text search

   Text fields use analyzers to break text into searchable tokens. Custom analyzers can improve search relevance and speed.

2. Step 2: Evaluate options for optimization

   Setting type to text with a custom analyzer helps optimize indexing and searching. keyword is for exact matches, not full-text search. Omitting mapping causes guessing, which is less efficient. Integer type is invalid for text.

3. Final Answer:

   By setting the field type to text with a custom analyzer for better indexing -> Option A

4. Quick Check:

   Custom analyzer on text field = faster, better search [OK]

Hint: Use custom analyzers on text fields for faster search [OK]

Common Mistakes:

• Using keyword type for full-text search
• Not defining mapping and relying on defaults
• Assigning wrong data types like integer to text fields