关注:CodingTechWork
引言
在使用 Elasticsearch (ES) 和 Kibana 构建数据存储和分析系统时,索引模板、索引和索引别名的管理是关键步骤。本文将详细介绍如何通过 RESTful API 和 Kibana Dev Tools 创建索引模板、索引以及索引别名,并提供具体的示例代码和操作步骤。
索引模板的创建
索引模板是 Elasticsearch 中用于定义索引结构和设置的模板。它可以帮助我们为一组索引设置统一的分片数量、副本数量、字段映射等配置,从而简化索引的管理。
创建索引模板的 API 请求
创建索引模板的请求方式为 PUT,请求路径为 /_template/<template_name>
。请求体中需要定义 index_patterns
、settings
和 mappings
等内容。
- 示例代码
PUT /_template/template_demo_01
{
"index_patterns": ["demo_*"],
"settings": {
"number_of_shards": 3,
"number_of_replicas": 1
},
"mappings": {
"properties": {
"message": {
"type": "text"
},
"timestamp": {
"type": "date"
},
"severity": {
"type": "keyword"
}
}
}
}
通过 Kibana Dev Tools 创建索引模板
在 Kibana 的 Dev Tools 中,可以直接粘贴上述代码并执行。执行成功后,Elasticsearch 会返回一个包含 acknowledged 字段的响应,表示模板已成功创建。
#! Legacy index templates are deprecated in favor of composable templates.
{
"acknowledged": true
}
索引的创建
索引是 Elasticsearch 中存储数据的基本单位。通过创建索引,我们可以定义数据的存储结构和查询方式。上面已经创建了模板,我们只需要demo_
开头创建索引即可,会复用模板结构。
创建索引的 API 请求
创建索引的请求方式为 PUT,请求路径为 <index_name>
。请求体中可以指定索引的 settings
和 mappings
,如果不指定,则会使用默认值或匹配到的索引模板中的配置。
- 示例代码
PUT demo_logs_202504
通过 Kibana Dev Tools 创建索引
在 Kibana 的 Dev Tools 中,粘贴上述代码并执行。执行成功后,Elasticsearch 会返回一个包含 acknowledged 字段的响应,表示索引已成功创建。
{
"acknowledged": true,
"shards_acknowledged": true,
"index": "demo_logs_202504"
}
查看索引结构
GET demo_logs_202504
索引别名的创建
索引别名是为索引提供一个别名,方便管理和查询。通过别名,我们可以更灵活地操作索引,而无需直接使用索引名称。
创建索引别名的 API 请求
创建索引别名的请求方式为 POST,请求路径为 /_aliases
。请求体中需要定义 actions,包含 add 或 remove 操作。
示例代码
POST /_aliases
{
"actions": [
{
"add": {
"index": "demo_logs_202504",
"alias": "demo_logs_read"
}
},
{
"add": {
"index": "demo_logs_202504",
"alias": "demo_logs_write"
}
}
]
}
通过 Kibana Dev Tools 创建索引别名
在 Kibana 的 Dev Tools 中,粘贴上述代码并执行。执行成功后,Elasticsearch 会返回一个包含 acknowledged 字段的响应,表示别名已成功创建。
{
"acknowledged": true
}
查看别名
GET demo_logs_202504/_alias
{
"demo_logs_202504": {
"aliases": {
"demo_logs_read": {},
"demo_logs_write": {}
}
}
}
总结
通过本文的介绍,我们了解了如何在 Elasticsearch 和 Kibana 中创建索引模板、索引和索引别名。通过 RESTful API 和 Kibana Dev Tools,我们可以灵活地管理索引结构和别名,从而提高数据管理和查询的效率。