RussianLDP Рейтинг@Mail.ru
WebMoney: 
WMZ Z294115950220 
WMR R409981405661 
WME E134003968233 		 Visa 
4274 3200 2453 6495 

Глава 4. Установка Connector/Python

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 и исходный текст. Двоичные дистрибутивы все именно такие.

  • Исходные тексты: дистрибутив, который содержит только исходные файлы и вообще независим от платформы.

4.1. Получение Connector/Python

Пакеты доступны на Connector/Python download site. Для некоторых упаковочных форматов есть различные пакеты для различных версий, выберите один подходящий для версии Python, установленной на вашей системе.

4.2. Установка Connector/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 .

Установка Connector/Python с pip

Используйте pip, чтобы установить Connector/Python на большей части операционных систем:

shell> pip install mysql-connector-python

Установка Connector/Python в Microsoft Windows

Управление всеми вашими продуктами 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.

Установка Connector/Python в Linux, использщуя репозитарий MySQL Yum

Для 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

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 в Linux, используя пакет Debian

Пакеты 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, используя образ диска

Образ диска Connector/Python macOS (файл .dmg) доступен на Connector/Python download site (см. раздел 4.1). С Connector/Python 2.1.1 образ диска включает расширение C, это не должно быть установлено отдельно.

Загрузите файл .dmg и поставьте Connector/Python, открывая его и дважды щелкая по получающемуся файлу .pkg.

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

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

  • Формат Zip (файл .zip).

  • Сжатый формат tar (файл .tar.gz).

Любой упаковочный формат может использоваться на любой платформе, но архивы Zip чаще всего используются на системах Windows.

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

С 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 из исходных текстов в Microsoft Windows

Connector/Python Zip-архив есть на Connector/Python download site (см. раздел 4.1).

Чтобы установить Connector/Python из архива Zip, загрузите его последнюю версию и выполните эти шаги:

  1. Распакуйте архив в намеченном инсталляционном каталоге (например, C:\mysql-connector\), используя WinZip или другой инструмент, который может читать файлы .zip.

  2. Запустите консоль и измените местоположение к каталогу, где вы распаковали архив Zip:

    shell> cd C:\mysql-connector\

  3. В каталоге 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

Установка Connector/Python из исходных текстов в Unix

Для Unix-систем вроде Linux, Solaris, macOS и FreeBSD, архив Connector/Python tar есть на Connector/Python download site (см. раздел 4.1).

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

shell> tar xzf mysql-connector-python-VER.tar.gz
shell> cd mysql-connector-python-VER
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

Чтобы включить расширение 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

4.4. Подтверждение Вашей установки Connector/Python

В Windows инсталляционное местоположение Connector/Python по умолчанию это C:\PythonX.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.

Поиск

  

Найди своих коллег!

Вы можете направить письмо администратору этой странички, Алексею Паутову. mailto:alexey.v.pautov@mail.ru