Connector/Python работает на любой платформе, где устанавливается Python. Python предварительно установлен на большую часть Unix и подобных Unix систем, таких как Linux, macOS и FreeBSD. На Microsoft Windows инсталлятор Python доступен с Python Download website. Если необходимо, загрузите и установите Python for Windows прежде, чем попытаться установить Connector/Python.
Connector/Python требует, чтобы
python был в системной
переменной PATH
и установка терпит неудачу, если
python не может быть найден.
В Unix python обычно
располагается в каталоге, включенном в PATH
.
В Windows, если вы устанавливаете Python, включите Add
python.exe to Path во время процесса установки, или вручную добавьте
каталог, содержащий python.exe.
Для получения дополнительной информации об установке и конфигурации Python в Windows см. Using Python on Windows в документации на Python.
Connector/Python осуществляет протокол клиент-сервер MySQL двумя путями:
Как чистый Пайтон. Это внедрение протокола не требует никаких других библиотек клиента MySQL или других компонентов.
Как расширение C, которое взаимодействует с библиотекой MySQL C клиента. Это внедрение протокола зависит от библиотеки клиента, но может пользоваться библиотекой, обеспеченной пакетами MySQL Server (см. MySQL C API Implementations). Расширение C доступно с Connector/Python 2.1.1.
Ни у какого внедрения протокола клиент-сервер нет сторонних зависимостей. Однако, если вы нуждаетесь в поддержке SSL, проверьте, что ваша установка Python была собрана, пользуясь библиотеками OpenSSL.
Установка Connector/Python подобна на каждой платформе и следует стандартным Python Distribution Utilities или Distutils. Дистрибутивы доступны в собственном формате для некоторых платформ, таких как пакеты RPM для Linux.
Терминология относительно дистрибутивов:
Собранный дистрибутив: пакет, созданный в родном упаковочном формате, предназначается для данной платформы. Это содержит независимый от платформы bytecode и исходный текст. Двоичные дистрибутивы все именно такие.
Исходные тексты: дистрибутив, который содержит только исходные файлы и вообще независим от платформы.
Пакеты доступны на Connector/Python download site. Для некоторых упаковочных форматов есть различные пакеты для различных версий, выберите один подходящий для версии Python, установленной на вашей системе.
Инсталляторы Connector/Python в родных форматах пакета доступны для Windows и Unix-систем:
Windows: MSI installer package.
Linux: Yum для EL6, EL7 и Fedora, RPM для Oracle Linux, Red Hat и SuSE, Debian-пакеты для Debian и Ubuntu.
macOS: пакет образа диска с инсталлятором PKG.
Вам, возможно, понадобится root
или права администратора, чтобы выполнить инсталляционную операцию.
С Connector/Python 2.1.1 двоичные дистрибутивы доступны, которые включают расширение C, которое взаимодействует с библиотекой клиента C MySQL. У некоторых упаковочных типов есть единственный файл, который включает код Connector/Python чистого Python с расширением C. Windows MSI и macOS Disk Image попадают в эту категорию. У других упаковочных типов есть два связанных файла: один с Connector/Python чистого Python, другой, который включает только расширение C. Для упаковки типов, у которых есть отдельные файлы, установите один или оба пакета. Эти два файла имеют связанные имена, но у того, который содержит расширение C, есть метка cext в имени.
Двоичный дистрибутив, которые обеспечивают расширение C, собраны с уже установленной библиотекой клиента C, обеспеченной установкой MySQL Server. Для тех дистрибутивов, которые статически не скомпонованы, необходимо установить Сервер MySQL, если он еще не присутствует в системе. Чтобы получить его, посетите MySQL download site .
Используйте pip, чтобы установить Connector/Python на большей части операционных систем:
shell> pip install mysql-connector-python
Управление всеми вашими продуктами MySQL, включая MySQL Connector/Python, с MySQL Installer это рекомендованный метож. Это адекватно обращается со всеми требованиями и предпосылками, конфигурациями и модернизациями.
Предпосылка. Microsoft Visual C++ 2015 Redistributable должен быть установлен на вашей системе.
MySQL Installer (рекомендуется): При выполнении MySQL Installer выберите MySQL Connector/Python в качестве одного из продуктов, чтобы установить. Инсталлятор MySQL устанавливает Windows MSI Installer, описанный в этой документации.
Windows MSI Installer (файл .msi
):
Чтобы использовать MSI Installer, запустите его и следуйте инструкциям,
чтобы установить Connector/Python куда надо.
Как с MySQL Installer, последующим выполнением Connector/Python MSI позволяет вам восстановить или удалить существующую установку Connector/Python.
Connector/Python Windows MSI Installers (файлы
.msi
) доступны с
Connector/Python download site (см.
раздел 4.1).
Выберите инсталлятор, подходящий для версии Python, установленного на вашей
системе. С Connector/Python 2.1.1 MSI Installers включают расширение C, это
не должно быть установлено отдельно.
Альтернативно, чтобы управлять инсталлятором из командной строки,
используйте эту команду в консоли, где
VER
и
PYVER
соответствующие номера версий Connector/Python и Python
в имени файла инсталлятора:
shell> msiexec /i mysql-connector-python-VER
-pyPYVER
.msi
Последующее выполнение Connector/Python, используя MSI installer, разрешает вам восстанавливать или удалять существующую установку Connector/Python.
Для EL6, EL7 и Fedora 19 или 20 можно установить Connector/Python, используя хранилище MySQL Yum (см. Installing Additional MySQL Products and Components with Yum ). У вас должно быть хранилище MySQL Yum в списке хранилищ вашей системы (для получения дополнительной информации посмотрите Adding the MySQL Yum Repository). Чтобы удостовериться, что ваше хранилище Yum актуально, используйте эту команду:
shell> sudo yum update mysql-community-release
Тогда установите Connector/Python следующим образом:
shell> sudo yum install mysql-connector-python
Connector/Python Linux RPM (файлы .rpm
)
доступен на Connector/Python download site (см.
раздел 4.1).
Чтобы установить пакет RPM Connector/Python (обозначенный здесь как
), используйте эту команду:PACKAGE
.rpm
shell> rpm -i PACKAGE
.rpm
Чтобы установить расширение C (доступно Connector/Python 2.1.1), установите соответствующий пакет с cext в имени пакета.
RPM обеспечивает особенность, чтобы проверить целостность и подлинность пакетов прежде, чем установить их. Чтобы узнать больше, посмотрите Verifying Package Integrity Using MD5 Checksums or GnuPG.
Пакеты Connector/Python Debian (файлы .deb
)
доступны для Debian Linux и подобных систем на Connector/Python
download site (см. раздел
4.1).
Чтобы поставить пакет Debian Connector/Python (обозначенный здесь как
), используйте эту команду:PACKAGE
.deb
shell> dpkg -i PACKAGE
.deb
Чтобы установить расширение C (доступно с Connector/Python 2.1.1), установите соответствующий пакет с cext в имени.
Образ диска Connector/Python macOS (файл
.dmg
) доступен на
Connector/Python download site (см.
раздел 4.1).
С Connector/Python 2.1.1 образ диска включает расширение C, это не должно
быть установлено отдельно.
Загрузите файл .dmg
и поставьте
Connector/Python, открывая его и дважды щелкая по получающемуся файлу
.pkg
.
Исходные тексты Connector/Python независимы от платформы и могут использоваться на любой платформе. Исходные тексты упакованы в два формата:
Формат Zip (файл .zip
).
Сжатый формат tar
(файл .tar.gz
).
Любой упаковочный формат может использоваться на любой платформе, но архивы Zip чаще всего используются на системах Windows.
С Connector/Python 2.1.1 исходные тексты включают расширение C, которое взаимодействует с библиотекой MySQL C клиента. Можно построить дистрибутив с или без поддержки этого расширения. Чтобы построить Connector/Python с поддержкой расширения C, необходимо удовлетворить следующие предпосылки.
Linux: компилятор C/C++, например, gcc.
Windows: Правильная версия Visual Studio: VS 2009 для Python 2.7, VS 2010 для Python 3.3.
Protobuf C++ (version >= 3.0.0).
Файлы для разработчика Python.
MySQL Server, включая файлы для разработчика, чтобы собрать дополнительное расширение C, которое взаимодействует с библиотекой MySQL C клиента.
Необходимо установить MySQL Server, если он еще не присутствует в системе. Чтобы получить его, посетите MySQL download site.
Для определенных платформ файлы для разработчика MySQL обеспечиваются в отдельных пакетах. Это верно для пакетов RPM и Debian, например.
Connector/Python Zip-архив есть на Connector/Python download site (см. раздел 4.1).
Чтобы установить Connector/Python из архива Zip, загрузите его последнюю версию и выполните эти шаги:
Распакуйте архив в намеченном инсталляционном каталоге
(например, C:\mysql-connector\
), используя
WinZip или другой инструмент,
который может читать файлы .zip
.
Запустите консоль и измените местоположение к каталогу, где вы распаковали архив Zip:
shell> cd C:\mysql-connector\
В каталоге Connector/Python выполните установку, используя эту команду:
shell> python setup.py install
Чтобы включать расширение C (доступно с Connector/Python 2.1.1), используйте вместо нее эту команду:
shell> python setup.py install --with-mysql-capi="path_name
"
Аргумент --with-mysql-capi
это путь к
инсталляционному каталогу MySQL Server.
Чтобы увидеть все варианты и команды, поддержанные
setup.py
:
shell> python setup.py --help
Для Unix-систем вроде Linux, Solaris, macOS и FreeBSD, архив Connector/Python tar есть на Connector/Python download site (см. раздел 4.1).
Чтобы поставить Connector/Python из архива
tar, скачайте
последнюю версию (обозначенную здесь как
VER
)
и выполните эти команды:
shell>tar xzf mysql-connector-python-
shell>VER
.tar.gzcd mysql-connector-python-
shell>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
:
shell> 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
это
путь к инсталляционному каталогу MySQL Server или путь к команде
mysql_config.
Чтобы увидеть все варианты и команды, поддержанные
setup.py
:
shell> python setup.py --help
В Windows инсталляционное местоположение Connector/Python по умолчанию это
C:\Python
,
где X.Y
\Lib\site-packages\X.Y
это версия Python
для установки соединителя.
В Unix-системах инсталляционное местоположение Connector/Python
по умолчанию это
/
,
где prefix
/pythonX.Y
/site-packages/prefix
место, где Python
устанавливается и X.Y
версия Python. См.
How installation works.
Расширение C устанавливается как
_mysql_connector.so
в каталог
site-packages
, а не в каталог
mysql/connector
.
В зависимости от вашей платформы инсталляционный путь мог бы отличаться от умолчания. Если вы не уверены, где устанавливается Connector/Python, сделайте следующее, чтобы определить его местоположение. Вывод здесь показывает инсталляционные местоположения как в macOS:
shell> python
>>> from distutils.sysconfig import get_python_lib
>>> print get_python_lib()# Python v2.x
/Library/Python/2.7/site-packages
>>> print(get_python_lib()) # Python v3.x
/Library/Frameworks/Python.framework/Versions/3.1/lib/python3.1/site-packages
Чтобы проверить, что ваша установка Connector/Python работает и способна соединиться с MySQL Server, можно воспользоваться очень простой программой, где вы поставляете параметры авторизации и принимаете информацию, запрошенную для связи. Для примера посмотрите раздел 5.1.