当前位置:   article > 正文

Elasticsearch索引模板_es索引模板

es索引模板

目录

1、索引模板是什么

2、索引模板的操作

2.1、定制索引结构

2.2、查询索引模板

2.3、创建索引

2.4、删除索引模板

2.5、es内置的索引模板

3、模板组件

3.1、创建组件模板

3.2、查看组件模板

3.3、使用组件模板

3.4、删除组件模板


1、索引模板是什么

        当需要为同一类索引应用相同的配置、映射、别名时,如果每次创建索引都逐一配置会比较麻烦。索引模板的出现正是为了简化这种操作,使用索引模板你可以方便地为某一类索引自动配置某些共同的参数。

2、索引模板的操作

2.1、定制索引结构

        如果你想在es中创建两个索引order1和order2,这两个索引分别记录了不同业务类型的订单信息,他们的映射结构、分片数、别名都相同。为了达成这个目的,可以创建一个索引模板order-template。

  1. PUT _index_template/order-template
  2. {
  3. "index_patterns": [
  4. "order*"
  5. ],
  6. "template": {
  7. "settings": {
  8. "number_of_shards": 3,
  9. "number_of_replicas": 1
  10. },
  11. "mappings": {
  12. "properties": {
  13. "order_id": {
  14. "type": "keyword"
  15. },
  16. "order_name": {
  17. "type": "text",
  18. "fields": {
  19. "keyword": {
  20. "type": "keyword",
  21. "ignore_above": 256
  22. }
  23. }
  24. },
  25. "create_time": {
  26. "type": "date",
  27. "format": ["yyyy-MM-dd","yyyy-MM-dd HH:mm:ss"]
  28. }
  29. }
  30. },
  31. "aliases": {
  32. "order": {}
  33. }
  34. },
  35. "version": 3,
  36. "priority": 100,
  37. "_meta":{
  38. "description":"this is order-template"
  39. }
  40. }

        在上面的配置中,index_patterns用于设置索引模板可以匹配的索引名称,这里使用*号通配符,表示所有以order开头的索引都会使用上面的模板。这个模板还配置了索引的分片数为3、副本分片数为1、字段映射和别名。priority用来设置模板的优先级,其值越大优先级越高。version表示版本号,_meta可以保存一些元数据。当模板order-template已经存在时,再次编辑模板配置并发送上述请求可以修改模板的内容。

2.2、查询索引模板

        如果想查询索引模板信息,可以使用下面的代码

GET _index_template/order-template

2.3、创建索引

        索引模板创建之后,当我们创建索引时,如果索引名称被索引模板匹配到,就会自动加载索引模板的配置到索引映射中。

        创建一个索引,索引名为order001

PUT order001

        创建成功后,查看索引的配置信息

GET order001

        查询成功后,可以在代码运行结果中看到模板中的配置已经在索引order001中得到应用,运行结果如下

  1. {
  2. "order001" : {
  3. "aliases" : {
  4. "order" : { }
  5. },
  6. "mappings" : {
  7. "properties" : {
  8. "create_time" : {
  9. "type" : "date",
  10. "format" : "[yyyy-MM-dd, yyyy-MM-dd HH:mm:ss]"
  11. },
  12. "order_id" : {
  13. "type" : "keyword"
  14. },
  15. "order_name" : {
  16. "type" : "text",
  17. "fields" : {
  18. "keyword" : {
  19. "type" : "keyword",
  20. "ignore_above" : 256
  21. }
  22. }
  23. }
  24. }
  25. },
  26. "settings" : {
  27. "index" : {
  28. "creation_date" : "1698127116029",
  29. "number_of_shards" : "3",
  30. "number_of_replicas" : "1",
  31. "uuid" : "gZG1JzzrTtGC4OrvPwujuA",
  32. "version" : {
  33. "created" : "7090199"
  34. },
  35. "provided_name" : "order001"
  36. }
  37. }
  38. }
  39. }

        如果你想在创建索引时自定义一些配置,可以在创建索引映射时指定,这样就可以覆盖掉索引模板的配置。创建一个索引,名称为order002,自定义分片数为5,副本分片数为2,新增一个字段amount,调整create_time字段的时间格式,代码如下

  1. PUT order002
  2. {
  3. "settings": {
  4. "number_of_shards": 5,
  5. "number_of_replicas": 2
  6. },
  7. "mappings": {
  8. "properties": {
  9. "amount":{
  10. "type": "float"
  11. },
  12. "create_time":{
  13. "type": "date",
  14. "format": ["yyyy/MM/dd HH/mm/ss"]
  15. }
  16. }
  17. }
  18. }

        查看order002的索引映射结果

GET order002

      查询成功后,可以在代码运行结果中看到order002的索引映射中的配置确实成功覆盖了索引模板中的配置

  1. {
  2. "order002" : {
  3. "aliases" : {
  4. "order" : { }
  5. },
  6. "mappings" : {
  7. "properties" : {
  8. "amount" : {
  9. "type" : "float"
  10. },
  11. "create_time" : {
  12. "type" : "date",
  13. "format" : "[yyyy/MM/dd HH/mm/ss]"
  14. },
  15. "order_id" : {
  16. "type" : "keyword"
  17. },
  18. "order_name" : {
  19. "type" : "text",
  20. "fields" : {
  21. "keyword" : {
  22. "type" : "keyword",
  23. "ignore_above" : 256
  24. }
  25. }
  26. }
  27. }
  28. },
  29. "settings" : {
  30. "index" : {
  31. "creation_date" : "1698127721114",
  32. "number_of_shards" : "5",
  33. "number_of_replicas" : "2",
  34. "uuid" : "K3NlLyaGTOW9c8W8ZcSO5g",
  35. "version" : {
  36. "created" : "7090199"
  37. },
  38. "provided_name" : "order002"
  39. }
  40. }
  41. }
  42. }

2.4、删除索引模板

        删除索引模板,执行如下代码

DELETE _index_template/order-template

2.5、es内置的索引模板

        Elasticsearch内置了两个索引模板,索引模板名称分别为metrics和logs,分别用来匹配名称符合logs-*-*和metrics-*-*的索引。在创建索引和索引模板时要特别注意不要匹配错索引模板,以避免最后索引配置的效果达不到预期。

  1. GET _index_template
  2. {
  3. "index_templates" : [
  4. {
  5. "name" : "metrics",
  6. "index_template" : {
  7. "index_patterns" : [
  8. "metrics-*-*"
  9. ],
  10. "composed_of" : [
  11. "metrics-mappings",
  12. "metrics-settings"
  13. ],
  14. "priority" : 100,
  15. "version" : 0,
  16. "_meta" : {
  17. "managed" : true,
  18. "description" : "default metrics template installed by x-pack"
  19. },
  20. "data_stream" : { }
  21. }
  22. },
  23. {
  24. "name" : "logs",
  25. "index_template" : {
  26. "index_patterns" : [
  27. "logs-*-*"
  28. ],
  29. "composed_of" : [
  30. "logs-mappings",
  31. "logs-settings"
  32. ],
  33. "priority" : 100,
  34. "version" : 0,
  35. "_meta" : {
  36. "managed" : true,
  37. "description" : "default logs template installed by x-pack"
  38. },
  39. "data_stream" : { }
  40. }
  41. }
  42. ]
  43. }

3、模板组件

       按照文章上面的操作我们已经可以快速地创建索引模板,并可以把配置自动应用到匹配的索引中了,但是这样做会使得索引模板的配置内容较多。为了简化索引模板中的配置内容,我们可以把常规的索引设置、映射等内容写成可复用的模板组件,然后在索引模板中引用这些组件,这样模板中的配置内容就会非常简洁,便于移植和管理。

3.1、创建组件模板

        创建组件模板component001和component002

  1. PUT _component_template/component001
  2. {
  3. "template":{
  4. "mappings":{
  5. "properties":{
  6. "date":{
  7. "type":"date",
  8. "format":["yyy-MM-dd HH:mm:ss"]
  9. }
  10. }
  11. }
  12. }
  13. }
  14. PUT _component_template/component002
  15. {
  16. "template": {
  17. "settings": {
  18. "number_of_shards": "3",
  19. "number_of_replicas": "1"
  20. },
  21. "aliases": {
  22. "mycomp": {}
  23. }
  24. }
  25. }

3.2、查看组件模板

        组件模板创建成功后,我们可以执行代码查看组件模板的端点信息

  1. GET _component_template/component*
  2. {
  3. "component_templates" : [
  4. {
  5. "name" : "component002",
  6. "component_template" : {
  7. "template" : {
  8. "settings" : {
  9. "index" : {
  10. "number_of_shards" : "3",
  11. "number_of_replicas" : "1"
  12. }
  13. },
  14. "aliases" : {
  15. "mycomp" : { }
  16. }
  17. }
  18. }
  19. },
  20. {
  21. "name" : "component001",
  22. "component_template" : {
  23. "template" : {
  24. "mappings" : {
  25. "properties" : {
  26. "date" : {
  27. "format" : [
  28. "yyy-MM-dd HH:mm:ss"
  29. ],
  30. "type" : "date"
  31. }
  32. }
  33. }
  34. }
  35. }
  36. }
  37. ]
  38. }

3.3、使用组件模板

        创建一个索引模板comp-test,把上面两个组件模板加载到索引模板中,索引模板就会匹配所有名称以comp开头的索引。

  1. PUT _index_template/comp-test
  2. {
  3. "index_patterns": ["comp*"],
  4. "priority": 100,
  5. "composed_of": ["component001", "component002"]
  6. }

        创建索引comp001并查看索引,可以在结果中看到两个组件模板中的配置信息

  1. PUT comp001
  2. GET comp001
  3. {
  4. "comp001" : {
  5. "aliases" : {
  6. "mycomp" : { }
  7. },
  8. "mappings" : {
  9. "properties" : {
  10. "date" : {
  11. "type" : "date",
  12. "format" : "[yyy-MM-dd HH:mm:ss]"
  13. }
  14. }
  15. },
  16. "settings" : {
  17. "index" : {
  18. "creation_date" : "1698129925357",
  19. "number_of_shards" : "3",
  20. "number_of_replicas" : "1",
  21. "uuid" : "2CT06CcGTBmHsUFIrmICkQ",
  22. "version" : {
  23. "created" : "7090199"
  24. },
  25. "provided_name" : "comp001"
  26. }
  27. }
  28. }
  29. }

3.4、删除组件模板

        删除组件模板时,需要先删除相关的索引模板,否则会报错,删除顺序如下

  1. DELETE _index_template/comp-test
  2. DELETE _component_template/component001
  3. DELETE _component_template/component002

声明:本文内容由网友自发贡献,不代表【wpsshop博客】立场,版权归原作者所有,本站不承担相应法律责任。如您发现有侵权的内容,请联系我们。转载请注明出处:https://www.wpsshop.cn/w/小舞很执着/article/detail/903709
推荐阅读
相关标签
  

闽ICP备14008679号