一、索引库操作
索引库就类似数据库表,mapping映射就类似表的结构。
我们要向es中存储数据,必须先创建"库"和"表"。
1、mapping映射属性
mapping是对索引库中文档的约束,常见的mapping属性包括:
- type:字段数据类型,常见的简单类型有:
- 字符串:text(可分词的文本)、keyword(精确值,例如:品牌、国家、ip地址)
- 数值:long、integer、short、byte、double、float、
- 布尔:boolean
- 日期:date
- 对象:object
- index:是否创建索引,默认为true
- analyzer:使用哪种分词器
- properties:该字段的子字段
2、创建索引库和映射
基本语法:
- 请求方式:PUT
- 请求路径:/索引库名,可以自定义
- 请求参数:mapping映射
示例:
java
PUT /heima
{
"mappings": {
"properties": {
"info":{
"type": "text",
"analyzer": "ik_smart"
},
"email":{
"type": "keyword",
"index": "false"
},
"name":{
"type": "object",
"properties": {
"firstName": {
"type": "keyword"
}
}
}
}
}
}
创建了一个索引库,里面有object类型的name和keyword类型的email和text类型的properties
3、查询索引库
基本语法:
请求方式:GET
请求路径:/索引库名
请求参数:无
java
GET /索引库名
4、修改索引库
索引库和mapping一旦创建无法修改,但是可以添加新的字段
java
PUT /索引库名/_mapping
{
"properties": {
"新字段名":{
"type": "integer"
}
}
}
5、删除索引库
语法:
请求方式:DELETE
请求路径:/索引库名
请求参数:无
java
DELETE /索引库名
二、文档操作
一般es中的数据就被称作文档
1、新增文档
语法:
java
POST /索引库名/_doc/文档id
{
"字段1": "值1",
"字段2": "值2",
"字段3": {
"子属性1": "值3",
"子属性2": "值4"
},
// ...
}
示例:
java
POST /heima/_doc/1
{
"info": "黑马程序员Java讲师",
"email": "zy@itcast.cn",
"name": {
"firstName": "云",
"lastName": "赵"
}
}
2、查询文档
根据rest风格,新增是post,查询应该是get,不过查询一般都需要条件,这里我们把文档id带上。
语法:
java
GET /{索引库名称}/_doc/{id}
通过kibana查看数据:
java
GET /heima/_doc/1
3、删除文档
删除使用DELETE请求,同样,需要根据id进行删除:
语法:
java
DELETE /{索引库名}/_doc/id值
示例:
java
# 根据id删除数据
DELETE /heima/_doc/1
4、修改文档
修改有两种方式:
- 全量修改:直接覆盖原来的文档
- 增量修改:修改文档中的部分字段
(1)全量修改
全量修改是覆盖原来的文档,其本质是:
- 根据指定的id删除文档
- 新增一个相同id的文档
注意:如果根据id删除时,id不存在,第二步的新增也会执行,也就从修改变成了新增操作了。
语法:
java
PUT /{索引库名}/_doc/文档id
{
"字段1": "值1",
"字段2": "值2",
// ... 略
}
示例:
java
PUT /heima/_doc/1
{
"info": "黑马程序员高级Java讲师",
"email": "zy@itcast.cn",
"name": {
"firstName": "云",
"lastName": "赵"
}
}
(2)增量修改
增量修改是只修改指定id匹配的文档中的部分字段。
语法:
java
POST /{索引库名}/_update/文档id
{
"doc": {
"字段名": "新的值",
}
}
示例:
java
POST /heima/_update/1
{
"doc": {
"email": "ZhaoYun@itcast.cn"
}
}