4.3 Installing Connector/Python from a Source Distribution — MySQL Connectors 1.0

4.3 Установка Connector/Python из исходного кода

Распределения Connector/Python из исходного кода независимы от платформы и могут использоваться на любой платформе. Распределения из исходного кода упакованы в двух форматах:

Архив в формате zip (.zip файл)
Архив в формате сжатого tar (.tar.gz файл)

Любой из этих форматов можно использовать на любой платформе, но архивы Zip чаще используются на системах Windows, а архивы tar — на системах Unix и Unix-подобных.

Предварительные условия для компиляции Connector/Python с расширением C

Распределения из исходного кода включают расширение C, которое взаимодействует с библиотекой MySQL C клиент. Вы можете скомпилировать дистрибутив с поддержкой этого расширения или без неё. Для компиляции Connector/Python с поддержкой расширения C вам необходимо выполнить следующие предварительные условия.

Примечание

Поддержка Python 2.7 была удалена в Connector/Python 8.0.24, а поддержка Python 3.7 — в Connector/Python 8.1.0.

Linux: Компилятор C/C++, например gcc

Windows: Текущая версия Visual Studio
Protobuf C++ (версия >= 4.21.1, <=4.21.12) для расширения C и/или пакет protobuf для чистого Python
Файлы разработки Python
Установленный MySQL Server, включая файлы разработки для компиляции необязательного расширения C, которое взаимодействует с MySQL C-клиентской библиотекой

Если MySQL Server у вас ещё не установлен, его необходимо установить. Для этого посетите сайт загрузки MySQL по ссылке MySQL download site.

Установка Connector/Python из исходного кода в Microsoft Windows

Архив Connector/Python в формате zip (.zip файл) доступен на сайте загрузки Connector/Python (см. Раздел 4.1, «Получение Connector/Python»).

Для установки Connector/Python из архива zip скачайте последнюю версию и выполните следующие шаги:

Распакуйте архив zip в нужной директории установки (например, C:\mysql-connector\) с помощью WinZip или другого инструмента, который может читать .zip файлы.
Запустите консольное окно и измените расположение на папку, куда вы распаковали архив zip:
```
$> cd C:\mysql-connector\
```
Внутри папки Connector/Python выполните установку с помощью этой команды:
```
$> python setup.py install
```
Чтобы включить расширение C (доступно начиная с Connector/Python 2.1.1), используйте вместо этого команду:
```
$> python setup.py install --with-mysql-capi="path_name"
```
Аргумент для --with-mysql-capi — путь к каталогу установки MySQL Server.

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

$> python setup.py --help

Установка Connector/Python из исходного кода на системах Unix и Unix-подобных

Для систем Unix и Unix-подобных, таких как Linux, Solaris, macOS и FreeBSD, доступен архив Connector/Python в формате tar (.tar.gz файл) на сайте загрузки Connector/Python (см. Раздел 4.1, «Получение Connector/Python»).

Для установки Connector/Python из архива tar скачайте последнюю версию (обозначенную здесь как VER) и выполните эти команды:

$> tar xzf mysql-connector-python-VER.tar.gz
$> cd mysql-connector-python-VER

$> sudo python setup.py install \
--with-protobuf-include-dir=/dir/to/protobuf/include \
--with-protobuf-lib-dir=/dir/to/protobuf/lib \
--with-protoc=/path/to/protoc/binary

Чтобы включить расширение C (доступное начиная с Connector/Python 2.1.1), которое взаимодействует с MySQL C-клиентской библиотекой, также добавьте --with-mysql-capi, например:

$> sudo python setup.py install \
  --with-protobuf-include-dir=/dir/to/protobuf/include \
  --with-protobuf-lib-dir=/dir/to/protobuf/lib \
  --with-protoc=/path/to/protoc/binary \
  --with-mysql-capi="path_name

Аргумент для --with-mysql-capi — путь к каталогу установки MySQL Server или путь к команде mysql_config.

Чтобы увидеть все параметры и команды, поддерживаемые setup.py, используйте эту команду:

$> python setup.py --help