Упражнение 44: использование базового API баз данных в Python

Исходник: Exercise 44: Using Python's Database API

Переводчик: Wizardforcel

Лицензия: CC BY-NC-SA 4.0

Гордо использует Google Translate

Python имеет стандартизованный базовый API для работы с базами данных, который позволяет использовать одинаковый код для доступа к различным базам данных. Каждая база данных, которую вы хотите подключиться, имеет свой отдельный модуль, который знает, как взаимодействовать с этой базой данных и следует стандартам, указанным в https://www.python.org/dev/peps/pep-0249/. Это делает легче работать со всеми базами данных, имеющими различные API. В этом упражнении вы будете использовать модуль sqlite3, описанный на странице https://docs.python.org/2/library/sqlite3.html, чтобы работать с SQL.

Изучение API

Как программисту, одной из вещей, которую вам постоянно приходится делать, это изучать API, написанные другими людьми. Я не подробно рассматриваю наиболее эффективные способы этого сделать, так как большинство программистов делают это естественно, как если бы они изучали язык. Язык Python и его модули очень связаны, поэтому когда вы изучаете Python, вы также изучаете API этих модулей. Однако есть один эффективный способ изучения того API, который я использую в этом упражнении.Чтобы изучить API модуля sqlite3, я выполняю следующие действия:

• Найдите все документы API; если документов нет, обратитесь к коду.
• Проверьте примеры или тестовый код и скопируйте его в свои файлы. Обычное чтение недостаточно; мне нужно сделать это работоспособным, поскольку часто документация не совпадает с текущей версией API. Создание всего, что указано в документации, помогает найти всё, что было забыто упомянуть.
• Когда вы получаете примеры кода для работы на вашем компьютере, запишите любую полезную информацию (WFM). WFM — это важные шаги конфигурации, которые были пропущены теми, кто писал документацию, так как их компьютер уже был настроен. Большинство программистов, пишущих документацию, начинают со своего настроенного компьютера, поэтому они могут пропустить некоторые библиотеки и программы, которые установлены, но не упомянуты. Эти различия WFM могут затруднять настройку API в рабочей среде, поэтому я записываю их для будущего использования.
• Создайте карточки или заметки для всех основных точек входа API и того, что они делают.
• Попробуйте создать небольшой пиковый тест, используя API, но только на основе ваших заметок. Если вы нажали на часть API, которую не помните, вернитесь к документации и обновите ваши заметки.+ В конце концов, если API трудно использовать, я рассмотрю использование простого API для "обёртки" над ним, который будет выполнять только те действия, которые мне нужны, чтобы я мог его игнорировать. Если этот подход не позволяет вам освоить API, следует рассмотреть использование другого API. Если автор API говорит вам "почитайте код", возможно, существует другой проект с документацией. Используйте этот проект. Если вы всё же должны использовать данный API, попробуйте делать свои заметки по мере работы с ним и напишите книгу, чтобы заработать деньги на лени автора.## Упражнение

Вы будете учиться использовать API библиотеки sqlite3, а затем попытаетесь создать свой собственный упрощённый API для работы с базами данных. Помните, что DB API 2.0 уже является простым способом доступа к базам данных, поэтому вашей задачей будет практиковаться в обёртывании этого API. Вашей целью должно стать полное понимание API библиотеки sqlite3, после чего вы сможете спроектировать более простой метод её использования.

Иногда "простота" может быть чисто субъективной или зависеть от текущих потребностей. Вы можете решить, что именно вы хотите упростить — это не обязательно будет способом взаимодействия с SQL-базами данных, но и самим процессом взаимодействия. Если ваше приложение работает только с людьми и животными, то ваше упрощение может заключаться в том, чтобы сделать API, который будет работать только для вас.

Дополнительное изучение

Прочитайте API других баз данных в Python. Вы можете прочитать Pyscopg PostgreSQL API и API MySQL для Python.