dbm --- Unix "數(shù)據(jù)庫" 接口?
源代碼: Lib/dbm/__init__.py
dbm 是一種泛用接口，針對各種 DBM 數(shù)據(jù)庫 --- 包括 dbm.gnu 或 dbm.ndbm。 如果未安裝這些模塊中的任何一種，則將使用 dbm.dumb 模塊中慢速但簡單的實現(xiàn)。 還有一個適用于 Oracle Berkeley DB 的 第三方接口。
- exception dbm.error?
一個元組，其中包含每個受支持的模塊可引發(fā)的異常，另外還有一個名為
dbm.error的特殊異常作為第一項 --- 后者最在引發(fā)dbm.error時被使用。
- dbm.whichdb(filename)?
此函數(shù)會猜測各種簡單數(shù)據(jù)庫模塊中的哪一個是可用的 ---
dbm.gnu,dbm.ndbm還是dbm.dumb--- 應(yīng)該被用來打開給定的文件。返回下列值中的一個：如果文件由于不可讀或不存在而無法打開則返回
None；如果文件的格式無法猜測則返回空字符串 ('')；或是包含所需模塊名稱的字符串，例如'dbm.ndbm'或'dbm.gnu'。
在 3.11 版更改: Accepts path-like object for filename.
- dbm.open(file, flag='r', mode=0o666)?
打開數(shù)據(jù)庫文件 file 并返回一個相應(yīng)的對象。
如果數(shù)據(jù)庫文件已存在，則使用
whichdb()函數(shù)來確定其類型和要使用的適當模塊；如果文件不存在，則會使用上述可導(dǎo)入模塊中的第一個。可選的 flag 參數(shù)可以是：
值
含意
'r'以只讀方式打開現(xiàn)有數(shù)據(jù)庫（默認）
'w'以讀寫方式打開現(xiàn)有數(shù)據(jù)庫
'c'以讀寫方式打開數(shù)據(jù)庫，如果不存在則創(chuàng)建它
'n'始終創(chuàng)建一個新的空數(shù)據(jù)庫，以讀寫方式打開
可選的 mode 參數(shù)是文件的 Unix 模式，僅在要創(chuàng)建數(shù)據(jù)庫時才會被使用。 其默認值為八進制數(shù)
0o666(并將被當前的 umask 所修改)。
open() 所返回的對象支持與字典相同的基本功能；可以存儲、獲取和刪除鍵及其對應(yīng)的值，并可使用 in 運算符和 keys() 方法，以及 get() 和 setdefault()。
在 3.2 版更改: 現(xiàn)在 get() 和 setdefault() 在所有數(shù)據(jù)庫模塊中均可用。
在 3.8 版更改: 從只讀數(shù)據(jù)庫中刪除鍵將引發(fā)數(shù)據(jù)庫模塊專屬的錯誤而不是 KeyError。
在 3.11 版更改: Accepts path-like object for file.
鍵和值總是被存儲為字節(jié)串。 這意味著當使用字符串時它們會在被存儲之前隱式地轉(zhuǎn)換至默認編碼格式。
這些對象也支持在 with 語句中使用，當語句結(jié)束時將自動關(guān)閉它們。
在 3.4 版更改: 向 open() 所返回的對象添加了上下文管理協(xié)議的原生支持。
以下示例記錄了一些主機名和對應(yīng)的標題，隨后將數(shù)據(jù)庫的內(nèi)容打印出來。:
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 存儲非字符串數(shù)據(jù)的持久化模塊。
以下部分描述了各個單獨的子模塊。
dbm.gnu --- GNU 對 dbm 的重解析?
源代碼: Lib/dbm/gnu.py
此模塊與 dbm 模塊很相似，但是改用 GNU 庫 gdbm 來提供某些附加功能。 請注意由 dbm.gnu 與 dbm.ndbm 所創(chuàng)建的文件格式是不兼容的。
dbm.gnu 模塊提供了對 GNU DBM 庫的接口。 dbm.gnu.gdbm 對象的行為類似于映射（字典），區(qū)別在于其鍵和值總是會在存儲之前被轉(zhuǎn)換為字節(jié)串。 打印 gdbm 對象不會打印出鍵和值，并且 items() 和 values() 等方法也不受支持。
- dbm.gnu.open(filename[, flag[, mode]])?
打開一個
gdbm數(shù)據(jù)庫并返回gdbm對象。 filename 參數(shù)為數(shù)據(jù)庫文件名稱。可選的 flag 參數(shù)可以是：
值
含意
'r'以只讀方式打開現(xiàn)有數(shù)據(jù)庫（默認）
'w'以讀寫方式打開現(xiàn)有數(shù)據(jù)庫
'c'以讀寫方式打開數(shù)據(jù)庫，如果不存在則創(chuàng)建它
'n'始終創(chuàng)建一個新的空數(shù)據(jù)庫，以讀寫方式打開
下列附加字符可被添加至旗標以控制數(shù)據(jù)庫的打開方式：
值
含意
'f'以快速模式打開數(shù)據(jù)庫。寫入數(shù)據(jù)庫將不會同步。
's'同步模式。這將導(dǎo)致數(shù)據(jù)庫的更改立即寫入文件。
'u'不要鎖定數(shù)據(jù)庫。
不是所有旗標都可用于所有版本的
gdbm。 模塊常量open_flags為包含受支持旗標字符的字符串。 如果指定了無效的旗標則會引發(fā)error。可選的 mode 參數(shù)是文件的 Unix 模式，僅在要創(chuàng)建數(shù)據(jù)庫時才會被使用。 其默認值為八進制數(shù)
0o666。除了與字典類似的方法，
gdbm對象還有以下方法：在 3.11 版更改: Accepts path-like object for filename.
- gdbm.firstkey()?
使用此方法和
nextkey()方法可以循環(huán)遍歷數(shù)據(jù)庫中的每個鍵。 遍歷的順序是按照gdbm的內(nèi)部哈希值，而不會根據(jù)鍵的值排序。 此方法將返回起始鍵。
- gdbm.nextkey(key)?
在遍歷中返回 key 之后的的下一個鍵。 以下代碼將打印數(shù)據(jù)庫
db中的每個鍵，而不會在內(nèi)存中創(chuàng)建一個包含所有鍵的列表:k = db.firstkey() while k is not None: print(k) k = db.nextkey(k)
- gdbm.reorganize()?
如果你進行了大量刪除操作并且想要縮減
gdbm文件所使用的空間，此例程將可重新組織數(shù)據(jù)庫。 除非使用此重組功能否則gdbm對象不會縮減數(shù)據(jù)庫文件大??；在其他情況下，被刪除的文件空間將會保留并在添加新的 (鍵, 值) 對時被重用。
- gdbm.sync()?
當以快速模式打開數(shù)據(jù)庫時，此方法會將任何未寫入數(shù)據(jù)強制寫入磁盤。
- gdbm.close()?
關(guān)閉
gdbm數(shù)據(jù)庫。
dbm.ndbm --- 基于 ndbm 的接口?
源代碼: Lib/dbm/ndbm.py
dbm.ndbm 模塊提供了對 Unix "(n)dbm" 庫的接口。 Dbm 對象的行為類似于映射（字典），區(qū)別在于其鍵和值總是被存儲為字節(jié)串。 打印 dbm 對象不會打印出鍵和值，并且 items() 和 values() 等方法也不受支持。
此模塊可與 "經(jīng)典classic" ndbm 接口或 GNU GDBM 兼容接口一同使用。 在 Unix 上，configure 腳本將嘗試定位適當?shù)念^文件來簡化此模塊的構(gòu)建。
- dbm.ndbm.library?
所使用的
ndbm實現(xiàn)庫的名稱。
- dbm.ndbm.open(filename[, flag[, mode]])?
打開一個 dbm 數(shù)據(jù)庫并返回
ndbm對象。 filename 參數(shù)為數(shù)據(jù)庫文件名稱（不帶.dir或.pag擴展名）。可選的 flag 參數(shù)必須是下列值之一：
值
含意
'r'以只讀方式打開現(xiàn)有數(shù)據(jù)庫（默認）
'w'以讀寫方式打開現(xiàn)有數(shù)據(jù)庫
'c'以讀寫方式打開數(shù)據(jù)庫，如果不存在則創(chuàng)建它
'n'始終創(chuàng)建一個新的空數(shù)據(jù)庫，以讀寫方式打開
可選的 mode 參數(shù)是文件的 Unix 模式，僅在要創(chuàng)建數(shù)據(jù)庫時才會被使用。 其默認值為八進制數(shù)
0o666(并將被當前的 umask 所修改)。除了與字典類似的方法，
ndbm對象還有以下方法：在 3.11 版更改: Accepts path-like object for filename.
- ndbm.close()?
關(guān)閉
ndbm數(shù)據(jù)庫。
dbm.dumb --- 便攜式 DBM 實現(xiàn)?
源代碼: Lib/dbm/dumb.py
備注
dbm.dumb 模塊的目的是在更健壯的模塊不可用時作為 dbm 模塊的最終回退項。 dbm.dumb 不是為高速運行而編寫的，也不像其他數(shù)據(jù)庫模塊一樣被經(jīng)常使用。
dbm.dumb 模塊提供了一個完全以 Python 編寫的持久化字典類接口。 不同于 dbm.gnu 等其他模塊，它不需要外部庫。 與其他持久化映射一樣，它的鍵和值也總是被存儲為字節(jié)串。
該模塊定義以下內(nèi)容：
- dbm.dumb.open(filename[, flag[, mode]])?
打開一個
dumbdbm數(shù)據(jù)庫并返回 dumbdbm 對象。 filename 參數(shù)為數(shù)據(jù)庫文件的主名稱（不帶任何特定擴展名）。 創(chuàng)建一個 dumbdbm 數(shù)據(jù)庫時將創(chuàng)建多個帶有.dat和.dir擴展名的文件。可選的 flag 參數(shù)可以是：
值
含意
'r'以只讀方式打開現(xiàn)有數(shù)據(jù)庫（默認）
'w'以讀寫方式打開現(xiàn)有數(shù)據(jù)庫
'c'以讀寫方式打開數(shù)據(jù)庫，如果不存在則創(chuàng)建它
'n'始終創(chuàng)建一個新的空數(shù)據(jù)庫，以讀寫方式打開
可選的 mode 參數(shù)是文件的 Unix 模式，僅在要創(chuàng)建數(shù)據(jù)庫時才會被使用。 其默認值為八進制數(shù)
0o666(并將被當前的 umask 所修改)。警告
當載入包含足夠巨大/復(fù)雜條目的數(shù)據(jù)庫時有可能導(dǎo)致 Python 解釋器的崩潰，這是由于 Python AST 編譯器有棧深度限制。
在 3.5 版更改:
open()在 flag 值為'n'時將總是創(chuàng)建一個新的數(shù)據(jù)庫。在 3.8 版更改: 附帶
'r'旗標打開的數(shù)據(jù)庫現(xiàn)在將是只讀的。 附帶'r'和'w'旗標的打開操作不會再創(chuàng)建數(shù)據(jù)庫。在 3.11 版更改: Accepts path-like object for filename.
除了
collections.abc.MutableMapping類所提供的方法，dumbdbm對象還提供了以下方法：- dumbdbm.sync()?
同步磁盤上的目錄和數(shù)據(jù)文件。 此方法會由
Shelve.sync()方法來調(diào)用。
- dumbdbm.close()?
關(guān)閉
dumbdbm數(shù)據(jù)庫。