Why mappings define document structure in Elasticsearch - See It in Action

Understanding Mappings in Elasticsearch

📖 Scenario: You are setting up a search system for a small online bookstore. You want to organize the book information so Elasticsearch knows how to store and search it properly.

🎯 Goal: Build an Elasticsearch index with a mapping that defines the structure of book documents, specifying fields and their types.

📋 What You'll Learn

Create an index called books with a mapping

Define fields title as text, author as keyword, and year as integer

Add a summary field as text with analyzer set to english

Ensure the mapping clearly shows the document structure

💡 Why This Matters

🌍 Real World

Elasticsearch mappings are used in real-world search engines to organize and optimize how data is stored and searched.

💼 Career

Understanding mappings is essential for roles like search engineers, backend developers, and data engineers working with Elasticsearch.

1

Create the index with basic mapping

Create an Elasticsearch index called books with a mapping that defines the fields title as text, author as keyword, and year as integer.

Elasticsearch

{
  "mappings": {
    "properties": {
      // Your code here
    }
  }
}

Hint

Use the mappings key with properties to define each field and its type.

2

Add a summary field with analyzer

Add a new field called summary to the properties in the mapping. Set its type to text and add an analyzer property with the value english.

Elasticsearch

{
  "mappings": {
    "properties": {
      "title": { "type": "text" },
      "author": { "type": "keyword" },
      "year": { "type": "integer" },
      // Your code here
    }
  }
}

Hint

The analyzer helps Elasticsearch understand the text better for searching.

3

Explain why mappings define document structure

Add a comment inside the mapping JSON explaining that mappings tell Elasticsearch how to store and search each field in the documents.

Elasticsearch

{
  "mappings": {
    "properties": {
      "title": { "type": "text" },
      "author": { "type": "keyword" },
      "year": { "type": "integer" },
      "summary": { "type": "text", "analyzer": "english" }
    }
  }
  // Your code here
}

Hint

Use a comment to explain the purpose of mappings in the JSON.

4

Complete the index creation with mapping

Wrap the mapping inside a full index creation request JSON with the index name books as the key, including the mappings you defined.

Elasticsearch

{
  "books": {
    // Your code here
  }
}

Hint

Put the mapping inside the index name key to complete the index creation JSON.

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