Linux에 SQL Server 2019 Machine Learning Services(Python 및 R) 설치
적용 대상: 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입니다.
- MRO 배포
packages.microsoft.com
와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 설치
다음 명령은 MRO를 제공하는 리포지토리를 등록합니다. 등록 후에 mssql-mlservices-mml-r과 같은 다른 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의 설치 옵션:
- 요구 사항에 따라 언어 지원을 설치합니다(단일 언어 또는 여러 언어).
- ‘전체 설치’는 미리 학습된 기계 학습 모델을 포함하여 사용 가능한 모든 기능을 제공합니다.
- ‘최소 설치’는 모델을 제외하지만 모든 기능을 포함합니다.
팁
가능하면 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 설치
다음 명령은 MRO를 제공하는 리포지토리를 등록합니다. 등록 후에 mssql-mlservices-mml-r과 같은 다른 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 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에서 작동하는 방식의 기초를 알아볼 수 있습니다. 다음 단계로 가려면 아래 링크를 참조하세요.