一 自定義mapping
- Mapping類似于數(shù)據(jù)庫中表定義伟阔,定義Index字段名搭综,字段類型及倒排索引相關配置;
- Mapping中字段類型一旦設定后站辉,禁止修改呢撞,若修改,重新建立新索引饰剥,進行reindex操作殊霞;
- 通過dynamic參數(shù)控制字段新增,參數(shù)有true/false/strict汰蓉;
##dynamic控制字段新增
##true:默認允許自動新增字段绷蹲; false:不允許自動新增字段,文檔可以正常寫入顾孽,但是無法對該字段進行查詢祝钢;strict:文檔不能寫入;
PUT my_index
{
"mappings": {
"doc": {
"dynamic":false,
"properties": {
"title": {
"type": "text"
},
"name": {
"type": "keyword"
},
"age": {
"type": "integer"
}
}
}
}
}
GET my_index/_mapping
PUT my_index/doc/1
{
"title":"hello,world",
"desc":"nothing here" ##dynamic為false岩齿,可以添加文檔太颤,但是不能查詢該字段苞俘;
}
二 常用參數(shù)設置
- copy_to
將該字段的值復制到目標字段盹沈,不會出現(xiàn)在_source中,只用來搜索吃谣;
PUT my_index
{
"mappings": {
"doc": {
"properties": {
"first_name": {
"type": "text",
"copy_to": "full_name"
},
"last_name": {
"type": "text",
"copy_to": "full_name"
},
"full_name": {
"type": "text"
}
}
}
}
}
PUT my_index/doc/1
{
"first_name": "John",
"last_name": "Smith"
}
GET my_index/_search
{
"query": {
"match": {
"full_name": { ##full_name中同時包含John和Smith
"query": "John Smith",
"operator": "and"
}
}
}
}
- index
控制當前字段是否時索引乞封,默認為true,即記錄索引岗憋,false不記錄肃晚,即不可搜索;
PUT my_index
{
"mappings": {
"doc": {
"properties": {
"cookie": {
"type": "text",
"index": false
}
}
}
}
}
PUT my_index/doc/1
{
"cookie":"name=alfred"
}
GET my_index/_search
{
"query":{
"match": {
"cookie": "name" ##Cannot search on field [cookie] since it is not indexed
}
}
}
- index_options
用于控制倒排索引記錄的內容仔戈;
docs: 記錄doc id
freqs: 記錄doc id 和 term frequencies
positions: 記錄doc id/term frequencies/term position
offsets: 記錄doc id/term frequencies/term position/character offsets
- null_value
當字段遇到null值時的處理策略关串,默認為null拧廊,即空值,es會自動忽略晋修,可以通過設定該字段的默認值吧碾;
PUT my_index
{
"mappings": {
"my_type": {
"properties": {
"status_code": {
"type": "keyword",
"null_value": "NULL"
}
}
}
}
}
PUT my_index/my_type/1
{
"status_code": null
}
PUT my_index/my_type/2
{
"status_code": []
}
GET my_index/_search
{
"query": {
"term": {
"status_code": "NULL"
}
}
}
三 數(shù)據(jù)類型
字符串型: text(分詞) keyword
數(shù)值型: long integer short byte double float half_float scaled_float
日期類型: date
布爾類型: boolean
二進制類型: binary
范圍類型: integer_range float_range long_range double_range date_range
數(shù)組類型: array
對象類型: object
嵌套類型: nested object
geo_point
geo_shape
記錄ip地址: ip
實現(xiàn)自動補全: completion
記錄分詞數(shù): token_count
記錄字符串hash值: murmur3
percolator
join
允許對用一個字段采用不同的配置,比如分詞墓卦,常見例子如對任命實現(xiàn)拼音搜索倦春,僅需再人名中增加pinyin子字段即可;
四 Dynamic Mapping
- 自動根據(jù)Json類型轉換為ES類型
- 日期自動識別
dynamic_date_formats:自定義日期類型
PUT my_index
{
"mappings":{
"my_type":{
"dynamic_date_formats":["MM/dd/yyyy"]
}
}
}
不定義mapping落剪,添加文檔后的日期格式識別為text類型
numeric_detection: 開啟字符串中數(shù)字自動識別
##將字符串中的數(shù)字識別為數(shù)值類型
PUT my_index
{
"mappings":{
"my_type":{
"numeric_dectection":true
}
}
}
PUT my_index/my_type/1
{
"my_float":"1.0",
"my_integer":"1"
}
允許根據(jù)es自動識別的數(shù)據(jù)類型/字段名等來動態(tài)設定字段類型睁本;
##match_mapping_type匹配自動識別字段類型,match忠怖,unmatch匹配字段名呢堰,path_match,path_unmath匹配路徑
PUT my_product_index
{
"mappings": {
"doc": {
"dynamic_templates": [
{
"strings": {
"match_mapping_type": "string",
"mapping": {
"type": "keyword"
}
}
}
]
}
五 Index Template
- 用于在新建索引時自動應用預先設定的配置凡泣,簡化所以創(chuàng)建暮胧,若有多個模板,根據(jù)order大小问麸,大的會覆蓋掉小的往衷;
PUT _template/test_template
{
"index_patterns": ["te*", "bar*"],
"order":0,
"settings": {
"number_of_shards": 1
},
"mappings": {
"doc": {
"_source": {
"enabled": false
},
"properties": {
"name": {
"type": "keyword"
}
}
}
}
}
PUT _template/test_template2
{
"index_patterns": ["test*"],
"order":1,
"settings": {
"number_of_shards": 1
},
"mappings": {
"doc": {
"_source": {
"enabled": true
}
}
}
}
PUT test_index
GET test_index/ ##order大的會覆蓋小的