Linux에 SQL Server 2019 Machine Learning Services(Python 및 R) 설치

아티클
05/30/2023

적용 대상: SQL Server 2019(15.x) - Linux

이 문서에서는 Linux에 SQL Server Machine Learning Services를 설치하는 과정을 안내합니다. Machine Learning Services를 사용하여 데이터베이스 내에서 Python 및 R 스크립트를 실행할 수 있습니다.

Machine Learning Services는 RHEL(Red Hat Enterprise Linux), SLES(SUSE Linux Enterprise Server) 및 Ubuntu에 설치할 수 있습니다. 자세한 내용은 Installation guidance for SQL Server on Linux(SQL Server on Linux 설치 지침)의 Supported platforms(지원되는 플랫폼) 섹션을 참조하세요.

중요

이러한 지침은 SQL Server 2019(15.x)에만 적용됩니다. 설치 단계가 다른 SQL Server 2022(16.x)의 경우 Linux에서 SQL Server 2022 Machine Learning Services(Python 및 R) 설치를 참조하세요.

설치 전 검사 목록

SQL Server on Linux를 설치한 다음, 설치를 확인합니다.
Python 및 R 확장의 SQL Server Linux 리포지토리를 확인합니다. 데이터베이스 엔진 설치에 대한 원본 리포지토리를 이미 구성한 경우 동일한 리포지토리 등록을 사용하여 mssql-mlservices 패키지 설치 명령을 실행할 수 있습니다.
(R만 해당) MRO(Microsoft R Open)는 SQL Server의 R 기능을 위한 기본 R 배포를 제공하며 RevoScaleR, MicrosoftML 및 기타 Machine Learning Services와 함께 설치되는 R 패키지를 사용하기 위한 필수 조건입니다.
- 필요한 버전은 MRO 3.5.2입니다.
- 아래에 설명된 packages.microsoft.com 대로 리포지토리를 등록하여 MRO 배포 microsoft-r-open-mro 를 설치합니다 microsoft-r-open-mkl.
- MRO를 설치하는 방법은 아래의 설치 섹션을 참조하세요.
T-SQL 명령을 실행하기 위한 도구가 있어야 합니다.
- Linux, Windows 및 macOS에서 실행되는 무료 데이터베이스 도구인 Azure Data Studio를 사용할 수 있습니다.

패키지 목록

인터넷에 연결된 디바이스에서 패키지는 각 운영 체제의 패키지 설치 프로그램을 사용하여 데이터베이스 엔진과 독립적으로 다운로드 및 설치됩니다. 다음 표에서는 사용할 수 있는 모든 패키지에 대해 설명하지만, R 및 Python의 경우 전체 기능 설치 또는 최소 기능 설치를 제공하는 패키지를 지정합니다.

사용 가능한 설치 패키지:

패키지 이름	적용 대상	Description
mssql-server-extensibility	모두	Python 및 R을 실행하는 데 사용되는 확장성 프레임워크입니다.
microsoft-openmpi	Python, R	Linux에서 병렬 처리를 위해 Rev* 라이브러리가 사용하는 메시지 전달 인터페이스입니다.
mssql-mlservices-python	Python	Anaconda 및 Python의 오픈 소스 배포입니다.
mssql-mlservices-mlm-py	Python	‘전체 설치’. 이미지 기능화 및 텍스트 감정 분석을 위한 revoscalepy, microsoftml, 미리 학습된 모델을 제공합니다.
mssql-mlservices-packages-py	Python	‘최소 설치’. revoscalepy 및 microsoftml을 제공합니다. 미리 학습된 모델을 제외합니다.
microsoft-r-open*	R	3개 패키지로 구성된 R의 오픈 소스 배포입니다.
mssql-mlservices-mlm-r	R	‘전체 설치’. 제공 항목: 이미지 기능화 및 텍스트 감정 분석을 위한 미리 학습된 모델, RevoScaleR, MicrosoftML, sqlRUtils, olapR
mssql-mlservices-packages-r	R	‘최소 설치’. RevoScaleR, sqlRUtils, MicrosoftML, olapR을 제공합니다. 미리 학습된 모델을 제외합니다.

RHEL에 설치

아래 단계에 따라 RHEL(Red Hat Enterprise Linux)에 SQL Server Machine Learning Services를 설치합니다.

RHEL에 MRO 설치

다음 명령은 MRO를 제공하는 리포지토리를 등록합니다. 등록 후에 mssql-mlservices-mml-r과 같은 다른 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에 설치

아래 단계에 따라 Ubuntu에 SQL Server Machine Learning Services를 설치합니다.

Ubuntu에 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의 설치 옵션:

요구 사항에 따라 언어 지원을 설치합니다(단일 언어 또는 여러 언어).
‘전체 설치’는 미리 학습된 기계 학습 모델을 포함하여 사용 가능한 모든 기능을 제공합니다.
‘최소 설치’는 모델을 제외하지만 모든 기능을 포함합니다.

팁

가능하면 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에 설치

아래 단계에 따라 SLES(SUSE Linux Enterprise Server)에 SQL Server Machine Learning Services를 설치합니다.

SLES에 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 tool을 통해 진행됩니다.

패키지 설치가 완료되면 mssql-conf setup을 실행하고, 프롬프트에 따라 SA 암호를 설정하고, 버전을 선택합니다. 아직 SQL Server on Linux를 구성하지 않은 경우에만 이 단계를 수행합니다.
```
sudo /opt/mssql/bin/mssql-conf setup
```
오픈 소스 Python 및 R 확장의 사용권 계약에 동의합니다. 다음 명령을 사용합니다.
```
# Run as SUDO or root
# Use set + EULA 
sudo /opt/mssql/bin/mssql-conf set EULA accepteulaml Y
```
mssql-conf setup을 실행하면 설치 프로그램이 mssql-mlservices 패키지를 검색하고 EULA에 동의하라는 메시지를 표시합니다(이전에 동의하지 않은 경우). EULA 매개 변수에 대한 자세한 내용은 mssql-conf 도구를 사용하여 SQL Server 구성을 참조하세요.
아웃바운드 네트워크 액세스를 사용하도록 설정합니다. 아웃바운드 네트워크 액세스는 기본적으로 사용 안 함으로 설정됩니다. 아웃바운드 요청을 사용하려면 mssql-conf 도구를 사용하여 "outboundnetworkaccess" 부울 속성을 설정합니다. 자세한 내용은 mssql-conf를 사용하여 SQL Server on Linux 구성을 참조하세요.
```
# Run as SUDO or root
# Enable outbound requests over the network
sudo /opt/mssql/bin/mssql-conf set extensibility outboundnetworkaccess 1
```
R 기능 통합의 경우에만 MKL_CBWR 환경 변수를 설정하여 Intel MKL(Math Kernel Library) 계산에서 일관성 있는 출력을 보장합니다.
- 사용자 홈 디렉터리에서 .bash_profile 파일을 편집하거나 만들고 파일에 export MKL_CBWR="AUTO" 줄을 추가합니다.
- Bash 명령 프롬프트에서 source .bash_profile을 입력하여 이 파일을 실행합니다.
SQL Server 실행 패드 서비스 및 데이터베이스 엔진 인스턴스를 다시 시작하여 INI 파일에서 업데이트된 값을 읽습니다. 확장성 관련 설정을 수정하면 알림 메시지가 표시됩니다.
```
systemctl restart mssql-launchpadd

systemctl restart mssql-server.service
```
Transact-SQL을 실행하는 Azure Data Studio 또는 SQL Server Management Studio(Windows에만 해당)와 같은 다른 도구를 사용하여 외부 스크립트 실행을 사용하도록 설정합니다.
```
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에서 찾을 수 있습니다.

설치의 유효성을 검사하려면 다음을 수행합니다.

쿼리 도구를 사용하여 Python 또는 R 호출 시스템 저장 프로시저를 실행하는 T-SQL 스크립트를 실행합니다.
다음 SQL 명령을 실행하여 SQL Server에서 R 실행을 테스트합니다. 오류가 발생하는 경우 서비스를 다시 시작해 보세요(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 명령을 실행하여 SQL Server에서 Python 실행을 테스트합니다.

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용 패키지와 EULA를 추가합니다.

오픈 소스 R 및 Python 배포에 대해 mlservices 관련 EULA 매개 변수 중 하나를 사용합니다.

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

전체 EULA는 mssql-conf 도구를 사용하여 SQL Server on Linux 구성에 나와 있습니다.

오프라인 설치

패키지 설치 단계의 오프라인 설치 지침을 따릅니다. 다운로드 사이트를 찾은 후 아래 패키지 목록을 사용하여 특정 패키지를 다운로드합니다.

팁

여러 패키지 관리 도구에서 패키지 종속성을 확인하는 데 도움이 되는 명령을 제공합니다. Yum의 경우 sudo yum deplist [package]를 사용합니다. Ubuntu의 경우 dpkg -I [package name].deb와 sudo apt-get install --reinstall --download-only [package name]을 차례로 사용합니다.

다운로드 사이트

https://packages.microsoft.com/에서 패키지를 다운로드합니다. Python 및 R용 mlservices 패키지는 모두 데이터베이스 엔진 패키지와 함께 배치됩니다. 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 개발자는 다음 자습서에 따라 SQL Server에서 Python을 사용하는 방법을 알아볼 수 있습니다.

Python 자습서: SQL Server Machine Learning Services에서 선형 회귀를 사용하여 스키 대여 예측
Python 자습서: Categorizing customers using k-means clustering with SQL Server Machine Learning Services(SQL Server Machine Learning Services에서 k-평균 클러스터링을 사용하여 고객 분류)

R 개발자는 몇 가지 간단한 예제를 시작하고 R이 SQL Server에서 작동하는 방식의 기초를 알아볼 수 있습니다. 다음 단계로 가려면 아래 링크를 참조하세요.

Linux에 SQL Server 2019 Machine Learning Services(Python 및 R) 설치

설치 전 검사 목록

패키지 목록

RHEL에 설치

RHEL에 MRO 설치

전체 설치

최소 설치

Ubuntu에 설치

Ubuntu에 MRO 설치

전체 설치

최소 설치

SLES에 설치

SLES에 MRO 설치

전체 설치

최소 설치

설치 후 구성(필수)

설치 확인

무인 설치

오프라인 설치

다운로드 사이트

RHEL/8 경로

Ubuntu/20.04 경로

SLES/12 경로

패키지 목록

피드백

피드백

추가 리소스

Linux에 SQL Server 2019 Machine Learning Services(Python 및 R) 설치

설치 전 검사 목록

패키지 목록

RHEL에 설치

RHEL에 MRO 설치

전체 설치

최소 설치

Ubuntu에 설치

Ubuntu에 MRO 설치

전체 설치

최소 설치

SLES에 설치

SLES에 MRO 설치

전체 설치

최소 설치

설치 후 구성(필수)

설치 확인

무인 설치

오프라인 설치

다운로드 사이트

RHEL/8 경로

Ubuntu/20.04 경로

SLES/12 경로

패키지 목록

관련 콘텐츠

피드백

피드백

추가 리소스