Why documents are the unit of data in Elasticsearch

Introduction

Documents are the main way Elasticsearch stores and organizes data. They keep all related information together in one place, making it easy to search and manage.

When you want to store a complete record like a user profile or a product description.

When you need to search for information quickly across many pieces of data.

When you want to update or delete a single piece of data without affecting others.

When you want to group related information together for easy retrieval.

When you want to index data so Elasticsearch can find it fast.

Syntax

Elasticsearch

{
  "_index": "index_name",
  "_id": "document_id",
  "_source": {
    "field1": "value1",
    "field2": "value2",
    "field3": "value3"
  }
}

Each document is a JSON object with fields and values.

Documents live inside an index, which is like a folder for similar data.

Examples

This document stores a user's name, age, and city.

Elasticsearch

{
  "_index": "users",
  "_id": "1",
  "_source": {
    "name": "Alice",
    "age": 30,
    "city": "New York"
  }
}

This document stores details about a product.

Elasticsearch

{
  "_index": "products",
  "_id": "100",
  "_source": {
    "product_name": "Coffee Mug",
    "price": 12.99,
    "in_stock": true
  }
}

Sample Program

This example adds a document about a book to the 'library' index and then retrieves it.

Elasticsearch

POST /library/_doc/1
{
  "title": "The Great Gatsby",
  "author": "F. Scott Fitzgerald",
  "year": 1925
}

GET /library/_doc/1

Important Notes

Documents are stored as JSON, which is easy to read and write.

Each document has a unique ID within its index.

Using documents helps Elasticsearch search and analyze data quickly.

Summary

Documents hold all related data together in Elasticsearch.

They are stored in indexes and identified by unique IDs.

This structure makes searching and managing data simple and fast.

Practice

1. Why are documents considered the unit of data in Elasticsearch?

easy

A. Because documents cannot be searched individually

B. Because documents are only used for storing metadata

C. Because documents are the same as database tables

D. Because each document holds all related information together in one place

Solution

1. Step 1: Understand the role of documents in Elasticsearch

   Documents store all related data fields together, making them self-contained units.

2. Step 2: Compare documents to other data units

   Unlike tables or metadata, documents hold actual data and can be searched independently.

3. Final Answer:

   Because each document holds all related information together in one place -> Option D

4. Quick Check:

   Documents = self-contained data units [OK]

Hint: Remember: documents bundle related data together [OK]

Common Mistakes:

• Thinking documents are just metadata
• Confusing documents with tables
• Assuming documents can't be searched alone

2. Which of the following is the correct way to identify a document in Elasticsearch?

easy

A. Using the document's file path on disk

B. Using the document's creation timestamp only

C. Using a unique document ID within an index

D. Using the document's size in bytes

Solution

1. Step 1: Identify how documents are stored

   Documents are stored inside indexes and each has a unique ID for identification.

2. Step 2: Eliminate incorrect options

   File paths, timestamps, or size are not used as unique identifiers in Elasticsearch.

3. Final Answer:

   Using a unique document ID within an index -> Option C

4. Quick Check:

   Unique ID = document identifier [OK]

Hint: Unique ID inside index identifies documents [OK]

Common Mistakes:

• Confusing file path with document ID
• Using timestamps as unique keys
• Assuming size identifies documents

3. Given an Elasticsearch index with documents representing books, which statement best explains why documents are efficient for searching?

medium

A. Because documents require manual indexing before searching

B. Because each document contains all book details, searches can target whole books quickly

C. Because documents only store keywords, not full data

D. Because documents are stored as separate files on disk, making file search faster

Solution

1. Step 1: Understand document structure for books

   Each document holds all details about a book, like title, author, and summary.

2. Step 2: Analyze search efficiency

   Having all data in one document allows Elasticsearch to quickly find relevant books without joining data.

3. Final Answer:

   Because each document contains all book details, searches can target whole books quickly -> Option B

4. Quick Check:

   Complete data per document = fast search [OK]

Hint: Whole data in one document speeds search [OK]

Common Mistakes:

• Thinking documents are separate files
• Believing documents store only keywords
• Assuming manual indexing is needed every time

4. You have an Elasticsearch document missing its unique ID. What problem will this cause?

medium

A. The document cannot be uniquely identified or updated

B. The document will be stored twice automatically

C. The document will be ignored during searches

D. The document will be converted into multiple smaller documents

Solution

1. Step 1: Understand the role of unique IDs

   Unique IDs allow Elasticsearch to find, update, or delete specific documents.

2. Step 2: Identify the impact of missing ID

   Without an ID, Elasticsearch cannot uniquely identify the document, causing update or delete failures.

3. Final Answer:

   The document cannot be uniquely identified or updated -> Option A

4. Quick Check:

   Missing ID = no unique identification [OK]

Hint: Missing ID means no unique document tracking [OK]

Common Mistakes:

• Assuming document duplicates automatically
• Thinking document is ignored in search
• Believing document splits into parts

5. You want to design an Elasticsearch index for storing user profiles. Why should each profile be a separate document rather than splitting data across multiple documents?

hard

A. Because storing all profile data in one document makes retrieval and updates simpler and faster

B. Because multiple documents per profile improve search speed by splitting data

C. Because Elasticsearch cannot store more than one document per user

D. Because documents must always be very small in size

Solution

1. Step 1: Consider data grouping in Elasticsearch

   Each document should hold all related data for easy access and management.

2. Step 2: Evaluate impact on retrieval and updates

   One document per profile means fewer queries and simpler updates, improving performance.

3. Step 3: Reject incorrect assumptions

   Splitting data into multiple documents complicates queries and slows down updates.

4. Final Answer:

   Because storing all profile data in one document makes retrieval and updates simpler and faster -> Option A

5. Quick Check:

   One document per profile = simpler management [OK]

Hint: Keep related data in one document for speed [OK]

Common Mistakes:

• Thinking multiple documents per profile speed search
• Believing Elasticsearch limits one document per user
• Assuming documents must be very small always