1. put mapping
    2. curl -XPOST '192.168.1.60:39200/abc/_mapping/tweet' -d '
    3. {
    4. "tweet":{
    5. "properties":{
    6. "name":{"type":"string","store":true}
    7. }
    8. }
    9. }
    10. '
    11. get mapping
    12. curl -XGET 192.168.1.60:39200/abc/_mapping/tweet
    13. {
    14. "cms-201607": {
    15. "mappings": {
    16. "cmslog": {
    17. "properties": {
    18. "@timestamp": {
    19. "type": "date",
    20. "format": "strict_date_optional_time||epoch_millis"
    21. },
    22. "api": {
    23. "type": "string"
    24. },
    25. "file": {
    26. "type": "string"
    27. },
    28. "ip": {
    29. "type": "string"
    30. },
    31. "lv": {
    32. "type": "string"
    33. },
    34. "lvn": {
    35. "type": "long"
    36. },
    37. "server": {
    38. "type": "string"
    39. },
    40. "sid": {
    41. "type": "string"
    42. },
    43. "ts": {
    44. "type": "string"
    45. },
    46. "tsn": {
    47. "type": "long"
    48. },
    49. "txt": {
    50. "type": "string"
    51. },
    52. "uid": {
    53. "type": "string"
    54. }
    55. }
    56. }
    57. }
    58. }
    59. }
    60. curl -XGET 'http://localhost:9200/_mapping/twitter,kimchy'
    61. curl -XGET 'http://localhost:9200/_all/_mapping/tweet,book'
    62. The API will always include a mappings section, even if there aren't any mappings. Previous versions would not return the mappings section.
    63. curl -XGET 'http://localhost:9200/_all/_mapping'
    64. curl -XGET 'http://localhost:9200/_mapping'
    65. 更新mapping
    66. cms-201607/cmslog/_mapping
    67. {
    68. "properties": {
    69. "txt": {
    70. "type": "string",
    71. "index": "not_analyzed",
    72. "store": "yes"
    73. }
    74. }
    75. }
    76. 为了能够把日期字段处理成日期,把数字字段处理成数字,把字符串字段处理成全文本(Full-text)或精确的字符串值,Elasticsearch需要知道每个字段里面都包含了什么类型。这些类型和字段的信息存储(包含)在映射(mapping)中。
    77. 正如《数据吞吐》一节所说,索引中每个文档都有一个类型(type)。 每个类型拥有自己的映射(mapping)或者模式定义(schema definition)。一个映射定义了字段类型,每个字段的数据类型,以及字段被Elasticsearch处理的方式。映射还用于设置关联到类型上的元数据。
    78. 在《映射》章节我们将探讨映射的细节。这节我们只是带你入门。1
    79. 核心简单字段类型
    80. Elasticsearch支持以下简单字段类型:
    81. 类型 表示的数据类型
    82. String string
    83. Whole number byte, short, integer, long
    84. Floating point float, double
    85. Boolean boolean
    86. Date date
    87. 当你索引一个包含新字段的文档--一个之前没有的字段--Elasticsearch将使用动态映射猜测字段类型,这类型来自于JSON的基本数据类型,使用以下规则:
    88. JSON type Field type
    89. Boolean: true or false "boolean"
    90. Whole number: 123 "long"
    91. Floating point: 123.45 "double"
    92. String, valid date: "2014-09-15" "date"
    93. String: "foo bar" "string"
    94. 注意
    95. 这意味着,如果你索引一个带引号的数字--"123",它将被映射为"string"类型,而不是"long"类型。然而,如果字段已经被映射为"long"类型,Elasticsearch将尝试转换字符串为long,并在转换失败时会抛出异常。
    96. 查看映射
    97. 我们可以使用_mapping后缀来查看Elasticsearch中的映射。在本章开始我们已经找到索引gb类型tweet中的映射:
    98. GET /gb/_mapping/tweet
    99. 这展示给了我们字段的映射(叫做属性(properties)),这些映射是Elasticsearch在创建索引时动态生成的:
    100. {
    101. "gb": {
    102. "mappings": {
    103. "tweet": {
    104. "properties": {
    105. "date": {
    106. "type": "date",
    107. "format": "strict_date_optional_time||epoch_millis"
    108. },
    109. "name": {
    110. "type": "string"
    111. },
    112. "tweet": {
    113. "type": "string"
    114. },
    115. "user_id": {
    116. "type": "long"
    117. }
    118. }
    119. }
    120. }
    121. }
    122. }
    123. 小提示
    124. 错误的映射,例如把age字段映射为string类型而不是integer类型,会造成查询结果混乱。
    125. 要检查映射类型,而不是假设它是正确的!
    126. 自定义字段映射
    127. 虽然大多数情况下基本数据类型已经能够满足,但你也会经常需要自定义一些特殊类型(fields),特别是字符串字段类型。 自定义类型可以使你完成一下几点:
    128. 区分全文(full text)字符串字段和准确字符串字段(译者注:就是分词与不分词,全文的一般要分词,准确的就不需要分词,比如『中国』这个词。全文会分成『中』和『国』,但作为一个国家标识的时候我们是不需要分词的,所以它就应该是一个准确的字符串字段)。
    129. 使用特定语言的分析器(译者注:例如中文、英文、阿拉伯语,不同文字的断字、断词方式的差异)
    130. 优化部分匹配字段
    131. 指定自定义日期格式(译者注:这个比较好理解,例如英文的 Feb,12,2016 中文的 2016212日)
    132. 以及更多
    133. 映射中最重要的字段参数是type。除了string类型的字段,你可能很少需要映射其他的type
    134. {
    135. "number_of_clicks": {
    136. "type": "integer"
    137. }
    138. }
    139. string类型的字段,默认的,考虑到包含全文本,它们的值在索引前要经过分析器分析,并且在全文搜索此字段前要把查询语句做分析处理。
    140. 对于string字段,两个最重要的映射参数是indexanalyer
    141. index
    142. index参数控制字符串以何种方式被索引。它包含以下三个值当中的一个:
    143. 解释
    144. analyzed 首先分析这个字符串,然后索引。换言之,以全文形式索引此字段。
    145. not_analyzed 索引这个字段,使之可以被搜索,但是索引内容和指定值一样。不分析此字段。
    146. no 不索引这个字段。这个字段不能为搜索到。
    147. string类型字段默认值是analyzed。如果我们想映射字段为确切值,我们需要设置它为not_analyzed
    148. {
    149. "tag": {
    150. "type": "string",
    151. "index": "not_analyzed"
    152. }
    153. }
    154. 其他简单类型(longdoubledate等等)也接受index参数,但相应的值只能是nonot_analyzed,它们的值不能被分析。
    155. 分析
    156. 对于analyzed类型的字符串字段,使用analyzer参数来指定哪一种分析器将在搜索和索引的时候使用。默认的,Elasticsearch使用standard分析器,但是你可以通过指定一个内建的分析器来更改它,例如whitespacesimpleenglish
    157. {
    158. "tweet": {
    159. "type": "string",
    160. "analyzer": "english"
    161. }
    162. }
    163. 在《自定义分析器》章节我们将告诉你如何定义和使用自定义的分析器。
    164. 更新映射
    165. 你可以在第一次创建索引的时候指定映射的类型。此外,你也可以晚些时候为新类型添加映射(或者为已有的类型更新映射)。
    166. 重要
    167. 你可以向已有映射中增加字段,但你不能修改它。如果一个字段在映射中已经存在,这可能意味着那个字段的数据已经被索引。如果你改变了字段映射,那已经被索引的数据将错误并且不能被正确的搜索到。
    168. 我们可以更新一个映射来增加一个新字段,但是不能把已有字段的类型那个从analyzed改到not_analyzed
    169. 为了演示两个指定的映射方法,让我们首先删除索引gb
    170. DELETE /gb
    171. 然后创建一个新索引,指定tweet字段的分析器为english
    172. PUT /gb <1>
    173. {
    174. "mappings": {
    175. "tweet" : {
    176. "properties" : {
    177. "tweet" : {
    178. "type" : "string",
    179. "analyzer": "english"
    180. },
    181. "date" : {
    182. "type" : "date"
    183. },
    184. "name" : {
    185. "type" : "string"
    186. },
    187. "user_id" : {
    188. "type" : "long"
    189. }
    190. }
    191. }
    192. }
    193. }
    194. <1> 这将创建包含mappings的索引,映射在请求体中指定。
    195. 再后来,我们决定在tweet的映射中增加一个新的not_analyzed类型的文本字段,叫做tag,使用_mapping后缀:
    196. PUT /gb/_mapping/tweet
    197. {
    198. "properties" : {
    199. "tag" : {
    200. "type" : "string",
    201. "index": "not_analyzed"
    202. }
    203. }
    204. }
    205. 注意到我们不再需要列出所有的已经存在的字段,因为我们没法修改他们。我们的新字段已经被合并至存在的那个映射中。
    206. 测试映射
    207. 你可以通过名字使用analyze API测试字符串字段的映射。对比这两个请求的输出:
    208. GET /gb/_analyze?field=tweet&text=Black-cats <1>
    209. GET /gb/_analyze?field=tag&text=Black-cats <2>
    210. <1> <2> 我们想要分析的文本被放在请求体中。+
    211. tweet字段产生两个词,"black""cat",tag字段产生单独的一个词"Black-cats"。换言之,我们的映射工作正常。