阅读es文档
This commit is contained in:
asahi
@@ -170,6 +170,322 @@ POST books/_doc
|
|||||||
"_primary_term": 1
|
"_primary_term": 1
|
||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
#### 向索引中添加多个document
|
||||||
|
可以使用`/_bulk`接口来在单个请求中添加多个document。`_bulk`请求的请求体由多个json串组成，json串之间通过换行符分隔。
|
||||||
|
|
||||||
|
bulk请求示例如下所示：
|
||||||
|
```
|
||||||
|
POST /_bulk
|
||||||
|
{ "index" : { "_index" : "books" } }
|
||||||
|
{"name": "Revelation Space", "author": "Alastair Reynolds", "release_date": "2000-03-15", "page_count": 585}
|
||||||
|
{ "index" : { "_index" : "books" } }
|
||||||
|
{"name": "1984", "author": "George Orwell", "release_date": "1985-06-01", "page_count": 328}
|
||||||
|
{ "index" : { "_index" : "books" } }
|
||||||
|
{"name": "Fahrenheit 451", "author": "Ray Bradbury", "release_date": "1953-10-15", "page_count": 227}
|
||||||
|
{ "index" : { "_index" : "books" } }
|
||||||
|
{"name": "Brave New World", "author": "Aldous Huxley", "release_date": "1932-06-01", "page_count": 268}
|
||||||
|
{ "index" : { "_index" : "books" } }
|
||||||
|
{"name": "The Handmaids Tale", "author": "Margaret Atwood", "release_date": "1985-06-01", "page_count": 311}
|
||||||
|
```
|
||||||
|
|
||||||
|
如果上述请求被正确处理，将会得到如下返回体：
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"errors": false,
|
||||||
|
"took": 29,
|
||||||
|
"items": [
|
||||||
|
{
|
||||||
|
"index": {
|
||||||
|
"_index": "books",
|
||||||
|
"_id": "QklI2IsBaSa7VYx_Qkh-",
|
||||||
|
"_version": 1,
|
||||||
|
"result": "created",
|
||||||
|
"_shards": {
|
||||||
|
"total": 2,
|
||||||
|
"successful": 2,
|
||||||
|
"failed": 0
|
||||||
|
},
|
||||||
|
"_seq_no": 1,
|
||||||
|
"_primary_term": 1,
|
||||||
|
"status": 201
|
||||||
|
}
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"index": {
|
||||||
|
"_index": "books",
|
||||||
|
"_id": "Q0lI2IsBaSa7VYx_Qkh-",
|
||||||
|
"_version": 1,
|
||||||
|
"result": "created",
|
||||||
|
"_shards": {
|
||||||
|
"total": 2,
|
||||||
|
"successful": 2,
|
||||||
|
"failed": 0
|
||||||
|
},
|
||||||
|
"_seq_no": 2,
|
||||||
|
"_primary_term": 1,
|
||||||
|
"status": 201
|
||||||
|
}
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"index": {
|
||||||
|
"_index": "books",
|
||||||
|
"_id": "RElI2IsBaSa7VYx_Qkh-",
|
||||||
|
"_version": 1,
|
||||||
|
"result": "created",
|
||||||
|
"_shards": {
|
||||||
|
"total": 2,
|
||||||
|
"successful": 2,
|
||||||
|
"failed": 0
|
||||||
|
},
|
||||||
|
"_seq_no": 3,
|
||||||
|
"_primary_term": 1,
|
||||||
|
"status": 201
|
||||||
|
}
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"index": {
|
||||||
|
"_index": "books",
|
||||||
|
"_id": "RUlI2IsBaSa7VYx_Qkh-",
|
||||||
|
"_version": 1,
|
||||||
|
"result": "created",
|
||||||
|
"_shards": {
|
||||||
|
"total": 2,
|
||||||
|
"successful": 2,
|
||||||
|
"failed": 0
|
||||||
|
},
|
||||||
|
"_seq_no": 4,
|
||||||
|
"_primary_term": 1,
|
||||||
|
"status": 201
|
||||||
|
}
|
||||||
|
},
|
||||||
|
{
|
||||||
|
"index": {
|
||||||
|
"_index": "books",
|
||||||
|
"_id": "RklI2IsBaSa7VYx_Qkh-",
|
||||||
|
"_version": 1,
|
||||||
|
"result": "created",
|
||||||
|
"_shards": {
|
||||||
|
"total": 2,
|
||||||
|
"successful": 2,
|
||||||
|
"failed": 0
|
||||||
|
},
|
||||||
|
"_seq_no": 5,
|
||||||
|
"_primary_term": 1,
|
||||||
|
"status": 201
|
||||||
|
}
|
||||||
|
}
|
||||||
|
]
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
### 定义mapping和data type
|
||||||
|
#### 使用dynamic mapping
|
||||||
|
当使用dynamic mapping时，elastic search默认情况下将会自动为新field创建mapping。上述示例中向索引中添加的document都使用了dynamic mapping，因为在创建索引时，并没有手动指定mapping。
|
||||||
|
|
||||||
|
可以向`books`索引中新增一个document，新增document中包含当前索引documents中不存在的字段：
|
||||||
|
```
|
||||||
|
POST /books/_doc
|
||||||
|
{
|
||||||
|
"name": "The Great Gatsby",
|
||||||
|
"author": "F. Scott Fitzgerald",
|
||||||
|
"release_date": "1925-04-10",
|
||||||
|
"page_count": 180,
|
||||||
|
"language": "EN"
|
||||||
|
}
|
||||||
|
```
|
||||||
|
此时，针对`books`索引，新字段`language`之前并不存在，会以`text`的data type被新增到mapping中。
|
||||||
|
|
||||||
|
可以通过`/{index_uid}/_mapping`请求来查看索引的mapping信息：
|
||||||
|
```
|
||||||
|
GET /books/_mapping
|
||||||
|
```
|
||||||
|
其返回的响应为：
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"books": {
|
||||||
|
"mappings": {
|
||||||
|
"properties": {
|
||||||
|
"author": {
|
||||||
|
"type": "text",
|
||||||
|
"fields": {
|
||||||
|
"keyword": {
|
||||||
|
"type": "keyword",
|
||||||
|
"ignore_above": 256
|
||||||
|
}
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"name": {
|
||||||
|
"type": "text",
|
||||||
|
"fields": {
|
||||||
|
"keyword": {
|
||||||
|
"type": "keyword",
|
||||||
|
"ignore_above": 256
|
||||||
|
}
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"new_field": {
|
||||||
|
"type": "text",
|
||||||
|
"fields": {
|
||||||
|
"keyword": {
|
||||||
|
"type": "keyword",
|
||||||
|
"ignore_above": 256
|
||||||
|
}
|
||||||
|
}
|
||||||
|
},
|
||||||
|
"page_count": {
|
||||||
|
"type": "long"
|
||||||
|
},
|
||||||
|
"release_date": {
|
||||||
|
"type": "date"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 手动指定索引的mapping
|
||||||
|
如下示例会展示如何在创建索引时手动指定索引的mapping：
|
||||||
|
```
|
||||||
|
PUT /my-explicit-mappings-books
|
||||||
|
{
|
||||||
|
"mappings": {
|
||||||
|
"dynamic": false,
|
||||||
|
"properties": {
|
||||||
|
"name": { "type": "text" },
|
||||||
|
"author": { "type": "text" },
|
||||||
|
"release_date": { "type": "date", "format": "yyyy-MM-dd" },
|
||||||
|
"page_count": { "type": "integer" }
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
上述示例中请求体含义如下：
|
||||||
|
- `"dynamic": false`: 在索引中禁用dynamic mapping，如果提交的document中包含了mapping中不存在的field，那么该提交的document将会被拒绝
|
||||||
|
- `"properties"`：properties属性定义了document中的fields及其数据类型
|
||||||
|
|
||||||
|
#### 将dynamic mapping和手动指定mapping相结合
|
||||||
|
如果在创建索引时手动指定了索引的mapping，那么在向索引中添加document时，document必须符合索引的定义。
|
||||||
|
|
||||||
|
如果要结合dynamic mapping和手动指定mapping，有如下两种方式：
|
||||||
|
- 使用update mapping Api
|
||||||
|
- 手动指定mapping时，将dynamic设置为true，此时向document中添加new field时无需对mapping执行update
|
||||||
|
|
||||||
|
### 搜索索引
|
||||||
|
#### 搜索所有文档
|
||||||
|
```
|
||||||
|
GET books/_search
|
||||||
|
```
|
||||||
|
上述请求将会搜索`books`索引中所有的文档
|
||||||
|
|
||||||
|
响应如下：
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"took": 2,
|
||||||
|
"timed_out": false,
|
||||||
|
"_shards": {
|
||||||
|
"total": 5,
|
||||||
|
"successful": 5,
|
||||||
|
"skipped": 0,
|
||||||
|
"failed": 0
|
||||||
|
},
|
||||||
|
"hits": {
|
||||||
|
"total": {
|
||||||
|
"value": 7,
|
||||||
|
"relation": "eq"
|
||||||
|
},
|
||||||
|
"max_score": 1,
|
||||||
|
"hits": [
|
||||||
|
{
|
||||||
|
"_index": "books",
|
||||||
|
"_id": "CwICQpIBO6vvGGiC_3Ls",
|
||||||
|
"_score": 1,
|
||||||
|
"_source": {
|
||||||
|
"name": "Brave New World",
|
||||||
|
"author": "Aldous Huxley",
|
||||||
|
"release_date": "1932-06-01",
|
||||||
|
"page_count": 268
|
||||||
|
}
|
||||||
|
},
|
||||||
|
... (truncated)
|
||||||
|
]
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
其中，响应体的字段含义如下：
|
||||||
|
- `took`：es执行该搜索请求花费的时间，单位为ms
|
||||||
|
- `time_out`：代表该请求是否超时
|
||||||
|
- `_shards`：代表该请求的分片数和成功数
|
||||||
|
- `hits`：hits对象中包含了执行结果
|
||||||
|
- `total`：total对象中包含了匹配结果的总数信息
|
||||||
|
- `max_score`：max_score包含了在所有匹配documents中最高的relavance score
|
||||||
|
- `_index`：该字段代表了document所属的索引
|
||||||
|
- `_id`：该字段代表document的唯一标识id
|
||||||
|
- `_score`：`_score`字段代表当前document的relavance score
|
||||||
|
- `_source`：该字段包含了indexing过程中提交的原始json对象
|
||||||
|
|
||||||
|
#### match请求
|
||||||
|
可以通过match请求来查询特定field中包含指定值的documents。这是全文本查询的标准查询。
|
||||||
|
|
||||||
|
如下示例中会查询索引中`name` field中包含`brave`的文档：
|
||||||
|
```
|
||||||
|
GET books/_search
|
||||||
|
{
|
||||||
|
"query": {
|
||||||
|
"match": {
|
||||||
|
"name": "brave"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
响应体结构如下：
|
||||||
|
```json
|
||||||
|
{
|
||||||
|
"took": 9,
|
||||||
|
"timed_out": false,
|
||||||
|
"_shards": {
|
||||||
|
"total": 5,
|
||||||
|
"successful": 5,
|
||||||
|
"skipped": 0,
|
||||||
|
"failed": 0
|
||||||
|
},
|
||||||
|
"hits": {
|
||||||
|
"total": {
|
||||||
|
"value": 1,
|
||||||
|
"relation": "eq"
|
||||||
|
},
|
||||||
|
"max_score": 0.6931471,
|
||||||
|
"hits": [
|
||||||
|
{
|
||||||
|
"_index": "books",
|
||||||
|
"_id": "CwICQpIBO6vvGGiC_3Ls",
|
||||||
|
"_score": 0.6931471,
|
||||||
|
"_source": {
|
||||||
|
"name": "Brave New World",
|
||||||
|
"author": "Aldous Huxley",
|
||||||
|
"release_date": "1932-06-01",
|
||||||
|
"page_count": 268
|
||||||
|
}
|
||||||
|
}
|
||||||
|
]
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
#### 删除索引
|
||||||
|
如果要删除创建的索引从头开始，可以使用如下方式：
|
||||||
|
```
|
||||||
|
DELETE /books
|
||||||
|
DELETE /my-explicit-mappings-books
|
||||||
|
```
|
||||||
|
删除索引将会永久删除其document、shards、元数据。
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user