Elasticsearch索引API

╰半橙微兮° 2024-04-17 22:47 73阅读 0赞

这些API负责管理索引的所有方面，如设置，别名，映射，索引模板。

# 创建索引 #

此API可用于创建索引。

//创建的索引的索引名为colleges
    POST http://localhost:9200/colleges

执行结果为

{ "acknowledged":true}

或者，加上一些设置如下 -

//创建的新的索引的索引名是colleges
    POST http://localhost:9200/colleges
    {                   
       "settings" : {   //指定该索引的一些设置
          "index" : {     
             "number_of_shards" : 5, "number_of_replicas" : 3
          }
       }
    }

执行结果

{ "acknowledged":true}

或使用映射

//创建的索引的索引名是colleges
    POST http://localhost:9200/colleges
    { 
       "settings" : {   //指定该索引的一些设置
          "number_of_shards" : 3
       },
    
       "mappings" : {   //指定该索引下的一些映射
          "type1" : {   //type名是"type1" 注意：在ES中创建一个mapping映射类似于在数据库中定义表结构，即表里面有哪些字段、字段是什么类型、字段的默认值等
             "_source" : {  "enabled" : false }, "properties" : { 
                "college_name" : {  "type" : "string" }, "college type" : { "type":"string"}
             }
          }
       }
    }

执行的结果如下：

{ "acknowledged":true}

# 删除索引 #

此API可用来删除任何索引。只需要传递一个删除请求以及指定索引的URL。 例如，

DELETE http://localhost:9200/colleges

可以通过使用`_all`或者`*`删除所有索引。如下

DELETE http://localhost:9200/_all
    或者
    DELETE http://localhost:9200/*

# 获取索引 #

这个API可以通过发送`get`请求到一个或多个索引来调用。这将返回有关索引的信息。

GET http://localhost:9200/schools

执行结果

{ 
       "schools":{      //返回有关该索引的详细信息
          "aliases":{ }, "mappings":{ 
             "school":{   //注意：在ES中的mapping映射 类似于在数据库中定义表结构，即表里面有哪些字段、字段是什么类型、字段的默认值等
                "properties":{ 
                   "city":{ "type":"string"}, "description":{ "type":"string"},
                   "fees":{ "type":"long"}, "location":{ "type":"double"},
                   "name":{ "type":"string"}, "rating":{ "type":"string"},
                   "state":{ "type":"string"}, "street":{ "type":"string"},
                   "tags":{ "type":"string"}, "zip":{ "type":"string"}
                }
             }
          },
    
          "settings":{  //该索引的一些设置信息
             "index":{  //number_of_shards是指索引的分片数，而number_of_replicas是指索引的备份数
                "creation_date":"1454409831535", "number_of_shards":"5",
                "number_of_replicas":"1", "uuid":"iKdjTtXQSMCW4xZMhpsOVA",
                "version":{ "created":"2010199"}
             }
          },
          "warmers":{ }
       }
    }

可以使用`_all`或`*`来获取所有索引的信息。

# 测试索引存在 #

HEAD twitter

![在这里插入图片描述][20190902155342989.png]  
可以通过向该索引发送“**获取请求**”来确定索引的存在。如果HTTP响应为`200`，则存在; 如果是`404`，它不存在。

# 打开/关闭索引API #

通过在`post`中添加`_close`或`_open`来请求索引，可以很容易地关闭或打开一个或多个索引。 例如，关闭索引-

//关闭了索引之后，就查不到该索引了  
说明： 关闭的索引不能进行读写操作，几乎不占集群开销。  
关闭的索引可以打开，打开走的是正常的恢复流程。

POST http://localhost:9200/schools/_close

或打开索引-

POST http://localhost:9200/schools/_open

# 索引别名 #

此API有助于使用`_aliases`关键字向任何索引提供别名。 单个别名可以映射到多个别名，且别名不能与索引具有相同的名称。 例如

POST http://localhost:9200/_aliases
    { 
       "actions" : [  //给schools索引添加一个别名 schools_pri
          {  "add" : {  "index" : "schools", "alias" : "schools_pri" } }
       ]
    }

执行结果：

{ "acknowledged":true}

然后

//我们通过别名来访问对应的索引
    GET http://localhost:9200/schools_pri

执行结果

//下面的schools是原索引名称 而schools_pri是其别名
    { "schools":{ "aliases":{ "schools_pri":{ }},"}}

# 索引设置 #

可以通过在URL结尾处附加`_settings`关键字来获取索引设置。 例如，

//下面的schools是索引的名称 后面加了个settings 代表我们要获取该索引的设置信息
    GET http://localhost:9200/schools/_settings

执行结果

{ 
       "schools":{ 
          "settings":{   //该索引的一些设置信息
             "index":{    //number_of_shards是指索引的分片数，而number_of_replicas是指索引的备份数
                "creation_date":"1454409831535", "number_of_shards":"5", 
                "number_of_replicas":"1", "uuid":"iKdjTtXQSMCW4xZMhpsOVA", 
                "version":{ "created":"2010199"}
            }
          }
       }
    }

# 索引模板 #

在创建索引时，为每个索引写定义信息可能是一件繁琐的事情，ES提供了索引模板功能，让你可以定义一个索引模板，模板中定义好settings、mapping、以及一个模式定义来匹配创建的索引。  
注意：模板只在索引创建时被参考，修改模板不会影响已创建的索引

举例来说明：新增/修改名为tempae\_1的模板，匹配名称为te\* 或 bar\*的索引创建：

//_templates是创建模板的意思， 而template_1是新建的模板的名称
    PUT _template/template_1
    {                    //该模板 匹配名称为te* 或 bar*的索引创建
      "index_patterns": ["te*", "bar*"],
      "settings": { 
        "number_of_shards": 1
      },
      "mappings": { 
        "type1": {   //注意：在ES中创建一个mapping映射类似于在数据库中定义表结构，即表里面有哪些字段、字段是什么类型、字段的默认值等
          "_source": { 
            "enabled": false
          },
          "properties": { 
            "host_name": { 
              "type": "keyword"
            },
            "created_at": { 
              "type": "date",
              "format": "EEE MMM dd HH:mm:ss Z YYYY"
            }
          }
        }
      }
    }

#### 查看索引模板 ####

GET /_template/template_1
    
    GET /_template/temp*     //这种方式是使用通配符查看
    
    GET /_template/template_1,template_2
    
    GET /_template //查看所有的索引模板

#### 删除模板 ####

//删除名为template_1的索引模板
    DELETE /_template/template_1

# 索引统计 #

此API可用于提取有关特定索引的统计信息。只需要发送一个带有索引`URL`和`_stats`关键字的`get`请求。

//查看指定索引的状态信息：
    GET http://localhost:9200/schools/_stats

执行结果

………………………………………………
    { "_shards":{ "total":10, "successful":5, "failed":0}, "_all":{ "primaries":{ "docs":{ 
       "count":3, "deleted":0}}}, "store":{ "size_in_bytes":16653, "throttle_time_in_millis":0},
    ………………………………………………

# 刷新清除数据 #

此API用于从索引内存中清除数据，并将其迁移到持久存储中，并清除内部事务日志。 例如，

//Flush，将缓存在内存中的索引数据刷新到持久存储中
    GET http://localhost:9200/schools/_flush

执行结果

{ "_shards":{ "total":10, "successful":5, "failed":0}}

本文转载自;https://www.yiibai.com/elasticsearch/elasticsearch\_index\_apis.html

[20190902155342989.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/17/5e79021ef6aa413bac179a62f2d7a872.png