12.5. dbm
—接口到Unix“数据库”¶
源代码: Lib/dbm/__init__.py
dbm
是DBM数据库的变体的通用接口— dbm.gnu
或 dbm.ndbm
。如果没有安装这些模块,将使用模块 dbm.dumb
中的缓慢但简单的实现。有一个 第三方接口 到Oracle Berkeley DB。
-
dbm.
whichdb
(filename)¶ 此函数尝试猜测几个简单数据库模块中的哪个可用—
dbm.gnu
,dbm.ndbm
或dbm.dumb
—应用于打开给定文件。返回以下值之一:
None
,如果文件无法读取或不存在则无法打开;空字符串(''
)如果文件的格式不能猜测;或包含所需模块名称的字符串,例如'dbm.ndbm'
或'dbm.gnu'
。
-
dbm.
open
(file, flag='r', mode=0o666)¶ 打开数据库文件 file 并返回相应的对象。
如果数据库文件已存在,则使用
whichdb()
函数确定其类型,并使用适当的模块;如果不存在,则使用上面列出的可以导入的第一个模块。可选的 flag 参数可以是:
值
含义
'r'
打开现有数据库以进行只读(默认)
'w'
打开现有数据库进行读写
'c'
打开用于读取和写入的数据库,如果不存在则创建它
'n'
始终创建一个新的空数据库,打开进行读取和写入
可选的 mode 参数是文件的Unix模式,仅在必须创建数据库时使用。它默认为八进制
0o666
(并且将由主流umask修改)。
open()
返回的对象支持与字典相同的基本功能;键及其相应的值可以被存储,检索和删除,并且 in
算子和 keys()
方法以及 get()
和 setdefault()
可用。
在 3.2 版更改: get()
和 setdefault()
现在可在所有数据库模块中使用。
键和值始终以字节存储。这意味着,当使用字符串时,它们在被存储之前被隐式地转换为默认编码。
这些对象也支持在 with
语句中使用,它将在完成时自动关闭它们。
在 3.4 版更改: 为 open()
返回的对象添加了对上下文管理协议的本机支持。
以下示例记录一些主机名和相应的标题,然后打印出数据库的内容:
import dbm
# Open database, creating it if necessary.
with dbm.open('cache', 'c') as db:
# Record some values
db[b'hello'] = b'there'
db['www.python.org'] = 'Python Website'
db['www.cnn.com'] = 'Cable News Network'
# Note that the keys are considered bytes now.
assert db[b'www.python.org'] == b'Python Website'
# Notice how the value is now in bytes.
assert db['www.cnn.com'] == b'Cable News Network'
# Often-used methods of the dict interface work too.
print(db.get('python.org', b'not present'))
# Storing a non-string key or value will raise an exception (most
# likely a TypeError).
db['www.yahoo.com'] = 4
# db is automatically closed when leaving the with statement.
参见
- 模块
shelve
持久性模块存储非字符串数据。
各个子模块将在以下部分中描述。
12.5.1. dbm.gnu
— GNU对dbm的重新解释¶
源代码: Lib/dbm/gnu.py
该模块与 dbm
模块非常相似,但是使用GNU库 gdbm
来提供一些附加功能。请注意,dbm.gnu
和 dbm.ndbm
创建的文件格式不兼容。
dbm.gnu
模块提供了一个到GNU DBM库的接口。 dbm.gnu.gdbm
对象的行为像映射(字典),除了键和值总是在存储之前转换为字节。打印 gdbm
对象不会打印键和值,并且不支持 items()
和 values()
方法。
-
dbm.gnu.
open
(filename[, flag[, mode]])¶ 打开
gdbm
数据库并返回gdbm
对象。 filename 参数是数据库文件的名称。可选的 flag 参数可以是:
值
含义
'r'
打开现有数据库以进行只读(默认)
'w'
打开现有数据库进行读写
'c'
打开用于读取和写入的数据库,如果不存在则创建它
'n'
始终创建一个新的空数据库,打开进行读取和写入
可以将以下附加字符附加到标志以控制数据库的打开方式:
值
含义
'f'
以快速模式打开数据库。对数据库的写入将不同步。
's'
同步模式。这将导致对数据库的更改立即写入文件。
'u'
不要锁定数据库。
并非所有标志对所有版本的
gdbm
都有效。模块常量open_flags
是一个支持的标志字符串。如果指定了无效标志,则引发异常error
。可选的 mode 参数是文件的Unix模式,仅在必须创建数据库时使用。它默认为八进制
0o666
。除了类似字典的方法之外,
gdbm
对象还有以下方法:-
gdbm.
nextkey
(key)¶ 返回遍历中 key 后面的键。以下代码打印数据库
db
中的每个键,而不必在包含所有键的内存中创建列表:k = db.firstkey() while k != None: print(k) k = db.nextkey(k)
-
gdbm.
reorganize
()¶ 如果您执行了大量删除,并希望缩小
gdbm
文件使用的空间,此例程将重组数据库。gdbm
对象不会缩短数据库文件的长度,除非使用此重组;否则,删除的文件空间将被保留并作为新(键,值)对添加重新使用。
-
gdbm.
sync
()¶ 当数据库以快速模式打开时,此方法强制任何未写入的数据写入磁盘。
-
gdbm.
close
()¶ 关闭
gdbm
数据库。
-
12.5.2. dbm.ndbm
—基于ndbm的接口¶
源代码: Lib/dbm/ndbm.py
dbm.ndbm
模块提供了一个到Unix“(n)dbm”库的接口。 Dbm对象的行为像映射(字典),除了键和值总是存储为字节。打印 dbm
对象不会打印键和值,并且不支持 items()
和 values()
方法。
此模块可以与“经典”ndbm接口或GNU GDBM兼容性接口一起使用。在Unix上,configure 脚本将尝试定位相应的头文件以简化构建此模块。
-
dbm.ndbm.
library
¶ 使用的
ndbm
实现库的名称。
-
dbm.ndbm.
open
(filename[, flag[, mode]])¶ 打开dbm数据库并返回
ndbm
对象。 filename 参数是数据库文件的名称(没有.dir
或.pag
扩展名)。可选的 flag 参数必须是以下值之一:
值
含义
'r'
打开现有数据库以进行只读(默认)
'w'
打开现有数据库进行读写
'c'
打开用于读取和写入的数据库,如果不存在则创建它
'n'
始终创建一个新的空数据库,打开进行读取和写入
可选的 mode 参数是文件的Unix模式,仅在必须创建数据库时使用。它默认为八进制
0o666
(并且将由主流umask修改)。除了类似字典的方法,
ndbm
对象提供了以下方法:-
ndbm.
close
()¶ 关闭
ndbm
数据库。
-
12.5.3. dbm.dumb
—便携式DBM实现¶
源代码: Lib/dbm/dumb.py
dbm.dumb
模块提供了一个完全用Python编写的持久性类字典接口。与其他模块(如 dbm.gnu
)不同,不需要外部库。与其他持久性映射一样,键和值始终以字节存储。
模块定义如下:
-
dbm.dumb.
open
(filename[, flag[, mode]])¶ 打开
dumbdbm
数据库并返回dumbdbm对象。 filename 参数是数据库文件的基本名称(没有任何特定的扩展名)。当创建dumbdbm数据库时,将创建具有.dat
和.dir
扩展名的文件。可选的 flag 参数仅支持
'c'
和'n'
值的语义。其他值将默认为始终为更新打开的数据库,如果不存在则将创建。可选的 mode 参数是文件的Unix模式,仅在必须创建数据库时使用。它默认为八进制
0o666
(并且将由主流umask修改)。在 3.5 版更改: 当标志具有值
'n'
时,open()
总是创建一个新数据库。从版本3.6开始弃用,将在版本3.8中删除:以“r”和“w”模式创建数据库。以’r’模式修改数据库。
除了由
collections.abc.MutableMapping
类提供的方法之外,dumbdbm
对象提供以下方法:-
dumbdbm.
sync
()¶ 同步磁盘上的目录和数据文件。此方法由
Shelve.sync()
方法调用。
-
dumbdbm.
close
()¶ 关闭
dumbdbm
数据库。
-