45:"/_next/static/chunks/33yus346z0l_n.js" 46:"/_next/static/chunks/2j22cxchii_xx.js" 47:"/_next/static/chunks/0iv56yrji_20j.js" 48:"/_next/static/chunks/32izpn90gvm22.js" 49:"/_next/static/chunks/3j8bi-zu9bqs4.js" 4a:"/_next/static/chunks/1z-pox7hqp2x3.js" 4b:"/_next/static/chunks/20w4eaqlekefm.js" 4c:"/_next/static/chunks/1tn-0fivsxsv1.js" 4d:"/_next/static/chunks/09nq57stwzkgf.js" 4e:"/_next/static/chunks/3m1xjj5kw5fie.js" 4f:"/_next/static/chunks/0gafyzg9j9yqj.js" 50:"/_next/static/chunks/3k2gyg36fnag_.js" 51:"/_next/static/chunks/3bgoyiso1rhn7.js" 52:"/_next/static/chunks/3cstd6xzfli_o.js" 53:"/_next/static/chunks/253gnmj0-cj17.js" 54:"/_next/static/chunks/0hlb44ca7-4a2.js" 55:"/_next/static/chunks/20329i6m_04t6.js" 56:"/_next/static/chunks/40mq7ggq-ozo4.js" 57:"/_next/static/chunks/082jo-0ajazgr.js" 58:"/_next/static/chunks/2ozcrjb_hh74t.js" 59:"/_next/static/chunks/01a-3hvnqu8wl.js" 5a:"/_next/static/chunks/05i8en-x14ibi.js" 5b:"/_next/static/chunks/3m0r7x0jt5wm7.js" 5c:"/_next/static/chunks/2k8pepwc4pxns.js" 5d:"/_next/static/chunks/0wa9m1-tphf9u.js" 5e:"/_next/static/chunks/30jdm3dwz834g.js" 5f:"/_next/static/chunks/0k9bl6dipnsvu.js" 60:"/_next/static/chunks/18ggtgz2yf759.js" 61:"/_next/static/chunks/0i3-eynrkvqi7.js" 62:I[593304,["$2a","$2b","$2c","$2d","$2e","$2f","$45","$46","$47","$48","$49","$4a","$4b","$4c","$4d","$4e","$4f","$50","$51","$52","$53","$54","$55","$56","$57","$58","$59","$5a","$5b","$5c","$5d","$5e","$5f","$60","$61"],"OwnedHydration"] 63:T42c,{ "_id": "user_12345", "profile": { "firstName": "Sarah", "lastName": "Chen", "email": "sarah.chen@example.com", "dateOfBirth": "1988-03-15", "verified": true }, "addresses": [ { "type": "home", "street": "123 Oak Avenue", "city": "San Francisco", "state": "CA", "zipCode": "94102", "isPrimary": true }, { "type": "work", "street": "456 Market Street", "city": "San Francisco", "state": "CA", "zipCode": "94105", "isPrimary": false } ], "preferences": { "notifications": { "email": true, "sms": false, "push": true }, "language": "en-US", "timezone": "America/Los_Angeles" }, "orders": [ { "orderId": "ORD-001", "date": "2024-01-10", "total": 159.99, "status": "delivered" }, { "orderId": "ORD-002", "date": "2024-01-25", "total": 89.50, "status": "processing" } ], "createdAt": "2023-06-01T10:30:00Z", "updatedAt": "2024-01-25T14:22:00Z" }64:T5cc, Sarah Chen sarah.chen@example.com 1988-03-15

123 Oak Avenue San Francisco CA 94102

456 Market Street San Francisco CA 94105

en-US America/Los_Angeles 159.99 89.50 2023-06-01T10:30:00Z 2024-01-25T14:22:00Z 65:T461,// Version 1: Initial user document (2022) { "_id": "user_001", "name": "Alice Johnson", "email": "alice@example.com" } // Version 2: Added address field (some users had it, some didn't) { "_id": "user_001", "name": "Alice Johnson", "email": "alice@example.com", "address": "123 Main St, Boston, MA" } // Version 3: Address became a structured object { "_id": "user_001", "firstName": "Alice", "lastName": "Johnson", "email": "alice@example.com", "address": { "street": "123 Main St", "city": "Boston", "state": "MA", "zipCode": "02101" } } // Version 4: Added preferences and normalized name fields { "_id": "user_001", "profile": { "firstName": "Alice", "lastName": "Johnson", "displayName": "Alice J." }, "contact": { "email": "alice@example.com", "phone": "+1-555-123-4567" }, "address": { "street": "123 Main St", "city": "Boston", "state": "MA", "zipCode": "02101", "country": "USA" }, "preferences": { "newsletter": true, "language": "en-US" } } // All four versions can coexist in the same collection!66:T4ae,// Find all users in San Francisco db.users.find({ "address.city": "San Francisco" }); // Find active users with orders over $100, return only name and email db.users.find( { status: "active", "orders.total": { $gt: 100 } }, { "profile.firstName": 1, "profile.lastName": 1, email: 1, _id: 0 } ); // Complex query with multiple conditions db.users.find({ $and: [ { "profile.verified": true }, { "preferences.notifications.email": true }, { $or: [ { "address.state": "CA" }, { "address.state": "NY" } ] }, { createdAt: { $gte: ISODate("2023-01-01") } } ] }); // Aggregation pipeline: average order value by state db.users.aggregate([ { $unwind: "$orders" }, { $group: { _id: "$address.state", avgOrderValue: { $avg: "$orders.total" }, totalOrders: { $sum: 1 } } }, { $sort: { avgOrderValue: -1 } }, { $limit: 10 } ]); // Update: add a tag to all users who haven't logged in for 90 days db.users.updateMany( { lastLogin: { $lt: new Date(Date.now() - 90 * 24 * 60 * 60 * 1000) } }, { $set: { "status": "dormant" }, $push: { "tags": "needs-reengagement" } } );67:T428,// Create a compound index for common query pattern // Supports queries filtering on status, then sorting by createdAt db.orders.createIndex( { status: 1, createdAt: -1 }, { name: "status_date_idx", background: true } ); // Create a text index for full-text search db.articles.createIndex( { title: "text", content: "text", tags: "text" }, { weights: { title: 10, tags: 5, content: 1 }, name: "article_text_search" } ); // Create a geospatial index for location queries db.restaurants.createIndex({ location: "2dsphere" }); // Query using geo index: find restaurants within 5km db.restaurants.find({ location: { $near: { $geometry: { type: "Point", coordinates: [-122.4194, 37.7749] }, $maxDistance: 5000 } } }); // Create a partial index on active orders only db.orders.createIndex( { customerId: 1, orderDate: -1 }, { partialFilterExpression: { status: { $in: ["pending", "processing"] } } } ); // Analyze query performance with explain() db.users.find({ email: "test@example.com" }).explain("executionStats");68:T4c1,// Electronics product { "_id": "prod_electronics_001", "category": "electronics", "name": "ProSound Wireless Headphones", "price": 249.99, "specs": { "driver": "40mm dynamic", "frequencyResponse": "20Hz-20kHz", "bluetooth": "5.2", "batteryLife": "30 hours", "noiseCancellation": true, "weight": "250g" }, "colors": ["black", "silver", "navy"], "warranty": "2 years", "inStock": true } // Clothing product { "_id": "prod_clothing_001", "category": "clothing", "name": "Classic Oxford Shirt", "price": 79.99, "specs": { "fabric": "100% cotton", "fit": "regular", "care": "machine wash cold" }, "sizes": ["S", "M", "L", "XL", "XXL"], "colors": ["white", "blue", "pink"], "gender": "men", "inStock": true } // Furniture product { "_id": "prod_furniture_001", "category": "furniture", "name": "Modern Sectional Sofa", "price": 1899.99, "specs": { "dimensions": { "width": "120 inches", "depth": "85 inches", "height": "34 inches" }, "material": "top-grain leather", "seating": 5, "configuration": "L-shaped" }, "colors": ["tan", "charcoal", "cream"], "deliveryWeeks": 4, "inStock": false }43:["$","$L62",null,{"owner":"anonymous","state":{"mutations":[],"queries":[{"dehydratedAt":1792287881091,"state":{"data":{"json":{"id":"seed_834366cc72a3278609565a4a488078f1","slug":"document-and-other-models","category":"Database Management System","topic":"Document and Other Models","title":"Document and Other Data Models","description":"Explore modern data models beyond the relational paradigm—including document stores, key-value databases, graph databases, and column-family systems. Understand when to choose each model based on data structure, query patterns, and scalability requirements in contemporary distributed systems.","difficulty":"BEGINNER","estimatedMinutes":75,"pages":[{"id":"seed_f9d4cee510f960c6d0fc414d53499fee","title":"Document Model (JSON, XML)","order":0,"content":[{"id":"opening-context","title":"The Rise of Document-Oriented Data","content":[{"data":{"content":"For decades, the **relational model** dominated data management. Tables, rows, columns, and foreign keys provided a powerful abstraction that enabled enterprises to manage structured data with integrity guarantees and sophisticated query capabilities. But as the internet era transformed how applications were built and scaled, a fundamental tension emerged: **the impedance mismatch between application objects and relational tables**.\n\nModern applications often work with complex, nested data structures—user profiles with varying attributes, product catalogs with heterogeneous specifications, content management systems with diverse document types. Forcing these naturally hierarchical structures into flat relational tables required complex joins, multiple queries, and extensive application-level mapping code. The **document model** emerged as a response to this friction, offering a data representation that mirrors how developers naturally think about and manipulate data in their applications."},"type":"text"},{"data":{"icon":"Target","title":"What You Will Learn","content":"This page provides comprehensive coverage of the document data model. You'll understand how document databases store semi-structured data, the fundamental principles underlying JSON and XML representations, schema flexibility and its implications, query mechanisms, indexing strategies, and the architectural decisions that make document stores the backbone of many modern web applications.","variant":"info"},"type":"callout"}]},{"id":"understanding-document-model","title":"Understanding the Document Model","content":[{"data":{"content":"The **document model** is a data model paradigm where the fundamental unit of storage is a **document**—a self-contained, self-describing data structure that encapsulates related data fields within a single entity. Unlike relational databases that distribute an object's data across multiple tables, document databases store entire objects as unified documents.\n\n**Core Concept:**\n\nA document is essentially a structured data container that can hold:\n- **Scalar values**: strings, numbers, booleans, dates\n- **Arrays**: ordered collections of values\n- **Nested documents**: embedded sub-documents creating hierarchical structures\n\nThis hierarchical, self-contained nature means that all the data needed to represent an entity typically resides within a single document, eliminating the need for costly join operations that are fundamental to relational databases."},"type":"text"},{"data":{"code":"$63","fileName":"document-structure-example.json","showLineNumbers":true},"type":"code"},{"data":{"content":"**Contrast with Relational Representation:**\n\nIn a relational database, this single user entity would require **at minimum four separate tables**:\n\n1. `users` table (profile fields)\n2. `addresses` table (with `user_id` foreign key)\n3. `preferences` table (with `user_id` foreign key)\n4. `orders` table (with `user_id` foreign key)\n\nRetrieving the complete user object would require joining all four tables—a potentially expensive operation that scales poorly as data volume increases. The document model represents the same data as a **single atomic unit**, enabling retrieval in a single read operation."},"type":"text"},{"data":{"icon":"Lightbulb","title":"Data Locality Advantage","content":"Document databases leverage **data locality**—related data is physically stored together on disk. When you fetch a document, all its nested data comes in a single disk read (or minimal reads). This contrasts sharply with relational queries that may scatter I/O across multiple tables stored in different disk locations, resulting in significantly higher latency for complex queries.","variant":"tip"},"type":"callout"}],"titleType":"number","titleNumber":1},{"id":"json-document-format","title":"JSON as a Document Format","content":[{"data":{"content":"**JSON (JavaScript Object Notation)** has become the dominant document format in modern databases. Originally derived from JavaScript's object literal syntax, JSON provides a lightweight, human-readable, language-independent data interchange format that maps naturally to data structures in virtually every programming language.\n\n**JSON Data Types:**\n\nJSON supports six fundamental data types that compose into complex structures:"},"type":"text"},{"data":{"rows":[["**String**","Unicode text enclosed in double quotes","`\"Hello, World!\"`","Supports escape sequences (\n, \\t, \\u0000)"],["**Number**","Integer or floating-point numeric value","`42`, `-3.14`, `2.998e8`","No distinction between int/float; no Infinity/NaN"],["**Boolean**","Logical true or false value","`true`, `false`","Lowercase only; not quoted"],["**Null**","Explicit absence of value","`null`","Distinct from undefined or missing keys"],["**Array**","Ordered collection of values","`[1, \"two\", true]`","Can contain mixed types; zero-indexed"],["**Object**","Unordered collection of key-value pairs","`{\"name\": \"Alice\"}`","Keys must be strings; values can be any type"]],"caption":"JSON Native Data Types","headers":["Type","Description","Example","Notes"]},"type":"table"},{"data":{"content":"**JSON's Structural Power:**\n\nThe recursive nature of JSON—where objects can contain other objects and arrays can contain arrays—enables arbitrarily complex hierarchical structures. This recursive composition is the foundation of document modeling, allowing developers to represent real-world entities with their full complexity."},"type":"text"},{"data":{"code":"{\n \"company\": {\n \"name\": \"TechCorp Industries\",\n \"founded\": 2010,\n \"headquarters\": {\n \"address\": {\n \"street\": \"1 Innovation Way\",\n \"city\": \"Palo Alto\",\n \"country\": \"USA\"\n },\n \"employees\": 2500\n },\n \"departments\": [\n {\n \"name\": \"Engineering\",\n \"headCount\": 800,\n \"teams\": [\n {\"name\": \"Backend\", \"members\": 200, \"techStack\": [\"Go\", \"Python\", \"PostgreSQL\"]},\n {\"name\": \"Frontend\", \"members\": 150, \"techStack\": [\"React\", \"TypeScript\"]},\n {\"name\": \"Infrastructure\", \"members\": 100, \"techStack\": [\"Kubernetes\", \"Terraform\"]}\n ]\n },\n {\n \"name\": \"Product\",\n \"headCount\": 120,\n \"teams\": [\n {\"name\": \"Consumer\", \"members\": 60},\n {\"name\": \"Enterprise\", \"members\": 60}\n ]\n }\n ],\n \"publicly_traded\": true,\n \"stock_symbol\": \"TECH\"\n }\n}","fileName":"json-nested-structures.json","showLineNumbers":true},"type":"code"},{"data":{"items":["**Developer Familiarity** — JSON is the native data format of JavaScript and maps directly to dictionaries/objects in Python, Java, Go, and virtually every modern language. No serialization complexity.","**Human Readability** — Unlike binary formats, JSON documents can be inspected, debugged, and modified with any text editor, dramatically simplifying development and troubleshooting.","**API Compatibility** — JSON is the standard format for REST APIs and web services. Documents stored as JSON can be served directly to clients without transformation.","**Schema Flexibility** — JSON documents don't require a predefined schema. Different documents in the same collection can have different fields, enabling agile development.","**Tooling Ecosystem** — Every programming language has mature JSON parsing libraries. Query tools, validators, and transformation utilities are ubiquitous."],"title":{"icon":"CheckCircle","text":"Why JSON Dominates Document Storage","type":"icon","color":"primary","variant":"outline-circle"},"variant":"accent"},"type":"list"},{"data":{"icon":"Info","title":"Binary JSON (BSON)","content":"Many document databases (notably MongoDB) use **BSON (Binary JSON)**—a binary-encoded serialization of JSON documents. BSON extends JSON with additional types (Date, Binary, ObjectId, Decimal128) and enables efficient scanning without full deserialization. While documents are conceptually JSON, they're stored and transmitted in BSON format for performance.","variant":"note"},"type":"callout"}],"titleType":"number","titleNumber":2},{"id":"xml-document-format","title":"XML as a Document Format","content":[{"data":{"content":"**XML (eXtensible Markup Language)** predates JSON as a document format and remains prevalent in enterprise systems, government data exchanges, and domains requiring rich metadata and validation capabilities. XML provides a more verbose but feature-rich alternative to JSON.\n\n**XML's Distinctive Characteristics:**\n\nUnlike JSON's minimalist design, XML was engineered for document-centric applications where metadata, namespaces, and validation are first-class concerns. This heritage gives XML capabilities that JSON lacks—at the cost of increased complexity and verbosity."},"type":"text"},{"data":{"code":"$64","fileName":"xml-document-example.xml","showLineNumbers":true},"type":"code"},{"data":{"left":[{"data":{"items":["**Attributes + Elements** — Data can be stored as element content or attributes, providing modeling flexibility","**Namespaces** — Prevent naming collisions when combining documents from multiple sources","**Schema Validation** — XSD schemas enable rigorous validation before data enters the system","**XSLT Transform** — Declarative transformation language for converting document structures","**XPath Queries** — Powerful path-based query language for document navigation","**Comments & Processing Instructions** — Self-documenting format with metadata support"],"title":{"icon":"CheckCircle","text":"XML Advantages","type":"icon","color":"primary","variant":"outline-circle"},"variant":"accent"},"type":"list"}],"right":[{"data":{"items":["**Verbosity** — Opening and closing tags significantly increase document size","**Parsing Overhead** — XML parsers are heavier than JSON parsers; slower processing","**Complexity** — Namespaces, DTDs, and schemas add configuration overhead","**Type Ambiguity** — All values are strings; types must be inferred or schema-defined","**JavaScript Friction** — JSON maps natively to JS objects; XML requires DOM manipulation","**API Mismatch** — Modern REST APIs universally favor JSON; XML feels dated"],"title":{"icon":"XCircle","text":"XML Disadvantages","type":"icon","color":"destructive","variant":"outline-circle"},"variant":"accent"},"type":"list"}]},"type":"two-column"},{"data":{"content":"**When XML Still Wins:**\n\nDespite JSON's dominance in web applications, XML remains the format of choice in several important domains:\n\n1. **Enterprise Integration** — SOAP web services, EDI, and B2B data exchange\n2. **Document Publishing** — EPUB, DocBook, academic publishing workflows\n3. **Configuration Files** — Maven, Android layouts, many enterprise frameworks\n4. **Regulatory Compliance** — Healthcare (HL7/FHIR), finance (FpML), government\n5. **Legacy Systems** — Vast installed base of XML-based enterprise applications"},"type":"text"},{"data":{"icon":"AlertCircle","title":"The Great Format Debate","content":"Choosing between JSON and XML isn't purely technical—it often depends on organizational context. A healthcare system bound by HL7 standards has little choice but XML. A startup building a mobile app will naturally choose JSON. Pragmatism trumps preference; understand both formats deeply.","variant":"warning"},"type":"callout"}],"titleType":"number","titleNumber":3},{"id":"schema-flexibility","title":"Schema Flexibility and Evolution","content":[{"data":{"content":"One of the most transformative characteristics of document databases is **schema flexibility**—also referred to as \"schemaless\" or \"schema-on-read\" architecture. Unlike relational databases where the schema must be defined before data insertion, document databases accept documents with varying structures within the same collection.\n\n**Understanding Schema-on-Read:**\n\nThe term \"schemaless\" is somewhat misleading. Document databases do have schemas—they just don't enforce them at the database level. Instead, the schema is implicit in application code that reads and writes documents. This is called **schema-on-read**: structure is interpreted when data is accessed, not when it's stored."},"type":"text"},{"data":{"code":"$65","fileName":"schema-evolution-example.json","showLineNumbers":true},"type":"code"},{"data":{"content":"**The Evolution Advantage:**\n\nIn relational databases, schema changes (ALTER TABLE) can be expensive operations requiring downtime, especially for large tables. Adding a column to a billion-row table might take hours. Document databases sidestep this entirely:\n\n1. **New fields**: Simply include them in new documents; old documents don't need modification\n2. **Field removal**: Stop including the field; existing documents retain it until explicitly updated\n3. **Type changes**: New documents use the new type; application code handles both\n4. **Structural changes**: Nest, flatten, or reorganize freely\n\nThis enables **continuous deployment** where schema changes are just code deployments—no database migration scripts, no maintenance windows."},"type":"text"},{"data":{"icon":"AlertCircle","title":"The Hidden Complexity","content":"Schema flexibility shifts complexity from the database to the application. Your code must handle documents in any version—checking for field existence, handling type variations, and gracefully degrading when expected data is missing. Without disciplined application architecture, 'schemaless' becomes 'schema-chaos'.","variant":"warning"},"type":"callout"},{"data":{"items":["**Version Fields** — Include a `schemaVersion` field in documents; application code branches on version to handle differences","**Migration Scripts** — Even without enforced schemas, maintain migration scripts that update documents from old versions to new","**Defensive Reading** — Always validate and provide defaults when reading documents; never assume fields exist","**Application-Level Validation** — Use JSON Schema or application validators to enforce structure before writes","**Document Contracts** — Define interfaces/types in your application code that represent expected document structure","**Gradual Migration** — Update documents lazily (on read/write) or via background jobs rather than all-at-once"],"title":{"icon":"Target","text":"Schema Management Best Practices","type":"icon","color":"primary","variant":"outline-circle"},"variant":"glass"},"type":"list"}],"titleType":"number","titleNumber":4},{"id":"querying-documents","title":"Querying Document Databases","content":[{"data":{"content":"Document databases provide rich query capabilities that allow you to filter, project, aggregate, and transform documents using expressive query languages. While each database has its own syntax, common patterns emerge across implementations.\n\n**MongoDB Query Language (MQL) Example:**\n\nMongoDB, the most widely-deployed document database, uses a JSON-based query syntax. Queries are themselves JSON objects specifying filter conditions, projections, and operations."},"type":"text"},{"data":{"code":"$66","fileName":"mongodb-queries.js","showLineNumbers":true},"type":"code"},{"data":{"rows":[["`$eq`","Matches values equal to specified value","`{ status: { $eq: \"active\" } }`"],["`$gt`, `$gte`","Greater than (or equal)","`{ age: { $gte: 18 } }`"],["`$lt`, `$lte`","Less than (or equal)","`{ price: { $lt: 100 } }`"],["`$in`","Matches any value in array","`{ status: { $in: [\"active\", \"pending\"] } }`"],["`$and`, `$or`","Logical conjunction/disjunction","`{ $or: [{ a: 1 }, { b: 2 }] }`"],["`$not`","Negates a condition","`{ age: { $not: { $lt: 18 } } }`"],["`$exists`","Checks if field exists","`{ email: { $exists: true } }`"],["`$regex`","Pattern matching","`{ name: { $regex: /^A/i } }`"],["`$elemMatch`","Match array element conditions","`{ orders: { $elemMatch: { status: \"shipped\", total: { $gt: 50 } } } }`"]],"caption":"Common Document Query Operators","headers":["Operator","Description","Example"]},"type":"table"},{"data":{"content":"**The Aggregation Framework:**\n\nBeyond simple CRUD operations, document databases provide aggregation pipelines—sequences of data transformation stages that process documents and return computed results. This enables complex analytics without moving data to separate systems:\n\n- **$match**: Filter documents (like WHERE in SQL)\n- **$project**: Reshape documents, include/exclude fields\n- **$group**: Group by key and compute aggregates (like GROUP BY)\n- **$sort**: Order results\n- **$limit / $skip**: Pagination\n- **$unwind**: Flatten arrays for element-level operations\n- **$lookup**: Join with other collections (similar to SQL JOIN)\n- **$facet**: Run multiple aggregation pipelines in parallel"},"type":"text"},{"data":{"icon":"Lightbulb","title":"Query Optimization","content":"Like relational databases, document database queries benefit enormously from proper indexing. A query on a non-indexed field requires a full collection scan. Use explain() or equivalent to analyze query plans, and create indexes on frequently-queried fields—including nested fields like 'address.city'.","variant":"tip"},"type":"callout"}],"titleType":"number","titleNumber":5},{"id":"embedding-vs-referencing","title":"Document Embedding vs Referencing","content":[{"data":{"content":"A critical design decision in document databases is determining when to **embed** related data within a document versus when to **reference** data stored in separate documents. This choice fundamentally affects query performance, data consistency, and application complexity.\n\n**Embedding:**\n\nEmbed related data directly within the parent document as nested objects or arrays."},"type":"text"},{"data":{"code":"// EMBEDDED: Blog post with comments inside the document\n{\n \"_id\": \"post_123\",\n \"title\": \"Understanding Document Databases\",\n \"content\": \"Document databases offer a flexible approach...\",\n \"author\": {\n \"id\": \"user_456\",\n \"name\": \"Jane Developer\",\n \"avatarUrl\": \"/avatars/jane.png\"\n },\n \"comments\": [\n {\n \"id\": \"comment_001\",\n \"author\": {\n \"id\": \"user_789\",\n \"name\": \"Bob Reader\"\n },\n \"text\": \"Great article! Very helpful.\",\n \"createdAt\": \"2024-01-15T10:30:00Z\",\n \"likes\": 12\n },\n {\n \"id\": \"comment_002\",\n \"author\": {\n \"id\": \"user_321\",\n \"name\": \"Alice Commenter\"\n },\n \"text\": \"Could you elaborate on indexing strategies?\",\n \"createdAt\": \"2024-01-15T11:45:00Z\",\n \"likes\": 5\n }\n ],\n \"tags\": [\"databases\", \"nosql\", \"architecture\"],\n \"viewCount\": 1523,\n \"createdAt\": \"2024-01-14T09:00:00Z\"\n}","fileName":"embedding-example.json","showLineNumbers":true},"type":"code"},{"data":{"content":"**Referencing:**\n\nStore related data in separate documents and reference them by ID, similar to foreign keys in relational databases."},"type":"text"},{"data":{"code":"// REFERENCED: Blog post with separate comment collection\n\n// In \"posts\" collection:\n{\n \"_id\": \"post_123\",\n \"title\": \"Understanding Document Databases\",\n \"content\": \"Document databases offer a flexible approach...\",\n \"authorId\": \"user_456\",\n \"commentIds\": [\"comment_001\", \"comment_002\"],\n \"tags\": [\"databases\", \"nosql\", \"architecture\"],\n \"viewCount\": 1523,\n \"createdAt\": \"2024-01-14T09:00:00Z\"\n}\n\n// In \"comments\" collection:\n{\n \"_id\": \"comment_001\",\n \"postId\": \"post_123\",\n \"authorId\": \"user_789\",\n \"text\": \"Great article! Very helpful.\",\n \"createdAt\": \"2024-01-15T10:30:00Z\",\n \"likes\": 12\n}\n\n// In \"users\" collection:\n{\n \"_id\": \"user_456\",\n \"name\": \"Jane Developer\",\n \"email\": \"jane@example.com\",\n \"avatarUrl\": \"/avatars/jane.png\"\n}","fileName":"referencing-example.json","showLineNumbers":true},"type":"code"},{"data":{"left":[{"data":{"items":["Data is always accessed together (one-to-one ownership)","Embedded array has bounded, predictable size","Read performance is critical; minimize round trips","Data doesn't need to be accessed independently","Atomicity is important (update parent + children together)"],"title":{"icon":"CheckCircle","text":"When to Embed","type":"icon","color":"primary","variant":"outline-circle"},"variant":"accent"},"type":"list"}],"right":[{"data":{"items":["Related data grows unboundedly (millions of comments)","Data is accessed independently (users, products)","Many-to-many relationships exist","Data is shared across multiple parents","Normalization reduces redundancy significantly"],"title":{"icon":"Target","text":"When to Reference","type":"icon","color":"primary","variant":"outline-circle"},"variant":"accent"},"type":"list"}]},"type":"two-column"},{"data":{"icon":"AlertCircle","title":"Document Size Limits","content":"Most document databases impose maximum document size limits (MongoDB: 16MB). Unbounded embedding—such as all comments inside a popular post—can exceed these limits and degrade performance. For potentially large collections, always use referencing.","variant":"warning"},"type":"callout"}],"titleType":"number","titleNumber":6},{"id":"indexing-strategies","title":"Indexing Strategies","content":[{"data":{"content":"Indexes are the foundation of document database performance. Without appropriate indexes, queries require full collection scans—examining every document to find matches. With proper indexes, the same queries execute in milliseconds.\n\n**Index Types:**\n\nDocument databases support various index types optimized for different query patterns:"},"type":"text"},{"data":{"rows":[["**Single Field**","Queries filtering on one field","`db.users.createIndex({ email: 1 })`"],["**Compound**","Queries filtering on multiple fields","`db.users.createIndex({ status: 1, createdAt: -1 })`"],["**Multikey**","Indexing array fields","`db.posts.createIndex({ tags: 1 })`"],["**Text**","Full-text search","`db.articles.createIndex({ content: \"text\" })`"],["**Geospatial**","Location-based queries","`db.stores.createIndex({ location: \"2dsphere\" })`"],["**Hashed**","Sharding on high-cardinality fields","`db.users.createIndex({ email: \"hashed\" })`"],["**TTL (Time-to-Live)**","Automatic document expiration","`db.sessions.createIndex({ createdAt: 1 }, { expireAfterSeconds: 3600 })`"],["**Partial**","Index only documents matching a filter","`db.orders.createIndex({ customerId: 1 }, { partialFilterExpression: { status: \"active\" } })`"]],"caption":"Document Database Index Types","headers":["Index Type","Use Case","Example"]},"type":"table"},{"data":{"code":"$67","fileName":"indexing-examples.js","showLineNumbers":true},"type":"code"},{"data":{"items":["**Index Query Patterns, Not Fields** — Analyze actual queries and create indexes that support them; don't index every field blindly","**Compound Index Order Matters** — Place equality conditions first, then sort fields, then range conditions (ESR rule)","**Monitor Index Usage** — Use database tools to identify unused indexes (wasting write performance) and missing indexes (slow queries)","**Consider Index Size** — Indexes consume memory; ensure your working set fits in RAM","**Covered Queries** — When possible, design indexes that contain all needed fields so queries can be answered from the index alone","**Build in Background** — On production systems, create indexes in the background to avoid blocking operations"],"title":{"icon":"Zap","text":"Indexing Best Practices","type":"icon","color":"primary","variant":"outline-circle"},"variant":"glass"},"type":"list"}],"titleType":"number","titleNumber":7},{"id":"real-world-applications","title":"Real-World Applications","content":[{"data":{"content":"Document databases power some of the world's most demanding applications. Their combination of schema flexibility, horizontal scalability, and developer-friendly data modeling makes them ideal for specific use cases.\n\n**Dominant Use Cases:**"},"type":"text"},{"data":{"rows":[["**Content Management**","CMS, blogs, digital assets","Flexible schemas handle diverse content types; embedded media metadata"],["**E-commerce**","Product catalogs, shopping carts","Products have varying attributes; nested reviews, specifications, variants"],["**User Profiles**","Social networks, personalization","Profiles vary by user type; preferences, history, connections embedded"],["**IoT & Telemetry**","Sensor data, device events","High write throughput; schema evolves with device firmware updates"],["**Gaming**","Player profiles, inventory, leaderboards","Complex nested inventory; rapid schema evolution during development"],["**Real-time Analytics**","Event streams, session data","Append-only patterns; flexible event schemas; time-series optimization"],["**Mobile Backends**","BaaS, sync services","JSON-native APIs; offline sync with document merging; schema flexibility"]],"caption":"Document Database Applications by Domain","headers":["Domain","Use Case","Why Documents Excel"]},"type":"table"},{"data":{"content":"**Case Study: E-commerce Product Catalog**\n\nConsider an e-commerce platform selling electronics, clothing, and furniture. In a relational model, you'd face a dilemma:\n- **Single table with many nullable columns**: Wasteful and confusing\n- **Entity-Attribute-Value (EAV)**: Flexible but query-hostile\n- **Table-per-category**: Explosion of tables; complex application logic\n\nWith documents, each product is simply stored with its relevant attributes:"},"type":"text"},{"data":{"code":"$68","fileName":"ecommerce-products.json","showLineNumbers":true},"type":"code"},{"data":{"icon":"CheckCircle","title":"The Flexibility Payoff","content":"When the business adds a new product category (say, grocery items with expiration dates and nutritional info), no database schema changes are needed. New products simply include their category-specific fields. This agility is why document databases dominate in fast-moving product development environments.","variant":"success"},"type":"callout"}],"titleType":"number","titleNumber":8},{"id":"summary","title":"Summary: Document Model Foundations","content":[{"data":{"content":"We've explored the document data model in depth—a paradigm that has reshaped how modern applications store and query data. Let's consolidate the essential concepts:"},"type":"text"},{"data":{"type":"ordered","items":["**Documents are self-contained units** — All related data lives within a single document, eliminating join complexity and enabling data locality","**JSON dominates modern document storage** — Its simplicity, human readability, and native mapping to programming language constructs make it the default choice","**XML retains enterprise relevance** — Where namespaces, validation, and regulatory compliance matter, XML's richer feature set still wins","**Schema flexibility enables agility** — Documents in the same collection can have different structures, enabling continuous evolution without migrations","**Embedding vs referencing is a core design decision** — Choose based on access patterns, data size bounds, and consistency requirements","**Indexing is non-negotiable for performance** — Without indexes, every query becomes a collection scan; invest in proper index design","**Document stores excel at specific workloads** — Content management, catalogs, user profiles, and event data are natural fits"],"title":{"icon":"CheckCircle","text":"Key Takeaways","type":"icon","color":"primary","variant":"outline-circle"},"variant":"accent"},"type":"list"},{"data":{"content":"**What's Next:**\n\nThe document model is just one approach in the broader NoSQL landscape. In the next page, we'll examine the **key-value model**—the simplest and fastest data model, optimized for scenarios where lookup by a unique key is the dominant access pattern. You'll see how key-value stores trade query flexibility for extreme performance and simplicity."},"type":"text"},{"data":{"icon":"CheckCircle","title":"Page Complete","content":"You now have a comprehensive understanding of the document data model—its formats, schema philosophy, query capabilities, and architectural trade-offs. This knowledge is foundational for evaluating when document databases are the right choice for your applications.","variant":"success"},"type":"callout"}],"titleType":"number","titleNumber":9}],"isLocked":false},{"id":"seed_97b4fc8bcc930a6676442b1194f48de5","title":"Key-Value Model","order":1,"content":null,"isLocked":true},{"id":"seed_846446d27cbdc457023d6071bd675ab0","title":"Graph Model","order":2,"content":null,"isLocked":true},{"id":"seed_f0153b60b38dd36ddf2e0cbf94bc4571","title":"Column-Family Model","order":3,"content":null,"isLocked":true},{"id":"seed_d0f7d79f10e098f5ecd28c857e54fd18","title":"Model Selection","order":4,"content":null,"isLocked":true}]}},"dataUpdateCount":1,"dataUpdatedAt":1792287881084,"error":null,"errorUpdateCount":0,"errorUpdatedAt":0,"fetchFailureCount":0,"fetchFailureReason":null,"fetchMeta":null,"isInvalidated":false,"status":"success","fetchStatus":"idle"},"queryKey":[["learningContent","getModule"],{"input":{"slug":"document-and-other-models"},"type":"query"}],"queryHash":"[[\"learningContent\",\"getModule\"],{\"input\":{\"slug\":\"document-and-other-models\"},\"type\":\"query\"}]"},{"dehydratedAt":1792287881092,"state":{"data":{"json":null},"dataUpdateCount":1,"dataUpdatedAt":1792287881082,"error":null,"errorUpdateCount":0,"errorUpdatedAt":0,"fetchFailureCount":0,"fetchFailureReason":null,"fetchMeta":null,"isInvalidated":false,"status":"success","fetchStatus":"idle"},"queryKey":[["learningContent","getProgress"],{"input":{"moduleId":"seed_834366cc72a3278609565a4a488078f1"},"type":"query"}],"queryHash":"[[\"learningContent\",\"getProgress\"],{\"input\":{\"moduleId\":\"seed_834366cc72a3278609565a4a488078f1\"},\"type\":\"query\"}]"},{"dehydratedAt":1792287881092,"state":{"data":{"json":null},"dataUpdateCount":1,"dataUpdatedAt":1792287881082,"error":null,"errorUpdateCount":0,"errorUpdatedAt":0,"fetchFailureCount":0,"fetchFailureReason":null,"fetchMeta":null,"isInvalidated":false,"status":"success","fetchStatus":"idle"},"queryKey":[["feedback","get"],{"input":{"contentType":"LEARNING_PAGE","contentId":"seed_97b4fc8bcc930a6676442b1194f48de5"},"type":"query"}],"queryHash":"[[\"feedback\",\"get\"],{\"input\":{\"contentId\":\"seed_97b4fc8bcc930a6676442b1194f48de5\",\"contentType\":\"LEARNING_PAGE\"},\"type\":\"query\"}]"},{"dehydratedAt":1792287881092,"state":{"data":{"json":null},"dataUpdateCount":1,"dataUpdatedAt":1792287881082,"error":null,"errorUpdateCount":0,"errorUpdatedAt":0,"fetchFailureCount":0,"fetchFailureReason":null,"fetchMeta":null,"isInvalidated":false,"status":"success","fetchStatus":"idle"},"queryKey":[["feedback","getUserLike"],{"input":{"contentType":"LEARNING_PAGE","contentId":"seed_97b4fc8bcc930a6676442b1194f48de5"},"type":"query"}],"queryHash":"[[\"feedback\",\"getUserLike\"],{\"input\":{\"contentId\":\"seed_97b4fc8bcc930a6676442b1194f48de5\",\"contentType\":\"LEARNING_PAGE\"},\"type\":\"query\"}]"},{"dehydratedAt":1792287881092,"state":{"data":{"json":[]},"dataUpdateCount":1,"dataUpdatedAt":1792287881082,"error":null,"errorUpdateCount":0,"errorUpdatedAt":0,"fetchFailureCount":0,"fetchFailureReason":null,"fetchMeta":null,"isInvalidated":false,"status":"success","fetchStatus":"idle"},"queryKey":[["highlights","getHighlights"],{"input":{"contentType":"LEARNING_PAGE","contentId":"seed_97b4fc8bcc930a6676442b1194f48de5"},"type":"query"}],"queryHash":"[[\"highlights\",\"getHighlights\"],{\"input\":{\"contentId\":\"seed_97b4fc8bcc930a6676442b1194f48de5\",\"contentType\":\"LEARNING_PAGE\"},\"type\":\"query\"}]"},{"dehydratedAt":1792287881092,"state":{"data":"$undefined","dataUpdateCount":0,"dataUpdatedAt":0,"error":null,"errorUpdateCount":0,"errorUpdatedAt":0,"fetchFailureCount":0,"fetchFailureReason":null,"fetchMeta":null,"isInvalidated":false,"status":"pending","fetchStatus":"fetching"},"queryKey":[["highlights","getPopularHighlights"],{"input":{"contentType":"LEARNING_PAGE","contentId":"seed_97b4fc8bcc930a6676442b1194f48de5","minCount":2},"type":"query"}],"queryHash":"[[\"highlights\",\"getPopularHighlights\"],{\"input\":{\"contentId\":\"seed_97b4fc8bcc930a6676442b1194f48de5\",\"contentType\":\"LEARNING_PAGE\",\"minCount\":2},\"type\":\"query\"}]","promise":"$@69"}]},"children":"$L6a"}]