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

Применимо к: 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 на 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.

  • Вы можете подключиться к экземпляру SQL Server с помощью любого знакомого клиентского средства SQL Server, например sqlcmd, SQL Server Management Studio (SSMS) или расширения MSSQL для Visual Studio Code.

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

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

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

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

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

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

Включает:

• Открытый исходный код 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 mlservices 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 mlservices 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

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

# 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.

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

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

Включает:

• Открытый исходный код 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

Установка на SUSE Linux Enterprise Server (SLES)

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

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

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

# 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.

1. После завершения установки пакета выполните команду mssql-conf setup и следуйте указаниям на экране, чтобы задать пароль sa и выбрать редакцию. Выполните этот шаг, только если SQL Server в Linux еще не настроен.

   sudo /opt/mssql/bin/mssql-conf setup
   

2. Примите условия лицензионного соглашения для расширений 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.

3. Включите исходящий сетевой доступ. По умолчанию исходящий сетевой доступ отключен. Чтобы включить исходящие запросы, задайте логическое свойство 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
   

4. Только для интеграции функции R задайте переменную среды MKL_CBWR, чтобы обеспечить согласованный вывод результатов вычислений Intel Math Kernel Library (MKL).

   • Измените или создайте файл .bash_profile в вашем домашнем каталоге, добавив в файл строку export MKL_CBWR="AUTO".

   • Выполните этот файл, введя команду source .bash_profile в командной строке bash.

5. Перезапустите службу панели запуска SQL Server и экземпляр ядра СУБД, чтобы считать обновленные значения из INI-файла. При изменении параметра, связанного с расширяемостью, отображается сообщение уведомления.

   systemctl restart mssql-launchpadd
   
   systemctl restart mssql-server.service
   

6. Включите выполнение внешнего скрипта. Вы можете подключиться к экземпляру SQL Server с помощью любого знакомого клиентского средства SQL Server, например sqlcmd, SQL Server Management Studio (SSMS) или расширения MSSQL для Visual Studio Code.

   EXECUTE sp_configure 'external scripts enabled', 1;
   
   RECONFIGURE WITH OVERRIDE;
   

7. Снова перезапустите службу панели запуска.

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

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

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

Чтобы проверить установку:

• Запустите скрипт T-SQL, который выполняет системную хранимую процедуру, вызывающую Python или R, с помощью инструмента запросов.

• Выполните следующую команду T-SQL, чтобы проверить выполнение R в SQL Server. Возникли ошибки? Попробуйте перезапустить службу, sudo systemctl restart mssql-server.service.

  EXECUTE 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
  

• Выполните следующую команду T-SQL, чтобы проверить выполнение Python в SQL Server.

  EXECUTE 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 и EULA.

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

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

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

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

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

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

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

Пути RHEL/8

Пути Ubuntu/20.04

Пути SLES/12

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

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

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

# 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 в службах SQL Server Машинное обучение
• Краткое руководство. Запуск простых скриптов R с помощью машинного обучения SQL
• Руководство по R: Предсказание тарифов на такси Нью-Йорка с помощью двоичной классификации