Установка служб машинного обучения SQL Server 2019 (Python, R) в Linux

Статья
05/30/2023

Область применения:SQL Server 2019 (15.x) — Linux

В этой статье представлен порядок установки Службы машинного обучения SQL Server в Linux. Службы машинного обучения можно использовать для запуска сценариев R или Python в базе данных.

Вы можете установить Службы машинного обучения на платформах Red Hat Enterprise Linux (RHEL), SUSE Linux Enterprise Server (SLES) и Ubuntu. Дополнительные сведения см. в разделе "Поддерживаемые платформы" в руководстве по установке SQL Server на Linux.

Важно!

Эти инструкции относятся только к SQL Server 2019 (15.x). Для SQL Server 2022 (16.x), где этапы установки отличаются, см. в статье "Установка SQL Server 2022 Машинное обучение Services (Python и R) в Linux.

Контрольный список перед установкой

Установите SQL Server в Linux и проверьте установку.
Проверьте репозитории SQL Server в Linux для расширений Python и R. Если вы уже настроили репозитории исходного кода для ядра СУБД, команды установки пакета mssql-mlservices можно выполнить, используя ту же регистрацию репозиториев.
(Только для R) Microsoft R Open (MRO) предоставляет базовый дистрибутив R для функции R в SQL Server и является необходимым компонентом для использования RevoScaleR, MicrosoftML и других пакетов R, устанавливаемых вместе со Службами машинного обучения.
- Требуемая версия: MRO 3.5.2.
- Зарегистрируйте репозиторий packages.microsoft.com , как описано ниже, чтобы установить дистрибутив MRO: microsoft-r-open-mro и microsoft-r-open-mkl.
- Сведения об установке MRO см. в следующих разделах об установке.
У вас должно быть средство для выполнения команд T-SQL.
- Вы можете использовать Azure Data Studio, бесплатное средство для работы с базами данных, которое работает в Linux, Windows и macOS.

Список пакетов

На устройстве, подключенном к Интернету, пакеты скачиваются и устанавливаются независимо от ядра СУБД с помощью установщика пакетов для каждой операционной системы. В следующей таблице описаны все доступные пакеты, однако для R и Python можно указать пакеты, обеспечивающие установку всех компонентов или установку минимального набора компонентов.

Доступные пакеты установки:

Имя пакета	Область действия	Description
mssql-server-extensibility	Все	Платформа расширяемости, используемая для выполнения кода Python и R.
microsoft-openmpi	Python, R	Интерфейс передачи сообщений, используемый библиотеками Rev* для распараллеливания в Linux.
mssql-mlservices-python	Python	Дистрибутив Anaconda и Python с открытым кодом.
mssql-mlservices-mlm-py	Python	Полная установка. Предоставляет revoscalepy, microsoftml, предварительно обученные модели для выделения признаков изображений и анализа тональности текста.
mssql-mlservices-packages-py	Python	Минимальная установка. Предоставляет revoscalepy и microsoftml. Не включает в себя предварительно обученные модели.
microsoft-r-open *	R	Дистрибутив R с открытым исходным кодом, состоящий из трех пакетов.
mssql-mlservices-mlm-r	R	Полная установка. Предоставляет: RevoScaleR, MicrosoftML, sqlRUtils, olapR, предварительно обученные модели для анализа признаков изображений и анализа тональности текста.
mssql-mlservices-packages-r	R	Минимальная установка. Предоставляет RevoScaleR, sqlRUtils, MicrosoftML, olapR. Не включает в себя предварительно обученные модели.

Установка в RHEL

Выполните следующие действия, чтобы установить Службы машинного обучения SQL Server на Red Hat Enterprise Linux (RHEL).

Установка MRO в RHEL

Следующие команды регистрируют репозиторий, предоставляющий MRO. После регистрации команды для установки других пакетов R, таких как mssql-mlservices-mml-r, будут автоматически включать MRO в качестве зависимости пакета.

# Import the Microsoft repository key

sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc

# Set the location of the package repo at the "prod" directory
# The following command is for version 8.x
# To get the version for 6.x or 7.x, replace 8 with 6 or 7, respectively.
rpm -Uvh https://packages.microsoft.com/config/rhel/8/packages-microsoft-prod.rpm

# Update packages on your system (optional)
yum update

Параметры установки для Python и R.

Установите языковую поддержку в соответствии с вашими требованиями (один или несколько языков).
В режиме полной установки устанавливаются все доступные функции, включая предварительно обученные модели машинного обучения.
В режиме минимальной установки исключаются модели, однако все функциональные возможности сохраняются.

Совет

По возможности запустите yum clean all, чтобы обновить пакеты в системе перед установкой.

Полная установка

Включает:

Открытый исходный код Python
Открытый исходный код R
Платформа расширяемости
Microsoft-openmpi
Расширения (Python, R)
Библиотеки машинного обучения
Предварительно обученные модели для Python и R

# Install as root or sudo
# Add everything (all R, Python)
# Be sure to include -9.4.7* in mlsservices package names
sudo yum install mssql-mlservices-mlm-py-9.4.7*
sudo yum install mssql-mlservices-mlm-r-9.4.7*

Минимальная установка

Включает:

Открытый исходный код Python
Открытый исходный код R
Платформа расширяемости
Microsoft-openmpi
Основные библиотеки Revo*
Библиотеки машинного обучения

# Install as root or sudo
# Minimum install of R, Python extensions
# Be sure to include -9.4.6* in mlsservices package names
sudo yum install mssql-mlservices-packages-py-9.4.7*
sudo yum install mssql-mlservices-packages-r-9.4.7*

Установка в Ubuntu

Выполните следующие действия, чтобы установить Службы машинного обучения SQL Server на Ubuntu.

Установка MRO на Ubuntu

# Install as root
sudo su

# Optionally, if your system does not have the https apt transport option
apt-get install apt-transport-https

# If you are on Ubuntu 20.04, install the following package (MRO 3.5 has a dependency on libtinfo.so.5 in Ubuntu 20.04)
apt-get install libncurses5

# Set the location of the package repo the "prod" directory containing the distribution.
# This example specifies 20.04. Replace with 16.04 or 14.04 if you want those versions.
wget https://packages.microsoft.com/config/ubuntu/20.04/packages-microsoft-prod.deb

# Register the repo
dpkg -i packages-microsoft-prod.deb

# Update packages on your system (required), including MRO installation
sudo apt-get update

Параметры установки для Python и R.

Установите языковую поддержку в соответствии с вашими требованиями (один или несколько языков).
В режиме полной установки устанавливаются все доступные функции, включая предварительно обученные модели машинного обучения.
В режиме минимальной установки исключаются модели, однако все функциональные возможности сохраняются.

Совет

По возможности запустите apt-get update, чтобы обновить пакеты в системе перед установкой.

Полная установка

Включает:

Открытый исходный код Python
Открытый исходный код R
Платформа расширяемости
Microsoft-openmpi
Расширения Python
Расширения R
Библиотеки машинного обучения
Предварительно обученные модели для Python и R

# Install as root or sudo
# Add everything (all R, Python)
# There is no asterisk in this full install
sudo apt-get install mssql-mlservices-mlm-py 
sudo apt-get install mssql-mlservices-mlm-r

Минимальная установка

Включает:

Открытый исходный код Python
Открытый исходный код R
Платформа расширяемости
Microsoft-openmpi
Основные библиотеки Revo*
Библиотеки машинного обучения

# Install as root or sudo
# Minimum install of R, Python
# No asterisk
sudo apt-get install mssql-mlservices-packages-py
sudo apt-get install mssql-mlservices-packages-r

Установка в SLES

Выполните следующие действия, чтобы установить Службы машинного обучения SQL Server на SUSE Linux Enterprise Server (SLES).

Установка MRO на SLES

# Install as root
sudo su

# Set the location of the package repo at the "prod" directory containing the distribution
# This example is for SLES12
zypper ar -f https://packages.microsoft.com/sles/12/prod packages-microsoft-com

# Update packages on your system (optional)
zypper update

Параметры установки для Python и R.

Установите языковую поддержку в соответствии с вашими требованиями (один или несколько языков).
В режиме полной установки устанавливаются все доступные функции, включая предварительно обученные модели машинного обучения.
В режиме минимальной установки исключаются модели, однако все функциональные возможности сохраняются.

Полная установка

Включает:

Открытый исходный код Python
Открытый исходный код R
Платформа расширяемости
Microsoft-openmpi
Расширения для Python и R
Библиотеки машинного обучения
Предварительно обученные модели для Python и R

# Install as root or sudo
# Add everything (all R, Python)
sudo zypper install mssql-mlservices-mlm-py
sudo zypper install mssql-mlservices-mlm-r

Минимальная установка

Включает:

Открытый исходный код Python
Открытый исходный код R
Платформа расширяемости
Microsoft-openmpi
Основные библиотеки Revo*
Библиотеки машинного обучения

# Install as root or sudo
# Minimum install of R, Python extensions
sudo zypper install mssql-mlservices-packages-py
sudo zypper install mssql-mlservices-packages-r

Настройка после установки (обязательно)

Дополнительная настройка осуществляется в основном с помощью средства mssql-conf.

Когда установка пакета завершится, выполните команду mssql-conf setup и следуйте указаниям, чтобы задать пароль системного администратора и выбрать выпуск. Выполните этот шаг, только если вы еще не настроили SQL Server в Linux.
```
sudo /opt/mssql/bin/mssql-conf setup
```
Примите условия лицензионного соглашения для расширений R и Python с открытым исходным кодом. Используйте следующую команду:
```
# Run as SUDO or root
# Use set + EULA 
sudo /opt/mssql/bin/mssql-conf set EULA accepteulaml Y
```
Программа установки обнаруживает пакеты mssql-mlservices и предлагает принять условия лицензионного соглашения (если оно не было принято ранее) при выполнении mssql-conf setup. Дополнительные сведения о параметрах лицензионного соглашения см. в статье Настройка SQL Server с помощью средства mssql-conf.
Включите исходящий сетевой доступ. По умолчанию исходящий сетевой доступ отключен. Чтобы включить исходящие запросы, задайте логическое свойство outboundnetworkaccess с помощью средства mssql-conf. Дополнительные сведения см. в статье Настройка SQL Server на Linux с помощью средства mssql-conf.
```
# Run as SUDO or root
# Enable outbound requests over the network
sudo /opt/mssql/bin/mssql-conf set extensibility outboundnetworkaccess 1
```
Только для интеграции с R присвойте переменной среды MKL_CBWR значение ensure consistent output из вычислений Intel Math Kernel Library (MKL).
- Измените или создайте файл .bash_profile в домашнем каталоге пользователя, добавив в него export MKL_CBWR="AUTO".
- Выполните этот файл, введя команду source .bash_profile в командной строке bash.
Перезапустите службу панели запуска SQL Server и экземпляр ядра СУБД, чтобы считать обновленные значения из INI-файла. При изменении параметра, связанного с расширяемостью, отображается сообщение уведомления.
```
systemctl restart mssql-launchpadd

systemctl restart mssql-server.service
```
Включите выполнение внешнего скрипта с помощью Azure Data Studio или другого средства, например SQL Server Management Studio (только для Windows), выполняющего скрипты Transact-SQL.
```
EXEC sp_configure 'external scripts enabled', 1 
RECONFIGURE WITH OVERRIDE 
```
Снова перезапустите службу панели запуска.

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

Библиотеки R (MicrosoftML, RevoScaleR и др.) можно найти по адресу /opt/mssql/mlservices/libraries/RServer.

Библиотеки Python (microsoftml и revoscalepy) можно найти по адресу /opt/mssql/mlservices/libraries/PythonServer.

Порядок проверки установки

Запустите скрипт T-SQL, который выполняет системную хранимую процедуру, вызывающую Python или R, с помощью инструмента запросов.
Выполните следующую команду SQL для тестирования выполнения R в SQL Server. Возникли ошибки? Попробуйте перезапустить службу, sudo systemctl restart mssql-server.service.
```
EXEC sp_execute_external_script   
@language =N'R', 
@script=N' 
OutputDataSet <- InputDataSet', 
@input_data_1 =N'SELECT 1 AS hello' 
WITH RESULT SETS (([hello] int not null)); 
GO 
```

Выполните следующую команду SQL для тестирования выполнения Python в SQL Server.

EXEC sp_execute_external_script  
@language =N'Python', 
@script=N' 
OutputDataSet = InputDataSet; 
', 
@input_data_1 =N'SELECT 1 AS hello' 
WITH RESULT SETS (([hello] int not null)); 
GO

Автоматическая установка

С помощью автоматической установки для ядра СУБД вы можете добавить пакеты для mssql-mlservices и лицензионных соглашений.

Используйте один из параметров лицензионного соглашения mlservices для дистрибутивов R и Python с открытым исходным кодом:

sudo /opt/mssql/bin/mssql-conf setup accept-eula-ml

Полный текст лицензионного соглашения см. в статье Настройка SQL Server в Linux с помощью средства mssql-conf.

Автономная установка

Описание шагов по установке пакетов см. в инструкциях по автономной установке. Найдите сайт скачивания, а затем скачайте конкретные пакеты с помощью приведенного ниже списка.

Совет

Некоторые средства управления пакетами предоставляют команды, помогающие определить зависимости пакетов. Для yum используйте sudo yum deplist [package]. Для Ubuntu используйте sudo apt-get install --reinstall --download-only [package name], а затем dpkg -I [package name].deb.

Сайт загрузки

Скачайте пакеты с сайта https://packages.microsoft.com/. Все пакеты mlservices для R и Python размещены вместе с пакетом ядра СУБД. Базовой версией для пакетов mlservices является 9.4.6. Не забывайте, что пакеты microsoft-r-open находятся в другом репозитории.

Пути RHEL/8

Пакет	Расположение для скачивания
Пакеты mssql/mlservices	https://packages.microsoft.com/rhel/8/mssql-server-2019/
Пакеты microsoft-r-open	https://packages.microsoft.com/rhel/8/prod/

Пути Ubuntu/20.04

Пакет	Расположение для скачивания
Пакеты mssql/mlservices	https://packages.microsoft.com/ubuntu/20.04/mssql-server-2019/pool/main/m/
Пакеты microsoft-r-open	https://packages.microsoft.com/ubuntu/20.04/prod/pool/main/m/

Пути SLES/12

Пакет	Расположение для скачивания
Пакеты mssql/mlservices	https://packages.microsoft.com/sles/12/mssql-server-2019/
Пакеты microsoft-r-open	https://packages.microsoft.com/sles/12/prod/

Выберите расширения, которые хотите использовать, скачайте пакеты, необходимые для требуемого языка. Имена файлов включают сведения о платформе в суффиксе.

Список пакетов

В зависимости от того, какие расширения вы хотите использовать, скачайте пакеты, необходимые для конкретного языка. Точные имена файлов содержат сведения о платформе в суффиксе, но приведенные ниже имена должны быть достаточно понятными, чтобы вы могли определить, какие файлы нужно получить.

# Core packages 
mssql-server-15.0.1000
mssql-server-extensibility-15.0.1000

# R
microsoft-openmpi-3.0.0
microsoft-r-open-mkl-3.5.2
microsoft-r-open-mro-3.5.2
mssql-mlservices-packages-r-9.4.7.64
mssql-mlservices-mlm-r-9.4.7.64


# Python
microsoft-openmpi-3.0.0
mssql-mlservices-python-9.4.7.64
mssql-mlservices-packages-py-9.4.7.64
mssql-mlservices-mlm-py-9.4.7.64

Разработчики на языке Python могут узнать, как использовать Python с SQL Server, изучив следующие руководства.

Разработчики на языке R могут ознакомиться с простыми примерами, а также узнать, как код R работает с SQL Server. Дополнительные сведения см. в следующих статьях.

Установка служб машинного обучения SQL Server 2019 (Python, R) в Linux

Контрольный список перед установкой

Список пакетов

Установка в RHEL

Установка MRO в RHEL

Полная установка

Минимальная установка

Установка в Ubuntu

Установка MRO на Ubuntu

Полная установка

Минимальная установка

Установка в SLES

Установка MRO на SLES

Полная установка

Минимальная установка

Настройка после установки (обязательно)

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

Автоматическая установка

Автономная установка

Сайт загрузки

Пути RHEL/8

Пути Ubuntu/20.04

Пути SLES/12

Список пакетов

Обратная связь

Обратная связь

Дополнительные ресурсы

Установка служб машинного обучения SQL Server 2019 (Python, R) в Linux

Контрольный список перед установкой

Список пакетов

Установка в RHEL

Установка MRO в RHEL

Полная установка

Минимальная установка

Установка в Ubuntu

Установка MRO на Ubuntu

Полная установка

Минимальная установка

Установка в SLES

Установка MRO на SLES

Полная установка

Минимальная установка

Настройка после установки (обязательно)

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

Автоматическая установка

Автономная установка

Сайт загрузки

Пути RHEL/8

Пути Ubuntu/20.04

Пути SLES/12

Список пакетов

Связанный контент

Обратная связь

Обратная связь

Дополнительные ресурсы