Установка Python и pip на Windows

В данном разделе мы научимся устанавливать Python и менеджер пакетов pip на Windows 10 с нуля. Лучший способ установить Python на Windows — это скачать официальный установщик с сайта python.org. Чтобы сделать это, откройте браузер и перейдите по ссылке https://python.org/. После завершения загрузки установщика, откройте «Загрузки». Сайт обнаружит, что вы посетили его с Windows, и предложит скачать последнюю версию Python 3 или Python 2. Если вы не знаете, какую версию использовать, то я рекомендую Python 3. Если вам нужно работать с унаследованным кодом Python 2, тогда вам необходим Python 2. Под вкладками Downloads → Download for Windows нажмите кнопку “Python 3.X.X” (или “Python 2.X.X”), чтобы скачать установочный файл.

64-разрядный Python против 32-разрядного

Если вы гадаете, какую версию Python нужно использовать 64-разрядную или 32-разрядную, вам, скорее всего, понадобится 32-разрядная. Иногда достаточно тяжело найти бинарники для 64-разрядной версии, а это значит, что некоторые сторонние модули могут установиться неправильно на 64-разрядной версии Python. Мое мнение – использовать ту версию, которую конкретно рекомендуют на официальном сайте. Если вы кликните кнопку Python 3 или Python 2 под “Download for Windows”, вы получите именно ту версию, которую выбрали. Помните, Если вы в итоге сделаете неправильный выбор, и захотите перейти на другую версию Python, вы можете просто удалить существующую версию и переустановить его, скачав другой установщик с официального сайта.

Запускаем установщик Python

По окончанию загрузки установщика, запустите его двойным щелчком мыши, чтобы начать установку Python. Обязательно установите флажок на «Add Python X.Y to PATH» в мастере настройке. Убедитесь, что флажок “Add Python X.Y to PATH” поставлен в установщике, в противном случае у вас будут проблемы с доступом инсталлятора Python к командной стоке. Нажмите «Установить» для начала установки. Установка должна пройти быстро, после чего Python будет готов к запуску на вашей системе. К следующему шагу нужно убедиться, что все было выполнено надлежащим образом.

Подтверждаем, что Python был установлен правильно

По окончанию установки, Python должен быть установлен на вашем компьютере. Давайте убедимся в том, что все было выполнено правильно, протестировав, имеет ли Python доступ к командной строке (cmd) Windows:

• Откройте командную строку Windows, запустив cmd.exe
• Введите pip и нажмите «Enter»
• Вы увидите справочный текст менеджера пакетов Python под названием “pip”. Если вы получите уведомление об ошибке, повторите этапы установки Python, и убедитесь в том, что вы обладаете рабочей версией Python. Большая часть проблем, с которыми вы можете столкнуться, будут иметь то или иное отношение к неправильной настройке PATH. Переустановка и подтверждение того, что опция “Add Python to PATH” была активирована, должны исправить эту проблему.

Есть вопросы по Python?

На нашем форуме вы можете задать любой вопрос и получить ответ от всего нашего сообщества!

Настройка сервера под Windows 10 для Python

Некоторое время тому назад я начал читать книгу Нейтана Яу. Искусство визуализации в бизнесе. Я думал усовершенствовать свои знания Excel, но оказалось, что автор больше ориентирован не на Excel, а на программирование, и его любимым языком является Python. Решив немного больше узнать об этом языке, я взялся за книгу Майка МакГрата Программирование на Python для начинающих. В одной из глав Майк предложил запустить web-сервер на локальном ПК и сконфигурировать его для интерпретации скриптов на Python. С ходу у меня это не получилось, и помощи от форумчан также не дождался. Выручили коллеги по работе. Один рекомендовал материал на форуме Stack Overflow, а второй помог, когда возникли проблемы. Итак…

Кликните правой кнопкой мыши на меню Пуск, и выберите Программы и компоненты –> Включение или отключение компонентов Windows. В открывшемся окне раскройте строку Службы IIS, и поставьте галочки напротив Службы Интернета. Убедитесь, что интерфейс CGI включен (рис. 1). Включите также Консоль управления ISS (рис. 2). Нажмите Ok. Windows применит изменения. Это может занять несколько минут.

Рис. 1. Подключение CGI

Скачать заметку в формате Word или pdf

Рис. 2. Включение консоли управления IIS

Скачайте программу Python с python.org. Я установил версию Python 3.5.1 с помощью Windows x86-64 web-based installer. Убедитесь, что вы установили версию x64, если у вас 64-разрядная версия Windows.

Разместите файлы-скрипты Python в рабочей папке, например, С:\MyScripts.

Установите разрешения на файлы в каталоге С:\MyScripts чтобы разрешить IIS читать и исполнять файлы. Для этого пройдите по меню Пуск –> Командная строка (администратор) и выполните три команды:

chdir С:\MyScripts
icacls . /grant » NT AUTHORITY\IUSR:(OI)(CI)(RX) »
icacls . /grant » Builtin\IIS_IUSRS:(OI)(CI)(RX) «

Откройте диспетчер служб IIS: Пуск –> Панель управления –> Система и безопасность –> Администрирование –> Диспетчер служб IIS. В левой части окна кликните правой кнопкой мыши на Default Web Site, и выберите Добавить приложение (рис. 4).

Рис. 4. Добавить приложение

Укажите виртуальный путь как /py и физический путь к файлам (рис. 5).

Рис. 5. Настройки нового приложения

В диспетчере служб IIS, добавьте сопоставление сценария для *.ру, и программы python.exe. Кликните на пиктограмме Сопоставление разработчиков (рис. 6).

Рис. 6. Сопоставление разработчиков

Выберите действие (в правой части окна) – Добавить сопоставление сценария. Настройте новый сценарий (рис. 7).

Рис. 7. Добавить сопоставление сценария

Настройте физическую папку Default Web Site (web-сайта по умолчанию, рис. 8). Теперь при наборе в web-браузере адреса localhost, будем попадать не в папку по умолчанию – С:\inetpub\wwwroot, а в папку C:\MyScripts.

Рис. 8. Изменение физической папки, открываемой при наборе в браузере адреса localhost; чтобы увеличить картинку, кликните на ней правой кнопкой мыши и выберите опцию Открыть картинку в новой вкладке

Для удобства работы с локальным web-сервером добавьте возможность видеть содержимое папок. Запустите Диспетчер служб IIS и откройте пиктограмму Просмотр каталога (рис. 9).

Рис. 9. Просмотр каталога

Кликните в правой части окна Включить (рис. 10).

Рис. 10. Включить опцию Просмотр каталога

Теперь, если вы в браузере наберете localhost, то увидите содержимое папки С:\MyScripts (рис. 11).

Рис. 11. Содержимое папки С:\MyScripts, наблюдаемое через web-браузер

Установка настраиваемой среды выполнения Python для SQL Server Install a Python custom runtime for SQL Server

Применимо к: Applies to: SQL Server 2019 (15.x) SQL Server 2019 (15.x) SQL Server 2019 (15.x) SQL Server 2019 (15.x) Применимо к: Applies to: SQL Server 2019 (15.x) SQL Server 2019 (15.x) SQL Server 2019 (15.x) SQL Server 2019 (15.x)

Узнайте, как установить настраиваемую среду выполнения Python для запуска внешних скриптов Python в SQL Server. Learn how to install a Python custom runtime for running external Python scripts with SQL Server on:

• Windows Windows
• Ubuntu Linux Ubuntu Linux
• Red Hat Enterprise Linux (RHEL) Red Hat Enterprise Linux (RHEL)
• SUSE Linux Enterprise Server (SLES) SUSE Linux Enterprise Server (SLES)

Настраиваемая среда выполнения позволяет выполнять скрипты машинного обучения и использует расширения языка SQL Server. The custom runtime can run machine learning scripts and uses the SQL Server Language Extensions.

Используйте для SQL Server собственную версию среды выполнения Python, а не версию среды выполнения по умолчанию, устанавливаемую вместе со Службами машинного обучения SQL Server. Use your own version of the Python runtime with SQL Server, instead of the default runtime version installed with SQL Server Machine Learning Services.

Предварительные требования Prerequisites

Перед установкой настраиваемой среды выполнения Python установите указанные ниже компоненты. Before installing a Python custom runtime, install:

• Если вы используете существующий экземпляр SQL Server, установите накопительный пакет обновления (CU) 3 или более поздней версии для SQL Server 2019. If you use an existing SQL Server instance, install Cumulative Update (CU) 3 or later for SQL Server 2019.

Установка расширений языка Install Language Extensions

Если в SQL Server 2019 установлены Службы машинного обучения, значит, расширения языка уже установлены и этот шаг можно пропустить. If you have Machine Learning Services installed on SQL Server 2019, Language Extensions is already installed and you can skip this step.

Выполните описанные ниже действия, чтобы установить расширения языка SQL Server, которые используются для настраиваемой среды выполнения Python. Follow the steps below to install SQL Server Language Extensions, which is used for the Python custom runtime.

Запустите мастер установки SQL Server 2019. Start the setup wizard for SQL Server 2019.

На вкладке Установка выберите параметр Новая установка изолированного экземпляра SQL Server или добавление компонентов к существующей установке. On the Installation tab, select New SQL Server stand-alone installation or add features to an existing installation.

На странице Выбор компонентов выберите следующие компоненты: On the Feature Selection page, select these options:

Службы ядра СУБД Database Engine Services

Чтобы использовать расширения языка с SQL Server, необходимо установить экземпляр ядра СУБД. To use Language Extensions with SQL Server, you must install an instance of the database engine. Можно использовать новый или уже существующий экземпляр. You can use either a new or an existing instance.

Службы машинного обучения и расширения языка Machine Learning Services and Language Extensions

Выберите Службы машинного обучения и расширения языка. Select Machine Learning Services and Language Extensions. Не выбирайте Python, так как настраиваемую среду выполнения Python вы установите позже. Do not select Python, as you will be installing the custom Python runtime later.

На странице Все готово для установки проверьте, включены ли указанные ниже компоненты, и нажмите Установить. On the Ready to Install page, verify that these selections are included, and select Install.

• Службы ядра СУБД Database Engine Services
• Службы машинного обучения и расширения языка Machine Learning Services and Language Extensions

Когда установка завершится, перезагрузите компьютер, если появится соответствующее предложение. After the setup is complete, restart the machine if you’re asked to do so.

Если вы устанавливаете новый экземпляр SQL Server 2019 с расширениями языка, обязательно установите накопительный пакет обновления 3 или более поздней версии, прежде чем перейти к следующему шагу. If you install a new instance of SQL Server 2019 with Language Extensions, then install the Cumulative Update (CU) 3 or later before you continue to the next step.

Установка Python Install Python

Расширение языка Python, используемое для настраиваемой среды выполнения Python, сейчас поддерживает только Python 3.7. The Python language extension used for the custom Python runtime currently supports Python 3.7 only. Если вы хотите использовать другую версию Python, выполните инструкции из репозитория расширения языка Python, чтобы изменить и скомпилировать расширение. If you would like to use a different version of Python, follow the instruction in the Python Language Extension GitHub repo to modify and rebuild the extension.

Скачайте Python 3.7 для Windows и запустите программу установки на сервере. Download Python 3.7 for Windows and run the Setup on the server.

Выберите Добавить Python 3.7 в переменную PATH, а затем выберите Настроить установку. Select Add Python 3.7 to PATH and then select Customize installation.

В разделе Дополнительные компоненты оставьте значения по умолчанию и нажмите кнопку Далее. Under Optional Features, leave the defaults and select Next.

Выберите параметр Установить для всех пользователей и запишите место установки. Select Install for all users and take note of the installation location.

Выберите пункт Установить. Select Install.

Установка Pandas Install pandas

Установите пакет pandas для Python из командной строки с повышенными привилегиями (запуск от имени администратора): Install the pandas package for Python from an elevated command prompt (Run as Administrator):

Предоставление доступа к папке Python Grant access to Python folder

Выполните приведенные ниже команды icacls из нового окна командной строки с повышенными привилегиями, чтобы предоставить разрешения на доступ для чтения и выполнения к папке установки Python для службы «Панель запуска SQL Server» и идентификатора безопасности S-1-15-2-1 (ALL_APPLICATION_PACKAGES). Run the following icacls commands from a new elevated command prompt to grant READ & EXECUTE access to the Python installation location to SQL Server Launchpad Service and SID S-1-15-2-1 (ALL_APPLICATION_PACKAGES).

В приведенных ниже примерах используется расположение установки Python C:\Program Files\Python37 . The examples below use the Python installation location as C:\Program Files\Python37 . Если у вас другое расположение, измените его в команде. If your location is different, change it in the command.

Предоставьте разрешения имени пользователя службы панели запуска SQL Server. Give permissions to SQL Server Launchpad Service user name.

Для именованного экземпляра с именем SQL01 используется команда icacls «C:\Program Files\Python37» /grant «NT Service\MSSQLLAUNCHPAD$SQL01»:(OI)(CI)RX /T . For named instance, the command will be icacls «C:\Program Files\Python37» /grant «NT Service\MSSQLLAUNCHPAD$SQL01»:(OI)(CI)RX /T for an instance called SQL01.

Предоставьте разрешения идентификатору безопасности S-1-15-2-1. Give permissions to SID S-1-15-2-1.

Приведенная выше команда предоставляет разрешения идентификатору безопасности компьютера S-1-15-2-1, что эквивалентно разрешению ALL APPLICATION PACKAGES (Все пакеты приложений) в английской версии Windows. The preceding command grants permissions to the computer SID S-1-15-2-1, which is equivalent to ALL APPLICATION PACKAGES on an English version of Windows. Кроме того, можно использовать icacls «C:\Program Files\Python37» /grant «ALL APPLICATION PACKAGES»:(OI)(CI)RX /T в английской версии Windows. Alternatively, you can use icacls «C:\Program Files\Python37» /grant «ALL APPLICATION PACKAGES»:(OI)(CI)RX /T on an English version of Windows.

Перезапуск панели запуска SQL Server Restart SQL Server Launchpad

Выполните описанные ниже действия, чтобы перезапустить службу «Панель запуска SQL Server». Follow these steps to restart the SQL Server Launchpad service.

В разделе Службы SQL Server щелкните элемент Панель запуска SQL Server (MSSQLSERVER) правой кнопкой мыши и выберите действие Перезапустить. Under SQL Server Services, right click on SQL Server Launchpad (MSSQLSERVER) and select Restart. Если используется именованный экземпляр, вместо (MSSQLSERVER) будет отображаться имя этого экземпляра. If you are using a named instance, the instance name will be shown instead of (MSSQLSERVER).

Регистрация расширения языка Register language extension

Выполните описанные ниже действия, чтобы скачать и зарегистрировать расширение языка Python, которое используется для настраиваемой среды выполнения Python. Follow these steps to download and register the Python language extension, which is used for the Python custom runtime.

Скачайте файл python-lang-extension-windows-release.zip из репозитория GitHub для расширений языка SQL Server. Download the python-lang-extension-windows-release.zip file from the SQL Server Language Extensions GitHub repo.

Для среды разработки или тестирования также можно использовать отладочную версию (python-lang-extension-windows-debug.zip). Alternatively, you can use the debug version (python-lang-extension-windows-debug.zip) in a development or test environment. Отладочная версия сохраняет в журнал подробные сведения, которые помогают изучать ошибки, и не рекомендуется для рабочих сред. The debug version provides verbose logging information to investigate any errors, and is not recommended for production environments.

С помощью Azure Data Studio подключитесь к экземпляру SQL Server и выполните приведенную ниже команду T-SQL, чтобы зарегистрировать расширение языка Python с помощью инструкции CREATE EXTERNAL LANGUAGE. Use Azure Data Studio to connect to your SQL Server instance and run the following T-SQL command to register the Python language extension with CREATE EXTERNAL LANGUAGE.

Измените путь в этой инструкции таким образом, чтобы он указывал расположение скачанного ZIP-файла с расширением языка (python-lang-extension-windows-release.zip) и место установки Python ( C:\\Program Files\\Python3.7 ). Modify the path in this statement to reflect the location of the downloaded language extension zip file (python-lang-extension-windows-release.zip) and the location your Python installation ( C:\\Program Files\\Python3.7 ).

Выполните эту инструкцию для каждой базы данных, в которой вы намерены использовать расширение языка Python. Execute the statement for each database you want to use the Python language extension in.

Python является зарезервированным словом, то есть вы не сможете указать такое имя для нового внешнего языка. Python is a reserved word and can’t be used as the name for a new external language name. Выберите другое имя. Use a different name instead. Например, в приведенной выше инструкции это имя myPython. For example, the statement above uses myPython.

Предварительные требования Prerequisites

Перед установкой настраиваемой среды выполнения Python установите указанные ниже компоненты. Before installing a Python custom runtime, install:

Установите SQL Server 2019 для Linux. Install SQL Server 2019 for Linux. Вы можете установить SQL Server на платформах Red Hat Enterprise Linux (RHEL), SUSE Linux Enterprise Server (SLES) и Ubuntu. You can install SQL Server on Red Hat Enterprise Linux (RHEL), SUSE Linux Enterprise Server (SLES), and Ubuntu. Дополнительные сведения см. в статье Руководство по установке SQL Server на Linux. For more information, see the Installation guidance for SQL Server on Linux.

Перейдите на накопительное обновление 3 или более поздней версии для SQL Server 2019. Upgrade to Cumulative Update (CU) 3 or later for SQL Server 2019. Выполните следующие действия: Follow these steps:

Настройте репозитории для накопительных обновлений. Configure the repositories for Cumulative Updates. Дополнительные сведения см. в статье Настройка репозиториев для установки и обновления SQL Server на Linux. For more information, see Configure repositories for installing and upgrading SQL Server on Linux.

Обновите пакет mssql-server до последнего накопительного обновления. Update the mssql-server package to the latest Cumulative Update. Дополнительные сведения см. в разделе об обновлении SQL Server в руководстве по установке SQL Server на Linux. For more information, see the Update or Upgrade SQL Server section in the installation guidance for SQL Server on Linux.

Установка расширений языка Install Language Extensions

Если в SQL Server 2019 установлены Службы машинного обучения, значит, пакет mssql-server-extensibility для расширений языка уже установлен и этот шаг можно пропустить. If you have Machine Learning Services installed on SQL Server 2019, the mssql-server-extensibility package for Language Extensions is already installed and you can skip this step.

Выполните приведенные ниже команды, чтобы установить расширения языка SQL Server для Ubuntu Linux, которые используются в настраиваемой среде выполнения Python. Run the commands below to install SQL Server Language Extensions on Ubuntu Linux, which is used for the Python custom runtime.

Если возможно, перед установкой выполните эту команду для обновления пакетов в системе. If possible, run this command to refresh the packages on the system prior to the installation.

Ubuntu может не иметь параметр https apt transport. Ubuntu might not have the https apt transport option. Чтобы установить его, выполните приведенную ниже команду. To install it, run this command.

Установите mssql-server-extensibility с помощью этой команды. Install mssql-server-extensibility with this command.

Установка Python 3.7 и Pandas Install Python 3.7 and pandas

Расширение языка Python, используемое для настраиваемой среды выполнения Python, сейчас поддерживает только Python 3.7. The Python language extension used for the custom Python runtime currently supports Python 3.7 only. Если вы хотите использовать другую версию Python, выполните инструкции из репозитория расширения языка Python, чтобы изменить и скомпилировать расширение. If you would like to use a different version of Python, follow the instruction in the Python Language Extension GitHub repo to modify and rebuild the extension.

Чтобы установить Python 3.7, выполните приведенные ниже команды. Run the commands below to install Python 3.7.

Чтобы установить пакет pandas, выполните приведенную ниже команду. Run the command below to install the pandas package

Настраиваемая установка Python Custom installation of Python

Если вы установили Python 3.7 в расположение /usr/lib/python3.7 по умолчанию, этот раздел можно пропустить и сразу перейти к разделу Регистрация расширения языка. If you have installed Python 3.7 in the default location of /usr/lib/python3.7 , you can skip this section and move on to the Register language extension section.

Если вы скомпилировали собственную версию Python 3.7, выполните приведенные ниже команды, чтобы сообщить SQL Server о настраиваемой установке. If you built your own version of Python 3.7, use the following commands to let SQL Server know your custom installation.

Добавление переменной среды Add environment variable

Измените службу mssql-launchpadd, добавив переменную среды PYTHONHOME в файл /etc/systemd/system/mssql-launchpadd.service.d/override.conf . First, edit the mssql-launchpadd service to add the PYTHONHOME environment variable to the file /etc/systemd/system/mssql-launchpadd.service.d/override.conf

Откройте файл с помощью systemctl. Open the file with systemctl

Вставьте следующий текст в открывающийся файл /etc/systemd/system/mssql-launchpadd.service.d/override.conf . Insert the following text in the /etc/systemd/system/mssql-launchpadd.service.d/override.conf file that opens. Установите значение параметра PYTHONHOME в соответствии с путем установки настраиваемой версии Python. Set value of PYTHONHOME to the custom Python installation path.

Сохраните файл и закройте редактор. Save the file and close the editor.

Убедитесь, что удается загрузить libpython3.7m.so.1.0 . Next, make sure libpython3.7m.so.1.0 can be loaded.

Создайте файл custom-python.conf в /etc/ld.so.conf.d . Create a custom-python.conf file in /etc/ld.so.conf.d .

В открывшийся файл добавьте путь к libpython3.7m.so.1.0 из настраиваемой установки Python. In the file that opens, add the path to libpython3.7m.so.1.0 from the custom Python installation.

Сохраните новый файл и закройте редактор. Save the new file and close the editor.

Запустите ldconfig и убедитесь, что можно загрузить libpython3.7m.so.1.0 , выполнив следующую команду и проверив наличие всех зависимых библиотек. Run ldconfig and verify libpython3.7m.so.1.0 can be loaded by running the following commands and checking that all the dependent libraries can be found.

Предоставление доступа к папке Python Grant access to Python folder

Присвойте параметру datadirectories в разделе «Расширяемость» файла /var/opt/mssql/mssql.conf значение настраиваемой установки Python. Set the datadirectories option in the extensibility section of /var/opt/mssql/mssql.conf file to the custom python installation.

Перезапуск службы mssql-launchpadd Restart mssql-launchpadd

Чтобы перезапустить службу mssql-launchpadd, выполните приведенную ниже команду. Run the following command to restart mssql-launchpadd.

Регистрация расширения языка Register language extension

Выполните описанные ниже действия, чтобы скачать и зарегистрировать расширение языка Python, которое используется для настраиваемой среды выполнения Python. Follow these steps to download and register the Python language extension, which is used for the Python custom runtime.

Скачайте файл python-lang-extension-linux-release.zip из репозитория GitHub для расширений языка SQL Server. Download the python-lang-extension-linux-release.zip file from the SQL Server Language Extensions GitHub repo.

Для среды разработки или тестирования также можно использовать отладочную версию (python-lang-extension-linux-debug.zip). Alternatively, you can use the debug version (python-lang-extension-linux-debug.zip) in a development or test environment. Отладочная версия сохраняет в журнал подробные сведения, которые помогают изучать ошибки, и не рекомендуется для рабочих сред. The debug version provides verbose logging information to investigate any errors, and is not recommended for production environments.

С помощью Azure Data Studio подключитесь к экземпляру SQL Server и выполните приведенную ниже команду T-SQL, чтобы зарегистрировать расширение языка Python с помощью инструкции CREATE EXTERNAL LANGUAGE. Use Azure Data Studio to connect to your SQL Server instance and run the following T-SQL command to register the Python language extension with CREATE EXTERNAL LANGUAGE.

Измените путь в этой инструкции таким образом, чтобы он указывал расположение скачанного ZIP-файла с расширением языка (python-lang-extension-linux-release.zip). Modify the path in this statement to reflect the location of the downloaded language extension zip file (python-lang-extension-linux-release.zip).

Выполните эту инструкцию для каждой базы данных, в которой вы намерены использовать расширение языка Python. Execute the statement for each database you want to use the Python language extension in.

Python является зарезервированным словом, то есть вы не сможете указать такое имя для нового внешнего языка. Python is a reserved word and can’t be used as the name for a new external language name. Выберите другое имя. Use a different name instead. Например, в приведенной выше инструкции это имя myPython. For example, the statement above uses myPython.

Предварительные требования Prerequisites

Перед установкой настраиваемой среды выполнения Python установите указанные ниже компоненты. Before installing a Python custom runtime, install:

Установите SQL Server 2019 для Linux. Install SQL Server 2019 for Linux. Вы можете установить SQL Server на платформах Red Hat Enterprise Linux (RHEL), SUSE Linux Enterprise Server (SLES) и Ubuntu. You can install SQL Server on Red Hat Enterprise Linux (RHEL), SUSE Linux Enterprise Server (SLES), and Ubuntu. Дополнительные сведения см. в статье Руководство по установке SQL Server на Linux. For more information, see the Installation guidance for SQL Server on Linux.

Перейдите на накопительное обновление 3 или более поздней версии для SQL Server 2019. Upgrade to Cumulative Update (CU) 3 or later for SQL Server 2019. Выполните следующие действия: Follow these steps:

Настройте репозитории для накопительных обновлений. Configure the repositories for Cumulative Updates. Дополнительные сведения см. в статье Настройка репозиториев для установки и обновления SQL Server на Linux. For more information, see Configure repositories for installing and upgrading SQL Server on Linux.

Обновите пакет mssql-server до последнего накопительного обновления. Update the mssql-server package to the latest Cumulative Update. Дополнительные сведения см. в разделе об обновлении SQL Server в руководстве по установке SQL Server на Linux. For more information, see the Update or Upgrade SQL Server section in the installation guidance for SQL Server on Linux.

Установка расширений языка Install Language Extensions

Если в SQL Server 2019 установлены Службы машинного обучения, значит, пакет mssql-server-extensibility для расширений языка уже установлен и этот шаг можно пропустить. If you have Machine Learning Services installed on SQL Server 2019, the mssql-server-extensibility package for Language Extensions is already installed and you can skip this step.

Выполните приведенную ниже команду, чтобы установить расширения языка SQL Server для Red Hat Enterprise Linux (RHEL), которые используются в настраиваемой среде выполнения Python. Run the command below to install SQL Server Language Extensions on Red Hat Enterprise Linux (RHEL), which is used for the Python custom runtime.

Установка Python 3.7 и Pandas Install Python 3.7 and pandas

Расширение языка Python, используемое для настраиваемой среды выполнения Python, сейчас поддерживает только Python 3.7. The Python language extension used for the custom Python runtime currently supports Python 3.7 only. Если вы хотите использовать другую версию Python, выполните инструкции из репозитория расширения языка Python, чтобы изменить и скомпилировать расширение. If you would like to use a different version of Python, follow the instruction in the Python Language Extension GitHub repo to modify and rebuild the extension.

Чтобы установить Python 3.7, выполните приведенные ниже команды. Run the commands below to install Python 3.7.

Чтобы установить пакет pandas, выполните приведенную ниже команду. Run the command below to install the pandas package

Настраиваемая установка Python Custom installation of Python

Если вы установили Python 3.7 в расположение /usr/lib/python3.7 по умолчанию, этот раздел можно пропустить и сразу перейти к разделу Регистрация расширения языка. If you have installed Python 3.7 in the default location of /usr/lib/python3.7 , you can skip this section and move on to the Register language extension section.

Если вы скомпилировали собственную версию Python 3.7, выполните приведенные ниже команды, чтобы сообщить SQL Server о настраиваемой установке. If you built your own version of Python 3.7, use the following commands to let SQL Server know your custom installation.

Добавление переменной среды Add environment variable

Измените службу mssql-launchpadd, добавив переменную среды PYTHONHOME в файл /etc/systemd/system/mssql-launchpadd.service.d/override.conf . First, edit the mssql-launchpadd service to add the PYTHONHOME environment variable to the file /etc/systemd/system/mssql-launchpadd.service.d/override.conf

Откройте файл с помощью systemctl. Open the file with systemctl

Вставьте следующий текст в открывающийся файл /etc/systemd/system/mssql-launchpadd.service.d/override.conf . Insert the following text in the /etc/systemd/system/mssql-launchpadd.service.d/override.conf file that opens. Установите значение параметра PYTHONHOME в соответствии с путем установки настраиваемой версии Python. Set value of PYTHONHOME to the custom Python installation path.

Сохраните файл и закройте редактор. Save the file and close the editor.

Убедитесь, что удается загрузить libpython3.7m.so.1.0 . Next, make sure libpython3.7m.so.1.0 can be loaded.

Создайте файл custom-python.conf в /etc/ld.so.conf.d . Create a custom-python.conf file in /etc/ld.so.conf.d .

В открывшийся файл добавьте путь к libpython3.7m.so.1.0 из настраиваемой установки Python. In the file that opens, add the path to libpython3.7m.so.1.0 from the custom Python installation.

Сохраните новый файл и закройте редактор. Save the new file and close the editor.

Запустите ldconfig и убедитесь, что можно загрузить libpython3.7m.so.1.0 , выполнив следующую команду и проверив наличие всех зависимых библиотек. Run ldconfig and verify libpython3.7m.so.1.0 can be loaded by running the following commands and checking that all the dependent libraries can be found.

Предоставление доступа к папке Python Grant access to Python folder

Присвойте параметру datadirectories в разделе «Расширяемость» файла /var/opt/mssql/mssql.conf значение настраиваемой установки Python. Set the datadirectories option in the extensibility section of /var/opt/mssql/mssql.conf file to the custom python installation.

Перезапуск службы mssql-launchpadd Restart mssql-launchpadd

Чтобы перезапустить службу mssql-launchpadd, выполните приведенную ниже команду. Run the following command to restart mssql-launchpadd.

Регистрация расширения языка Register language extension

Выполните описанные ниже действия, чтобы скачать и зарегистрировать расширение языка Python, которое используется для настраиваемой среды выполнения Python. Follow these steps to download and register the Python language extension, which is used for the Python custom runtime.

Скачайте файл python-lang-extension-linux-release.zip из репозитория GitHub для расширений языка SQL Server. Download the python-lang-extension-linux-release.zip file from the SQL Server Language Extensions GitHub repo.

Для среды разработки или тестирования также можно использовать отладочную версию (python-lang-extension-linux-debug.zip). Alternatively, you can use the debug version (python-lang-extension-linux-debug.zip) in a development or test environment. Отладочная версия сохраняет в журнал подробные сведения, которые помогают изучать ошибки, и не рекомендуется для рабочих сред. The debug version provides verbose logging information to investigate any errors, and is not recommended for production environments.

С помощью Azure Data Studio подключитесь к экземпляру SQL Server и выполните приведенную ниже команду T-SQL, чтобы зарегистрировать расширение языка Python с помощью инструкции CREATE EXTERNAL LANGUAGE. Use Azure Data Studio to connect to your SQL Server instance and run the following T-SQL command to register the Python language extension with CREATE EXTERNAL LANGUAGE.

Измените путь в этой инструкции таким образом, чтобы он указывал расположение скачанного ZIP-файла с расширением языка (python-lang-extension-linux-release.zip). Modify the path in this statement to reflect the location of the downloaded language extension zip file (python-lang-extension-linux-release.zip).

Выполните эту инструкцию для каждой базы данных, в которой вы намерены использовать расширение языка Python. Execute the statement for each database you want to use the Python language extension in.

Python является зарезервированным словом, то есть вы не сможете указать такое имя для нового внешнего языка. Python is a reserved word and can’t be used as the name for a new external language name. Выберите другое имя. Use a different name instead. Например, в приведенной выше инструкции это имя myPython. For example, the statement above uses myPython.

Предварительные требования Prerequisites

Перед установкой настраиваемой среды выполнения Python установите указанные ниже компоненты. Before installing a Python custom runtime, install:

Установите SQL Server 2019 для Linux. Install SQL Server 2019 for Linux. Вы можете установить SQL Server на платформах Red Hat Enterprise Linux (RHEL), SUSE Linux Enterprise Server (SLES) и Ubuntu. You can install SQL Server on Red Hat Enterprise Linux (RHEL), SUSE Linux Enterprise Server (SLES), and Ubuntu. Дополнительные сведения см. в статье Руководство по установке SQL Server на Linux. For more information, see the Installation guidance for SQL Server on Linux.

Перейдите на накопительное обновление 3 или более поздней версии для SQL Server 2019. Upgrade to Cumulative Update (CU) 3 or later for SQL Server 2019. Выполните следующие действия: Follow these steps:

Настройте репозитории для накопительных обновлений. Configure the repositories for Cumulative Updates. Дополнительные сведения см. в статье Настройка репозиториев для установки и обновления SQL Server на Linux. For more information, see Configure repositories for installing and upgrading SQL Server on Linux.

Обновите пакет mssql-server до последнего накопительного обновления. Update the mssql-server package to the latest Cumulative Update. Дополнительные сведения см. в разделе об обновлении SQL Server в руководстве по установке SQL Server на Linux. For more information, see the Update or Upgrade SQL Server section in the installation guidance for SQL Server on Linux.

Установка расширений языка Install Language Extensions

Если в SQL Server 2019 установлены Службы машинного обучения, значит, пакет mssql-server-extensibility для расширений языка уже установлен и этот шаг можно пропустить. If you have Machine Learning Services installed on SQL Server 2019, the mssql-server-extensibility package for Language Extensions is already installed and you can skip this step.

Выполните приведенную ниже команду, чтобы установить расширения языка SQL Server для SUSE Linux Enterprise Server (SLES), которые используются в настраиваемой среде выполнения Python. Run the command below to install SQL Server Language Extensions on SUSE Linux Enterprise Server (SLES), which is used for the Python custom runtime.

Установка Python 3.7 и Pandas Install Python 3.7 and pandas

Расширение языка Python, используемое для настраиваемой среды выполнения Python, сейчас поддерживает только Python 3.7. The Python language extension used for the custom Python runtime currently supports Python 3.7 only. Если вы хотите использовать другую версию Python, выполните инструкции из репозитория расширения языка Python, чтобы изменить и скомпилировать расширение. If you would like to use a different version of Python, follow the instruction in the Python Language Extension GitHub repo to modify and rebuild the extension.

Установите на сервере Python 3.7. Install Python 3.7 on the server.

Чтобы установить пакет pandas, выполните приведенную ниже команду. Run the command below to install the pandas package

Настраиваемая установка Python Custom installation of Python

Если вы установили Python 3.7 в расположение /usr/lib/python3.7 по умолчанию, этот раздел можно пропустить и сразу перейти к разделу Регистрация расширения языка. If you have installed Python 3.7 in the default location of /usr/lib/python3.7 , you can skip this section and move on to the Register language extension section.

Если вы скомпилировали собственную версию Python 3.7, выполните приведенные ниже команды, чтобы сообщить SQL Server о настраиваемой установке. If you built your own version of Python 3.7, use the following commands to let SQL Server know your custom installation.

Добавление переменной среды Add environment variable

Измените службу mssql-launchpadd, добавив переменную среды PYTHONHOME в файл /etc/systemd/system/mssql-launchpadd.service.d/override.conf . First, edit the mssql-launchpadd service to add the PYTHONHOME environment variable to the file /etc/systemd/system/mssql-launchpadd.service.d/override.conf

Откройте файл с помощью systemctl. Open the file with systemctl

Вставьте следующий текст в открывающийся файл /etc/systemd/system/mssql-launchpadd.service.d/override.conf . Insert the following text in the /etc/systemd/system/mssql-launchpadd.service.d/override.conf file that opens. Установите значение параметра PYTHONHOME в соответствии с путем установки настраиваемой версии Python. Set value of PYTHONHOME to the custom Python installation path.

Сохраните файл и закройте редактор. Save the file and close the editor.

Убедитесь, что удается загрузить libpython3.7m.so.1.0 . Next, make sure libpython3.7m.so.1.0 can be loaded.

Создайте файл custom-python.conf в /etc/ld.so.conf.d . Create a custom-python.conf file in /etc/ld.so.conf.d .

В открывшийся файл добавьте путь к libpython3.7m.so.1.0 из настраиваемой установки Python. In the file that opens, add the path to libpython3.7m.so.1.0 from the custom Python installation.

Сохраните новый файл и закройте редактор. Save the new file and close the editor.

Запустите ldconfig и убедитесь, что можно загрузить libpython3.7m.so.1.0 , выполнив следующую команду и проверив наличие всех зависимых библиотек. Run ldconfig and verify libpython3.7m.so.1.0 can be loaded by running the following commands and checking that all the dependent libraries can be found.

Предоставление доступа к папке Python Grant access to Python folder

Присвойте параметру datadirectories в разделе «Расширяемость» файла /var/opt/mssql/mssql.conf значение настраиваемой установки Python. Set the datadirectories option in the extensibility section of /var/opt/mssql/mssql.conf file to the custom python installation.

Перезапуск службы mssql-launchpadd Restart mssql-launchpadd

Чтобы перезапустить службу mssql-launchpadd, выполните приведенную ниже команду. Run the following command to restart mssql-launchpadd.

Регистрация расширения языка Register language extension

Выполните описанные ниже действия, чтобы скачать и зарегистрировать расширение языка Python, которое используется для настраиваемой среды выполнения Python. Follow these steps to download and register the Python language extension, which is used for the Python custom runtime.

Скачайте файл python-lang-extension-linux-release.zip из репозитория GitHub для расширений языка SQL Server. Download the python-lang-extension-linux-release.zip file from the SQL Server Language Extensions GitHub repo.

Для среды разработки или тестирования также можно использовать отладочную версию (python-lang-extension-linux-debug.zip). Alternatively, you can use the debug version (python-lang-extension-linux-debug.zip) in a development or test environment. Отладочная версия сохраняет в журнал подробные сведения, которые помогают изучать ошибки, и не рекомендуется для рабочих сред. The debug version provides verbose logging information to investigate any errors, and is not recommended for production environments.

С помощью Azure Data Studio подключитесь к экземпляру SQL Server и выполните приведенную ниже команду T-SQL, чтобы зарегистрировать расширение языка Python с помощью инструкции CREATE EXTERNAL LANGUAGE. Use Azure Data Studio to connect to your SQL Server instance and run the following T-SQL command to register the Python language extension with CREATE EXTERNAL LANGUAGE.

Измените путь в этой инструкции таким образом, чтобы он указывал расположение скачанного ZIP-файла с расширением языка (python-lang-extension-linux-release.zip). Modify the path in this statement to reflect the location of the downloaded language extension zip file (python-lang-extension-linux-release.zip).

Выполните эту инструкцию для каждой базы данных, в которой вы намерены использовать расширение языка Python. Execute the statement for each database you want to use the Python language extension in.

Python является зарезервированным словом, то есть вы не сможете указать такое имя для нового внешнего языка. Python is a reserved word and can’t be used as the name for a new external language name. Выберите другое имя. Use a different name instead. Например, в приведенной выше инструкции это имя myPython. For example, the statement above uses myPython.

Включение внешнего скрипта Enable external script

Внешний скрипт Python можно выполнить с помощью хранимой процедуры sp_execute_external script. You can execute a Python external script with the stored procedure sp_execute_external script.

Чтобы включить внешние скрипты, выполните с помощью Azure Data Studio приведенную ниже инструкцию. To enable external scripts, use Azure Data Studio to execute the statement below.

Проверка установки Verify installation

Используйте приведенный ниже скрипт SQL для проверки установки и функций настраиваемой среды выполнения Python. Use the following SQL script to verify the installation and functionality of the Python custom runtime.