Installieren von Paketen mit R-Tools

Gilt für: SQL Server 2016 (13.x) SQL Server 2017 (14.x)

In diesem Artikel erfahren Sie, wie Sie mit R-Standardtools neue R-Pakete in einer Instanz von SQL Server Machine Learning Services oder SQL Server R Services installieren können. Sie können Pakete in einer SQL Server-Instanz installieren, die über eine Internetverbindung verfügt, sowie in einer vom Internet isolierten Instanz.

Zusätzlich zu den R-Standardtools können Sie R-Pakete installieren mit:

• RevoScaleR

• T-SQL (CREATE EXTERNAL LIBRARY)

Allgemeine Hinweise

• In SQL Server ausgeführter R-Code kann nur Pakete verwenden, die in der Standardinstanzbibliothek installiert sind. SQL Server kann auch dann keine Pakete aus externen Bibliotheken laden, wenn sich die entsprechenden Bibliotheken auf demselben Computer befinden. Das gilt auch für R-Bibliotheken, die in anderen Microsoft-Produkten installiert sind.

• Die R-Paketbibliothek befindet sich im Ordner „Programme“ Ihrer SQL Server-Instanz, und für die Installation in diesem Ordner sind standardmäßig Administratorberechtigungen erforderlich. Weitere Informationen finden Sie unter Speicherort der Paketbibliothek.

  Nicht-Administratoren können Pakete mit RevoScaleR 9.0.1 und höher oder CREATE EXTERNAL LIBRARY installieren. Der Benutzer dbo_owner oder ein Benutzer mit der Berechtigung CREATE EXTERNAL LIBRARY kann R-Pakete in die aktuelle Datenbank installieren. Weitere Informationen finden Sie unter

  • Verwenden von RevoScaleR zum Installieren von R-Paketen
  • Verwenden von T-SQL (CREATE EXTERNAL LIBRARY) zum Installieren von R-Paketen in SQL Server

• In einer gesicherten SQL Server-Umgebung sollten Sie Folgendes vermeiden:

  • Pakete, für die Netzwerkzugriff erforderlich ist
  • Pakete, für die erhöhte Zugriffsrechte für das Dateisystem erforderlich sind
  • Pakete, die für die Webentwicklung oder andere Aufgaben verwendet werden und nicht von der Ausführung in SQL Server profitieren

Online-Installation (mit Internetzugriff)

Wenn die SQL Server-Instanz Zugriff auf das Internet hat, können Sie R-Pakete mit Standardtools zur Paketinstallation installieren.

1. Bestimmen Sie den Speicherort der Instanzbibliothek (weitere Informationen finden Sie unter Abrufen von Informationen zu R-Paketen), und navigieren Sie zum Ordner, in dem die R-Tools installiert sind.

   Der Standardpfad einer Standardinstanz von SQL Server lautet z. B. wie folgt:

   C:\Program Files\Microsoft SQL Server\MSSQL14.MSSQLSERVER\R_SERVICES\bin\x64\

2. Führen Sie R oder Rgui in diesem Ordner als Administrator aus.

3. Führen Sie den R-Befehl install.packages aus, und geben Sie den Paketnamen an. Wenn das Paket Abhängigkeiten aufweist, lädt das Installationsprogramm diese automatisch herunter und installiert sie.

Wenn Sie über mehrere parallele Instanzen von SQL Server verfügen, führen Sie die Installation für jede Instanz, in der Sie das Paket verwenden möchten, separat aus. Pakete können nicht von mehreren Instanzen gemeinsam genutzt werden.

Offline-Installation (ohne Internetzugriff)

Häufig haben Server, die Produktionsdatenbanken hosten, keine Internetverbindung. Um R-Pakete in dieser Umgebung zu installieren, müssen Sie Pakete und Abhängigkeiten im Voraus (als ZIP-Dateien) herunterladen und vorbereiten und dann die Dateien in einen Ordner auf dem Server kopieren. Sobald die Dateien an Ort und Stelle sind, können die Pakete offline installiert werden.

Das Ermitteln aller Abhängigkeiten ist kompliziert. Für R empfehlen wir, mit miniCRAN ein lokales Repository zu erstellen. miniCRAN verwendet eine Liste der Pakete, die Sie installieren möchten, analysiert Abhängigkeiten und stellt alle notwendigen ZIP-Dateien zusammen. Anschließend erstellt das Tool ein einzelnes Repository, das Sie in die isolierte SQL Server-Instanz kopieren können. Das Paket igraph ist auch bei der Analyse von Paketabhängigkeiten hilfreich.

Weitere Informationen finden Sie im Artikel zum Thema Erstellen eines lokalen R-Paketrepositorys mit miniCRAN.

Sobald sich die ZIP-Datei in der SQL Server-Instanz befindet, können Sie sie mithilfe von R-Standardtools auf dem Server installieren.

1. Bestimmen Sie den Speicherort der Instanzbibliothek (weitere Informationen finden Sie unter Abrufen von Informationen zu R-Paketen), und navigieren Sie zum Ordner, in dem die R-Tools installiert sind.

   Der Standardpfad einer Standardinstanz von SQL Server lautet z. B. wie folgt:

   C:\Program Files\Microsoft SQL Server\MSSQL14.MSSQLSERVER\R_SERVICES\bin\x64\

2. Führen Sie R oder Rgui in diesem Ordner als Administrator aus.

3. Führen Sie den R-Befehl install.packages aus, und geben Sie den Paket- oder Repositorynamen und den Speicherort der ZIP-Dateien an. Beispiel:

   install.packages("C:\\Temp\\Downloaded packages\\mynewpackage.zip", repos=NULL)
   

   Dieser Befehl extrahiert das R-Paket mynewpackage aus der lokalen ZIP-Datei und installiert das Paket. Wenn das Paket Abhängigkeiten aufweist, prüft das Installationsprogramm, ob bereits Pakete in der Bibliothek vorhanden sind. Haben Sie ein Repository erstellt, das die Abhängigkeiten enthält, installiert das Installationsprogramm auch die erforderlichen Pakete.

   Hinweis

   Wenn erforderliche Pakete nicht in der Instanzbibliothek vorhanden sind und nicht in den ZIP-Dateien gefunden werden, schlägt die Installation des Zielpakets fehl.

Alternativ zu miniCRAN können Sie diese Schritte auch manuell durchführen:

1. Bestimmen Sie alle Paketabhängigkeiten.
2. Prüfen Sie, ob alle erforderlichen Pakete bereits auf dem Server installiert sind. Wenn das Paket installiert ist, prüfen Sie, ob die Version stimmt.
3. Laden Sie das Paket und alle Abhängigkeiten auf einen separaten Computer mit Internetzugriff herunter.
4. Legen Sie das Paket und die Abhängigkeiten in einem einzelnen Paketarchiv ab.
5. Zippen Sie das Archiv, wenn es nicht bereits in einem komprimierten Format vorliegt.
6. Verschieben Sie die Dateien in einen Ordner, auf den der Server zugreifen kann.
7. Führen Sie einen unterstützten Installationsbefehl oder eine DDL-Anweisung aus, um das Paket in die Instanzbibliothek zu installieren.

Weitere Informationen

• Abrufen von R-Paketinformationen
• Tipps für die Verwendung von R-Paketen
• Tutorials für die Programmiersprache R in SQL Server