{"id":20917548,"url":"https://github.com/impact-eintr/bolt","last_synced_at":"2025-06-28T11:04:36.785Z","repository":{"id":57653443,"uuid":"431339853","full_name":"impact-eintr/bolt","owner":"impact-eintr","description":"boltdb 毕设里的一个组件","archived":false,"fork":false,"pushed_at":"2022-09-07T23:15:52.000Z","size":917,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-12T23:31:15.258Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/impact-eintr.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-11-24T03:55:40.000Z","updated_at":"2022-04-03T04:38:51.000Z","dependencies_parsed_at":"2022-08-26T07:10:48.512Z","dependency_job_id":null,"html_url":"https://github.com/impact-eintr/bolt","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/impact-eintr/bolt","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/impact-eintr%2Fbolt","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/impact-eintr%2Fbolt/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/impact-eintr%2Fbolt/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/impact-eintr%2Fbolt/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/impact-eintr","download_url":"https://codeload.github.com/impact-eintr/bolt/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/impact-eintr%2Fbolt/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262419748,"owners_count":23308098,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-18T16:34:07.530Z","updated_at":"2025-06-28T11:04:36.763Z","avatar_url":"https://github.com/impact-eintr.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"## bolt\n以下内容来自:\n\u003chttps://www.bookstack.cn/read/jaydenwen123-boltdb_book/00fe39712cec954e.md\u003e\n\n在用自己的话介绍boltdb之前，我们先看下boltdb官方是如何自我介绍的呢？\n\n\u003e Bolt is a pure Go key/value store inspired by [Howard Chu’s][hyc_symas] [LMDB project][lmdb]. The goal of the project is to provide a simple, fast, and reliable database for projects that don’t require a full database server such as Postgres or MySQL.\n\u003e Since Bolt is meant to be used as such a low-level piece of functionality, simplicity is key. The API will be small and only focus on getting values and setting values. That’s it.\n\n看完了官方的介绍，接下来让我用一句话对boltdb进行介绍：\n\nboltdb是一个纯go编写的支持事务的文件型单机kv数据库。\n\n下面对上述几个核心的关键词进行一一补充。\n\n\u003e 纯go：\n\n意味着该项目只由golang语言开发，不涉及其他语言的调用。因为大部分的数据库基本上都是由c或者c++开发的，boltdb是一款难得的golang编写的数据库。\n\n\u003e 支持事务：\n\nboltdb数据库支持两类事务：读写事务、只读事务。这一点就和其他kv数据库有很大区别。\n\n\u003e 文件型： \n\nboltdb所有的数据都是存储在磁盘上的，所以它属于文件型数据库。这里补充一下个人的理解，在某种维度来看，boltdb很像一个简陋版的innodb存储引擎。底层数据都存储在文件上，同时数据都涉及数据在内存和磁盘的转换。但不同的是，innodb在事务上的支持比较强大。\n\n\u003e 单机：\n\nboltdb不是分布式数据库，它是一款单机版的数据库。个人认为比较适合的场景是，用来做wal日志或者读多写少的存储场景。\n\n\u003e kv数据库： \n \nboltdb不是sql类型的关系型数据库，它和其他的kv组件类似，对外暴露的是kv的接口，不过boltdb支持的数据类型key和value都是[]byte。\n\n其实boltdb的用法很简单，从其项目github的文档里面就可以看得出来。它本身的定位是key/value(后面简称为kv)存储的嵌入式数据库，因此那提到kv我们自然而然能想到的最常用的操作，就是set(k,v)和get(k)了。确实如此boltdb也就是这么简单。\n\n不过在详细介绍boltdb使用之前，我们先以日常生活中的一些场景来作为切入点，引入一些在boltdb中抽象出来的专属名词(DB、Bucket、Cursor、k/v等)，下面将进入正文，前面提到boltdb的使用确实很简单，就是set和get。但它还在此基础上还做了一些额外封装。下面通过现实生活对比来介绍这些概念。\n\nboltdb本质就是存放数据的，那这和现实生活中的柜子就有点类似了，如果我们把boltdb看做是一个存放东西的柜子的话，它里面可以存放各种各样的东西，确实是的，但是我们想一想，所有东西都放在一起会不会有什么问题呢？\n\n咦，如果我们把钢笔、铅笔、外套、毛衣、短袖、餐具这些都放在一个柜子里的话，会有啥问题呢？这对于哪些特别喜欢收拾屋子，东西归类放置的人而言，简直就是一个不可容忍的事情，因为所有的东西都存放在一起，当东西多了以后就会显得杂乱无章。\n\n在生活中我们都有分类、归类的习惯，例如对功能类似的东西(钢笔、铅笔、圆珠笔等)放一起，或者同类型的东西(短袖、长袖等)放一起。把前面的柜子通过隔板来隔开，分为几个小的小柜子，第一个柜子可以放置衣服，第二个柜子可以放置书籍和笔等。当然了，这是很久以前的做法了，现在买的柜子，厂家都已经将其内部通过不同的存放东西的规格做好了分隔。大家也就不用为这些琐事操心了。既然这样，那把分类、归类这个概念往计算机中迁移过来，尤其是对于存放数据的数据库boltdb中，它也需要有分类、归类的思想，因为归根到底，它也是由人创造出来的嘛。\n\n好了到这儿，我们引入我们的三大名词了“DB”、“Bucket”、“k/v”。\n\nDB： 对应我们上面的柜子。\n\nBucket： 对应我们将柜子分隔后的小柜子或者抽屉了。\n\nk/v： 对应我们放在抽屉里的每一件东西。为了方便我们后面使用的时候便捷，我们需要给每个东西都打上一个标记，这个标记是可以区分每件东西的，例如k可以是该物品的颜色、或者价格、或者购买日期等，v就对应具体的东西啦。这样当我们后面想用的时候，就很容易找到。尤其是女同胞们的衣服和包包，哈哈\n\n再此我们就可以得到一个大概的层次结构，一个柜子(DB)里面可以有多个小柜子(Bucket)，每个小柜子里面存放的就是每个东西(k/v)啦。\n\n那我们想一下，我们周末买了一件新衣服，回到家，我们要把衣服放在柜子里，那这时候需要怎么操作呢？\n\n很简单啦，下面看看我们平常怎么做的。\n\n第一步：如果家里没有柜子，那就得先买一个柜子；\n\n第二步：在柜子里找找之前有没有放置衣服的小柜子，没有的话，那就分一块出来，总不能把新衣服和钢笔放在一块吧。\n\n第三步：有了放衣服的柜子，那就里面找找，如果之前都没衣服，直接把衣服打上标签，然后丢进去就ok啦；如果之前有衣服，那我们就需要考虑要怎么放了，随便放还是按照一定的规则来放。这里我猜大部分人还是会和我一样吧。喜欢按照一定的规则放，比如按照衣服的新旧来摆放，或者按照衣服的颜色来摆放，或者按照季节来摆放，或者按照价格来摆放。哈哈\n\n我们在多想一下，周一早上起来我们要找一件衣服穿着去上班，那这时候我们又该怎么操作呢？\n\n第一步：去找家里存放东西的柜子，家里没柜子，那就连衣服都没了，尴尬…。所以我们肯定是有柜子的，对不对\n\n第二步：找到柜子了，然后再去找放置衣服的小柜子，因为衣服在小柜子存放着。\n\n第三步：找到衣服的柜子了，那就从里面找一件衣服了，找哪件呢！最新买的？最喜欢的？天气下雨了，穿厚一点的？天气升温了，穿薄一点的？今天没准可能要约会，穿最有气质的？…..\n\n那这时候根据不同场景来确定了规则，明确了我们要找的衣服的标签，找起来就会很快了。我们一下子就能定位到要穿的衣服了。嗯哼，这就是排序、索引的威力了\n\n如果之前放置的衣服没有按照这些规则来摆放。那这时候就很悲剧了，就得挨个挨个找，然后自己选了。哈哈，有点全表扫描的味道了\n\n啰里啰嗦扯了一大堆，就是为了给大家科普清楚，一些boltdb中比较重要的概念，让大家对比理解。降低理解难度。下面开始介绍boltdb是如何简单使用的。\n\n``` go\n\nimport \"bolt\"\nfunc main(){\n    // 我们的大柜子\n    db, err := bolt.Open(\"./my.db\", 0600, nil)\n    if err != nil {\n        panic(err)\n    }\n    defer db.Close()\n    // 往db里面插入数据\n    err = db.Update(func(tx *bolt.Tx) error {\n       //我们的小柜子\n        bucket, err := tx.CreateBucketIfNotExists([]byte(\"user\"))\n        if err != nil {\n            log.Fatalf(\"CreateBucketIfNotExists err:%s\", err.Error())\n            return err\n        }\n        //放入东西\n        if err = bucket.Put([]byte(\"hello\"), []byte(\"world\")); err != nil {\n            log.Fatalf(\"bucket Put err:%s\", err.Error())\n            return err\n        }\n        return nil\n    })\n    if err != nil {\n        log.Fatalf(\"db.Update err:%s\", err.Error())\n    }\n    // 从db里面读取数据\n    err = db.View(func(tx *bolt.Tx) error {\n        //找到柜子\n        bucket := tx.Bucket([]byte(\"user\"))\n        //找东西\n        val := bucket.Get([]byte(\"hello\"))\n        log.Printf(\"the get val:%s\", val)\n        val = bucket.Get([]byte(\"hello2\"))\n        log.Printf(\"the get val2:%s\", val)\n        return nil\n    })\n    if err != nil {\n        log.Fatalf(\"db.View err:%s\", err.Error())\n    }\n}\n```\n\n\n### 组织结构\n\n![img](https://static.sitestack.cn/projects/jaydenwen123-boltdb_book/f14d43644ae24228e23d62b62f80a7a3.png)\n\n### 特点\n1. mmap\n\n在boltdb中所有的数据都是以page页为单位组织的，那这时候通常我们的理解是，当通过索引定位到具体存储数据在某一页时，然后就先在页缓存中找，如果页没有缓存，则打开数据库文件中开始读取那一页的数据就好了。 但这样的话性能会极低。boltdb中是通过mmap内存映射技术来解决这个问题。当数据库初始化时，就会进行内存映射，将文件中的数据映射到内存中的一段连续空间，后续再读取某一页的数据时，直接在内存中读取。性能大幅度提升。\n\n2. b+树\n\n在boltdb中，索引和数据时按照b+树来组织的。其中一个bucket对象对应一颗b+树，叶子节点存储具体的数据，非叶子节点只存储具体的索引信息，很类似mysql innodb中的主键索引结构。同时值得注意的是所有的bucket也构成了一颗树。但该树不是b+树。\n\n3. 嵌套bucket\n\n前面说到，在boltdb中，一个bucket对象是一颗b+树，它上面存储一批kv键值对。但同时它还有一个特性，一个bucket下面还可以有嵌套的subbucket。subbucket中还可以有subbucket。这个特性也很重要。\n\n\n## 核心数据结构\n\n从一开始，boltdb的定位就是一款文件数据库，顾名思义它的数据都是存储在磁盘文件上的，目前我们大部分场景使用的磁盘还是机械磁盘。而我们又知道数据落磁盘其实是一个比较慢的操作(此处的快慢是和操作内存想对比而言)。所以怎么样在这种硬件条件无法改变的情况下，如何提升性能就成了一个恒定不变的话题。而提升性能就不得不提到它的数据组织方式了。所以这部分我们主要来分析boltdb的核心数据结构。\n\n我们都知道，操作磁盘之所以慢，是因为对磁盘的读写耗时主要包括：寻道时间+旋转时间+传输时间。而这儿的大头主要是在寻道时间上，因为寻道是需要移动磁头到对应的磁道上，通过马达驱动磁臂移动是一种机械运动，比较耗时。我们往往对磁盘的操作都是随机读写，简而言之，随机读写的话，需要频繁移动磁头到对应的磁道。这种方式性能比较低。还有一种和它对应的方式：顺序读写。顺序读写的性能要比随机读写高很多。\n\n因此，所谓的提升性能，**无非就是尽可能的减少磁盘的随机读写，更大程度采用顺序读写的方式。**这是主要矛盾，不管是mysql的innodb还是boltdb他们都是围绕这个核心来展开的。**如何将用户写进来在内存中的数据尽可能采用顺序写的方式放进磁盘，同时在用户读时，将磁盘中保存的数据以尽可能少的IO调用次数加载到内存中，进而返回用户。**这里面就涉及到具体的数据在磁盘、内存中的组织结构以及相互转换了。下面我们就对这一块进行详细的分析\n\n这里面主要包含几块内容：一个是它在磁盘上的数据组织结构page、一个是它在内存中的数据组织结构node、还有一个是page和node之间的相互转换关系。\n\n这里先给大家直观的科普一点：\n\nset操作： 本质上对应的是 set-\u003enode-\u003epage-\u003efile的过程\n\nget操作： 本质上对应的是 file-\u003epage-\u003enode-\u003eget的过程\n\n\n## bolt的事务\n- 同一时间有且只能有一个读写事务执行；\n- 但同一个时间可以允许有多个只读事务执行\n- 每个事务都拥有自己的一套一致性视图\n\n提到事务，我们不得不提大家烂熟于心的事务四个特性：ACID。为方便阅读后续的内容，下面再简单回顾一下：\n1. A(atomic)原子性: 只要事务一开始(Begin)，那么事务要么执行成功(Commit)，要么执行失败(Rollback)， 上述过程只会出现两种状态，在事务执行过程中的中间状态以及数据是不可见的。\n2. C(consistency)一致性：事务开始前和事务提交后的数据都是一致的。\n3. I(isolation)隔离性: 不同事务之间是相互隔离、互不影响的。具体的隔离程度是由具体的事务隔离级别来控制。\n4. D(duration)持久性: 事务开始前和事务提交后的数据都是永久的。不会存在数据丢失或者篡改的风险。\n\n### 实现\n\n\u003e 持久性\n\n首先boltdb是一个文件数据库，所有的数据最终都保存在文件中。当事务结束(Commit)时，会将数据进行刷盘\n同时，boltdb通过冗余一份元数据来做容错。当事务提交时，如果写入到一半机器挂了，此时数据就会有问题\n而当boltdb再次恢复时，会对元数据进行校验和修复。这两点就保证事务中的持久性\n\n\u003e 隔离性\n\n其次boltdb在上层支持多个进程以只读的方式打开数据库，一个进程以写的方式打开数据库\n在数据库内部中事务支持两种，读写事务和只读事务。这两类事务是互斥的\n同一时间可以有多个只读事务执行，或者只能有一个读写事务执行，\n上述两类事务，在底层实现时，都是保留一整套完整的视图和元数据信息，彼此之间相互隔离。因此通过这两点就保证了隔离性\n\n\u003e 原子性\n\n在boltdb中，数据先写内存，然后再提交时刷盘。如果其中有异常发生，事务就会回滚\n同时再加上同一时间只有一个进行对数据执行写入操作。所以它要么写成功提交、要么写失败回滚。也就支持原子性了\n\n\u003e 一致性\n\n通过以上的几个特性的保证，最终也就保证了一致性\n\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fimpact-eintr%2Fbolt","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fimpact-eintr%2Fbolt","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fimpact-eintr%2Fbolt/lists"}