SQL Server Java Language Extension installeren in Linux

Van toepassing op: SQL Server 2019 (15.x) op Linux en latere versies

Meer informatie over het installeren van het Java Language Extension-onderdeel voor SQL Server in Linux. De Java-taalextensie maakt deel uit van SQL Server Language Extensions en een invoegtoepassing voor de database-engine.

Hoewel u de database-engine en taalextensies gelijktijdig kunt installeren, is het een aanbevolen procedure om eerst de SQL Server Database Engine te installeren en te configureren, zodat u eventuele problemen kunt oplossen voordat u meer onderdelen toevoegt.

Prerequisites

• Je Linux-distributie moet worden ondersteund door SQL Server. Containers worden apart bedekt in een latere kogel. Ondersteunde distributies zijn onder andere:

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

• Je hebt een query-editor nodig om Transact-SQL (T-SQL) commando's uit te voeren voor configuratie en validatie na de installatie. Wij raden de MSSQL-extensie aan voor Visual Studio Code. Het is een gratis download die op Linux draait.

• Taalextensies worden ook ondersteund in Linux-containers. Vooraf gebouwde containers met Language Extensions zijn niet beschikbaar, maar je kunt er een maken vanuit de SQL Server-containers door gebruik te maken van een voorbeeldtemplate op GitHub.

• Taalextensies en Machine Learning Services worden standaard geïnstalleerd op SQL Server Big Data-clusters. Als u Big Data-clusters gebruikt, hoeft u de stappen in dit artikel niet te volgen.

Pakketlijst

Op een apparaat met internetverbinding download en installeer je pakketten onafhankelijk van de Database Engine door gebruik te maken van de pakketinstaller voor elk besturingssysteem. In de volgende tabel worden alle beschikbare pakketten beschreven.

Java-taalextensie installeren

# 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

Post-installatie configuratie (vereist)

1. Machtigingen verlenen voor Linux

   U hoeft deze stap niet uit te voeren als u externe bibliotheken gebruikt. Externe bibliotheken zijn de aanbevolen aanpak. Voor hulp bij het maken van een externe bibliotheek uit je jar bestand, zie CREATE EXTERNAL LIBRARY.

   Als u geen externe bibliotheken gebruikt, moet u SQL Server machtigingen geven voor het uitvoeren van de Java-klassen in uw jar.

   Om lees- en uitvoeringstoegang te verlenen aan een jar bestand, voer je het volgende chmod commando uit op het jar bestand. Zet je cursusbestanden altijd in een jar functie wanneer je met SQL Server werkt. Zie jar voor hulp bij het maken van een bestand.

   chmod ug+rx <MyJarFile.jar>
   

   Je moet ook toestemming geven mssql_satellite om het bestand te lezen en uit te jar voeren.

   chown mssql_satellite:mssql_satellite <MyJarFile.jar>
   

   Aanvullende configuratie is voornamelijk via het hulpprogramma mssql-conf.

2. Voeg het mssql gebruikersaccount toe dat wordt gebruikt om de SQL Server-service uit te voeren. Deze stap is nodig als je de setup nog niet eerder hebt uitgevoerd.

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

3. Uitgaande netwerktoegang inschakelen. Uitgaande netwerktoegang is standaard uitgeschakeld. Om uitgaande verzoeken in te schakelen, stel je de outboundnetworkaccess Boolean-eigenschap in met de mssql-conf tool. Zie SQL Server configureren in Linux met mssql-conf voor meer informatie.

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

4. Start de SQL Server Launchpad-service en het Database Engine-exemplaar opnieuw op om de bijgewerkte waarden uit het INI-bestand te lezen. Een herstartbericht herinnert je telkens wanneer je een uitbreidbaarheids-gerelateerde instelling aanpast.

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

5. Externe scriptuitvoering inschakelen. U kunt verbinding maken met een exemplaar van SQL Server met behulp van een vertrouwd SQL Server-clienthulpprogramma, zoals sqlcmd, SQL Server Management Studio (SSMS) of de MSSQL-extensie voor Visual Studio Code.

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

6. Start de mssql-launchpadd service opnieuw op.

7. Registreer voor elke database waarin je taalextensies wilt gebruiken de externe taal met CREATE EXTERNAL LANGUAGE. Zie de volgende sectie voor stappen.

Externe taal registreren

Registreer voor elke database waarin je taalextensies wilt gebruiken de externe taal met CREATE EXTERNAL LANGUAGE.

In het volgende voorbeeld wordt een externe taal met de naam Java toegevoegd aan een database op SQL Server in 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"}'
);

Voor de Java-extensie bepaalt de omgevingsvariabele JRE_HOME het pad om de JVM te vinden en te initialiseren.

De CREATE EXTERNAL LANGUAGE DDL biedt een ENVIRONMENT_VARIABLES parameter om omgevingsvariabelen in te stellen voor het proces dat de extensie host. Gebruik deze parameter om omgevingsvariabelen in te stellen die externe taaluitbreidingen vereisen.

Zie CREATE EXTERNAL LANGUAGE voor meer informatie.

Installatie verifiëren

Java-feature-integratie bevat geen bibliotheken, maar je kunt wel uitvoeren grep -r JRE_HOME /etc om te bevestigen dat de JRE_HOME omgevingsvariabele bestaat.

Als u de installatie wilt valideren, voert u een T-SQL-script uit waarmee een door het systeem opgeslagen procedure wordt uitgevoerd die Java aanroept. U hebt een queryhulpprogramma nodig voor deze taak. U kunt verbinding maken met een exemplaar van SQL Server met behulp van een vertrouwd SQL Server-clienthulpprogramma, zoals sqlcmd, SQL Server Management Studio (SSMS) of de MSSQL-extensie voor Visual Studio Code.

Limitations

Impliciete authenticatie is niet beschikbaar op Linux. Java-code die in het externe proces draait, kan niet terugverbinden met de server om toegang te krijgen tot data of andere bronnen.

Resourcebeheer

Linux en Windows hebben gelijkheid voor resource governance voor externe resource pools, maar de statistieken voor sys.dm_resource_governor_external_resource_pools hebben momenteel verschillende eenheden op Linux.

Verwante inhoud

• Zelfstudie: Zoeken naar een tekenreeks met behulp van reguliere expressies (regex) in Java