Installieren der Java-Spracherweiterung für SQL Server unter Linux

Gilt für: SQL Server 2019 (15.x) unter Linux und höheren Versionen

Erfahren Sie, wie Sie die Komponente Java-Spracherweiterung für SQL Server unter Linux installieren. Die Java-Spracherweiterung ist Teil der SQL Server-Spracherweiterungen und ein Add-On für die Datenbank-Engine.

Obwohl Sie die Datenbank-Engine und Spracherweiterungen gleichzeitig installieren können, empfiehlt es sich, zuerst die SQL Server-Datenbank-Engine zu installieren und zu konfigurieren, damit Sie eventuelle Probleme beheben können, bevor Sie weitere Komponenten hinzufügen.

Voraussetzungen

• Deine Linux-Distribution muss von SQL Server unterstützt werden. Behälter werden in einem späteren Geschoss separat abgedeckt. Unterstützte Distributionen umfassen:

  • Red Hat Enterprise Linux (RHEL)
  • SUSE Linux Enterprise Server (SLES)
  • Ubuntu

• Du brauchst einen Abfrageeditor, der Transact-SQL (T-SQL)-Befehle für die Konfiguration und Validierung nach der Installation ausführen kann. Wir empfehlen die MSSQL-Erweiterung für Visual Studio Code. Es ist ein kostenloser Download, der unter Linux läuft.

• Spracherweiterungen werden auch in Linux-Containern unterstützt. Vorgefertigte Container mit Spracherweiterungen sind nicht verfügbar, aber du kannst einen aus den SQL Server-Containern erstellen, indem du eine Beispielvorlage auf GitHub verwendest.

• Spracherweiterungen und Machine Learning Services werden standardmäßig auf Big Data-Clustern für SQL Server installiert. Wenn Sie Big Data-Cluster verwenden, müssen Sie die Schritte in diesem Artikel nicht ausführen.

Paketliste

Auf einem internetverbundenen Gerät lädst und installierst du Pakete unabhängig von der Datenbank-Engine, indem du den Paket-Installer für jedes Betriebssystem nutzt. Die folgende Tabelle enthält alle verfügbaren Pakete.

Installieren der Java-Spracherweiterung

# Install as root or sudo
sudo yum install mssql-server-extensibility-java

# Install as root or sudo
sudo apt-get install mssql-server-extensibility-java

# Install as root or sudo
sudo zypper install mssql-server-extensibility-java

Nachinstallationskonfiguration (erforderlich)

1. Erteilen Sie Berechtigungen unter Linux.

   Wenn Sie externe Bibliotheken verwenden, müssen Sie diesen Schritt nicht ausführen. Externe Bibliotheken sind der empfohlene Ansatz. Für Hilfe beim Erstellen einer externen Bibliothek aus deiner jar Datei siehe CREATE EXTERNAL LIBRARY.

   Wenn Sie keine externen Bibliotheken verwenden, müssen Sie SQL Server Berechtigungen zum Ausführen der Java-Klassen in Ihrer jar-Datei erteilen.

   Um eine jar Datei zum Lesen und Ausführen zu gewähren, führen Sie den folgenden chmod Befehl auf der jar Datei aus. Speichern Sie Ihre Kursdateien immer, jar wenn Sie mit SQL Server arbeiten. Hilfe zum Erstellen von jarfinden Sie unter Erstellen einer Java-JAR-Datei aus Klassendateien.

   chmod ug+rx <MyJarFile.jar>
   

   Du musst außerdem Berechtigungen geben mssql_satellite , um die jar Datei zu lesen und auszuführen.

   chown mssql_satellite:mssql_satellite <MyJarFile.jar>
   

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

2. Fügen Sie das mssql-Benutzerkonto hinzu, um den SQL Server-Dienst auszuführen. Dieser Schritt ist erforderlich, wenn du das Setup vorher nicht ausgeführt hast.

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

3. Aktivieren Sie den Zugriff auf ausgehenden Netzwerkdatenverkehr. Der Zugriff auf ausgehenden Netzwerkdatenverkehr ist standardmäßig deaktiviert. Um ausgehende Anfragen zu aktivieren, setzen Sie mit dem mssql-conf Tool die outboundnetworkaccess boolesche Eigenschaft ein. 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
   

4. 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 Neustart-Nachricht erinnert Sie jedes Mal, wenn Sie eine erweiterbarkeitsbezogene Einstellung ändern.

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

5. Aktivieren sie die Ausführung externer Skripts. Sie können eine Verbindung mit einer Sql Server-Instanz herstellen, indem Sie ein vertrautes SQL Server-Clienttool verwenden, z. B. sqlcmd, SQL Server Management Studio (SSMS) oder die MSSQL-Erweiterung für Visual Studio Code.

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

6. Starten Sie den Dienst mssql-launchpadd neu.

7. Für jede Datenbank, in der Sie Spracherweiterungen verwenden möchten, registrieren Sie die externe Sprache mit CREATE EXTERNAL LANGUAGE. Siehe den nächsten Abschnitt für Schritte.

Registrieren einer externen Sprache

Für jede Datenbank, in der Sie Spracherweiterungen verwenden möchten, registrieren Sie die externe Sprache mit CREATE EXTERNAL LANGUAGE.

Im folgenden Beispiel wird die externe Sprache mit dem Namen Java zu einer Datenbank unter SQL Server für Linux hinzugefügt.

CREATE EXTERNAL LANGUAGE Java
FROM (
    CONTENT = N'/opt/mssql-extensibility/lib/java-lang-extension.tar.gz',
    FILE_NAME = 'javaextension.so',
    ENVIRONMENT_VARIABLES = N'{"JRE_HOME":"/opt/mssql/lib/zulu-jre-11"}'
);

Für die Java-Erweiterung bestimmt die Umgebungsvariable JRE_HOME den Pfad, um das JVM zu finden und zu initialisieren.

Die CREATE EXTERNAL LANGUAGE DDL stellt einen ENVIRONMENT_VARIABLES Parameter bereit, um die Umgebungsvariablen für den Prozess festzulegen, der die Erweiterung hostet. Verwenden Sie diesen Parameter, um Umweltvariablen festzulegen, die externe Spracherweiterungen erfordern.

Weitere Informationen finden Sie unter CREATE EXTERNAL LANGUAGE.

Überprüfen der Installation

Die Integration von Java-Funktionen beinhaltet keine Bibliotheken, aber du kannst ausführengrep -r JRE_HOME /etc, um zu bestätigen, dass die JRE_HOME Umgebungsvariable existiert.

Sie können die Installation überprüfen, indem Sie ein T-SQL-Skript ausführen, das eine gespeicherte Systemprozedur ausführt, die Java aufruft. Für diese Aufgabe benötigen Sie ein Abfragetool. Sie können eine Verbindung mit einer Sql Server-Instanz herstellen, indem Sie ein vertrautes SQL Server-Clienttool verwenden, z. B. sqlcmd, SQL Server Management Studio (SSMS) oder die MSSQL-Erweiterung für Visual Studio Code.

Einschränkungen

Implizite Authentifizierung ist unter Linux nicht verfügbar. Java-Code, der im externen Prozess läuft, kann keine Verbindung zum Server herstellen, um auf Daten oder andere Ressourcen zuzugreifen.

Ressourcenverwaltung

Linux und Windows haben Parität bei der Ressourcenverwaltung für externe Ressourcenpools, aber die Statistiken für sys.dm_resource_governor_external_resource_pools haben derzeit unterschiedliche Einheiten auf Linux.

Verwandte Inhalte

• Tutorial: Suchen nach einer Zeichenfolge mithilfe regulärer Ausdrücke (RegEx) in Java