Дбм: dBm — логарифмическая единица м…

Специальное уведомление

Центр занятости Джерарда Мойлана (информация о вакансиях) находится на 5-м этаже здания 301 West Preston Street Building в комнате 510A.

Время работы с 8:30 до 16:30 с понедельника по пятницу (кроме праздничных дней).

Компьютеры доступны для заявителей, чтобы подать заявку в режиме онлайн.

Онлайн-сервисы

• Биржа трудовых ресурсов Мэриленда (MWE)
  
• E-Verify – Департамент бюджета и управления теперь использует E-Verify для проверки права новых сотрудников на работу в США. Для получения дополнительной информации посетите E-Verify
• . Самопроверка – вы можете проверить свое право на трудоустройство, прежде чем подавать заявление о приеме на работу, с помощью самопроверки, которая является бесплатной услугой E-Verify, программы Министерства внутренней безопасности. Дополнительную информацию см. на странице Самопроверка 9.0025

​

dbm — Интерфейсы к «базам данных» Unix — Документация Python 3.11.2

dbm — это общий интерфейс для вариантов базы данных DBM — dbm.gnu или dbm.ndbm . Если ни один из этих модулей не установлен, будет использоваться медленная, но простая реализация в модуле dbm.dumb . Там является сторонним интерфейсом для БД Oracle Беркли.

исключение dbm.error

Кортеж, содержащий исключения, которые могут быть вызваны каждым из поддерживаемых модулей, с уникальным исключением, также названным dbm. error в качестве первого item — последний используется при возникновении ошибки dbm.error .

dbm.whatdb( имя файла )

Эта функция пытается угадать, какой из нескольких простых модулей базы данных в наличии —

dbm.gnu , dbm.ndbm или dbm.dumb — должен использоваться для открытия данного файла.

Возвращает одно из следующих значений: Нет , если файл не может быть открыт. потому что он нечитаем или не существует; пустая строка ( '' ), если формат файла невозможно угадать; или строка, содержащая требуемый модуль имя, например 'dbm.ndbm' или 'dbm.gnu' .

Изменено в версии 3.11: принимает объект, подобный пути, для имени файла.

dbm.open( файл , флаг=’r’ , режим=0o666 )

Открыть файл базы данных файл и вернуть соответствующий объект.

Если файл базы данных уже существует, функция whichdb() используется для определить его тип и использовать соответствующий модуль; если его не существует, используется первый из перечисленных выше модулей, который можно импортировать.

Необязательный аргумент флага может быть:

Значение	Значение
"р"	Открыть существующую базу данных только для чтения (по умолчанию)
'ш'	Открыть существующую базу данных для чтения и письмо
'с'	Открытая база данных для чтения и записи, создать его, если он не существует
'н'	Всегда создавать новую пустую базу данных, открывать для чтения и записи

Необязательный аргумент mode представляет собой режим Unix файла, используемый только тогда, когда необходимо создать базу данных. По умолчанию используется восьмеричное число 0o666 (и будет модифицированный преобладающим umask).

Объект, возвращаемый open() , поддерживает ту же базовую функциональность, что и словари; ключи и соответствующие им значения могут быть сохранены, извлечены и удалено, а в операторе и метод keys() доступны, а также get() и setdefault() .

Изменено в версии 3.2: get() и setdefault() теперь доступны во всех модулях базы данных.

Изменено в версии 3.8: удаление ключа из базы данных, доступной только для чтения, вызывает ошибку модуля базы данных. вместо KeyError .

Изменено в версии 3.11: принимает объект, подобный пути, для файла.

Ключ и значения всегда хранятся в виде байтов. Это означает, что когда используются строки, они неявно преобразуются в кодировку по умолчанию перед хранится.

Эти объекты также поддерживают использование в инструкции with , которая автоматически закроет их, когда закончите.

Изменено в версии 3.4: Добавлена ​​встроенная поддержка протокола управления контекстом для объектов. возвращается open() .

В следующем примере записываются некоторые имена хостов и соответствующий заголовок, а затем выводит содержимое базы данных:

 импорт дбм
# Открыть базу данных, создав ее при необходимости.
с dbm.open('cache', 'c') как db:
    # Запись некоторых значений
    db[b'привет'] = b'здесь'
    db['www.python.org'] = 'Веб-сайт Python'
    db['www.cnn.com'] = 'Сеть кабельных новостей'
    # Обратите внимание, что ключи теперь считаются байтами.
    утверждать db[b'www.python.org'] == b'Веб-сайт Python'
    # Обратите внимание, что значение теперь в байтах.
    утверждать db['www.cnn.com'] == b'Cable News Network'
    # Часто используемые методы интерфейса dict тоже работают.
    print(db.get('python.org', b'нет'))
    # Сохранение нестрокового ключа или значения вызовет исключение (большинство
    # скорее всего ошибка типа).
    дб['www. yahoo.com'] = 4
# БД автоматически закрывается при выходе из оператора with.
 

См. также

Модуль полка

Постоянный модуль, в котором хранятся нестроковые данные.

Отдельные подмодули описаны в следующих разделах.

Исходный код: Lib/dbm/gnu.py

Этот модуль очень похож на модуль dbm , но использует библиотеку GNU вместо gdbm для предоставления некоторых дополнительных функций. Обратите внимание, что форматы файлов, созданные dbm.gnu и dbm.ndbm несовместимы.

Модуль dbm.gnu предоставляет интерфейс к библиотеке GNU DBM. Объекты dbm.gnu.gdbm ведут себя как сопоставления (словари), за исключением того, что ключи и значения всегда конвертируются в байты перед сохранением. Печать gdbm объект не печатает ключи и значения, а методы items() и values() не являются поддерживается.

исключение дбм.gnu.ошибка

Возникло при dbm.gnu -специфических ошибках, таких как ошибки ввода-вывода. KeyError является возникает из-за общих ошибок сопоставления, таких как указание неправильного ключа.

dbm.gnu.open( имя файла [ флаг [ режим ]])

Открыть базу данных gdbm и вернуть объект gdbm . Имя файла аргумент — это имя файла базы данных.

Дополнительный флаг аргумент может быть:

Значение	Значение
"р"	Открыть существующую базу данных только для чтения (по умолчанию)
'ш'	Открыть существующую базу данных для чтения и письмо
'с'	Открытая база данных для чтения и записи, создать его, если он не существует
'н'	Всегда создавать новую пустую базу данных, открывать для чтения и записи

Следующие дополнительные символы могут быть добавлены к флагу для управления как открывается база данных:

Значение	Значение
'ж'	Открыть базу данных в быстром режиме. Пишет к базе данных не будут синхронизированы.
	Синхронный режим. Это вызовет изменения в базу данных для немедленной записи в файл.
'у'	Не блокировать базу данных.

Не все флаги действительны для всех версий gdbm . Константа модуля open_flags — это строка поддерживаемых символов флага. Исключение ошибка возникает, если указан недопустимый флаг.

Необязательный аргумент mode представляет собой режим Unix файла, используемый только тогда, когда необходимо создать базу данных. По умолчанию используется восьмеричное число 0o666 .

В дополнение к словарным методам объекты gdbm имеют следующие методы:

Изменено в версии 3.11: принимает объект, подобный пути, в качестве имени файла.

gdbm.firstkey()

С помощью этого метода можно перебрать каждый ключ в базе данных. метод nextkey() . Обход заказывает внутренний gdbm хэш-значения и не будут сортироваться по ключевым значениям. Этот метод возвращает стартовый ключ.

gdbm.nextkey( ключ )

Возвращает ключ, следующий за ключ в обход. Следующий код печатает каждый ключ в базе данных db , без необходимости создавать список в памяти, который содержит их все:

 к = db.firstkey()
в то время как k не None:
    печать (к)
    k = db.следующий ключ (k)
 

gdbm.реорганизовать()

Если вы выполнили много удалений и хотели бы уменьшить пространство используется файлом gdbm , эта процедура реорганизует базу данных. гдбм объекты не будут сокращать длину файла базы данных, кроме как с помощью этого реорганизация; в противном случае удаленное файловое пространство будет сохранено и повторно использовано как новое добавляются пары (ключ, значение).

gdbm.sync()

Когда база данных была открыта в быстром режиме, этот метод принудительно незаписанные данные для записи на диск.

gdbm.close()

Закройте базу данных gdbm .

Исходный код: Lib/dbm/ndbm.py

Модуль dbm.ndbm предоставляет интерфейс к библиотеке Unix «(n)dbm». Объекты Dbm ведут себя как сопоставления (словари), за исключением того, что ключи и значения всегда хранится в виде байтов. Печать объекта dbm не печатает ключи и значения, а методы items() и values() не поддерживаются.

Этот модуль можно использовать с «классическим» интерфейсом ndbm или с GNU GDBM. интерфейс совместимости. В Unix сценарий configure попытается чтобы найти соответствующий заголовочный файл, чтобы упростить сборку этого модуля.

исключение dbm.ndbm.error

Инициировано dbm.ndbm -специфические ошибки, такие как ошибки ввода-вывода. KeyError возникает для общих ошибок сопоставления, таких как указание неправильного ключа.

dbm.ndbm.library

Имя используемой библиотеки реализации ndbm .

dbm.ndbm.open( имя файла [ флаг [ режим ]])

Откройте базу данных dbm и верните объект ndbm . Аргумент имя файла является имя файла базы данных (без расширений .dir или .pag ).

Необязательный аргумент флаг должен иметь одно из следующих значений:

Значение	Значение
"р"	Открыть существующую базу данных только для чтения (по умолчанию)
'ш'	Открыть существующую базу данных для чтения и письмо
'с'	Открытая база данных для чтения и записи, создать его, если он не существует
'н'	Всегда создавать новую пустую базу данных, открывать для чтения и записи

Необязательный аргумент mode представляет собой режим Unix файла, используемый только тогда, когда необходимо создать базу данных. По умолчанию используется восьмеричное число 0o666 (и будет модифицированный преобладающим umask).

В дополнение к словарным методам, ndbm объектов предоставить следующий метод:

Изменено в версии 3.11: принимает объект, подобный пути, в качестве имени файла.

ndbm.close()

Закройте базу данных ndbm .

Исходный код: Lib/dbm/dumb.py

Примечание

Модуль dbm.dumb предназначен в качестве крайней меры для dbm , если более надежный модуль недоступен. дбм.тупой Модуль написан не для скорости и используется не так активно, как другие модули базы данных.

Модуль dbm.dumb обеспечивает постоянный интерфейс, подобный словарю, который полностью написан на Python. В отличие от других модулей, таких как dbm. gnu нет требуется внешняя библиотека. Как и в случае с другими постоянными сопоставлениями, ключи и значения всегда хранятся в виде байтов.

Модуль определяет следующее:

исключение dbm.dumb.error

Инициирован на dbm.dumb -ошибки, такие как ошибки ввода/вывода. KeyError является возникает из-за общих ошибок сопоставления, таких как указание неправильного ключа.

dbm.dumb.open( имя файла [ флаг [ режим ]])

Открыть базу данных dumpdbm и возвратить объект dumpdbm. Аргумент имени файла : базовое имя файла базы данных (без каких-либо конкретных расширений). Когда база данных dumbdbm создана, файлы с .dat и .dir расширения создаются.

Необязательный аргумент флага может быть:

Значение	Значение
"р"	Открыть существующую базу данных только для чтения (по умолчанию)
'ш'	Открыть существующую базу данных для чтения и письмо
'с'	Открытая база данных для чтения и записи, создать его, если он не существует
'н'	Всегда создавать новую пустую базу данных, открывать для чтения и записи

Необязательный аргумент mode представляет собой режим Unix файла, используемый только тогда, когда необходимо создать базу данных. По умолчанию используется восьмеричное число 0o666 9.0157 (и будут изменены преобладающим umask).

Предупреждение

Возможен сбой интерпретатора Python при загрузке базы данных с достаточно большой/сложной записью из-за ограничений глубины стека в Компилятор Python AST.

Изменено в версии 3.5: open() всегда создает новую базу данных, когда флаг имеет значение 'н' .

Изменено в версии 3.8: База данных, открытая с флагами 'r' , теперь доступна только для чтения. Открытие с флаги 'r' и 'w' больше не создает базу данных, если она не существовать.

Изменено в версии 3.11: принимает объект, подобный пути, в качестве имени файла.

В дополнение к методам, предусмотренным 90 156 collections.abc.MutableMapping 90 157 классов, 90 156 90 156 объектов dumbdbm предоставить следующие методы:

dumbdbm.sync()

Синхронизация каталога на диске и файлов данных.