一、入门代码
LMDB的全称是Lightning Memory-Mapped Database(快如闪电的内存映射数据库),它的文件结构简单,包含一个数据文件和一个锁文件:
LMDB文件可以同时由多个进程打开,具有极高的数据存取速度,访问简单,不需要运行单独的数据库管理进程,只要在访问数据的代码里引用LMDB库,访问时给文件路径即可。
让系统访问大量小文件的开销很大,而LMDB使用内存映射的方式访问文件,使得文件内寻址的开销非常小,使用指针运算就能实现。数据库单文件还能减少数据集复制/传输过程的开销。
在python中使用lmdb: linux中,可以使用指令‘pip install lmdb' 安装lmdb包。
1. 生成一个空的lmdb数据库文件
1
2
3
4
5
6
7
|
# -*- coding: utf-8 -*- import lmdb # 如果train文件夹下没有data.mbd或lock.mdb文件,则会生成一个空的,如果有,不会覆盖 # map_size定义最大储存容量,单位是kb,以下定义1TB容量 env = lmdb. open ( "./train" ,map_size = 1099511627776 ) env.close() |
2. LMDB数据的添加、修改、删除
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
|
# -*- coding: utf-8 -*- import lmdb # map_size定义最大储存容量,单位是kb,以下定义1TB容量 env = lmdb. open ( "./train" , map_size = 1099511627776 ) txn = env.begin(write = True ) # 添加数据和键值 txn.put(key = '1' , value = 'aaa' ) txn.put(key = '2' , value = 'bbb' ) txn.put(key = '3' , value = 'ccc' ) # 通过键值删除数据 txn.delete(key = '1' ) # 修改数据 txn.put(key = '3' , value = 'ddd' ) # 通过commit()函数提交更改 txn.commit() env.close() |
3. 查询lmdb数据库内容
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
|
# -*- coding: utf-8 -*- import lmdb env = lmdb. open ( "./train" ) # 参数write设置为True才可以写入 txn = env.begin(write = True ) ############################################添加、修改、删除数据 # 添加数据和键值 txn.put(key = '1' , value = 'aaa' ) txn.put(key = '2' , value = 'bbb' ) txn.put(key = '3' , value = 'ccc' ) # 通过键值删除数据 txn.delete(key = '1' ) # 修改数据 txn.put(key = '3' , value = 'ddd' ) # 通过commit()函数提交更改 txn.commit() ############################################查询lmdb数据 txn = env.begin() # get函数通过键值查询数据 print txn.get( str ( 2 )) # 通过cursor()遍历所有数据和键值 for key, value in txn.cursor(): print (key, value) ############################################ env.close() |
4. 读取已有.mdb文件内容
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
|
# -*- coding: utf-8 -*- import lmdb env_db = lmdb.Environment( 'trainC' ) # env_db = lmdb.open("./trainC") txn = env_db.begin() # get函数通过键值查询数据,如果要查询的键值没有对应数据,则输出None print txn.get( str ( 200 )) for key, value in txn.cursor(): #遍历 print (key, value) env_db.close() |
二、进阶
LMDB 介绍
LMDB 全称为 Lightning Memory-Mapped Database,就是非常快的内存映射型数据库,LMDB使用内存映射文件,可以提供更好的输入/输出性能,对于用于神经网络的大型数据集( 比如 ImageNet ),可以将其存储在 LMDB 中。
因为最开始 Caffe 就是使用的这个数据库,所以网上的大多数关于 LMDB 的教程都通过 Caffe 实现的,对于不了解 Caffe 的同学很不友好,所以本篇文章只讲解 LMDB。
LMDB属于key-value数据库,而不是关系型数据库( 比如 MySQL ),LMDB提供 key-value 存储,其中每个键值对都是我们数据集中的一个样本。LMDB的主要作用是提供数据管理,可以将各种各样的原始数据转换为统一的key-value存储。
LMDB效率高的一个关键原因是它是基于内存映射的,这意味着它返回指向键和值的内存地址的指针,而不需要像大多数其他数据库那样复制内存中的任何内容。
LMDB不仅可以用来存放训练和测试用的数据集,还可以存放神经网络提取出的特征数据。如果数据的结构很简单,就是大量的矩阵和向量,而且数据之间没有什么关联,数据内没有复杂的对象结构,那么就可以选择LMDB这个简单的数据库来存放数据。
LMDB的文件结构很简单,一个文件夹,里面是一个数据文件和一个锁文件。数据随意复制,随意传输。它的访问简单,不需要单独的数据管理进程。只要在访问代码里引用LMDB库,访问时给文件路径即可。
用LMDB数据库来存放图像数据,而不是直接读取原始图像数据的原因:
- 数据类型多种多样,比如:二进制文件、文本文件、编码后的图像文件jpeg、png等,不可能用一套代码实现所有类型的输入数据读取,因此通过LMDB数据库,转换为统一数据格式可以简化数据读取层的实现。
- lmdb具有极高的存取速度,大大减少了系统访问大量小文件时的磁盘IO的时间开销。LMDB将整个数据集都放在一个文件里,避免了文件系统寻址的开销,你的存储介质有多快,就能访问多快,不会因为文件多而导致时间长。LMDB使用了内存映射的方式访问文件,这使得文件内寻址的开销大幅度降低。
LMDB 的基本函数
env = lmdb.open()
:创建 lmdb 环境txn = env.begin()
:建立事务txn.put(key, value)
:进行插入和修改txn.delete(key)
:进行删除txn.get(key)
:进行查询txn.cursor()
:进行遍历txn.commit()
:提交更改
创建一个 lmdb 环境:
# 安装:pip install lmdb
import lmdb
env = lmdb.open(lmdb_path, map_size=1099511627776)
lmdb_path
指定存放生成的lmdb数据库的文件夹路径,如果没有该文件夹则自动创建。
map_size
指定创建的新数据库所需磁盘空间的最小值,1099511627776B=1T。可以在这里进行 存储单位换算。
会在指定路径下创建 data.mdb
和 lock.mdb
两个文件,一是个数据文件,一个是锁文件。
修改数据库内容:
txn = env.begin(write=True)
# insert/modify
txn.put(str(1).encode(), "Alice".encode())
txn.put(str(2).encode(), "Bob".encode())
# delete
txn.delete(str(1).encode())
txn.commit()
先创建一个事务(transaction) 对象 txn
,所有的操作都必须经过这个事务对象。因为我们要对数据库进行写入操作,所以将 write
参数置为 True
,默认其为 False
。
使用 .put(key, value)
对数据库进行插入和修改操作,传入的参数为键值对。
值得注意的是,需要在键值字符串后加 .encode()
改变其编码格式,将 str
转换为 bytes
格式,否则会报该错误:TypeError: Won't implicitly convert Unicode to bytes; use .encode()
。在后面使用 .decode()
对其进行解码得到原数据。
使用 .delete(key)
删除指定键值对。
对LMDB的读写操作在事务中执行,需要使用 commit
方法提交待处理的事务。
查询数据库内容:
txn = env.begin()
print(txn.get(str(2).encode()))
for key, value in txn.cursor():
print(key, value)
env.close()
每次 commit()
之后都要用 env.begin()
更新 txn(得到最新的lmdb数据库)。
使用 .get(key)
查询数据库中的单条记录。
使用 .cursor()
遍历数据库中的所有记录,其返回一个可迭代对象,相当于关系数据库中的游标,每读取一次,游标下移一位。
也可以想文件一样使用 with
语法:
with env.begin() as txn:
print(txn.get(str(2).encode()))
for key, value in txn.cursor():
print(key, value)
完整的demo如下:
import lmdb
import os, sys
def initialize():
env = lmdb.open("lmdb_dir")
return env
def insert(env, sid, name):
txn = env.begin(write=True)
txn.put(str(sid).encode(), name.encode())
txn.commit()
def delete(env, sid):
txn = env.begin(write=True)
txn.delete(str(sid).encode())
txn.commit()
def update(env, sid, name):
txn = env.begin(write=True)
txn.put(str(sid).encode(), name.encode())
txn.commit()
def search(env, sid):
txn = env.begin()
name = txn.get(str(sid).encode())
return name
def display(env):
txn = env.begin()
cur = txn.cursor()
for key, value in cur:
print(key, value)
env = initialize()
print("Insert 3 records.")
insert(env, 1, "Alice")
insert(env, 2, "Bob")
insert(env, 3, "Peter")
display(env)
print("Delete the record where sid = 1.")
delete(env, 1)
display(env)
print("Update the record where sid = 3.")
update(env,