Elasticsearch学习笔记（六）—Elasticsearch文档及其CRUD操作

最新推荐文章于 2024-04-27 02:01:30 发布
最新推荐文章于 2024-04-27 02:01:30 发布
阅读量269 收藏
点赞数
分类专栏： ElasticSearch 文章标签： Elasticsearch API 文档
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/ljjzj/article/details/101447338
版权

一、文档

最顶层结构或者根对象(root object)序列化成的JSON数据（以唯一ID标识并存储于Elasticsearch中），可以认为对象(object)和文档(document)是等价相通的。

文档元数据

节点说明
_index文档存储的地方
_type文档代表的对象的类
_id文档的唯一标识

_index
索引(index)类似于关系型数据库里的“数据库”——它是我们存储和索引关联数据的地方。数据被存储和索引在分片(shards)中， 索引只是一个把一个或多个分片分组在一起的逻辑空间。索引名必须是全部小写， 不能以下划线开头， 不能包含逗号

_type
在关系型数据库中， 我们经常将相同类的对象存储在一个表里， 因为它们有着相同的结构。 同理， 在Elasticsearch中， 我们使用相同类型(type)的文档表示相同的“事物”， 因为他们的数据结构也是相同的

_id
id仅仅是一个字符串， 它与 _index 和 _type 组合时， 就可以在ELasticsearch中唯一标识一个文档。 当创建一个文档， 你可以自定义 _id ， 也可以让Elasticsearch帮你自动生成

二、文档CRUD操作

1. 索引文档

指定id创建文档 ，使用put
put /website/blog/1
{
  "title":"first blog",
  "date":"2019/10/28"
}

响应
{
  "_index": "website",
  "_type": "blog",
  "_id": "1",
  "_version": 1,
  "result": "created",
  "_shards": {
    "total": 2,
    "successful": 1,
    "failed": 0
  },
  "created": true
}

响应指出请求的索引已经被成功创建， 这个索引中包含 _index 、 _type 和 _id 元数据，版本号是1

注意使用put并不能保证每次都是新建文档，如果再次put相同id的文档，会对原有的文档进行覆盖。

PUT /website/blog/1
{
  "title": "three blog",
  "feel":"nice",
  "date": "2019/10/28"
}

//响应
{
  "_index": "website",
  "_type": "blog",
  "_id": "1",
  "_version": 2,   //版本号自增
  "result": "updated",
  "_shards": {
    "total": 2,
    "successful": 1,
    "failed": 0
  },
  "created": false   //表示不是新建，而是覆盖
}

在内部， Elasticsearch已经标记旧文档为删除并添加了一个完整的新文档。 旧版本文档不会立即消失， 但你也不能去访问它。 Elasticsearch会在你继续索引更多数据时清理被删除的文档

不指定id，使用post
post /website/blog
{
   "title":"second blog",
  "date":"2019/10/28"
}

//响应
{
  "_index": "website",
  "_type": "blog",
  "_id": "AW4TC7FgHfHdzvmX4JMA",
  "_version": 1,
  "result": "created",
  "_shards": {
    "total": 2,
    "successful": 1,
    "failed": 0
  },
  "created": true
}

自动生成id：AW4TC7FgHfHdzvmX4JMA，每次都是新建文档，不会覆盖

自动生成的id，长度为20个字符，URL安全，base64编码，GUID，分布式系统并行生成时不可能会发生冲突

使用put创建新文档
PUT /website/blog/1?op_type=create
{
  "title": "four blog",
  "feel":"nice",
  "date": "2019/10/28"
}

//响应
{
  "error": {
    "root_cause": [
      {
        "type": "version_conflict_engine_exception",
        "reason": "[blog][1]: version conflict, document already exists (current version [2])",
        "index_uuid": "oqUDP19MSL2Y9XmPxCf1cA",
        "shard": "3",
        "index": "website"
      }
    ],
    "type": "version_conflict_engine_exception",
    "reason": "[blog][1]: version conflict, document already exists (current version [2])",
    "index_uuid": "oqUDP19MSL2Y9XmPxCf1cA",
    "shard": "3",
    "index": "website"
  },
  "status": 409
}

存在不会进行覆盖，报409错误

也可以这样写，效果和上面相同

PUT /website/blog/3/_create
{
  "title": "five blog",
  "feel":"nice",
  "date": "2019/10/28"
}

2. 检索文档

使用Get

GET /website/blog/1
{
  "_index": "website",
  "_type": "blog",
  "_id": "1",
  "_version": 1,
  "found": true,
  "_source": {
    "title": "first blog",
    "date": "2019/10/28"
  }
}

响应包含了现在熟悉的元数据节点， 增加了 _source 字段， 它包含了在创建索引时我们发送给Elasticsearch的原始文档

检索文档部分内容

get /website/blog/1?_source=title
{
  "_index": "website",
  "_type": "blog",
  "_id": "1",
  "_version": 1,
  "found": true,
  "_source": {
    "title": "first blog"
  }
}

只需要返回source字段

get /website/blog/1/_source
{
  "title": "first blog",
  "date": "2019/10/28"
}

查询对应索引下所有文档

get /website/_search
{
  "took": 1,
  "timed_out": false,
  "_shards": {
    "total": 5,
    "successful": 5,
    "failed": 0
  },
  "hits": {
    "total": 2,
    "max_score": 1,
    "hits": [
      {
        "_index": "website",
        "_type": "blog",
        "_id": "AW4TC7FgHfHdzvmX4JMA",
        "_score": 1,
        "_source": {
          "title": "second blog",
          "date": "2019/10/28"
        }
      },
      {
        "_index": "website",
        "_type": "blog",
        "_id": "1",
        "_score": 1,
        "_source": {
          "title": "first blog",
          "date": "2019/10/28"
        }
      }
    ]
  }
}

字段解释：

took
整个搜索请求花费的毫秒数。

timeout
查询超时与否，如果响应速度比完整的结果更重要，可以指定超时时间

get /website/_search?timeout=10ms

shards

  • total 字段 参与查询的分片数
  • successful 字段 有多少是成功的
  • failed 字段 有多少的是失败的

hits
total 字段 表示匹配到的文档总数

hits 数组包含了匹配到的前10条数据，hits 数组中的每个结果都包含 _index 、 _type 和文档的 _id 字段，每个节点都有一个 _score 字段， 这是相关性得分(relevance score)， 它衡量了文档与查询的匹配程度。 默认的， 返回的结果中关联性最大的文档排在首位； 这意味着， 它是按照 _score 降序排列的。max_score 指的是所有文档匹配查询中 _score 的最大值

3. 修改文档

  • put是对原有文档的覆盖，使用新的文档替换旧文档

  • update API对文档可以进行局部更新

post /website/blog/1/_update
{
  "doc":{
    "action":"go to the moives",
    "date":"2019/10/29"
  }
}

get /website/blog/1
{
  "_index": "website",
  "_type": "blog",
  "_id": "1",
  "_version": 5,
  "found": true,
  "_source": {
    "title": "one blog",
    "feel": "nice",
    "date": "2019/10/29",
    "action": "go to the moives"
  }
}

最简单的 update 请求表单接受一个局部文档参数 doc ， 它会合并到现有文档中，存在的标量字段被覆盖， 新字段被添加。例如上述例子新加了action字段，修改了date值

可以使用Groovy实现局部更新，我们可以在脚本中写各种逻辑，然后执行即可。

4. 删除文档

DELETE /website/blog/AW4TDmKTHfHdzvmX4JMC
{
  "found": true,
  "_index": "website",
  "_type": "blog",
  "_id": "AW4TDmKTHfHdzvmX4JMC",
  "_version": 2,
  "result": "deleted",
  "_shards": {
    "total": 2,
    "successful": 1,
    "failed": 0
  }
}

删除一个文档也不会立即从磁盘上移除， 它只是被标记成已删除。 Elasticsearch
将会在你之后添加更多索引的时候才会在后台进行删除内容的清理。

未找到对应删除文档，删除失败

DELETE /website/blog/AW4
{
  "found": false,
  "_index": "website",
  "_type": "blog",
  "_id": "AW4",
  "_version": 1,
  "result": "not_found",
  "_shards": {
    "total": 2,
    "successful": 1,
    "failed": 0
  }
}

三、版本控制与更新冲突

对于多用户的局部更新，由于网络原因，可能会出现旧值覆盖新值的情况，或者多线程常见的问题。

ES使用乐观版本并发控制，为每个文档指定版本号，通过CAS比较，如果不是期望的版本号，也就是说中间被人修改过该文档，就让本次更新请求失败

使用内部版本号
PUT /website/blog/3?version=2
{
  "title": "five blog",
  "feel":"sad",
  "date": "2019/10/29"
}

//响应
{
  "error": {
    "root_cause": [
      {
        "type": "version_conflict_engine_exception",
        "reason": "[blog][3]: version conflict, current version [1] is different than the one provided [2]",
        "index_uuid": "lhDIRTZ7S9mYFUIj9z6AcA",
        "shard": "4",
        "index": "website"
      }
    ],
    "type": "version_conflict_engine_exception",
    "reason": "[blog][3]: version conflict, current version [1] is different than the one provided [2]",
    "index_uuid": "lhDIRTZ7S9mYFUIj9z6AcA",
    "shard": "4",
    "index": "website"
  },
  "status": 409
}

文档3的版本号是1，这里传入的version参数值为2，所以发生冲突，更新失败

注意，这里传入参数version值必须和文档现有的version值完全相等，精确匹配，否则失败

使用外部版本号
PUT /website/blog/4?version=3&version_type=external
{
  "title": "six blog",
  "feel":"funny",
  "date": "2019/10/29"
}

指定该文档的版本为4，外部版本号必须是整数， 大于0小于 9.2e+18

PUT /website/blog/4?version=3&version_type=external
{
  "title": "six blog",
  "feel":"funny",
  "date": "2019/10/29"
}
//响应
{
  "error": {
    "root_cause": [
      {
        "type": "version_conflict_engine_exception",
        "reason": "[blog][4]: version conflict, current version [3] is higher or equal to the one provided [2]",
        "index_uuid": "lhDIRTZ7S9mYFUIj9z6AcA",
        "shard": "2",
        "index": "website"
      }
    ],
    "type": "version_conflict_engine_exception",
    "reason": "[blog][4]: version conflict, current version [3] is higher or equal to the one provided [2]",
    "index_uuid": "lhDIRTZ7S9mYFUIj9z6AcA",
    "shard": "2",
    "index": "website"
  },
  "status": 409
}

报错的原因是因为外部版本号要求更新传入的version > 当前文档版本号，而不是精确匹配，否则报错，这里讲version值传入4即可成功更新

水墨之白
关注
  • 0
    点赞
  • 踩
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
Elasticsearch学习笔记（三）：ES的集群检查，文档CRUD
Lee_Ho_的博客
06-12 538
一. Document的数据格式 ES是面向文档的分析搜索引擎 （1）应用系统的数据结构基本上都是面向对象的。 （2）对象数据存储到数据库当中，只能拆解开来，变为扁平的多张表，每次查询的时候还需要还原为对象格式，相当麻烦。 （3）ES是面向文档的，文档中存储的数据结构，与面向对象的数据结构是一样的，基...
ElasticSearch 学习笔记
01-20
文章目录ElasticSearch 学习笔记基本概念倒排索引timeout 超时Query 与 filter 的区别query全文检索短语检索高亮检索分组检索平均值的检索区间检索批量查询查询排序查询缓存文档替换与删除ES路由查询路由分词Mapping...
Elasticsearch学习笔记3：关于索引、文档的CRUD操作（kibana）
Vincent9847的博客
06-26 190
一、 环境：ES 7.6.x 、kibana 一、关于索引的基本操作 1.创建一个索引 PUT /索引/~类型名/文档id put /test1/user/1 { "name":"xiaoyi", "age":3 ] 2.指定字段类型 put /test1 { "mappings": { "properties": { "name": { "type": "text" ..
【ElasticSearch】学习笔记（一）es的基本操作
Decade_Faiz的博客
12-13 342
创建索引库：PUT /索引库名查询索引库：GET /索引库名删除索引库：DELETE /索引库名修改索引库(添加新字段)：PUT /索引库名/_mapping创建文档：POST /索引库名/_doc/id { json文档 }查询文档：GET /索引库名/_doc/id删除文档：DELETE /索引库名/_doc/id修改文档：全量修改：PUT /索引库名/_doc/文档id { json文档 }
ElasticSearch学习笔记
m0_52712579的博客
07-29 340
文本分析是把全文本转换一系列单词(term/token)的过程，也叫分词。Analysis是通过Analyzer来实现的。分词器的作用就是把整篇文档，按一定的语义切分成一个一个的词条，目标是提升文档的召回率并降低无效数据的噪音。recall召回率，也叫可搜索性，指搜索的时候，增加能够搜索到的结果的数量。降噪指降低文档中一些低相关性词条对整体搜索排序结果的干扰。...
【Elasticsearch】学习笔记-p4（DSL查询文档）
2401_84103216的博客
04-27 352
match和的区别是什么？match：根据一个字段查询：根据多个字段查询，参与查询字段越多，查询性能越差3.精准查询精确查询一般是查找keyword、数值、日期、boolean等类型字段。所以不会对搜索条件分词。term根据词条精确值查询range根据值的范围查询1、看视频进行系统学习这几年的Crud经历，让我明白自己真的算是菜鸡中的战斗机，也正因为Crud，导致自己技术比较零散，也不够深入不够系统，所以重新进行学习是很有必要的。
【ElasticSearch】学习笔记（三）es的高级操作
Decade_Faiz的博客
12-16 338
默认的拼音分词器会将每个汉字单独分为拼音，但我们希望的是每个词条形成一组拼音，所以需要对拼音分词器做个性化定制，形成自定义分词器。**character filters：**在tokenizer之前对文本进行处理。例如删除字符，替换字符。**tokenizer：**将文本按照一定的规则切割成词条(term),例如keyword，就是不分词；还有ik_smart。**tokenizer filter:**将tokenizer输出的词条做进一步处理。例如大小写转换、同义词处理、拼音处理等。
ElasticSearch学习笔记（完）
qq_36949403的博客
05-03 526
ElasticSearch （库，表 记录） ELK ： 数据清洗 版本 ： Elasticserach7.6.1 6.x 7.x 的别别十分大 SQL ： like %百度% 大数据量的情况下就需要写一些索引 ElasticSerach ： 搜索！（百度，github，淘宝） 1，生态圈！ 2，分词器IK 3，ReFul操作 ES、 4，CRUD 5，springboot集成ElasticSerach（从原理分析） 6，爬虫爬取数据 7，实战模拟全文检索 以后只需要用到搜索
【学习笔记】ElasticSearch（ES）基本概念和语句学习笔记
zuzhiang的博客
01-22 2727
一、ES名词 ES：ElasticSearch又称ES，是一个可伸缩的、分布式的、近实时搜索的开源全文搜索与分析引擎。 index（索引）：一个索引就是一个拥有几分相似特征的文档的集合。相当于MySQL中的数据库。 type（类型）：一个索引中可以定义一种或多种类型。一个类型是索引的一个逻辑上的分类/分区，其语义完全由你来定。相当于MySQL中的表。 field（字段）：相当于MySQL中表的字段。 mapping（映射）：mapping是处理数据的方式和规则方面做一些限制，如某个字段的数据类型、默认值、分
(狂神)ElasticSearch快速入门笔记，ElasticSearch基本操作以及爬虫(Java-ES仿京东实战)
04-18
(狂神)ElasticSearch快速入门笔记，ElasticSearch基本操作以及爬虫(Java-ES仿京东实战),包含了小狂神讲的东西，特别适合新手学习，笔记保存下来可以多看看。好记性不如烂笔头哦~，ElasticSearch，简称es，es是一个...
SpringBoot整合Elasticsearch并实现CRUD操作
08-27
主要介绍了SpringBoot整合Elasticsearch并实现CRUD操作,需要的朋友可以参考下
Elasticsearch文档的CRUD
01-07
1、Create 一个文档 使用 HTPP PUT 请求 支持自动生成文档 Id 和指定文档 Id 两种方式 通过调用 “post /users/_doc”，系统会自动生成 document Id 使用 HTTP PUT users/_create/1 创建时，URI 中显示指定 _create...
grpcio-1.63.0-cp38-cp38-linux_armv7l.whl
最新发布
05-28
Python库是一组预先编写的代码模块，旨在帮助开发者实现特定的编程任务，无需从零开始编写代码。这些库可以包括各种功能，如数学运算、文件操作、数据分析和网络编程等。Python社区提供了大量的第三方库，如NumPy、Pandas和Requests，极大地丰富了Python的应用领域，从数据科学到Web开发。Python库的丰富性是Python成为最受欢迎的编程语言之一的关键原因之一。这些库不仅为初学者提供了快速入门的途径，而且为经验丰富的开发者提供了强大的工具，以高效率、高质量地完成复杂任务。例如，Matplotlib和Seaborn库在数据可视化领域内非常受欢迎，它们提供了广泛的工具和技术，可以创建高度定制化的图表和图形，帮助数据科学家和分析师在数据探索和结果展示中更有效地传达信息。
SQLyog-13.1.3-0.x86Community.exe
05-28
SQLyog-13.1.3-0.x86Community
VB自动出题题库系统设计(源代码+系统).rar
05-28
计算机专业毕业设计VB精品论文资源
debugpy-1.0.0b2-cp35-cp35m-manylinux1_i686.whl
05-28
Python库是一组预先编写的代码模块，旨在帮助开发者实现特定的编程任务，无需从零开始编写代码。这些库可以包括各种功能，如数学运算、文件操作、数据分析和网络编程等。Python社区提供了大量的第三方库，如NumPy、Pandas和Requests，极大地丰富了Python的应用领域，从数据科学到Web开发。Python库的丰富性是Python成为最受欢迎的编程语言之一的关键原因之一。这些库不仅为初学者提供了快速入门的途径，而且为经验丰富的开发者提供了强大的工具，以高效率、高质量地完成复杂任务。例如，Matplotlib和Seaborn库在数据可视化领域内非常受欢迎，它们提供了广泛的工具和技术，可以创建高度定制化的图表和图形，帮助数据科学家和分析师在数据探索和结果展示中更有效地传达信息。
elasticsearch 学习笔记
08-19
elasticsearch 学习笔记包括以下内容: 一、Elasticsearch概述: - Elasticsearch是一种开源的分布式搜索和分析引擎，可以用于快速搜索、分析和存储大量的结构化和非结构化数据。 - Elasticsearch与Solr相比有一些...

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值