ES之八：elasticsearch2.x下的JAVA API示例

一、index说明

相信有不少读者用elasticsearch的时候第一个难题就是如何创建好一个index。下面给出具体的样例和原则，帮助大家创建一个相对适合自己业务场景的index，有助于开展后续的开发工作。

先上创建index的模板:

curl -XPUT 'http://127.0.0.1:9200/my_index_name_v1?pretty' -d '{
  "aliases": {
    "my_index_name": {}
  },
  "settings": {
    "index": {
      "refresh_interval": "10s",
      "number_of_shards" : "",
      "number_of_replicas" : "",
      "search.slowlog.threshold.query.warn": "5s",
      "search.slowlog.threshold.query.info": "1s",
      "search.slowlog.threshold.fetch.warn": "1s",
      "search.slowlog.threshold.fetch.info": "800ms",
      "indexing.slowlog.threshold.index.warn": "12s",
      "indexing.slowlog.threshold.index.info": "5s"
    }
  },
  "mappings": {
    "my_type_name": {
      "properties": {
        "xxx_id": {
          "type": "keyword"
        },
        "timestamp" : {
          "type": "long"
        },
        "@timestamp" : {
          "type": "date"
        },
        "xxx_status": {
          "type": "integer"
        },
        "xxx_content": {
          "type": "text"
        }
      }
    }
  }
}'

现在讲该模板进行分类讲解：

URI部分

http方法：首先要注意是put方法，es的http接口严格遵从restful风格，创建属于put。大家在用某些工具注意选择正确的方法，比如cerebro插件的默认方法是post，方法使用不当，除了命令执行失败以外还有可能会污染mapping结构。
index名字：若业务类型只需要建立一个固定的index进行业务访问，强烈推荐让你的index名字加后缀_v1，方便后续因为主分片数调整或者调整某字段类型等原因需要reindex。若不加后缀，且没有指定好index的别名，最终的结果是reindex需要业务线停止写入，且需要改代码将访问index名字改为index的别名，这时可能会取名为xxx_v1，导致额外的工作。总之，建议index名字为your_indexname_v1，而别名为index_name。
pretty标记：建议加入，但不强制。

设置部分

refresh_interval：该设置主要是每隔多久刷新数据，可以让刚刚写入的数据被查到。若写入数据量较大或者业务对于变更后及时查到的要求不高，则可以设置时间大一些。推荐一些粗糙的准则，若一天的写入能超过100g的数据量，则建议至少设置为10s，500g设置为60s，1T以上设置为120s。具体的以当时集群硬件配置和所有index读取写入的情况而定。
number_of_shards和number_of_replicas：主分片数和副本分片数，推荐直接设置为12，副本分片数设置为1。具体可以参考文章：https://blog.csdn.net/tanruixing/article/details/87883896
慢日志设置：建议读取写入根据业务访问情况进行设置，唯一需要注意的是不要设置过小，则可能会将磁盘打满，甚至影响数据存储。强烈推荐必须设置，方便后续观察业务使用情况。

mapping部分

• type名字：一般来讲，推荐一个index对应一个type，若有多个type，则所有的type的字段大部分应该是相同的。若全部不同，推荐将type设置为index的名字，分成多个index，防止由于文档字段稀疏导致浪费存储。
• 字段名称包含id，推荐用keyword类型，若业务能确认一定是字符串类型，则可以用long型
• 时间戳类型，推荐为long型，方便业务访问，或者date类型，方便kibana和grafana访问。
• status或者type字段，推荐用integer类型，便于枚举
• content字段，推荐确认对应的分词器，设置为text类型，不推荐用keyword。特别是字段很长的情况。

二、命名规范：

1、inde索引命名规范：受文件系统的限制。仅可能为小写字母，不能下划线开头。同时需遵守下列规则：

1. 不能包括 , /, *, ?, ", <, >, |, 空格, 逗号, #
2. 7.0版本之前可以使用冒号:,但不建议使用并在7.0版本之后不再支持
3. 不能以这些字符 -, _, + 开头
4. 不能包括 . 或 …
5. 长度不能超过 255 个字符

以上这些命名限制是因为当Elasticsearch使用索引名称作为磁盘上的目录名称，这些名称必须符合不同操作系统的约定。
我猜想未来可能会放开这些限制，因为我们使用uuid关联索引放在磁盘上，而不使用索引名称。

2、类型：类型名称可以包括除了null的任何字符，不能以下划线开头。7.0版本之后不再支持类型，默认为_doc。

3、字段：对字段命名规范及不能完全使用空格。点号可以使用，但用于对象类型，举例：

"foo.bar.baz": "abc"

相当于：

"foo": {
  "bar": {
    "baz": "abc"
  }
}

“对象路径”必须是有效的。所以foo . . bar，这就产生了连锁反应，因为它不能解析到有效路径。类似的:

"foo.": {
  "bar": {
    "baz": "abc"
  }
}

同样这个命名也是不容许的，因为以点号结尾会造成混淆。所以. .不能使用。

4、路由：路由命名也是除了空的任何字符。问题是多个路由值传入查询字符串，使用逗号分隔，如：
?routing=foo,bar

如果路由值包含逗号，会造成路由值解析错误。

三、Elasticsearch支持文档中字段的多种不同数据类型

核心数据类型

字符串:text和keyword

（text类型的数据被用来索引长文本，例如电子邮件主体部分或者一款产品的介绍，这些文本会被分析，在建立索引文档之前会被分词器进行分词，转化为词组。经过分词机制之后es允许检索到该文本切分而成的词语，但是text类型的数据不能用来过滤、排序和聚合等操作。
    keyword类型的数据可以满足电子邮箱地址、主机名、状态码、邮政编码和标签等数据的要求，不进行分词，常常被用来过滤、排序和聚合。
    综上，可以发现text类型在存储数据的时候会默认进行分词，并生成索引。而keyword存储数据的时候，不会分词建立索引，显然，这样划分数据更加节省内存。）

数字:long、integer、short、byte、double、float、half_float、scaled_float

日期:date

日期纳秒:date_nanos

布尔:boolean

二进制:binary

范围:integer_range、float_range、long_range、double_range、date_range

复杂数据类型

对象object：用于单个JSON对象

嵌套nested：用于JSON对象数组

地理数据类型

Geo-point：geo_point表示lat/lon坐标点

Geo-shape：geo_shape用于复杂形状（如多边形）

专门的数据类型

IP：ip用于IPv4和IPv6地址

完成数据类型：completion提供自动完成建议

令牌数：token_count用于计算字符串中的令牌数量

mapper-murmur3：murmur3在索引时计算值的哈希值并将它们存储在索引中

mapper-annotated-text：annotated-text索引包含特殊标记的文本（通常用于标识命名实体）

过滤器：接受来自query-dsl的查询

连接：为同一索引中的文档定义父/子关系

别名：定义现有字段的别名

排名功能：记录数字特性以提高查询时的命中率。

密集向量：记录浮点值的密集向量。

稀疏向量：记录浮点值的稀疏向量。

按类型搜索：类似文本的字段，为查询进行优化，以实现按类型完成

数组

在Elasticsearch中，数组不需要专用字段数据类型，默认情况下，任何字段都可以包含零个或多个值，但是数组中的所有值必须具有相同的数据类型。

多字段

为不同的目的以不同的方式索引相同的字段通常是有用的，例如，字符串字段可以映射为用于全文搜索的text字段，以及用于排序或聚合的keyword字段，或者，你可以使用标准分析器、英语分析器和法语分析器索引文本字段。

这就是多字段的目的，大多数数据类型通过fields参数支持多字段。

四、elasticsearch中的复合主键，类似MYSQL唯一索引功能

在elasticsearch 无法设置多主键，只有唯一ID。
但是我们可以设置ID的规则，来实现多主键。
比如本来想设置两个主键，分别是NAME 和 AGE ，id=name_age
是因为在同一个index下，id是唯一的。

转自：https://blog.csdn.net/tanruixing/article/details/88426009

参考：https://blog.csdn.net/neweastsun/article/details/95868716

参考：https://blog.csdn.net/kakaluoteyy/article/details/80324553

参考：https://blog.csdn.net/ahahwang/article/details/90635324