Types de champs imbriqués et objets
Apprenez comment Elasticsearch gère les objets et les tableaux JSON, pourquoi le type objet par défaut aplatit les données et comment le type imbriqué préserve les relations dans les tableaux d’objets.
Types de champs imbriqués et objets est une leçon Elasticsearch & Full Text Search Systems gratuite sur CoddyKit. Ceci est la leçon 4 sur 4. Tu peux lire la leçon complète ci-dessous gratuitement — puis la pratiquer en direct dans le navigateur avec un éditeur de code intégré et un tuteur IA 24/7. Elle fait partie du parcours d'apprentissage Elasticsearch & Full Text Search Systems, et ta progression se synchronise sur le web et l'application CoddyKit. Le cours Elasticsearch & Full Text Search Systems comprend 4 leçons au total.
Certaines parties de cette leçon n'ont pas encore été traduites et s'affichent en anglais.
Storing Structured Data
Real-world documents often contain nested structures: a blog post with comments, a product with variants, or an order with line items. Elasticsearch must decide how to index these JSON objects so they stay searchable.
This lesson covers the two main approaches: the default object type and the specialized nested type.
The Default object Type
By default, any JSON object inside a document is mapped as the object type. Elasticsearch flattens the inner fields into dotted paths.
A field author.name simply becomes a normal Lucene field. This is efficient and works perfectly for single objects.
PUT my_index/_doc/1
{
"author": { "first": "Jane", "last": "Doe" }
}How Flattening Looks
Internally the object above is stored as two flat fields: author.first = Jane and author.last = Doe. The hierarchy is only conceptual; Lucene sees independent fields.
This is fine until you have an array of objects.
The Flattening Problem
Consider an array of users. After flattening, Elasticsearch loses the link between which first name belongs to which last name.
The arrays become user.first = [Alice, John] and user.last = [White, Smith] separately.
PUT my_index/_doc/2
{
"user": [
{ "first": "Alice", "last": "White" },
{ "first": "John", "last": "Smith" }
]
}Why It Matters
A query for first = Alice AND last = Smith would incorrectly match the document above, because the cross-object relationship is gone. The values are pooled together.
The nested type solves this.
Declaring a Nested Field
Set the field type to nested in the mapping. Each object in the array is then indexed as a hidden, separate Lucene document, preserving its internal field relationships.
PUT my_index
{
"mappings": {
"properties": {
"user": { "type": "nested" }
}
}
}Querying Nested Fields
You must use a nested query and specify the path. Conditions inside are evaluated against a single sub-document, so cross-object false matches disappear.
GET my_index/_search
{
"query": {
"nested": {
"path": "user",
"query": {
"bool": { "must": [
{ "match": { "user.first": "Alice" }},
{ "match": { "user.last": "Smith" }}
]}
}
}
}
}Inner Hits
Add inner_hits to a nested query to return which specific sub-document(s) matched, not just the parent document. This is essential for highlighting the relevant array element.
"nested": {
"path": "user",
"inner_hits": {},
"query": { "match": { "user.first": "Alice" } }
}Costs of Nested
Nested fields are powerful but have trade-offs:
- Each array element is a separate Lucene doc, increasing index size.
- Updating one element re-indexes the whole parent document.
- Deeply nested or large arrays can hurt performance.
Use the index.mapping.nested_objects.limit setting to cap counts.
Nested vs join
For tightly coupled data that updates together, nested is ideal. For independently updated, high-cardinality relationships, consider the join (parent-child) field type instead, which decouples updates at a higher query cost.
When to Choose Which
Use object when arrays do not require cross-field correlation. Use nested when you must match multiple fields within the same array element. Defaulting to nested for everything wastes resources.
Quick Check
Test your understanding of nested mappings.
Recap
You learned how Elasticsearch indexes JSON objects:
- The default
objecttype flattens fields and pools array values. - The
nestedtype indexes each array element separately to preserve relationships. - Query nested fields with the
nestedquery plus apath, and useinner_hitsto find matching elements. - Nested types cost more storage and require full re-indexing on element updates.
Questions Fréquemment Posées
La leçon « Types de champs imbriqués et objets » est-elle gratuite ?
Oui — le texte complet de « Types de champs imbriqués et objets » est gratuit à lire ici sur le web. Pour la pratiquer de manière interactive (un éditeur de code intégré et un tuteur IA 24/7) et déverrouiller le reste du cours Elasticsearch & Full Text Search Systems, passe à CoddyKit PRO. Le cours Elasticsearch & Full Text Search Systems comprend 4 leçons au total.
Qu'est-ce que j'apprendrai dans « Types de champs imbriqués et objets » ?
Apprenez comment Elasticsearch gère les objets et les tableaux JSON, pourquoi le type objet par défaut aplatit les données et comment le type imbriqué préserve les relations dans les tableaux d’objet… Tu pratiques Elasticsearch & Full Text Search Systems avec du code pratique que tu exécutes directement dans le navigateur, et un tuteur IA 24/7 répond à tes questions au fur et à mesure que tu avances dans la leçon.
Dois-je avoir de l'expérience pour commencer Elasticsearch & Full Text Search Systems ?
Aucune expérience préalable n'est requise. Elasticsearch & Full Text Search Systems sur CoddyKit est structuré pour les débutants jusqu'aux apprenants avancés, donc tu peux commencer ici ou depuis le début et avancer à ton rythme. Ceci est la leçon 4 sur 4.
Combien de temps prend la leçon « Types de champs imbriqués et objets » ?
La plupart des leçons CoddyKit prennent environ 5–10 minutes. Chacune est courte et interactive, tu progresses régulièrement et tu repiques exactement où tu t'es arrêté sur le web et l'app.
Peux-tu écrire et exécuter du code dans cette leçon Elasticsearch & Full Text Search Systems ?
Oui. Chaque leçon Elasticsearch & Full Text Search Systems inclut un éditeur de code intégré, tu écris et exécutes du vrai code directement dans ton navigateur et tu reçois des retours IA instantanés — aucune configuration locale requise.
Toutes les leçons de ce cours
- Personnalisation des mappages de champs
- Mappages dynamiques ou explicites
- Modèles d’index et alias
- Types de champs imbriqués et objets