12.5. dbm — Unix “数据库” 接口

是一种泛用接口，针对各种 DBM 数据库 — 包括 dbm.gnu 或。如果未安装这些模块中的任何一种，则将使用 dbm.dumb 模块中慢速但简单的实现。还有一个适用于 Oracle Berkeley DB 的。

exception

一个元组，其中包含每个受支持的模块可引发的异常，另外还有一个名为 dbm.error 的特殊异常作为第一项 — 后者最在引发时被使用。

dbm.whichdb(filename)

此函数会猜测各种简单数据库模块中的哪一个是可用的 — dbm.gnu, 还是 dbm.dumb — 应该被用来打开给定的文件。

返回下列值中的一个：如果文件由于不可读或不存在而无法打开则返回 None；如果文件的格式无法猜测则返回空字符串 ('')；或是包含所需模块名称的字符串，例如 'dbm.ndbm' 或 'dbm.gnu'。

dbm.open(file, flag=’r’, mode=0o666)

打开数据库文件 file 并返回一个相应的对象。

如果数据库文件已存在，则使用函数来确定其类型和要使用的适当模块；如果文件不存在，则会使用上述可导入模块中的第一个。

可选的 flag 参数可以是：

可选的 mode 参数是文件的 Unix 模式，仅在要创建数据库时才会被使用。其默认值为八进制数 0o666 (并将被当前的 umask 所修改)。

open() 所返回的对象支持与字典相同的基本功能；可以存储、获取和删除键及其对应的值，并可使用运算符和 keys() 方法，以及 get() 和 setdefault()。

在 3.2 版更改: 现在 get() 和 setdefault() 在所有数据库模块中均可用。

键和值总是被存储为字节串。这意味着当使用字符串时它们会在被存储之前隐式地转换至默认编码格式。

这些对象也支持在 with 语句中使用，当语句结束时将自动关闭它们。

在 3.4 版更改: 向所返回的对象添加了上下文管理协议的原生支持。

以下示例记录了一些主机名和对应的标题，随后将数据库的内容打印出来。:

参见

模块 shelve

存储非字符串数据的持久化模块。

以下部分描述了各个单独的子模块。

源代码:

此模块与 dbm 模块很相似，但是改用 GNU 库 gdbm 来提供某些附加功能。请注意由与 dbm.ndbm 所创建的文件格式是不兼容的。

模块提供了对 GNU DBM 库的接口。 dbm.gnu.gdbm 对象的行为类似于映射（字典），区别在于其键和值总是会在存储之前被转换为字节串。打印 gdbm 对象不会打印出键和值，并且 items() 和 values() 等方法也不受支持。

exception dbm.gnu.error

针对 dbm.gnu 专属错误例如 I/O 错误引发。的引发则针对一般映射错误例如指定了不正确的键。

dbm.gnu.open(filename[, flag[, mode]])

可选的 flag 参数可以是：

下列附加字符可被添加至旗标以控制数据库的打开方式：

不是所有旗标都可用于所有版本的 gdbm。模块常量 open_flags 为包含受支持旗标字符的字符串。如果指定了无效的旗标则会引发 error。

可选的 mode 参数是文件的 Unix 模式，仅在要创建数据库时才会被使用。其默认值为八进制数 0o666。

除了与字典类似的方法，gdbm 对象还有以下方法：

gdbm.firstkey()

使用此方法和方法可以循环遍历数据库中的每个键。遍历的顺序是按照 gdbm 的内部哈希值，而不会根据键的值排序。此方法将返回起始键。
gdbm.sync()

当以快速模式打开数据库时，此方法会将任何未写入数据强制写入磁盘。
gdbm.close()

关闭 gdbm 数据库。

源代码: Lib/dbm/ndbm.py

模块提供了对 Unix “(n)dbm” 库的接口。 Dbm 对象的行为类似于映射（字典），区别在于其键和值总是被存储为字节串。打印 dbm 对象不会打印出键和值，并且 items() 和 values() 等方法也不受支持。

此模块可与 “经典classic” ndbm 接口或 GNU GDBM 兼容接口一同使用。在 Unix 上，configure 脚本将尝试定位适当的头文件来简化此模块的构建。

exception dbm.ndbm.error

dbm.ndbm.library

所使用的实现库的名称。

dbm.ndbm.open(filename[, flag[, mode]])

打开一个 dbm 数据库并返回 ndbm 对象。 filename 参数为数据库文件名称（不带 .dir 或 .pag 扩展名）。

可选的 flag 参数必须是下列值之一：

可选的 mode 参数是文件的 Unix 模式，仅在要创建数据库时才会被使用。其默认值为八进制数 0o666 (并将被当前的 umask 所修改)。

除了与字典类似的方法，ndbm 对象还有以下方法：

ndbm.close()

关闭 ndbm 数据库。

源代码: Lib/dbm/dumb.py

注解

模块的目的是在更健壮的模块不可用时作为 dbm 模块的最终回退项。不是为高速运行而编写的，也不像其他数据库模块一样被经常使用。

dbm.dumb 模块提供了一个完全以 Python 编写的持久化字典类接口。不同于等其他模块，它不需要外部库。与其他持久化映射一样，它的键和值也总是被存储为字节串。

该模块定义以下内容：

exception dbm.dumb.error

针对 dbm.dumb 专属错误例如 I/O 错误引发。的引发则针对一般映射例如指定了不正确的键。

dbm.dumb.open(filename[, flag[, mode]])

打开一个 dumbdbm 数据库并返回 dumbdbm 对象。 filename 参数为数据库文件的主名称（不带任何特定扩展名）。创建一个 dumbdbm 数据库时将创建多个带有 .dat 和 .dir 扩展名的文件。

可选的 flag 参数仅支持 'c' 和 'n' 这两个值的语义。其他值将默认设为数据库总是打开为可更新，并且在数据库不存在时将被创建。

可选的 mode 参数是文件的 Unix 模式，仅在要创建数据库时才会被使用。其默认值为八进制数 0o666 (并将被当前的 umask 所修改)。

在 3.5 版更改: open() 在 flag 值为 'n' 时将总是创建一个新的数据库。

Deprecated since version 3.6, will be removed in version 3.8: 创建数据库使用 'r' 和 'w' 模式。修改数据库使用 'r' 模式。

除了类所提供的方法，dumbdbm 对象还提供了以下方法：

dumbdbm.sync()

同步磁盘上的目录和数据文件。此方法会由 Shelve.sync() 方法来调用。