# ES7学习笔记（三）新建索引

# 与ES的交互方式

与es的交互方式采用http的请求方式，请求的格式如下：

curl -X<VERB> '<PROTOCOL>://<HOST>:<PORT>/<PATH>?<QUERY_STRING>' -d '<BODY>'

是请求的方法，比如：GET、POST、DELETE、PUT等。
协议：http或者https。
主机地址。
端口
API的路径。比如查看集群状态：`/_cluster/stats`。
参数。比如：?pretty，打印出格式化以后的Json。
请求的内容。比如：添加索引时的数据。

# 创建索引

es创建索引的请求方式如下：

PUT /<index>

请求的方法用PUT。
/后面直接跟索引的名称即可。
索引的设置和字段都放在Body中。

比如我们创建一个名字叫组织机构的索引，这个索引只有两个字段，一个id，一个name。并且这个索引设置为2个分片，2个副本。

我们使用POSTMAN发送请求，如下：

http://192.168.73.130:9200/orgnization

请求的方法选择PUT。然后在请求体（Body）中，写上索引的字段名称，索引的分片数和副本数，如下：

{
    "settings":{
        "number_of_shards":2,
        "number_of_replicas":2
    },
    "mappings":{
        "properties":{
            "id":{
                "type":"long"
            },
            "name":{
                "type":"text"
            }
        }
    }
}

我们观察一下，请求体中分为两个部分：settings和mappings。在settings中，我们设置了分片数和副本数。

number_of_shards：分片的数量；
number_of_replicas：副本的数量；

在mappings中，我们设置索引的字段，在这里，我们只设置了id和name，id的映射类型是long，name的映射类型是text。这些类型我们会在后续为大家介绍。

请求体写完后，我们点击发送，es返回的结果如下：

{
    "acknowledged": true,
    "shards_acknowledged": true,
    "index": "orgnization"
}

说明索引创建成功，索引的名字正是我们在请求中设置的orgnization。

然后，我们通过elasticsearch-head插件观察一下刚才创建的索引，如图：

我们可以看到索引orgnization已经创建好了，它有2个分片，分别是0和1，并且每个分片都是两个副本。如果我们仔细观察这个图，可以看出node-130节点中的0分片，和node-132节点中的1分片，它们的边框是加粗的，这说明它们是主节点，而边框没有加粗的节点是从节点，也就是我们说的副本节点。

# 查看索引

如果我们要查看一个索引的设置，可以通过如下请求方式：

GET /<index>

在我们的例子中，查看orgnization索引的设置，我们在POSTMAN中发送如下的请求：

我们可以看到索引的具体设置，比如：mapping的设置，分片和副本的设置。这些和我们创建索引时候的设置是一样的。

# 修改索引

索引一旦创建，我们是无法修改里边的内容的，不如说修改索引字段的名称。但是我们是可以向索引中添加其他字段的，添加字段的方式如下：

PUT /<index>/_mapping

然后在我们的请求体中，写好新添加的字段。比如，在我们的例子当中，新添加一个type字段，它的类型我们定义为long，请求如下：

http://192.168.73.130:9200/orgnization/_mapping

请求类型要改为PUT，请求体如下：

{
  "properties": {
    "type": {
      "type": "long"
    }
  }
}

我们点击发送，返回的结果如图所示：

添加索引字段成功，我们再使用GET查看一下索引，如图：

我们可以成功的查询到新添加的索引字段了。

# 删除索引

如果我们要删除一个索引，请求方式如下：

DELETE /<index>

假如我们要删除刚才创建的orgnization索引，我们只要把请求的方法改成DELETE，然后访问我们索引就可以，

http://192.168.73.130:9200/orgnization

# 关闭索引

如果索引被关闭，那么关于这个索引的所有读写操作都会被阻断。索引的关闭也很简单，请求方式如下：

POST /<index>/_close

在我们的例子中，如果要关闭索引，降请求方法改成POST，然后发送如下请求：

http://192.168.73.130:9200/orgnization/_close

# 打开索引

与关闭索引相对应的是打开索引，请求方式如下：

POST /<index>/_open

在我们的例子中，如果要打开索引，降请求方法改成POST，然后发送如下请求：

http://192.168.73.130:9200/orgnization/_open

# 冻结索引

冻结索引和关闭索引类似，关闭索引是既不能读，也不能写。而冻结索引是可以读，但是不能写。冻结索引的请求方式如下：

POST /<index>/_freeze

对应我们的例子当中：

http://192.168.73.130:9200/orgnization/_freeze

# 解冻索引

与冻结索引对应的是解冻索引，方式如下：

POST /<index>/_unfreeze

对应我们的例子：

http://192.168.73.130:9200/orgnization/_unfreeze

这节内容到这里就结束了。。

← ES学习（二）ES的集群原理 ES学习（四）字段类型（mapping） →