pickleDB一个轻量级python数据库

pickleDB

欢迎

pickleDB是一个轻量级而且非常简单的键值对存储，你可以通过非常少的代码来完成对数据库的增删改查

• 虽然名为 pickleDB，但是实际上现在已经和 pickle 没有什么关系了，在使用的时候也不需要额外导入 pickle

快速开始

>>> import pickledb

# 打开或者新建数据库
>>> db = pickledb.load('example.db', False)

# 新增一条数据
>>> db.set('key', 'value')
True

# 从数据库中查询数据
>>> db.get('key')
'value'

# 保存所有的更改
>>> db.dump()
True

快速安装

你可以使用 pip 直接安装他

$ pip install pickledb

基础命令

打开或者新建一个数据库

使用命令 pickledb.load() 可以快速新建或者打开一个数据库,命名通常以.db结尾

• 两个参数
  • 参数1：数据库的名字
  • 参数2：是否在每一次修改或者删除值之后自动保存
• 返回值
  • 将会返回一个可以继续进行其他操作的 PickleDB 对象

db = pickledb.load('example.db', False) # 第二个值推荐设置为 True(非官方推荐)

# 如果第二值设置的是 False,数据不会自动保存,需要手动调用
db.dump()

设置一条数据

使用命令 pickledb.set() 就可以设置一个数据，如果数据已经存在，那么就会直接覆盖之前的数据

• 两个参数
  • 参数1：键(key) 的名字
    键必须得是字符串，否则会引发错误Key/name must be a string!
  • 参数2：值(value) 的内容，值可以是任何值，python内字典支持的所有内容都可以存入，包括但不限于字符串，数字，列表，字典
• 返回值
  • 返回值为 True,如果保存失败会直接返回报错，不会返回 False(截至v0.9.2一直如此)

import pickledb

db = pickledb.load('testdb.db',True)
db.set('listtest',[1,2,3]) # 值是一个列表
print(db.get('listtest'))

# 打印结果 [1, 2, 3]

import pickledb

db = pickledb.load('testdb.db',True)
db.set('dicttest',{'a':1,"b":2})
print(db.get('dicttest'))

# 打印结果 {'a': 1, 'b': 2}

增加一条数据

使用命令 pickledb.append() 可以为键添加更多的值，这个和上面方法的区别在于，如果有同名的数据，那么这个命令不会覆盖，而是会尝试添加

• 两个参数

  • 参数1：键(key) 的名字
    键必须得是字符串，否则会引发错误Key/name must be a string!

  • 参数2：值(value) 的内容，值可以是任何值，python内字典支持的所有内容都可以存入，包括但不限于字符串，数字，列表

• 返回值

  • 永恒为 True,我感觉作者都没想好怎么返回失败，真蚌埠住了

如果添加的值是列表

import pickledb

db = pickledb.load('testdb.db',True)

#print(db.set('a','这是一个值a'))
db.set('listtest',[1,2,3])
db.append('listtest',[6,7,8])

print(db.get('listtest'))

# 打印结果 [1, 2, 3, 6, 7, 8]

如果添加的值为数字

如果添加的值是一个数字，那么他们会相加

import pickledb

db = pickledb.load('testdb.db',True)
db.set('number',1)
print(db.get('number')) # 输出结果为 1

db.append('number',6)
print(db.get('number')) # 输出结果为 7

如果添加的是字符串

import pickledb

db = pickledb.load('testdb.db',True)
db.set('strtest','a')
print(db.get('strtest')) # 输出结果为 a

db.append('strtest','b')
print(db.get('strtest')) # 输出结果为 ab

注意，这个值无法添加字典，如果添加字典会导致报错

获取数据

• 使用命令 pickledb.get()可以获取到数据
• 使用命令pickledb.getall()可以获取到数据库中所有键的列表
  长成这个样子dict_keys(['number', 'strtest'])

import pickledb

db = pickledb.load('testdb.db',True)
print(db.getall())
# 输出结果 dict_keys(['number', 'strtest'])

删除一个数据

• 使用命令 pickledb.rem()来删除一个数据
• 参数只有一个，就是需要删除的键的名字

删除数据库

import pickledb

db = pickledb.load('testdb.db',True)

db.deldb()

一些废话

如果你是从小甲鱼那边学完 pickle 直接过来，你可以直接忘记 pickle 了，使用 pickledb 能够让你存储数据更加方便而且强大，但是请不要用它来存储重要数据，请将那些数据存到 sqlite 或者 mysql 之类更加有安全保障的地方

pickledb 的精髓就在于不需要经过其他的转换，存进去是什么样取出来还是什么样，同时方便调用也不存在复杂的 SQL 语句

但是缺点在于 pickledb 还处于一个非常早期的版本，许多功能并不完善

• 比如无法完成复杂的查找功能
• 无法和其他的数据库互通
• 无法导出数据库数据

如果你需要使用到上面的方法，可能 pickledb 并不适合你，sqlite3 会是更好的选择

但是如果你有下面的一些需求

• 不需要太复杂的查找功能
• 一些需要中期保存的数据，需要存到我的硬盘，但是不想学习或者不想使用正式数据库
• 我想有一个只有我能打得开的数据库

更多文档请查阅英文版官方API
https://pythonhosted.org/pickleDB/

版本更新添加了新的功能或者你对这个模块由疑问请在评论区留言❤️

如果你觉得这篇文章对你有帮助请点一个赞👍