做自由与创造的先行者

数据持久性 | Data Persistence bsddb

Python开发手册    

自2.6版以来已弃用:该bsddb模块已在Python 3中删除。

该bsddb模块为Berkeley DB库提供了一个接口。用户可以使用适当的公开呼叫创建哈希,btree或基于记录的库文件。Bsddb对象的行为通常与字典类似。但是,键和值必须是字符串,因此要将其他对象用作键或存储其他类型的对象,用户必须以某种方式将它们序列化,通常使用marshal.dumps()或pickle.dumps()。

该bsddb模块需要从4.0到4.7的Berkeley DB库版本。

模块中提供了更现代的DB,DBEnv和DBSequence对象接口,bsddb.db它与上述URL中记录的Berkeley DB C API密切匹配。bsddb.dbAPI 提供的其他功能包括微调,事务处理,日志记录和多进程并发数据库访问。

以下是bsddb与旧的Python bsddb模块兼容的旧界面的描述。从Python 2.5开始,此接口对于多线程访问应该是安全的。该bsddb.dbAPI推荐用于线程用户,因为它提供了更好的控制。

该bsddb模块定义了以下函数,用于创建访问适当类型的Berkeley DB文件的对象。每个函数的前两个参数是相同的。为了便于携带,大多数情况下只应使用前两个参数。

bsddb.hashopen(filename[, flag[, mode[, pgsize[, ffactor[, nelem[, cachesize[, lorder[, hflags]]]]]]]])

打开名为filename的哈希格式文件。从不打算保存在磁盘上None的文件可以通过传递作为文件名来创建。可选标志标识用于打开文件的模式。它可以是'r'(只读),'w'(读写),'c'(读写 - 如果需要则创建;默认)或'n'(读写 - 截断为零长度)。其他参数很少使用,只传递给低级dbopen()函数。请参阅Berkeley DB文档以获取它们的使用和解释。

bsddb.btopen(filename[, flag[, mode[, btflags[, cachesize[, maxkeypage[, minkeypage[, pgsize[, lorder]]]]]]]])

打开名为filename的btree格式文件。从不打算保存在磁盘上None的文件可以通过传递作为文件名来创建。可选标志标识用于打开文件的模式。它可以是'r'(只读),'w'(读写),'c'(读写 - 如果需要则创建;默认)或'n'(读写 - 截断为零长度)。其他参数很少使用,只传递给低级dbopen函数。请参阅Berkeley DB文档以获取它们的使用和解释。

bsddb.rnopen(filename[, flag[, mode[, rnflags[, cachesize[, pgsize[, lorder[, rlen[, delim[, source[, pad]]]]]]]]]])

打开一个名为filename的DB记录格式文件。从不打算保存在磁盘上None的文件可以通过传递作为文件名来创建。可选标志标识用于打开文件的模式。它可以是'r'(只读),'w'(读写),'c'(读写 - 如果需要则创建;默认)或'n'(读写 - 截断为零长度)。其他参数很少使用,只传递给低级dbopen函数。请参阅Berkeley DB文档以获取它们的使用和解释。

注释

从2.3开始,Python的某些Unix版本可能有一个bsddb185模块。这只是为了允许与旧Berkeley DB 1.85数据库附带的系统向后兼容。bsddb185不应该直接在新代码中使用该模块。该模块已在Python 3中删除。如果您发现您仍然需要它,请查看PyPI。

1.哈希,BTree和记录对象

一旦实例化,哈希,btree和记录对象支持与字典相同的方法。另外,他们支持下面列出的方法。

在版本2.3.1中进行了更改:添加了字典方法。

bsddbobject.close()

关闭底层文件。该对象不能再被访问。由于open()这些对象没有开放的方法,所以要再次打开文件,bsddb必须调用一个新的模块打开函数。

bsddbobject.keys()

返回DB文件中包含的密钥列表。列表的顺序是未指定的,不应该依赖。特别是,对于不同的文件格式,返回列表的顺序是不同的。

bsddbobject.has_key(key)

返回1如果DB文件中包含的参数作为重点。

bsddbobject.set_location(key)

将游标设置为key所指示的项目并返回包含该键及其值的元组。对于使用二进制树数据库的数据库btopen(),如果key实际上不存在于数据库中,则游标将按照排序顺序指向下一个项目并返回该键和值。对于其他数据库,KeyError如果在数据库中找不到密钥,则会引发其他数据库。

bsddbobject.first()

将光标设置为DB文件中的第一项并返回。除B-Tree数据库外,文件中键的顺序是未指定的。bsddb.error如果数据库为空,则引发此方法。

bsddbobject.next()

将光标设置为DB文件中的下一个项目并将其返回。除B-Tree数据库外,文件中键的顺序是未指定的。

bsddbobject.previous()

将光标设置到数据库文件中的前一项并返回。除B-Tree数据库外,文件中键的顺序是未指定的。这在散列表数据库(打开的数据库hashopen())上不受支持。

bsddbobject.last()

将光标设置为DB文件中的最后一项并返回。文件中的键的顺序是未指定的。这在散列表数据库(打开的数据库hashopen())上不受支持。bsddb.error如果数据库为空,则引发此方法。

bsddbobject.sync()

在磁盘上同步数据库。

网站建设开发|APP设计开发|小程序建设开发
下一篇:数据持久性 | Data Persistence copy_reg
上一篇:数据持久性 | Data Persistence anydbm