# dynamic（动态设置） 原文链接 : [https://www.elastic.co/guide/en/elasticsearch/reference/5.3/dynamic.html](https://www.elastic.co/guide/en/elasticsearch/reference/5.3/dynamic.html) 译文链接 : [http://www.apache.wiki/pages/createpage-entervariables.action?templateId=4816898&spaceKey=Elasticsearch&title=&newSpaceKey=Elasticsearch&fromPageId=9405287](http://www.apache.wiki/pages/createpage-entervariables.action?templateId=4816898&spaceKey=Elasticsearch&title=&newSpaceKey=Elasticsearch&fromPageId=9405287) 贡献者 : @您的名字，[ApacheCN](/display/~apachecn)，[Apache中文网](/display/~apachechina) ## 默认情况下,字段会动态的添加到 **document** 或者 **document **的 [inner objects](https://www.elastic.co/guide/en/elasticsearch/reference/5.3/object.html "Object datatype")（内部对象），只需要通过索引包含这个新字段的 **document。**例如: ``` curl -XPUT 'localhost:9200/my_index/my_type/1?pretty' -H 'Content-Type: application/json' -d' # 1 { "username": "johnsmith", "name": { "first": "John", "last": "Smith" } } ' curl -XGET 'localhost:9200/my_index/_mapping?pretty' # 2 curl -XPUT 'localhost:9200/my_index/my_type/2?pretty' -H 'Content-Type: application/json' -d' # 3 { "username": "marywhite", "email": "mary@white.com", "name": { "first": "Mary", "middle": "Alice", "last": "White" } } ' curl -XGET 'localhost:9200/my_index/_mapping?pretty' # 4 ``` | 1 | 这个文档介绍了字符串字段 **username ,**对象字段name，和两个在 **name** 对象下的字符串字段 ,可以称为 **name.first** 和 **name.last**。 | | 2 | 检查映射来验证上面的 **PUT**。 | | 3 | 这个文档添加两个字符串字段 **email** 和 **name.middle**。 | | 4 | 检查映射来验证上面的改动. | 新字段如何被检测和添加到映射的细节可以见  **[_Dynamic Mapping_](https://www.elastic.co/guide/en/elasticsearch/reference/5.3/dynamic-mapping.html "Dynamic Mapping").** **dynamic** 设置控制着新的字段是否可以动态的添加.有三个配置参数： | **true** | 新检测的字段被添加到映射中.（默认配置） | | **false** | 新检测的字段将被忽略。 必须明确添加新字段。 | | **strict** | 如果检测到新字段，将抛出异常并且文档是拒绝的。 | dynamic 可以在映射类型级别和每个[inner object](https://www.elastic.co/guide/en/elasticsearch/reference/5.3/object.html "Object datatype")（内部对象）进行设置。 inner object（内部对象）继承其父对象和来自于映射类型的设置. 例如 ： ``` curl -XPUT 'localhost:9200/my_index?pretty' -H 'Content-Type: application/json' -d' { "mappings": { "my_type": { "dynamic": false, # 1 "properties": { "user": { # 2 "properties": { "name": { "type": "text" }, "social_networks": { # 3 "dynamic": true, "properties": {} } } } } } } } ' ``` | 1 | **dynamic mapping**（动态映射）在类型级别被禁用,所以不会有新的顶级字段动态添加. | | 2 | **user** 对象继承类型级别设置. | | 3 | **user.social_networks** 对象允许动态映射，因此可以将新字段添加到该 **inner object** （内部对象）。 | 建议 **dynamic** 设置允许在同一索引中相同名称的字段的有不同设置。 可以使用 [PUT mapping API](https://www.elastic.co/guide/en/elasticsearch/reference/5.3/indices-put-mapping.html "Put Mapping")（PUT映射API）在现有字段上更新字段的值。