Installieren von SQL Server 2019 Machine Learning Services (Python und R) unter Linux

Artikel
10/30/2023

Gilt für: SQL Server 2019 (15.x) – Linux

In diesem Artikel werden Sie durch die Installation von SQL Server Machine Learning Services unter Linux geführt. Python- und R-Skripts können mit Machine Learning Services in einer Datenbank ausgeführt werden.

Sie können Machine Learning Services unter Red Hat Enterprise Linux (RHEL), SUSE Linux Enterprise Server (SLES) und Ubuntu installieren. Weitere Informationen finden Sie im Abschnitt „Unterstützte Plattformen“ im Leitfaden für die Installation von SQL Server unter Linux.

Wichtig

Diese Anweisungen gelten speziell für SQL Server 2019 (15.x). Für SQL Server 2022 (16.x) gelten andere Installationsschritte. Weitere Informationen finden Sie unter Installieren von SQL Server 2022 Machine Learning Services (Python und R) unter Linux.

Prüfliste vor der Installation

Installieren Sie SQL Server für Linux, und überprüfen Sie die Installation.
Suchen Sie in den SQL Server für Linux-Repositorys nach den Python- und R-Erweiterungen. Wenn Sie für die Datenbank-Engine-Installation bereits Quellrepositorys konfiguriert haben, können Sie die mssql-mlservices-Befehle für die Paketinstallation mithilfe derselben Repositoryregistrierung ausführen.
(Nur R) Microsoft R Open (MRO) enthält die grundlegende R-Verteilung für das R-Feature in SQL Server und ist eine Voraussetzung für RevoScaleR, MicrosoftML und andere R-Pakete, die mit Machine Learning Services installiert werden.
- Die erforderliche Version ist MRO 3.5.2.
- Registrieren Sie das packages.microsoft.com Repository wie unten beschrieben, um die MRO-Verteilung zu installieren: microsoft-r-open-mro und microsoft-r-open-mkl.
- Weitere Informationen zur Installation von MRO finden Sie in den Abschnitten weiter unten.
Sie sollten über ein Tool zum Ausführen von T-SQL-Befehlen verfügen.
- Sie können z. B. Azure Data Studio verwenden, ein kostenloses Datenbanktool, das unter Linux, Windows und macOS ausgeführt werden kann.

Paketliste

Auf einem mit dem Internet verbundenen Gerät werden Pakete unabhängig von der Datenbank-Engine mithilfe des Paketinstallationsprogramms für das betreffende Betriebssystem heruntergeladen und installiert. In der folgenden Tabelle werden alle verfügbaren Pakete beschrieben. Für R und Python geben Sie jedoch Pakete an, die entweder die vollständigen Installation oder die minimale Installation durchführen.

Verfügbare Installationspakete:

Paketname	Gilt für	BESCHREIBUNG
mssql-server-extensibility	All	Erweiterbarkeitsframework zum Ausführen von Python und R
microsoft-openmpi	Python, R	Die Schnittstelle zur Nachrichtenübergabe, die von den Revo*-Bibliotheken zur Parallelisierung unter Linux verwendet wird
mssql-mlservices-python	Python	Open-Source-Verteilung von Anaconda und Python.
mssql-mlservices-mlm-py	Python	Vollständige Installation: Stellt vortrainierte revoscalepy- bzw. microsoftml-Modelle für Imagefeatures und Stimmungsanalyse für Texte bereit.
mssql-mlservices-packages-py	Python	Minimale Installation: Stellt revoscalepy und microsoftml bereit. Schließt vortrainierte Modelle aus.
microsoft-r-open*	R	Open-Source-Verteilung von R, die aus drei Paketen besteht.
mssql-mlservices-mlm-r	R	Vollständige Installation: Umfasst: RevoScaleR, MicrosoftML, sqlRUtils, olapR, vorab trainierte Modelle für Bildfeatures und Stimmungsanalyse.
mssql-mlservices-packages-r	R	Minimale Installation: Stellt RevoScaleR, sqlRUtils, MicrosoftML und olapR bereit. Schließt vortrainierte Modelle aus.

Installieren unter RHEL

Die folgenden Schritte beschreiben, wie Sie SQL Server Machine Learning Services unter Red Hat Enterprise Linux (RHEL) installieren.

Installieren von MRO unter RHEL

Mit den folgenden Befehlen wird das Repository registriert, das MRO bereitstellt. Nach der Registrierung enthalten die Befehle zum Installieren anderer R-Pakete (z. B. mssql-mlservices-mml-r) automatisch MRO als Paketabhängigkeit.

# 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

Die folgenden Installationsoptionen stehen für Python und R zur Verfügung:

Installieren Sie die Sprachunterstützung basierend auf Ihren Anforderungen (einzelne oder mehrere Sprachen).
Die vollständige Installation stellt alle verfügbaren Features einschließlich der vorab trainierten Modelle bereit.
Die minimale Installation enthält die Modelle zwar nicht, jedoch sind alle Funktionen enthalten.

Tipp

Führen Sie nach Möglichkeit yum clean all aus, um vor der Installation Pakete auf dem System zu aktualisieren.

Die vollständige Installation

Enthält:

Open-Source-Python
Open-Source-R
Erweiterbarkeitsframework
Microsoft-openmpi
Erweiterungen (Python, R)
Machine Learning-Bibliotheken
Vorab trainierte Modelle für Python und 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*

Die minimale Installation

Enthält:

Open-Source-Python
Open-Source-R
Erweiterbarkeitsframework
Microsoft-openmpi
Revo*-Kernbibliotheken
Machine Learning-Bibliotheken

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

Installation unter Ubuntu

Die folgenden Schritte beschreiben, wie Sie SQL Server Machine Learning Services unter Ubuntu installieren.

Installieren von MRO unter 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

Die folgenden Installationsoptionen stehen für Python und R zur Verfügung:

Installieren Sie die Sprachunterstützung basierend auf Ihren Anforderungen (einzelne oder mehrere Sprachen).
Die vollständige Installation stellt alle verfügbaren Features sowie vorab trainierte Modelle bereit.
Die minimale Installation enthält die Modelle zwar nicht, jedoch sind alle Funktionen enthalten.

Tipp

Führen Sie nach Möglichkeit apt-get update aus, um vor der Installation Pakete auf dem System zu aktualisieren.

Die vollständige Installation

Enthält:

Open-Source-Python
Open-Source-R
Erweiterbarkeitsframework
Microsoft-openmpi
Python-Erweiterungen
R-Erweiterungen
Machine Learning-Bibliotheken
Vorab trainierte Modelle für Python und 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

Die minimale Installation

Enthält:

Open-Source-Python
Open-Source-R
Erweiterbarkeitsframework
Microsoft-openmpi
Revo*-Kernbibliotheken
Machine Learning-Bibliotheken

# 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

Installieren unter SLES

Die folgenden Schritte beschreiben, wie Sie SQL Server Machine Learning Services unter SUSE Linux Enterprise Server (SLES) installieren.

Installieren von MRO unter 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

Die folgenden Installationsoptionen stehen für Python und R zur Verfügung:

Installieren Sie die Sprachunterstützung basierend auf Ihren Anforderungen (einzelne oder mehrere Sprachen).
Die vollständige Installation stellt alle verfügbaren Features sowie vorab trainierte Modelle bereit.
Die minimale Installation enthält die Modelle zwar nicht, jedoch sind alle Funktionen enthalten.

Die vollständige Installation

Enthält:

Open-Source-Python
Open-Source-R
Erweiterbarkeitsframework
Microsoft-openmpi
Erweiterungen für Python und R
Machine Learning-Bibliotheken
Vorab trainierte Modelle für Python und 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

Die minimale Installation

Enthält:

Open-Source-Python
Open-Source-R
Erweiterbarkeitsframework
Microsoft-openmpi
Revo*-Kernbibliotheken
Machine Learning-Bibliotheken

# 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

Konfigurieren nach der Installation (erforderlich)

Die zusätzliche Konfiguration erfolgt in erster Linie über das Tool mssql-conf.

Nachdem die Paketinstallation abgeschlossen ist, führen Sie „mssql-conf setup“ aus, und befolgen Sie die Anweisungen, um das Systemadministratorkennwort festzulegen und Ihre Edition auszuwählen. Führen Sie diesen Schritt nur aus, wenn Sie SQL Server für Linux noch nicht konfiguriert haben.
```
sudo /opt/mssql/bin/mssql-conf setup
```
Akzeptieren Sie die Lizenzvereinbarungen für die Erweiterungen für Open-Source-R und -Python. Verwenden Sie den folgenden Befehl:
```
# Run as SUDO or root
# Use set + EULA 
sudo /opt/mssql/bin/mssql-conf set EULA accepteulaml Y
```
Wenn mssql-conf setup ausgeführt wird, erkennt das Setup die mssql-mlservices-Pakete und fordert Sie zum Akzeptieren der EULA auf (sofern diese noch nicht akzeptiert wurde). Weitere Informationen zu den EULA-Parametern finden Sie unter Konfigurieren von SQL Server mit dem Tool mssql-conf.
Aktivieren Sie den Zugriff auf ausgehenden Netzwerkdatenverkehr. Der Zugriff auf ausgehenden Netzwerkdatenverkehr ist standardmäßig deaktiviert. Sie können mithilfe des Tools mssql-conf die boolesche Eigenschaft „outboundnetworkaccess“ festlegen, um ausgehende Anforderungen zu aktivieren. Weitere Informationen finden Sie unter Konfigurieren von SQL Server für Linux mithilfe von mssql-conf.
```
# Run as SUDO or root
# Enable outbound requests over the network
sudo /opt/mssql/bin/mssql-conf set extensibility outboundnetworkaccess 1
```
Wenn Sie nur das R-Feature integrieren möchten, legen Sie die Umgebungsvariable MKL_CBWR über die Intel Math Kernel Library-Berechnungen auf ensure consistent output (Konsistente Ausgabe sicherstellen) fest.
- Bearbeiten oder erstellen Sie eine Datei namens .bash_profile in im Benutzerstammverzeichnis, und fügen Sie die Zeile export MKL_CBWR="AUTO" zur Datei hinzu.
- Führen Sie diese Datei aus, indem Sie source .bash_profile in der Bash-Eingabeaufforderung eingeben.
Starten Sie anschließend das SQL Server-Launchpad und die Datenbank-Engine-Instanz neu, um die aktualisierten Werte aus der INI-Datei zu lesen. Eine Benachrichtigungsmeldung wird angezeigt, wenn eine Einstellung bezüglich der Erweiterbarkeit geändert wird.
```
systemctl restart mssql-launchpadd

systemctl restart mssql-server.service
```
Aktivieren Sie die externe Skriptausführung mithilfe von Azure Data Studio oder einem anderen Tool wie SQL Server Management Studio (nur unter Windows), das Transact-SQL ausführt.
```
EXEC sp_configure 'external scripts enabled', 1 
RECONFIGURE WITH OVERRIDE 
```
Starten Sie den Launchpad-Dienst neu.

Überprüfen der Installation

R-Bibliotheken (z. B. MicrosoftML, RevoScaleR) finden Sie unter /opt/mssql/mlservices/libraries/RServer.

Python-Bibliotheken (microsoftml und revoscalepy) finden Sie unter /opt/mssql/mlservices/libraries/PythonServer.

So überprüfen Sie die Installation:

Führen Sie ein T-SQL-Skript aus, das eine gespeicherte Systemprozedur ausführt, die Python oder R mit einem Abfragetool aufruft.
Führen Sie den folgenden SQL-Befehl aus, um die Ausführung von R in SQL Server testen. Treten Fehler auf? Versuchen Sie einen Dienstneustart (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 
```

Führen Sie den folgenden SQL-Befehl aus, um die Ausführung von Python in SQL Server testen.

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

Unbeaufsichtigte Installation

Fügen Sie die Pakete für „mssql-mlservices“ und die Lizenzbedingungen über eine unbeaufsichtigte Installation der Datenbank-Engine hinzu.

Verwenden Sie einen der mlservices-spezifischen EULA-Parameter für die Open-Source-Verteilungen von R und Python:

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

Die vollständige EULA finden Sie unter Konfigurieren von SQL Server für Linux mithilfe des mssql-conf-Tools.

Offlineinstallation

Befolgen Sie die Anweisungen zur Offlineinstallation, um die Pakete zu installieren. Der nachfolgenden Liste können Sie entnehmen, auf welchen Websites Sie jeweils entsprechende Downloads finden. Laden Sie dann alle nötigen Pakete herunter.

Tipp

Einige der Paketverwaltungstools umfassen Befehle, mit denen Sie Paketabhängigkeiten ermitteln können. Verwenden Sie für yum sudo yum deplist [package]. Verwenden Sie für Ubuntu erst sudo apt-get install --reinstall --download-only [package name] und dann dpkg -I [package name].deb.

Downloadsite

Laden Sie Pakete unter https://packages.microsoft.com/ herunter. Alle mlservices-Pakete für Python und R werden zusammen mit dem Datenbank-Engine-Paket bereitgestellt. Die Basisversion für die mlservices-Pakete ist 9.4.6. Beachten Sie, dass die microsoft-r-open-Pakete sich in einem anderen Repository befinden.

RHEL/8-Pfade

Paket	Downloadspeicherort
mssql/mlservices-Pakete	https://packages.microsoft.com/rhel/8/mssql-server-2019/
microsoft-r-open-Pakete	https://packages.microsoft.com/rhel/8/prod/

Ubuntu/20.04-Pfade

Paket	Downloadspeicherort
mssql/mlservices-Pakete	https://packages.microsoft.com/ubuntu/20.04/mssql-server-2019/pool/main/m/
microsoft-r-open-Pakete	https://packages.microsoft.com/ubuntu/20.04/prod/pool/main/m/

SLES/12-Pfade

Paket	Downloadspeicherort
mssql/mlservices-Pakete	https://packages.microsoft.com/sles/12/mssql-server-2019/
microsoft-r-open-Pakete	https://packages.microsoft.com/sles/12/prod/

Wählen Sie die Erweiterungen aus, die Sie verwenden möchten, und laden Sie die erforderlichen Pakete für eine spezifische Sprache herunter. Die Dateinamen sollten Plattforminformationen im Suffix enthalten.

Paketliste

Je nachdem, welche Erweiterungen Sie verwenden möchten, müssen Sie die für die jeweilige Sprache erforderlichen Pakete herunterladen. Genaue Dateinamen enthalten Plattforminformationen im Suffix, aber die unten aufgeführten Dateinamen sollten genau genug sein, damit Sie herausfinden können, welche Dateien Sie benötigen.

# 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-Entwickler können in den folgenden Tutorials erfahren, wie Python mit SQL Server verwendet werden kann:

R-Entwickler können mit einigen einfachen Beispielen loslegen und die Grundlagen der Funktionen von R unter SQL Server kennenlernen. Informationen zu den nächsten Schritten finden Sie unter den folgenden Links:

Freigeben über

Installieren von SQL Server 2019 Machine Learning Services (Python und R) unter Linux

Prüfliste vor der Installation

Paketliste

Installieren unter RHEL

Installieren von MRO unter RHEL

Die vollständige Installation

Die minimale Installation

Installation unter Ubuntu

Installieren von MRO unter Ubuntu

Die vollständige Installation

Die minimale Installation

Installieren unter SLES

Installieren von MRO unter SLES

Die vollständige Installation

Die minimale Installation

Konfigurieren nach der Installation (erforderlich)

Überprüfen der Installation

Unbeaufsichtigte Installation

Offlineinstallation

Downloadsite

RHEL/8-Pfade

Ubuntu/20.04-Pfade

SLES/12-Pfade

Paketliste

Feedback

Zusätzliche Ressourcen

Freigeben über

Installieren von SQL Server 2019 Machine Learning Services (Python und R) unter Linux

Prüfliste vor der Installation

Paketliste

Installieren unter RHEL

Installieren von MRO unter RHEL

Die vollständige Installation

Die minimale Installation

Installation unter Ubuntu

Installieren von MRO unter Ubuntu

Die vollständige Installation

Die minimale Installation

Installieren unter SLES

Installieren von MRO unter SLES

Die vollständige Installation

Die minimale Installation

Konfigurieren nach der Installation (erforderlich)

Überprüfen der Installation

Unbeaufsichtigte Installation

Offlineinstallation

Downloadsite

RHEL/8-Pfade

Ubuntu/20.04-Pfade

SLES/12-Pfade

Paketliste

Zugehöriger Inhalt

Feedback

Zusätzliche Ressourcen