翻译【ElasticSearch Server】第一章:开始使用ElasticSearch集群(6)

时间:2023-03-09 08:06:04
翻译【ElasticSearch Server】第一章:开始使用ElasticSearch集群(6)

创建一个新文档(Creating a new document)

现在我们将尝试索引一些文档。对于我们的示例,让我们想象我们正在为我们的博客建立某种CMS。实体之一是博客的文章。使用JSON记法,在以下的例子中一个文档可以如下所示:

 {
"id": "1",
"title": "New version of Elastic Search released!",
"content": "…",
"priority": 10,
"tags": ["announce", "elasticsearch", "release"]
}

正 如我们所看到的,JSON文档包含一组字段,每个字段可以不同的形式。在我们的例子中,我们有一个数字(priority)、文本(title)和一个字 符串数组(tags)。在接下来的例子中,我们将向您展另一个类型。如前所述,ElasticSearch能猜到这些类型(因为JSON是semi- typed,就是说数字没有引号)并自动在它的内部结构自定义存储数据的方式。

现在我们想将这个记录存储在索引并使其可用于搜索。选择索引名称blog和索引类型article,我们可以通过执行以下命令:

 curl -XPUT http://localhost:9200/blog/article/1
-d '{"title": "New version of Elastic Search released!",
"content": "...",
"tags": ["announce", "elasticsearch", "release"] }'

你可以注意到CURL的新选项-d,这个选项的参数值的文本应该用作请求负载-一个请求体。这样我们可以发送更多的信息,如文档定义。

注意,唯一标识符是放置在URL中而不是请求体中。如果您忽略这个标识符,搜索会返回一个错误,类似如下:

 No handler found for uri [/blog/article/] and method [PUT]

如果一切都是正确的,服务器将用JSON响应,类似于:

 {
"ok":true,
"_index":"blog",
"_type":"article",
"_id":"1",
"_version":1
}

在前面的响应中,ElasticSearch包含操作的状态信息和显示新文档被放置的地方。有文档的唯一标识符和当前版本信息,版本号将由ElasticSearch每次文档自动递增变化。

在 上面的例子中,我们已经指定文档的标识符。但ElasticSearch可以自动生成。这似乎是非常方便的,但是只有当一个索引是唯一的数据源才适用。如 果我们使用一个数据库来存储数据和使用ElasticSearch来全文搜索,同步这些数据将会受阻,除非生成的标识符也是存储在数据库中。通过使用下面 的命令能实现生成一个唯一键。

 curl -XPOST http://localhost:9200/blog/article/ -d
'{"title": "New version of Elastic Search released!",
"content": "...",
"tags": ["announce", "elasticsearch", "release"] }'

注意是POST而不是PUT。参阅前一章REST动词,我们想要改变一个索引列表而不是创建一个新的实体,这就是为什么我们使用POST而不是PUT。服务器的响应应该类似如下:

 {
"ok" : true,
"_index" : "blog",
"_type" : "article",
"_id" : "XQmdeSe_RVamFgRHMqcZQg",
"_version" : 1
}

注意突出显示的行,有一个自动生成的唯一示标识符。