SQL Server Java Language Extension installeren in Linux

Van toepassing op: SQL Server 2019 (15.x) - 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.

Vereiste voorwaarden

• De Linux-versie moet worden ondersteund door SQL Server, maar bevat geen Docker Engine. Ondersteunde versies zijn onder andere:

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

• U moet een hulpprogramma hebben voor het uitvoeren van Transact-SQL (T-SQL)-opdrachten. Een query-editor is nodig voor configuratie en validatie na installatie. We raden Azure Data Studio aan, een gratis download die wordt uitgevoerd op Linux.

• Taalextensies worden ook ondersteund in Linux-containers. We bieden geen vooraf gemaakte containers met taalextensies, maar u kunt er een maken vanuit de SQL Server-containers met behulp van een voorbeeldsjabloon die beschikbaar is 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. Zie Python- en R-scripts uitvoeren met Machine Learning Services op SQL Server 2019 Big Data-clusters voor meer informatie.

Pakketlijst

Op een apparaat met internetverbinding worden pakketten onafhankelijk van de Database Engine gedownload en geïnstalleerd met behulp van het pakketinstallatieprogramma 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

Configuratie na installatie (vereist)

1. Machtigingen verlenen voor Linux

   U hoeft deze stap niet uit te voeren als u externe bibliotheken gebruikt. De aanbevolen manier van werken is het gebruik van externe bibliotheken. Zie CREATE EXTERNAL LIBRARY voor hulp bij het maken van een externe bibliotheek vanuit uw jar bestand

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

   Als u lees- en uitvoertoegang tot een jar bestand wilt verlenen, voert u de volgende chmod-opdracht uit op het jar bestand. We raden u aan uw klasbestanden altijd in een jar te plaatsen wanneer u met SQL Server werkt. Zie Een Java-.jar-bestand maken op basis van klassebestanden voor hulp bij het maken jarvan een bestand.

   chmod ug+rx <MyJarFile.jar>
   

   U moet ook mssql_satellite-machtigingen verlenen voor het jar-bestand om te lezen en uit te 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. Dit is vereist als u de installatie nog niet eerder hebt uitgevoerd.

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

3. Uitgaande netwerktoegang inschakelen. Uitgaande netwerktoegang is standaard uitgeschakeld. Als u uitgaande aanvragen wilt inschakelen, stelt u de outboundnetworkaccess booleaanse eigenschap in met behulp van het hulpprogramma mssql-conf . Zie SQL Server configureren in Linux met mssql-confvoor 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 u eraan wanneer een instelling voor uitbreidbaarheid wordt gewijzigd.

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

5. Externe scriptuitvoering inschakelen met behulp van Azure Data Studio of een ander hulpprogramma, zoals SQL Server Management Studio (alleen Windows), waarop T-SQL wordt uitgevoerd.

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

6. Start de mssql-launchpadd service opnieuw op.

7. Voor elke database waarin u taalextensies wilt gebruiken, moet u de externe taal registreren bij CREATE EXTERNAL LANGUAGE. Zie de stappen in de volgende sectie.

Externe taal registreren

Voor elke database waarin u taalextensies wilt gebruiken, moet u de externe taal registreren bij 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 wordt de omgevingsvariabele JRE_HOME gebruikt om het pad te bepalen waaruit de JVM moet worden gezocht en geïnitialiseerd.

De CREATE EXTERNAL LANGUAGE DDL biedt een parameter (ENVIRONMENT_VARIABLES) om omgevingsvariabelen specifiek in te stellen voor het proces dat als host fungeert voor de extensie. Dit proces is de aanbevolen en meest effectieve manier om omgevingsvariabelen in te stellen die zijn vereist voor externe taalextensies.

Zie CREATE EXTERNAL LANGUAGE voor meer informatie.

Installatie controleren

Integratie van Java-functies bevat geen bibliotheken, maar u kunt uitvoeren grep -r JRE_HOME /etc om het maken van de JAVA_HOME omgevingsvariabele te bevestigen.

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. Azure Data Studio is een goede keuze. Andere veelgebruikte hulpprogramma's, zoals SQL Server Management Studio, zijn alleen beschikbaar voor Windows. Als u een Windows-computer met deze hulpprogramma's hebt, gebruikt u deze om verbinding te maken met uw Linux-installatie van de database-engine.

Beperkingen

Impliciete verificatie is momenteel niet beschikbaar in Linux, wat betekent dat u vanuit een lopende Java-sessie geen verbinding terug naar de server kunt maken om toegang te krijgen tot gegevens of andere bronnen.

Resourcebeheer

Er is pariteit tussen Linux en Windows voor resourcebeheer voor externe resourcegroepen, maar de statistieken voor sys.dm_resource_governor_external_resource_pools hebben momenteel verschillende eenheden in Linux.

Verwante inhoud

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