小小林熬夜学编程

这个屌丝很懒，什么也没留下！

热门标签

elasticsearch 索引详解_elasticsearch创建索引指定mapper、setting、aliases

作者：小小林熬夜学编程 | 2024-05-01 12:45:01

踩

elasticsearch创建索引指定mapper、setting、aliases

索引

此文章已收录至项目 Developer-Knowledge-Base

我找到的最新的官方文档（英文）：链接

索引类似于 MySQL 中的表，

创建索引

基本使用

语法：PUT /<index>

index 就是索引名，，对于索引名，有以下限制

只能使用小写字母
不能使用这些字符 \/*?"<>|,#``
不能以 - + _ 开头
长度不能超过 255 个字节
冒号 : 在7.0 版本之前可以使用，7.0 版本之后就不能使用了

请求体

请求体内支持这些参数

aliases：（可选）索引别名，类似与 MySQL 中的视图，将单独一章来写别名

mappings：（可选）映射对象，就相当于 MySQL 中的定义表结构，索引中字段的映射。此映射可以包括：

字段名称
字段数据类型]
映射参数

settings：可选，索引设置）配置索引的选项。

mappings (索引映射)

Mapping 是定义文档如何储存与索引，就跟 MySQL 中定义表结构一样

示例：

PUT /my-index
{
  "mappings": {
    "properties": {
      "age":    { "type": "integer" },  
      "email":  { "type": "keyword"  }, 
      "name":   { "type": "text"  }     
    }
  }
}
1
2
3
4
5
6
7
8
9
10

该示例创建了一个名为 my-index 的索引，有三个映射，分别是 age， email ，name

Mapping 中的字段类型一旦设定后，禁止直接修改，原因是 Lucene 实现的倒排索引生成后不允许修改，如果修改必须重新建立新的索引，然后做 reindex 操作。

如果你想要一个字段只用于储存，而不被索引或搜索等，可以将 index 设置为 false

PUT /my-index/_mapping
{
  "properties": {
    "employee-id": {
      "type": "keyword",
      "index": false
    }
  }
}
1
2
3
4
5
6
7
8
9

这样 employee-id 字段就会被存储，但不会被索引和搜索

查看索引的映射

GET /索引名/_mapping
1

如果想查询特定字段的映射

GET /索引名/_mapping/field/字段名
1

虽然 mapping 不能修改，但是可以新增字段，通过 dynamic 参数来控制字段的新增

true ：(默认) 允许自动新增字段
false ：不允许自动新增字段，但文档可以正常发写入，但无法对新增的字段进行查询操作
strict：文档不能写入，报错

自动新增字段就是在存入文档的时候如果有未定义的字段，会直接帮你自动新增字段映射

使用示例

PUT /my-index
{
  "mappings": {
    "dynamic": false,
    "properties": {
      "age":    { "type": "integer" },  
      "email":  { "type": "keyword"  }, 
      "name":   { "type": "text"  }     
    }
  }
}
1
2
3
4
5
6
7
8
9
10
11

mapper 的参数有很多，详情可看官方文档

传送门

settings(索引设置)

static

只能在创建索引时或关闭的索引上设置

index.number_of_shards：主分片数量，默认 1
index.number_of_routing_shards：拆分索引的路由分片数量，默认值位于 2~1024 之间，依赖索引主分片数量
index.shard.check_on_startup：打开前检查分片是否损坏，默认 false
index.codec：压缩存储算法，默认 LZ4
index.routing_partition_size：自定义路由可以到达的分片数量，默认 1

dynamic

可以使用 API 实时对索引进行操作

index.number_of_replicas：主分片的副本数，默认 1
index.auto_expand_replicas：根据集群中数据节点的数量自动扩展副本的数量，默认 false
index.search.idle.after：搜索空闲之前不能接收搜索和获取请求的时间，默认 30s
index.refresh_interval：刷新操作频率，最近对索引的更改既可见，默认 1s。-1 关闭刷新操作
index.max_result_window：查询索引结果的最大数量，默认 10000
index.max_inner_result_window：内部或聚合命中最大数量，默认 100
index.max_rescore_window：打分请求的最大索引数量，默认 10000（同 index.max_result_window）
index.max_docvalue_fields_search：查询中允许的最大字段数，默认 100
index.max_script_fields：查询中允许的最大脚本字段数，默认 32
index.query.default_field：查询返回的默认字段，默认*（表示所有）

示例：

PUT /twitter
{
    "settings" : {
        "number_of_shards" : 3,
        "number_of_replicas" : 2
    }
}
1
2
3
4
5
6
7

查看设置

GET /<target>/_settings

GET /<target>/_settings/<setting>
1
2
3

查看索引

语法：GET /<target>

target 就是查询目标，可以查询多个（逗号分割），可以使用通配符 * , _all

示例

# 查询 bank 索引
GET /bank
# 查询 bank 索引与 my-index 索引
GET /bank,my-index
# 查询以 my 开头的索引
GET /my*
# 查询 bank 索引与 my 开头的索引
GET /bank,my*
1
2
3
4
5
6
7
8

查询所有索引

GET /*
1

或者

GET /_all
1

删除索引

语法：DELETE /<index>

示例：

DELETE /my-index
1

这样就删除了 my-index 索引

也可以删除多个索引，以逗号分割就可以了

DELETE /my-index,my-index1
1

还可以删除全部索引

DELETE /_all
1

打开/关闭索引

一旦索引被关闭，那么这个索引只能显示元数据信息，不能够进行读写操作。

关闭索引语法：POST /<index>/_close
打开索引语法：POST /<target>/_open

这里的路径参数 index 与 target 是一样的，都可以是以逗号分割的索引列表或者表达式

示例

关闭索引 my-index

POST /my-index/_close
1

打开索引

POST /my-index/_open
1

操作多个

关闭 my-index 与 bank

POST /my-index,bank/_close
1

关闭 my 开头的

POST /my*/_close
1

关闭所有

POST /*/_close
# 或者
POST /_all/_close
1
2
3

索引别名

索引别名大部分内容来自：博客园 - 奥辰

索引别名的官方文档：传送门

ES 中可以为索引添加别名，一个别名可以指向到多个索引中，同时在添加别名时可以设置筛选条件，指向一个索引的部分数据，实现在关系数据库汇总的视图功能，这就是 ES 中别名的强大之处。别名是一个非常实用的功能，为我们使用索引提供了极大的灵活性，许多 ES 的 API 都支持用别名来代替真实索引名。通过索引我们可以方便的进行以下操作：

实现正在云心的集群上的一个索引到另一个索引之间的无缝切换。试想一下这种藏进，由于业务变换，我们需要将业务数据有索引 1 变换到新的索引 2 上，如果没有别名，我们必须修改和总段业务系统，但是有了别名，只需要修改别名，另起指向新的索引 2 即可，这样的操作可以在用户无任何感知的情况下完成。
使数据检索等炒作更加方便。加入有两个月的日志数据，分别存放在 index_202008 和 index_202009 两个索引中，没有使用别名进行检索时，我们需要同时写上两个索引名称进行检索，使用索引后，我们可以令别名同时指向这两个索引，检索时只需要使用这个别名就可以同时在两个索引中尽心检索。
为一个索引中的部分数据创建别名，例如，一个索引中存放了一整年的数据，现在新增一个业务场景，更多的是对其中某一个月的数据进行检索，这时，我们可以在创建别名时，通过设置过滤条件 filter，可以单独令别名指向一个月的数据，使得检索更加高效。

通过上面的场景我们可以看出，ES 中别名可以指向一个索引，也可以同时指向多个索引，甚至可以通过配合过滤器 filter 指向索引中部分数据。别名可以再创建索引时添加，也可以在索引创建后进行添加，ES 中提供丰富的 API 对别名进行管理。

创建别名

创建别名有很多种方法，可以创建索引同时创建别名，也可以在创建索引后创建，既可以让别名指向多个索引，也可以让别名指向一个索引的部分数据，甚至指向一个字段。我们来一一例举这是如何操作的。

创建索引同时创建别名

例子：创建一个名为 users 用户索引，索引中记录了用户出生年，现在，我们在创建索引的同时，创建两个别名，一个别名指向整个 users 索引，并通过 filter 进行过滤，使别名只指向 2000 年出生的用户。

PUT /users
{
 "mappings":{
  "properties":{
   "birth-year":{"type":"integer"}
  }
 }
 aliases":{
  "myusers":{}
  "2000":{
   "filter":{
    "term":{"birth-year":2000}
   }
  }
 }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

其中别名 myusers 指向整个 users 索引，别名 2000 只指向 2000 年出生的用户

创建索引后创建别名

直接通过 API 路由传递别名来创建，这种方法有一下几种请求方式，注意，这种方式要求索引必须存在。

PUT /<index>/_alias/<alias>

POST /<index>/_alias/<alias>

PUT /<index>/_aliases/<alias>

POST /<index>/_aliases/<alias>
1
2
3
4
5
6
7

可以通过请求体来对别名进行设置，例如创建一个名为 2020 的别名，指向 users 索引中 birth-year 字段值为 2020 的文档。

PUT /users/alias/2020
{
 "filter":{
  "term":{
   "birth-year" : 2020
  }
 }
}
1
2
3
4
5
6
7
8

创建字段别名

索引可以拥有别名，字段也可以，在创建索引时，我们可以为字段设置一个别名。例如，为 username 字段设置一个别名 name。

PUT /users
{
 "mappings":{ 
  "properties":{ 
   "username":{
    "type":"keyword" 
   },
   "name":{
    "type":"alias", 
    "path":"username" 
   }
  }
 }
} 
1
2
3
4
5
6
7
8
9
10
11
12
13
14

修改、删除

之所在现在要将修改别名和删除出别名放在一起来说，是因为下面的这个 API 功能太多，既能够添加别名，也能修改别名，还能删除别名。 API 文档

新增别名

POST _aliases
{
  "actions": [
    {
      "add": {
        "index": "my-data-stream",
        "alias": "my-alias",
        "filter":{
   "term":{
    "birth-year" : 2020
   }
  }
      }
    }
  ]
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

actions 是一组操作集合，可以是 add ，remove

add 是添加操作，remove 是删除操作

index 是索引名 alias 是别名，还有其他参数可参阅API 文档

删除别名

POST _aliases
{
  "actions": [
    {
      "remove": {
        "index": "my-data-stream",
        "alias": "my-alias"
      }
    }
  ]
}
1
2
3
4
5
6
7
8
9
10
11

这个 API 形式上很好理解，就是想aliases路由发送一个 POST 请求，别名的信息都是在请求体中进行配置，actions表示需要进行的操作，里面每一个子项都表示一个动作，这个动作可以为add表示添加别名的操作，remove表示删除别名的操作。index表示针对哪一个索引上创建别名，alias后面跟着的就是新建或者需要删除的别名的名称。下面通过一些例子说明如何使用这一 API。

为同一索引创建多个别名

POST /_aliases
{
    "actions" : [
        {"add" : {"index" : "users", "alias" : "alias1"}},
        { "add": { "index" : "users", "alias" : "alias2"}}
    ]
}
1
2
3
4
5
6
7

删除一个别名

POST /_aliases
{
    "actions" : [
        { "add": { "index" : "users", "alias" : "alias2"}}
    ]
}
1
2
3
4
5
6

重命名一个别名

ES 中别为提供直接进行重命名操作的关键字，而是先执行 remove，然后执行 add，这一操作是原子操作，所以无需担心别名删除未创建的短暂中空期，这相当于为为原来别名创建了一个新的引用，删除旧的应用，实际还是同一个别名，例如将名为 alias1 的别名重命名为 alias2，可以这么操作：

POST /_aliases
{
    "actions" : [
        {"remove" : {"index" : "users", "alias" : "alias1"}},
        { "add": { "index" : "users", "alias" : "alias2"}}
    ]
}
1
2
3
4
5
6
7

创建一个别名指向多个索引

例如创建一个名为 myusers 的别名同时指向索引 users1 和 users2：

POST /_aliases
{
    "actions" : [
        { "add": { "indices" : ["users1","users2"], "alias" : "myusers"}}
    ]
}
1
2
3
4
5
6

也可以通过通配符来实现这一操作：

POST /_aliases
{
    "actions" : [
        { "add": { "indices" : ["users*"], "alias" : "myusers"}}
    ]
}
1
2
3
4
5
6

创建有过滤条件的别名

POST /_aliases
{
    "actions" : [
        {
            "add": {
                "indices" : ["users*"],
                "alias" : "myusers",
                "filter":{
                    "term":{
                        "birth-year" : 2020
                    }
                }
            }
        }
    ]
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

创建可写入别名

如果一个别名单独指向一个索引，那么使用别名进行写入操作是不会有问题的，但是，一个别名指向多个索引索引时，是不能进行写入操作，因为 ES 不知道将文档写入到哪一个索引。这一问题可以在创建别名时将某一个索引设置为可写来解决，注意，只能设置一个。

POST /_aliases
{
    "actions" : [
        { "add" : { "index" : "users1","alias" : "myusers" ,"is_write_index": true }},
        { "add": { "index" : "users2", "alias" : "myusers"}}
    ]
}
1
2
3
4
5
6
7

查看索引别名

查看别名是否存在

使用 HEAD 请求方式 + 别名可以查看别名是否存在：

HEAD /_alias/<alias>

HEAD /<index>/_alias/<alias>
1
2
3

如果是查看某个索引是否有某个别名，可以这么操作：

HEAD /users/_alias/myusers1
1

users 是索引名，myusers1 是别名

查看别名信息

GET /_cat/aliases/<alias>

GET /_cat/aliases
1
2
3

前者查看指定别名，后者查看集群中所有别名

索引模板与组件模板

官方文档在这 : 官方文档

索引模板：就是把已经创建好的某个索引的参数设置 (settings) 和索引映射 (mapping) 保存下来作为模板，在创建新索引时，指定要使用的模板名，就可以直接重用已经定义好的模板中的设置和映射。

模板有两种类型：索引模板和组件模板。

组件模板是可重用的构建块，用于配置映射，设置和别名；它们不会直接应用于一组索引。
索引模板可以包含组件模板的集合，也可以直接指定设置，映射和别名。

Elasticsearch 具有内置索引模板，每个索引模板的优先级为 100，适用于以下索引模式：

logs-*-*
metrics-*-*
synthetics-*-*

组件模板

创建

语法：PUT /_component_template/<component-template>

路径参数 component-template 就是要创建的组件模板的名称

Elasticsearch 具有内置组件模板

logs-mappings
logs-settings
metrics-mappings
metrics-settings
synthetics-mapping
synthetics-settings

Elastic Agent 是使用这些模板进行配置的，如果希望覆盖这些模板，就需要把 version 参数定得比内置的高

创建组件模板支持这些参数

template
- aliases ：索引别名参数
- mappings：索引映射关系
- settings：索引设置
version：组件模板的版本，会使用高版本的，没有默认值
_meta ：该索引模版的用户元数据配置，可以存放任何数据，是一个对象类型，比如可以写注释等
allow_auto_create：覆盖集群配置 action.auto_create_index

使用示例

PUT _component_template/template_1
{
  "template": {
    "settings" : {
        "number_of_shards" : 1
    },
    "aliases" : {
        "alias1" : {},
        "alias2" : {
            "filter" : {
                "term" : {"user.id" : "kimchy" }
            },
            "routing" : "shard-1"
        },
        "{index}-alias" : {} 
    },
    "version": 123,
  },
  "_meta": {
    "description": "set number of shards to one",
    "serialization": {
      "class": "MyComponentTemplate",
      "id": 10
    }
  }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26

其中 {index} 会替换成你创建的索引的名称

查询

语法：GET /_component_template/<component-template>

路径参数 <component-template> 是组件模板的名称或者表达式，可以查询多个（使用逗号分割），可以使用通配符 *

示例

GET /_component_template/temp*
1

获取所有组件模板

GET /_component_template
1

修改

直接起相同名字的覆盖就完事了

删除

语法：DELETE /_component_template/<component-template>

路径参数 <component-template> 是组件模板的名称或者表达式，可以查询多个（使用逗号分割），可以使用通配符 *

示例

DELETE /_component_template/temp*
1

索引模板

创建索引模板

语法：PUT /_index_template/<index-template>

index-template 是组件模板的名称

请求体的话有这些参数

composed_of ：（可选）组件模板的名称集合，是个字符串数组，这些组件模板是按顺序合并的，也就是说越后面的组件模板优先级越高
data_stream ：（可选）如果包含此对象，则使用模板创建数据流及其备份索引。支持空对象。
index_patterns：（必选）字符串数组，使用通配符定义匹配索引的规则
template
- aliases ：索引别名参数
- mappings：索引映射关系
- settings：索引设置
priority ：（可选）模板的优先级，默认为 0，创建新索引时会使用优先级高的模板
version：组件模板的版本，会使用高版本的，没有默认值
_meta ：该索引模版的用户元数据配置，可以存放任何数据，是一个对象类型，比如可以写注释等

示例：

PUT /_index_template/template_1
{
  "index_patterns" : ["t*"],
  "priority" : 0,
  "template": {
    "settings" : {
      "number_of_shards" : 1,
      "number_of_replicas": 0
    },
    "mappings" : {
      "_source" : { "enabled" : false }
    }
  }
}

PUT /_index_template/template_2
{
  "index_patterns" : ["te*"],
  "priority" : 1,
  "template": {
    "settings" : {
      "number_of_shards" : 2
    },
    "mappings" : {
      "_source" : { "enabled" : true }
    }
  }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28

现在这种情况，如果使用 te 开头的索引会使用模板 template_2 因为它优先级高

PUT /_component_template/template_with_2_shards
{
  "template": {
    "settings": {
      "index.number_of_shards": 2
    }
  }
}

PUT /_component_template/template_with_3_shards
{
  "template": {
    "settings": {
      "index.number_of_shards": 3
    }
  }
}

PUT /_index_template/template_1
{
  "index_patterns": ["t*"],
  "composed_of": ["template_with_2_shards", "template_with_3_shards"]
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

这样，匹配 t* 这个表达式的索引（例如：te）将会有三个主分片，因为template_with_3_shards 的优先级更高

删除索引模板

语法： DELETE /_component_template/<component-template>

路径参数component-template是需要删除的索引模板的名称，可以是表达式，可以说多个（逗号分割）

声明：本文内容由网友自发贡献，不代表【wpsshop博客】立场，版权归原作者所有，本站不承担相应法律责任。如您发现有侵权的内容，请联系我们。转载请注明出处：https://www.wpsshop.cn/w/小小林熬夜学编程/article/detail/518896