Обзор¶

Поддерживаемые платформы¶

SQLAlchemy поддерживает следующие платформы:

• cPython 3.7 и выше

• Версии PyPy, совместимые с Python-3

Поддержка AsyncIO¶

Поддержка SQLAlchemy asyncio зависит от проекта greenlet. Эта зависимость будет установлена по умолчанию на распространенных машинных платформах, однако она поддерживается не на всех архитектурах, а также может не устанавливаться по умолчанию на менее распространенных архитектурах. Дополнительные сведения об обеспечении поддержки asyncio см. в разделе Указания по установке платформы Asyncio (включая Apple M1).

Поддерживаемые методы установки¶

Установка SQLAlchemy осуществляется с помощью стандартных методик Python, основанных на setuptools, либо обращаясь непосредственно к setup.py, либо используя pip или другие совместимые с setuptools подходы.

Установите с помощью pip¶

Когда pip доступен, дистрибутив можно скачать с PyPI и установить в один шаг:

pip install SQLAlchemy

Эта команда загрузит последнюю выпущенную версию SQLAlchemy с сайта Python Cheese Shop и установит ее в вашу систему. Для большинства распространенных платформ будет загружен файл Python Wheel, который предоставляет встроенные расширения Cython / C.

Для установки последней предрелизной версии, такой как 2.0.0b1, pip требует использования флага --pre:

pip install --pre SQLAlchemy

Если последняя версия является предварительной версией, то она будет установлена вместо последней выпущенной версии.

Установка вручную из исходного дистрибутива¶

Если установка производится не из pip, исходный дистрибутив можно установить с помощью скрипта setup.py:

python setup.py install

Исходная установка является платформой ag

Создание расширений Cython¶

SQLAlchemy включает расширения Cython, которые обеспечивают дополнительный прирост скорости в различных областях, с текущим акцентом на скорость наборов результатов Core.

setup.py автоматически соберет расширения, если будет обнаружена соответствующая платформа, при условии, что установлен пакет Cython. Полная ручная сборка выглядит следующим образом:

# cd into SQLAlchemy source distribution
cd path/to/sqlalchemy

# install cython
pip install cython

# optionally build Cython extensions ahead of install
python setup.py build_ext

# run the install
python setup.py install

Сборка исходных текстов может также выполняться с помощью методов PEP 517, например, с помощью build:

# cd into SQLAlchemy source distribution
cd path/to/sqlalchemy

# install build
pip install build

# build source / wheel dists
python -m build

Если сборка расширений Cython не удалась из-за того, что Cython не установлен, отсутствует компилятор или возникла другая проблема, процесс установки выдаст предупреждение и повторно запустит сборку без расширений Cython после завершения, сообщив об окончательном состоянии.

Чтобы запустить сборку/установку без попытки компиляции расширений Cython, можно указать переменную окружения DISABLE_SQLALCHEMY_CEXT. Это нужно либо для особых условий тестирования, либо в редких случаях, когда проблемы совместимости/сборки не преодолеваются обычным механизмом «пересборки»:

export DISABLE_SQLALCHEMY_CEXT=1; python setup.py install

Установка API базы данных¶

SQLAlchemy является разработкой

Проверка установленной версии SQLAlchemy¶

Эта документация охватывает SQLAlchemy версии 2.0. Если вы работаете в системе, где уже установлен SQLAlchemy, проверьте версию из подсказки Python следующим образом:

>>> import sqlalchemy
>>> sqlalchemy.__version__  
2.0.0

Следующие шаги¶

Установив SQLAlchemy, как новые, так и старые пользователи могут Proceed to the SQLAlchemy Tutorial.