11.11. bsddb – интерфейс к библиотеке Berkeley DB¶bsddb – Interface to Berkeley DB library

Модуль bsddb предоставляет интерфейс к библиотеке Berkeley DB. Пользователи могут создавать файлы библиотеки на основе хешей, B-деревьев или записей, используя соответствующий вызов open. Объекты bsddb в целом ведут себя как словари. Однако ключи и значения должны быть строками, поэтому для использования других объектов в качестве ключей или для хранения объектов других типов необходимо их каким-либо образом сериализовать, обычно с помощью marshal.dumps() или pickle.dumps().

Модуль bsddb требует версию библиотеки Berkeley DB с 4.0 по 4.7.

Более современный интерфейс объектов DB, DBEnv и DBSequence доступен в модуле bsddb.db, который в точности соответствует C API Berkeley DB, описанному по указанным выше адресам. Дополнительные возможности, предоставляемые API bsddb.db, включают тонкую настройку, транзакции, журналирование и многопроцессный конкурентный доступ к базе данных.

Ниже приводится описание устаревшего интерфейса bsddb, совместимого со старым модулем Python bsddb. Начиная с Python 2.5 этот интерфейс должен быть безопасным для многопоточного доступа. API bsddb.db рекомендуется для пользователей, работающих с потоками, так как он обеспечивает лучший контроль.

Модуль bsddb определяет следующие функции, создающие объекты для доступа к соответствующему типу файла Berkeley DB. Первые два аргумента каждой функции одинаковы. Для удобства переносимости в большинстве случаев следует использовать только первые два аргумента.

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

Открыть файл в хеш-формате с именем filename. Файлы, которые не предназначены для сохранения на диске, можно создать, передав None в качестве filename. Необязательный параметр flag определяет режим открытия файла. Он может быть 'r' (только чтение), 'w' (чтение-запись), 'c' (чтение-запись – создать при необходимости; по умолчанию) или 'n' (чтение-запись – усечь до нулевой длины). Остальные аргументы используются редко и просто передаются low-level функции dbopen(). Обратитесь к документации Berkeley DB за разъяснением их использования и назначения.

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

Открыть файл в формате B-дерева с именем filename. Файлы, которые не предназначены для сохранения на диске, можно создать, передав None в качестве filename. Необязательный параметр flag определяет режим открытия файла. Он может быть 'r' (только чтение), 'w' (чтение-запись), 'c' (чтение-запись – создать при необходимости; по умолчанию) или 'n' (чтение-запись – усечь до нулевой длины). Остальные аргументы используются редко и просто передаются low-level функции dbopen. Обратитесь к документации Berkeley DB за разъяснением их использования и назначения.

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

Открыть файл в формате записей DB с именем filename. Файлы, которые не предназначены для сохранения на диске, можно создать, передав None в качестве filename. Необязательный параметр flag определяет режим открытия файла. Он может быть 'r' (только чтение), 'w' (чтение-запись), 'c' (чтение-запись – создать при необходимости; по умолчанию) или 'n' (чтение-запись – усечь до нулевой длины). Остальные аргументы используются редко и просто передаются low-level функции dbopen. Обратитесь к документации Berkeley DB за разъяснением их использования и назначения.

>>> import bsddb
>>> db = bsddb.btopen('spam.db', 'c')
>>> for i in range(10): db['%d'%i] = '%d'% (i*i)
...
>>> db['3']
'9'
>>> db.keys()
['0', '1', '2', '3', '4', '5', '6', '7', '8', '9']
>>> db.first()
('0', '0')
>>> db.next()
('1', '1')
>>> db.last()
('9', '81')
>>> db.set_location('2')
('2', '4')
>>> db.previous()
('1', '1')
>>> for k, v in db.iteritems():
...     print k, v
0 0
1 1
2 4
3 9
4 16
5 25
6 36
7 49
8 64
9 81
>>> '8' in db
True
>>> db.sync()
0