Mappages dynamiques ou explicites
Comprenez les compromis entre le mappage dynamique et les mappages définis explicitement, ainsi que la manière de contrôler le comportement du mappage dynamique.
Mappages dynamiques ou explicites est une leçon Elasticsearch & Full Text Search Systems gratuite sur CoddyKit. Ceci est la leçon 2 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.
Mappings: Schema for Data
When you put data into Elasticsearch, it needs to know what kind of data each field holds. This definition is called a mapping.
Think of a mapping as the schema for your documents, similar to a table schema in a traditional database.
There are two main ways Elasticsearch handles mappings: dynamic (automatic) and explicit (manual).
Dynamic Mapping: Auto-Schema
Dynamic mapping is Elasticsearch's default behavior. It's like an intelligent assistant that tries to guess the data type of new fields automatically.
When you index a document with a new field that Elasticsearch hasn't seen before, it analyzes the field's value and assigns a default mapping to it.
How Dynamic Mapping Works
The magic happens with the first document containing a new field. Elasticsearch inspects the value and infers its type:
"Hello"→textandkeyword123→longtrue→boolean"2023-01-01"→date
This makes getting started very quick!
Dynamic Mapping: Benefits
Dynamic mapping offers several advantages:
- Ease of Use: No need to pre-define your schema. Just index documents!
- Flexibility: Easily adapt to changing data structures or add new fields without modifying existing mappings.
- Rapid Prototyping: Great for initial data exploration and quick development cycles.
Dynamic Mapping: Drawbacks
While convenient, dynamic mapping has downsides, especially in production:
- Inconsistent Types: A field might be mapped as a
long, then later you index astring, leading to errors. - Performance Overhead: Inferring mappings takes resources. Too many unique fields can strain the cluster.
- Schema Drift: Unintended fields can be indexed, cluttering your schema and potentially causing issues.
Explicit Mapping: Taking Control
Explicit mapping means you manually define the schema for your index before you add any documents.
You tell Elasticsearch exactly what type each field should be, how it should be analyzed, and other specific settings.
Explicit Mapping: Benefits
For production systems, explicit mapping is usually preferred:
- Data Consistency: Guarantees fields always have the correct type.
- Optimized Performance: Knowing field types upfront allows Elasticsearch to store and search data more efficiently.
- Error Prevention: Prevents unexpected data types or schema changes from breaking your application.
- Full Control: Fine-tune every aspect of how your data is handled.
Controlling Dynamic Behavior
You can control how Elasticsearch handles new fields using the dynamic setting within your mapping. It can be set to:
true(default): New fields are added dynamically.false: New fields are completely ignored.strict: New fields throw an error, preventing indexing.
This setting can be applied at the index level or for specific object fields.
Example: `dynamic: false` (Ignore)
Setting "dynamic": "false" tells Elasticsearch to completely ignore any new fields that appear in documents. They won't be indexed or searchable.
This is useful if you want to prevent accidental schema changes but don't want to fail document indexing.
PUT /my_product_index
{
"mappings": {
"dynamic": "false",
"properties": {
"product_id": { "type": "keyword" },
"name": { "type": "text" }
}
}
}
PUT /my_product_index/_doc/1
{
"product_id": "PROD001",
"name": "Laptop",
"color": "Silver"
}
// The 'color' field will be ignored and not indexed.Example: `dynamic: strict` (Error)
When "dynamic": "strict", any document containing a field not explicitly defined in the mapping will cause an indexing error.
This is the strictest approach, ensuring your schema is always exactly what you defined.
PUT /my_strict_index
{
"mappings": {
"dynamic": "strict",
"properties": {
"user_id": { "type": "keyword" },
"username": { "type": "text" }
}
}
}
PUT /my_strict_index/_doc/1
{
"user_id": "U001",
"username": "Alice",
"email": "alice@example.com"
}
// This will return an error because 'email' is new.Test Your Knowledge!
Consider an index with the following mapping:
PUT /my_data
{
"mappings": {
"dynamic": "false",
"properties": {
"id": { "type": "keyword" },
"value": { "type": "long" }
}
}
}What happens if you try to index the following document?
PUT /my_data/_doc/1
{
"id": "A1",
"value": 100,
"new_field": "extra data"
}Recap: Dynamic vs. Explicit
You've learned about the two main approaches to mapping in Elasticsearch:
- Dynamic Mapping: Automatic, flexible, great for quick starts but can lead to inconsistencies.
- Explicit Mapping: Manual, controlled, crucial for production for data integrity and performance.
The dynamic setting (true, false, strict) gives you fine-grained control over how Elasticsearch reacts to new fields. Choose wisely based on your project's needs!
Apprends Elasticsearch & Full Text Search Systems avec un tuteur IA — gratuit
Écris et exécute du vrai code dans ton navigateur, obtiens de l'aide instantanée d'un tuteur IA disponible 24h/24, et reprends là où tu t'es arrêté sur le web ou dans l'app.
- Cours
- 12
- Leçons
- 48
Questions Fréquemment Posées
La leçon « Mappages dynamiques ou explicites » est-elle gratuite ?
Oui — le texte complet de « Mappages dynamiques ou explicites » 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 « Mappages dynamiques ou explicites » ?
Comprenez les compromis entre le mappage dynamique et les mappages définis explicitement, ainsi que la manière de contrôler le comportement du mappage dynamique. 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 2 sur 4.
Combien de temps prend la leçon « Mappages dynamiques ou explicites » ?
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