Elasticsearch 高手之路
  • Introduction
  • First Chapter
  • 1.ElasticSearch 5.x 安装
    • 1.1.Window 环境
    • 1.2.Linux 环境
  • 2.基础学前班
  • 3.基础
    • 3.1.配置文件
    • 3.2.Mapping
      • 3.2.1.字段的数据类型
        • 3.2.1.1.核心数据类型
        • 3.2.1.2.复合数据类型
        • 3.2.1.3.Geo地理数据类型
        • 3.2.1.4.特定数据类型
      • 3.2.2.Meta-Fields(元字段)
        • _index,_uid,_type,_id 元字段
        • _source,_size 元字段
        • _all, _field_names元字段
        • _parent,_routing 元字段
        • _meta 元字段
      • 3.2.3.Mapping parameters(映射参数)
        • analyzer(分析器)
        • normalizer(归一化)
        • boost(提升)权重
        • Coerce(强制类型转换)
        • copy_to(合并参数)
        • doc_values(文档值)
        • dynamic(动态设置)
        • enabled(开启字段)
        • fielddata(字段数据)
        • format (日期格式)
        • ignore_above(忽略超越限制的字段)
        • ignore_malformed(忽略格式不对的数据)
        • include_in_all(_all 查询包含字段)
        • index_options(索引设置)
        • index (索引)
        • fields(字段)
        • norms (标准信息)
        • null_value(空值)
        • position_increment_gap(短语位置间隙)
        • properties (属性)
        • search_analyzer (搜索分析器)
        • similarity (相似度模型)
        • store(存储)
        • term_vectors(词根信息)
      • 3.2.4.Dynamic Mapping(动态映射)
        • _default_ mapping(mapping中的_default_)
        • Dynamic field mapping(动态字段映射)
        • Dynamic templates(动态模板)
        • Override default template(覆盖默认模板)
    • 3.3. Analysis(分析)
      • 3.3.1.Anatomy of an analyzer(分析器的分析)
      • 3.3.2.Testing analyzers(测试分析器)
      • 3.3.3.Analyzers(分析器)
        • Configuring built-in analyzers(配置内置分析器)
        • Standard Analyzer(标准分析器)
        • Simple Analyzer(简单分析器)
        • Whitespace Analyzer(空格分析器)
        • Stop Analyzer(停止词分词器)
        • Keyword Analyzer(关键词分析器)
        • Pattern Analyzer(模式分析器)
        • Language Analyzers(语言分析器)
        • Fingerprint Analyzer(指纹分析器)
        • Custom Analyzer(自定义分析器)
      • 3.3.4. Tokenizers(分词器)
        • Standard Tokenizer(标准分词器)
        • Letter Tokenizer
        • Lowercase Tokenizer (小写分词器)
        • Whitespace Tokenizerr (空格分词器)
        • UAX URL Email Tokenizer
        • Classic Tokenizer
        • Thai Tokenizer(泰语分词器)
        • NGram Tokenizer
        • Edge NGram Tokenizer
        • Keyword Tokenizer(关键词分词器)
        • Pattern Tokenizer(模式分词器)
        • Path Hierarchy Tokenizer(路径层次分词器)
      • 3.3.5.Token Filters(词语过滤器)
      • 3.3.5.补充1:Token Filters(词语过滤器)
      • 3.3.5.补充2:Token Filters(词语过滤器)
      • 3.3.6.Character Filters(字符过滤器)
        • HTML Strip Character Filter(HTML标签过滤)
        • Mapping Character Filter(字符替换映射)
        • Pattern Replace Character Filter(正则替换字符)
    • 3.4. APIs
      • 3.4.1.索引 APIs (Indices APIs)
        • 创建/删除/获取->索引
        • 启动关闭/缩小/滚动->索引
        • 提交/获取/获取字段->映射
        • 索引->别名/是否存在/类型存在
        • 更新索引/获取->设置(未完成)
        • 分析器、索引模板(未完成)
        • Shadow replica indices 卷影副本索引
        • 索引->统计信息/段
        • 索引->恢复/分片存储
        • 清理缓存/刷新/同步刷新
        • 重新加载/强制合并
      • 3.4.2.文档 APIs (Document APIs)
        • 读写文档(Reading and Writing documents)
        • 索引文档 API
        • 获取/批量获取->文档
        • 删除/根据查询API删除
        • 更新/根据查询API更新
        • Bulk API(批量操作)
        • Reindex API(复制索引)
        • Term Vectors(词条向量)/Multi termvectors API
        • ?refresh
      • 3.4.3.搜索 APIs (Search APIs)
        • Search / URI Search
        • Request Body Search(未完成)
          • Query / From / Size
          • Sort / Source filtering
          • Fields / Script Fields / Doc value Fields
          • Post filter
          • Highlighting
          • Rescoring / Search Type
          • Scroll
          • Preference / Explain
          • Version / Index Boost
          • min_score / Named Queries
          • Inner hits / Search After
          • Field Collapsing 字段折叠
        • Search 模板/Multi Search 模板
        • Search Shards API
        • Suggesters
          • Term suggester
          • Phrase Suggester
          • Completion Suggester
          • Context Suggester
          • 返回suggester的类型
        • Multi Search API
        • Count API
        • Validate API
        • Explain API
        • Profile API
          • Profiling Queries
          • Profiling Aggregations
          • Profiling Considerations
        • Percolator / Field stats API
        • Field Capabilities API
    • 3.5.Query DSL(DSL方式查询)
      • 3.5.1.查询和过滤上下文
      • 3.5.2.Match All 查询
      • 3.5.3.全文搜索(Full Text Search)
        • 匹配查询(Match Query)
        • 短语匹配查询(Match Phrase Query)
        • 短语前缀匹配查询(Match Phrase Prefix Query)
        • 多字段查询(Multi Match Query)
        • 常用术语查询(Common Terms Query)
        • (Query String Query) 未完成
      • 3.5.4.Term级别查询(Term level queries)
        • Term 查询
        • Terms 查询
        • Range 查询(范围查询)
        • Exists 查询(非空值查询)
        • Prefix 查询(前缀查询)
        • Wildcard 查询(通配符查询)
        • Regexp 查询(正则表达式查询)
        • Fuzzy 查询(模糊查询)
        • Type Query(类型查询)
        • Ids Query(ID 查询)
      • 3.5.5.复合查询(Compound queries)
        • Constant Score 查询
        • Bool 查询
        • Dis Max 查询
        • Function Score 查询
        • Boosting 查询
        • Indices 查询
      • 3.5.6.Joining 查询(连接查询)
        • Nested Query(嵌套查询)
        • Has Child Query
        • Has Parent Query
        • Parent Id Query
      • 3.5.7.地理位置查询 (Geo queries)
        • GeoShape Query(地理形状查询)
        • Geo Bounding Box Query(地理边框查询)
        • Geo Distance Query(地理距离查询)
        • Geo Distance Range Query(地理距离范围查询)
        • Geo Polygon Query(地理多边形查询)
      • 3.5.8.专业查询(Specialized queries)
      • 3.5.9.Span 查询
        • Span Term 查询
        • Span Multi Term 查询
        • Span First 查询
        • Span Near 查询
        • Span Or 查询
        • Span Not 查询
        • Span Containing 查询
        • Span Within 查询
        • Span Field Masking 查询
    • 3.6.Aggregations(聚合分析)
      • 3.6.1.量度聚合(Metric Aggregations)
        • 平均值聚合(Avg Aggregation)
        • 基数聚合(Cardinality Aggregation)
        • 扩展统计聚合( Extended Stats Aggregation)
        • 地理边界聚合(Geo Bounds Aggregation)
        • 地理重心聚合(Geo Centroid Aggregation)
        • 最大值聚合(Max Aggregation)
        • 最小值聚合(Min Aggregation)
        • Percentiles Aggregation
        • Percentile Ranks Aggregation
        • Scripted Metric Aggregation
        • Stats Aggregation
        • 总和聚合(Sum Aggregation)
        • Top hits Aggregation
        • Value Count Aggregation
      • 3.6.2.桶聚合(Bucket Aggregations)
        • 邻接矩阵聚合(Adjacency Matrix Aggregation)
        • Children Aggregation
        • 日期直方图聚合(Date Histogram Aggregation)
        • 日期范围聚合(Date Range Aggregation)
        • 多元化的采样器聚集(Diversified Sampler Aggregation)
        • 过滤器聚合(Filter Aggregation)
        • 多过滤器聚合(Filters Aggregation)
        • 地理距离聚合(Geo Distance Aggregation)
        • GeoHash网格聚合(GeoHash grid Aggregation)
        • 全局聚合(Global Aggregation)
        • 直方图聚合(Histogram Aggregation)
        • IP范围聚合(IP Range Aggregation)
        • 丢失字段聚合(Missing Aggregation)
        • 嵌套聚合(Nested Aggregation)
        • 范围聚合(Range Aggregation)
        • Reverse nested Aggregation
        • 采样聚合(Sampler Aggregation)
        • Significant Terms Aggregation
      • 3.6.3.管道聚合(Pipeline Aggregations)
        • 平均值桶聚合( Avg Bucket Aggregation)
        • 导数聚合(Derivative Aggregation)
        • 最大值桶聚合(Max Bucket Aggregation)
        • 最小值桶聚合(Min Bucket Aggregation)
        • 总和桶聚合(Sum Bucket Aggregation)
        • 统计桶聚合(Stats Bucket Aggregation)
        • 扩展信息桶聚合(Extended Stats Bucket Aggregation)
        • 百分数桶聚合(Percentiles Bucket Aggregation)
        • Moving Average Aggregation
        • 累积汇总聚合(Cumulative Sum Aggregation)
        • 桶脚本聚合(Bucket Script Aggregation)
        • 桶选择器聚合(Bucket Selector Aggregation)
        • 串行差异聚合(Serial Differencing Aggregation)
      • 3.6.4.矩阵聚合(Matrix Aggregations)
        • 矩阵统计(Matrix Stats)
      • 3.6.5.缓存频繁聚合(Caching heavy aggregations)
      • 3.6.6.仅返回需要聚合的结果(Returning only aggregation results)
      • 3.6.7.聚合元数据(Aggregation Metadata)
      • 3.6.8.返回聚合的类型(Returning the type of the aggregation)
    • Glossary of terms (词汇表)
    • 未完成的任务
  • 4.基础补充总结
    • 3.2.Mapping
    • 3.3.分析器与定义自己的分析器(Analyzer)
  • 原理
  • 实战
    • 结构化搜索
    • 聚合分析
    • 数据建模
    • 应用场景
  • PHP API
    • 安装与快速入门
    • 配置
    • 实战
  • 资料
  • 笔记
    • 1.x 升级 2.x
Powered by GitBook
On this page
  • String 字符串型
  • String数据类型
  • text数据类型
  • keyword数据类型
  • Numeric 数字型
  • Date 日期型
  • 多日期格式
  • date字段的参数
  • Boolean 布尔型
  • Boolean字段的参数
  • Binary 二进制型
  • binary字段的参数
  • Range 范围型
  • range字段的参数

Was this helpful?

  1. 3.基础
  2. 3.2.Mapping
  3. 3.2.1.字段的数据类型

3.2.1.1.核心数据类型

分类

字段的数据类型

String 字符串型

text和keyword

Numeric 数字型

long, integer, short, byte, double, float, half_float, scaled_float

Date 日期型

date

Boolean 布尔型

boolean

Binary 二进制型

binary

Range 范围型

integer_range, float_range, long_range, double_range, date_range

String 字符串型

字符串型包括两种可用的数据类型:text和keyword

区别详解:

  • text数据类型的字段会进行分词,能够全文索引,不能够用于排序(sort) 和聚合操作(aggregations)

  • keyword数据类型不分词,够用于过滤、排序(sort) 和聚合操作(aggregations)

有时,同时具有全文( text )和关键字( keyword )版本是有帮助的:一个用于全文本搜索,另一个用于聚合和排序。这可以通过多字段实现。

举例:

字符串: xiao xia mi

text数据类型:会拆分成xiao,xia,mi 三个单词进行倒排索引

keyword数据类型:则会作为一个整体进行索引。

当进行搜索时候,term操作时(term对搜索的关键词不进行拆分,作为一个整体进行搜索),搜索“xiao xia mi“,则会作为整体进行搜索,只有keyword数据类型可以搜索的到,及时你搜索“”xiao“,仍然无法匹配,因为keyword数据类型把“xiao xia mi“作为一个整体进行索引。

  • 如果说是精确匹配(exact value),则必须类型设置为keyword数据类型,搜索时使用term搜索,如如电子邮件地址(email addresses),主机名(hostnames),状态码(status codes),邮政编码(zip codes)和标签(tags)。

  • 如果说是字段全文检索,则使用text数据类型,搜索时s会用match搜索(因为match搜索会进行分词,然后去搜索),如电子邮件内容,产品描述(product description);

注意这边有一个历史遗留问题 原来代表字符串型的只有一个string的数据类型,现在拆分成了两个text和keyword

所以即使你使用string 做为mapping,不指定index属性(是否分词),则默认是text类型

详细解析:

keyword数据类型:

PUT /test_index
{
  "mappings": {
    "test_type": {
      "properties": {
         "full_name": {
           "type": "string",
           "index": "not_analyzed"
        }
      }
    }
  }
}

以上等价于5.x如下写法, 原因:not_analyzed代表不分词,keyword数据类型代表不进行字段分词的数据类型

PUT /test_index
{
  "mappings": {
    "test_type": {
      "properties": {
         "full_name": {
           "type": "keyword"
        }
      }
    }
  }
}

text数据类型

PUT /test_index
{
  "mappings": {
    "test_type": {
      "properties": {
         "full_name": {
           "type": "string"
        }
      }
    }
  }
}

以上等价于5.x如下写法, 原因:默认为analyzed代表分词,text数据类型代表进行字段分词的数据类型

PUT /test_index
{
  "mappings": {
    "test_type": {
      "properties": {
         "full_name": {
           "type": "text"
        }
      }
    }
  }
}

发散思维:如果以下写法进行写

指定类型为text,是一个分词的数据类型,然后指定index属性为不分词,结果会是怎么样

PUT /test_index
{
  "mappings": {
    "test_type": {
      "properties": {
         "full_name": {
           "type": "text",
           "index": "not_analyzed"
        }
      }
    }
  }
}

结果查看,仍然为text数据类型:

GET /test_index/_mapping/test_type

{
  "test_index": {
    "mappings": {
      "test_type": {
        "properties": {
          "full_name": {
            "type": "text"
          }
        }
      }
    }
  }
}

String数据类型

string字段不支持在5.x中创建的索引,这是因为text和keyword字段。在5.x中创建的索引中创建字符串字段将导致Elasticsearch尝试将string升级到相应的text或keyword字段。它将返回一个HTTP Warning请求头,告诉您该string已被弃用。此升级过程并不总是完美的,因为有一些string支持的组合功能,但不被text和keyword支持 。因此,最好使用text或keyword 。

从2.x导入的索引仅支持string ,而不支持text或keyword 。为了简化从2.x Elasticsearch的迁移,将应用于从2.x导入的索引的text和keyword映射降级为string 。最终,低于5.x版本的长期索引需要及时重建,截止时间为升级到6.x之前,这种降级可以在您分配合理后时间平滑进行。

text数据类型

示例:

PUT my_index
{
  "mappings": {
    "my_type": {
      "properties": {
        "full_name": {
          "type":  "text"
        }
      }
    }
  }
}

text数据类型字段的参数

analyzer

分析器应用于analyzed字符串字段,无论是在索引时间还是在搜索时间(除非被search_analyzer )。 默认为默认索引分析器或standard分析器。

boost

映射字段级查询时间提升。 接受一个浮点数,默认为1.0 。

eager_global_ordinals

是否应该全新加载全局序号? true或false (默认)。 对于经常用于(重要)术语聚合的字段,启用此功能是一个好主意。

fielddata

是否可以使用内存中的字段数据进行排序,聚合或脚本编写?true或false (默认)

fielddata_frequency_filter

此为高级设置,允许在fielddata启用时决定哪些值加载到内存中。 默认情况下,所有值都被加载。

fields

多字段允许以多种方式将相同的字符串值索引到不同的目的,例如用于搜索的一个字段和用于排序和聚合的多字段,或由不同分析器分析的相同字符串值。

include_in_all

字段值是否应包含在_all字段中? 接受true或false 。如果index设置为no ,或者如果父object字段将include_in_all,默认设置为false。 否则默认为true 。

index

字段是否参数搜索,参数只接受 true (默认值) 和 false

index_options

索引中应存储哪些信息,以便搜索和突出显示。 默认为positions 。

norms

在评分查询时是否应考虑字段长度。 接受true (默认)或false 。

position_increment_gap

应该在字符串数组的每个元素之间插入的假项目位置的数量。 默认为在分析器上配置的position_increment_gap ,默认为100 。 100被选中,因为它阻止了匹配术语与字段值之间的合理大小的间隔(小于100)的短语查询。

store

字段值是否应与_source字段分开存储和检索。 接受true或false (默认)。

search_analyzer

analyzer应在搜索时使用在analyzed领域。 默认为analyzer设置。

search_quote_analyzer

在遇到短语时应在搜索时使用的分析器。 默认为search_analyzer设置。

similarity

应该使用哪种评分算法或相似度 。 默认为BM25

term_vector

是否应为analyzed字段存储术语向量。 默认为no 。

从5.x向2.x导入的索引不支持text类型。需要将将text类型转为string类型 ,采用重建方式。

keyword数据类型

示例:

PUT my_index
{
  "mappings": {
    "my_type": {
      "properties": {
        "tags": {
          "type":  "keyword"
        }
      }
    }
  }
}

keyword数据类型字段的参数

boost

映射字段级查询时间提升。 接受一个浮点数,默认为1.0 。

doc_values

该字段是否应该以多列的方式存储在磁盘上,以便以后可以将其用于排序,聚合或脚本? 接受true(默认)或false。

eager_global_ordinals

是否应该全新加载全局序号? true或false (默认)。 对于经常用于(重要)术语聚合的字段,启用此功能是一个好主意。

fields

多字段允许以多种方式将相同的字符串值索引到不同的目的,例如用于搜索的一个字段和用于排序和聚合的多字段,或由不同分析器分析的相同字符串值。

ignore_above

include_in_all

字段值是否应包含在_all字段中? 接受true或false 。如果index设置为no ,或者如果父object字段将include_in_all,默认设置为false。 否则默认为true 。

index

字段是否参数搜索,参数只接受 true (默认值) 和 false

index_options

索引中应存储哪些信息,以便搜索和突出显示。 默认为positions 。

norms

在评分查询时是否应考虑字段长度。 接受true (默认)或false 。

null_value

接受一个字符串作为替换任何显式空值的字段。 默认为null,这意味着该字段被视为丢失。

store

字段值是否应与_source字段分开存储和检索。 接受true或false (默认)。

search_analyzer

analyzer应在搜索时使用在analyzed领域。 默认为analyzer设置。

search_quote_analyzer

在遇到短语时应在搜索时使用的分析器。 默认为search_analyzer设置。

similarity

应该使用哪种评分算法或相似度 。 默认为BM25

从5.x向2.x导入的索引不支持text类型。需要将将text类型转为string类型 ,采用重建方式。

Numeric 数字型

下面的数字型所支持的数据类型:

long

integer

short

一个有符号的16位整数,最小值是-32,768 并且最大值是32,767

byte

一个有符号的8位整数,最小值是-128 并且最大值是127

double

双精度64位IEEE 754浮点。

float

32位单精度IEEE 754浮点。

half_float

16位IEEE 754浮点。

scaled_float

支持long数据类型和一个固定的比例因子

下面是配置一个数字字段映射的一个例子

PUT my_index
{
  "mappings": {
    "my_type": {
      "properties": {
        "number_of_bytes": {
          "type": "integer"
        },
        "time_in_seconds": {
          "type": "float"
        },
        "price": {
          "type": "scaled_float",
          "scaling_factor": 100
        }
      }
    }
  }
}

注意:double , float 和half_float数据类型的-0.0 和 +0.0是不同值。因此,做一个term查询-0.0将不匹配 +0.0,反之亦然。同样适用于范围(range)查询:如果上限是 -0.0.那么 +0.0就会不匹配,如果下界+0.0.那么 -0.0将不匹配

类型如何选择?

在满足需求的情况下,尽可能选择范围小的数据类型。比如,某个字段的取值最大值不会超过100,那么选择byte类型即可。迄今为止吉尼斯记录的人类的年龄的最大值为134岁,对于年龄字段,short足矣。字段的长度越短,索引和搜索的效率越高。 优先考虑使用带缩放因子的浮点类型。

Date 日期型

JSON没有date这种数据类型, 所以elasticsearch中的date可以是以下形式:

  • 包含格式化日期的字符串,例如 “2015-01-01”或“2015/01/01 12:10:30”。

  • 代表milliseconds-since-the-epoch的长整型数。

  • 代表seconds-since-the-epoch的整型数。

在内部,日期将转换为UTC(如果指定了时区),并将其存储为表示milliseconds-since-the-epoch的长整型数。

日期格式可以自定义,但如果没有指定格式,则使用默认格式:

"strict_date_optional_time||epoch_millis"

这意味着它将接受带有可选时间戳的日期,这些日期符合strict_date_optional_time或者milliseconds-since-the-epoch所支持的格式。

例如:

PUT my_index
{
  "mappings": {
    "my_type": {
      "properties": {
        "date": {
          "type": "date" #1
        }
      }
    }
  }
}

PUT my_index/my_type/1
{ "date": "2015-01-01" } #2

PUT my_index/my_type/2
{ "date": "2015-01-01T12:10:30Z" } #3

PUT my_index/my_type/3
{ "date": 1420070400001 } #4

GET my_index/_search
{
  "sort": { "date": "asc"} #5
}

1

日期属性使用的默认格式。

2

本文档使用纯文本。

3

本文档包含了一段时间。

4

本文档使用milliseconds-since-the-epoch.

5

请注意,返回的排序值全部以毫秒为单位。

多日期格式

可以使用||分隔多个格式 作为分隔符。 将依次尝试每种格式,直到找到匹配的格式。 第一个格式将用于将从时间的毫秒转换为字符串。

PUT my_index
{
  "mappings": {
    "my_type": {
      "properties": {
        "date": {
          "type":   "date",
          "format": "yyyy-MM-dd HH:mm:ss||yyyy-MM-dd||epoch_millis"
        }
      } 
    }
  }
}

date字段的参数

date字段接受以下参数:

映射字段级查询时间提升。 接受一个浮点数,默认为1.0。

该字段是否应该以多列的方式存储在磁盘上,以便以后可以将其用于排序,聚合或脚本? 接受true(默认)或false。

可以解析的日期格式。默认是strict_date_optional_time丨丨epoch_millis。

locale

如果为真,则格式错误的数字将被忽略。 如果为false(默认),格式错误的数字会引发异常并拒绝整个文档。

字段值是否应包含在_all字段中? 接受真或假 如果index设置为false,或者如果父对象字段将include_in_all设置为false,则默认为false。 否则默认为true。

应该可以搜索该字段吗? 接受true(默认)和false。

接受一个配置格式的日期值作为替换任何显式空值的字段。 默认为null,这意味着该字段被视为丢失。

字段值是否应与_source字段分开存储和检索。 接受true或false(默认)。

Boolean 布尔型

布尔字段接受JSONtrue和false值,但也可以接受被解释为true或false的字符串和数字:

False值

false, "false", "off", "no", "0", "", 0, 0.0

True值

任何非false值

一定要规范只使用 true 和 false

5.1.0中弃用。

虽然Elasticsearch目前在索引时间内接受上述值。 不建议使用这些伪布尔值搜索布尔域。 请改用“true”或“false”。

在5.3.0中弃用

任何非false,“false”,true和“true”的值已被弃用。

例如:

PUT my_index
{
  "mappings": {
    "my_type": {
      "properties": {
        "is_published": {
          "type": "boolean"
        }
      }
    }
  }
}

POST my_index/my_type/1
{
  "is_published": "true" #1
}

GET my_index/_search
{
  "query": {
    "term": {
      "is_published": true #2
    }
  }
}

1

索引了一个文档"true", 被解析成了true.

2

使用true搜索文档

POST my_index/my_type/1
{
  "is_published": true
}

POST my_index/my_type/2
{
  "is_published": false
}

GET my_index/_search
{
  "aggs": {
    "publish_state": {
      "terms": {
        "field": "is_published"
      }
    }
  },
  "script_fields": {
    "is_published": {
      "script": {
        "lang": "painless",
        "inline": "doc['is_published'].value"
      }
    }
  }
}

Boolean字段的参数

boolean字段接受以下参数

映射字段级查询时间提升。 接受一个浮点数,默认为1.0。

该字段是否应该以多列的方式存储在磁盘上,以便以后可以将其用于排序,聚合或脚本? 接受true(默认)或false。

应该可以搜索该字段吗?接受true(默认)和false。

接受上面列出的任何真实或虚假的价值。 该值替换任何显式空值。 默认为null,这意味着该字段被视为丢失。

字段值是否应与_sourcefield分开存储和检索。 接受true或false(默认)。

Binary 二进制型

binary(二进制)类型接受二进制值作为Base64编码字符串。 该字段默认情况下不存储,不可搜索:

PUT my_index
{
  "mappings": {
    "my_type": {
      "properties": {
        "name": {
          "type": "text"
        },
        "blob": {
          "type": "binary"
        }
      }
    }
  }
}

PUT my_index/my_type/1
{
  "name": "Some binary blob",
  "blob": "U29tZSBiaW5hcnkgYmxvYg=="  #1
}

1

Base64编码的二进制值不能有嵌入的换行符\n。

binary字段的参数

binary(二进制)字段接受一下参数

该字段是否应该以多列的方式存储在磁盘上,以便以后可以将其用于排序,聚合或脚本? 接受true(默认)或false。

字段值是否应与_sourcefield分开存储和检索。 接受true或false(默认)。

白话解析:

二进制字段是存储在索引中的二进制数据的Base64表示,可用来存储以二进制形式正常写入的数据,例如图像.基于此类型的字段在默认情况下制备存储,而不索引,因此只能提取,但无法对其执行搜索操作.

Range 范围型

支持以下范围类型:

integer_range

float_range

单精度32位IEEE 754浮点值范围。

long_range

double_range

双精度64位IEEE 754浮点值范围。

date_range

以系统纪元经过的无符号64位整数毫秒表示的日期值范围。

以下是使用各种范围字段配置映射的示例,后跟跟踪多个范围类型的示例。

PUT range_index
{
  "mappings": {
    "my_type": {
      "properties": {
        "expected_attendees": {
          "type": "integer_range"
        },
        "time_frame": {
          "type": "date_range", #1
          "format": "yyyy-MM-dd HH:mm:ss||yyyy-MM-dd||epoch_millis"
        }
      }
    }
  }
}

PUT range_index/my_type/1
{
  "expected_attendees" : { #2
    "gte" : 10,
    "lte" : 20
  },
  "time_frame" : { #3
    "gte" : "2015-10-31 12:00:00", #4
    "lte" : "2015-11-01"
  }
}

以下是date_range查询的一个例子,该日期字段名为“time_frame”。

POST range_index/_search
{
  "query" : {
    "range" : {
      "time_frame" : { #5
        "gte" : "2015-10-31",
        "lte" : "2015-11-01",
        "relation" : "within" #6
      }
    }
  }
}

上述查询产生的结果。

{
  "took": 13,
  "timed_out": false,
  "_shards" : {
    "total": 2,
    "successful": 2,
    "failed": 0
  },
  "hits" : {
    "total" : 1,
    "max_score" : 1.0,
    "hits" : [
      {
        "_index" : "range_index",
        "_type" : "my_type",
        "_id" : "1",
        "_score" : 1.0,
        "_source" : {
          "expected_attendees" : {
            "gte" : 10, "lte" : 20
          },
          "time_frame" : {
            "gte" : "2015-10-31 12:00:00", "lte" : "2015-11-01"
          }
        }
      }
    ]
  }
}

1

date_range类型接受由日期类型定义的相同字段参数。

2

举办与10至20名与会者的会议举例。

3

日期范围接受与date range queries(日期范围查询)中所述相同的格式。

4

示例日期范围使用日期时间戳。 这也接受日期数学格式,或者系统时间的“now”。

5

Range queries(范围查询)与range query(范围查询)中所述相同。

6

范围查询范围字段支持一个关系参数,可以是WITHIN,CONTAINS,INTERSECTS(默认)之一。

range字段的参数

range字段接受一下参数:

尝试将字符串转换为数字并截断整数的分数。 接受true(默认)和false。

映射字段级查询时间提升。 接受一个浮点数,默认为1.0。

字段值是否应包含在_all字段中? 接受true或者false。 如果index设置为false,或者如果父对象字段将include_in_all设置为false,则默认为false。 否则默认为true。

应该可以搜索该字段吗? 接受true(默认)和false。

字段值是否应与_source字段分开存储和检索。 接受true或false(默认)。

Previous3.2.1.字段的数据类型Next3.2.1.2.复合数据类型

Last updated 5 years ago

Was this helpful?

一个有符号的64位整数,最小值是 并且最大值是

一个有符号的32位整数,最小值是$$$$ 并且最大值是

从几个月来解析日期时使用的区域设置在所有语言中都不具有相同的名称和/或缩写。 默认为 ,

32位有符号整型数范围。最小值是,最大值是。

64位有符号整型数范围。最小值是,最大值是。

−263-2^{63}−263
263−12^{63} -1263−1
−231-2^{31}−231
231−12^{31} -1231−1
−231-2^{31}−231
231−12^{31}-1231−1
−263-2^{63}−263
263−12^{63}-1263−1
boost
doc_values
format
ROOT locale
ignore_malformed
include_in_all
index
null_value
store
boost
doc_values
index
null_value
store
doc_values
store
coerce
boost
include_in_all
index
store