Installera SQL Server Java Language Extension på Linux

Gäller för: SQL Server 2019 (15.x) – Linux och senare versioner

Lär dig hur du installerar Java Language Extension-komponenten för SQL Server i Linux. Java Language Extension är en del av SQL Server Language Extensions och ett tillägg till databasmotorn.

Även om du kan installera databasmotorn och språktillägg samtidigt är det en bra idé att installera och konfigurera SQL Server Database Engine först så att du kan lösa eventuella problem innan du lägger till fler komponenter.

Förutsättningar

• Linux-versionen måste stödjas av SQL Server, men innehåller inte Docker-motorn. Exempel på versioner som stöds är:

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

• Du bör ha ett verktyg för att köra kommandon för Transact-SQL (T-SQL). En frågeredigerare krävs för konfiguration och validering efter installationen. Vi rekommenderar Azure Data Studio, en kostnadsfri nedladdning som körs på Linux.

• Språktillägg stöds också på Linux-containrar. Vi tillhandahåller inte fördefinierade containrar med språktillägg, men du kan skapa en från SQL Server-containrarna med hjälp av en exempelmall som är tillgänglig på GitHub.

• Språktillägg och Machine Learning Services installeras som standard på SQL Server-stordatakluster. Om du använder stordatakluster behöver du inte följa stegen i den här artikeln. Mer information finns i Köra Python- och R-skript med Machine Learning Services på SQL Server 2019 Big Data Clusters.

Paketlista

På en Internetansluten enhet laddas paket ned och installeras oberoende av databasmotorn med hjälp av paketinstallationsprogrammet för varje operativsystem. I följande tabell beskrivs alla tillgängliga paket.

Installera Java-språktillägget

# 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

Konfiguration efter installationen (krävs)

1. Bevilja behörigheter för Linux

   Du behöver inte utföra det här steget om du använder externa bibliotek. Det rekommenderade sättet att arbeta är att använda externa bibliotek. Hjälp med att skapa ett externt bibliotek från filen jar finns i SKAPA EXTERNT BIBLIOTEK

   Om du inte använder externa bibliotek måste du ge SQL Server behörighet att köra Java-klasserna i .jar

   Om du vill bevilja läs- och körningsåtkomst till en jar fil kör du följande chmod-kommando på jar filen. Vi rekommenderar att du alltid placerar dina klassfiler i en jar när du arbetar med SQL Server. Mer information om hur du skapar en jarfinns i Skapa en Java .jar-fil från klassfiler.

   chmod ug+rx <MyJarFile.jar>
   

   Du måste också ge mssql_satellite behörigheter till jar filen för att läsa/köra.

   chown mssql_satellite:mssql_satellite <MyJarFile.jar>
   

   Ytterligare konfiguration sker främst via verktyget mssql-conf.

2. Lägg till användarkontot mssql som används för att köra SQL Server-tjänsten. Detta krävs om du inte har kört installationen tidigare.

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

3. Aktivera utgående nätverksåtkomst. Utgående nätverksåtkomst är inaktiverad som standard. Om du vill aktivera utgående begäranden anger du den outboundnetworkaccess booleska egenskapen med hjälp av verktyget mssql-conf . Mer information finns i Konfigurera SQL Server på Linux med mssql-conf.

   # Run as SUDO or root
   # Enable outbound requests over the network
   sudo /opt/mssql/bin/mssql-conf set extensibility outboundnetworkaccess 1
   

4. Starta om SQL Server Launchpad-tjänsten och databasmotorinstansen för att läsa de uppdaterade värdena från INI-filen. Ett omstartsmeddelande påminner dig när en utökningsrelaterad inställning ändras.

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

5. Aktivera körning av externa skript med Hjälp av Azure Data Studio eller något annat verktyg som SQL Server Management Studio (endast Windows) som kör T-SQL.

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

6. mssql-launchpadd Starta om tjänsten igen.

7. För varje databas som du vill använda språktillägg i måste du registrera det externa språket med SKAPA EXTERNT SPRÅK. Se steg i nästa avsnitt.

Registrera externt språk

För varje databas som du vill använda språktillägg i måste du registrera det externa språket med SKAPA EXTERNT SPRÅK.

I följande exempel läggs ett externt språk med namnet Java till en databas på SQL Server i Linux.

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 Java-tillägget används miljövariabeln JRE_HOME för att fastställa sökvägen för att hitta och initiera JVM från.

CREATE EXTERNAL LANGUAGE DDL innehåller en parameter (ENVIRONMENT_VARIABLES) för att ange miljövariabler specifikt för processen som är värd för tillägget. Den här processen är det rekommenderade och mest effektiva sättet att ange miljövariabler som krävs av externa språktillägg.

Mer information finns i SKAPA EXTERNT SPRÅK.

Verifiera installationen

Java-funktionsintegrering innehåller inte bibliotek, men du kan köra grep -r JRE_HOME /etc för att bekräfta att miljövariabeln har skapats JAVA_HOME .

Verifiera installationen genom att köra ett T-SQL-skript som kör en system lagrad procedur som anropar Java. Du behöver ett frågeverktyg för den här uppgiften. Azure Data Studio är ett bra val. Andra verktyg som används ofta, till exempel SQL Server Management Studio, finns endast tillgängliga för Windows. Om du har en Windows-dator med dessa verktyg använder du den för att ansluta till linux-installationen av databasmotorn.

Begränsningar

Underförstådd autentisering är för närvarande inte tillgänglig i Linux, vilket innebär att du inte kan ansluta tillbaka till servern från pågående Java för att komma åt data eller andra resurser.

Resursförvaltning

Det finns paritet mellan Linux och Windows för resursstyrning för externa resurspooler, men statistiken för sys.dm_resource_governor_external_resource_pools har för närvarande olika enheter på Linux.

Relaterat innehåll

• Självstudie: Sök efter en sträng med reguljära uttryck (regex) i Java