Installare l'estensione del linguaggio Java di SQL Server su Linux

Si applica a: SQL Server 2019 (15.x) - Linux e versioni successive

Informazioni su come installare il componente dell'estensione del linguaggio Java per SQL Server in Linux. L'estensione del linguaggio Java fa parte delle estensioni del linguaggio di SQL Server ed è un componente aggiuntivo per il motore di database.

Anche se è possibile installare il motore di database e le estensioni del linguaggio simultaneamente, è consigliabile installare e configurare prima il motore di database di SQL Server per poter risolvere eventuali problemi prima di aggiungere altri componenti.

Prerequisiti

• La versione di Linux deve essere supportata da SQL Server, ma non include il motore Docker. Le versioni supportate includono:

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

• È necessario avere uno strumento per eseguire i comandi Transact-SQL (T-SQL). Un editor di query è necessario per la configurazione e la convalida successiva all'installazione. È consigliabile usare Azure Data Studio, scaricabile gratuitamente, che viene eseguito in Linux.

• Le estensioni del linguaggio sono supportate anche nei contenitori Linux. Non vengono forniti contenitori predefiniti con le estensioni del linguaggio, ma è possibile crearne uno dai contenitori di SQL Server usando un modello di esempio disponibile in GitHub.

• Le estensioni del linguaggio e Machine Learning Services vengono installati per impostazione predefinita nei cluster Big Data di SQL Server. Se si usano cluster Big Data, non è necessario seguire la procedura descritta in questo articolo. Per ulteriori informazioni, eseguire script Python e R con i servizi di Machine Learning in un cluster Big Data SQL Server 2019

Elenco di pacchetti

In un dispositivo connesso a Internet i pacchetti vengono scaricati e installati in modo indipendente dal motore di database usando il programma di installazione del pacchetto per ogni sistema operativo. Nella tabella seguente vengono descritti tutti i pacchetti disponibili.

Installare l'estensione del linguaggio Java

# 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

Configurazione successiva all'installazione (obbligatoria)

1. Concedere le autorizzazioni in Linux

   Non è necessario eseguire questo passaggio se si usano librerie esterne. Il modo consigliato per lavorare è usare le librerie esterne. Per la creazione di una libreria esterna dal file jar, vedere CREATE EXTERNAL LIBRARY

   Se non si usano librerie esterne, è necessario fornire a SQL Server le autorizzazioni per eseguire le classi Java nel file jar.

   Per concedere l'accesso in lettura e in esecuzione a un file jar, eseguire il comando chmod seguente sul file jar. Si consiglia di inserire sempre i file di classe in un file jar quando si lavora con SQL Server. Per informazioni sulla creazione di un oggetto jar, vedere Creare un file jar Java da file di classe.

   chmod ug+rx <MyJarFile.jar>
   

   È anche necessario assegnare alle mssql_satellite autorizzazioni jar il file JAR da leggere/eseguire.

   chown mssql_satellite:mssql_satellite <MyJarFile.jar>
   

   La configurazione aggiuntiva viene eseguita principalmente tramite lo strumento mssql-conf.

2. Aggiungere l'account utente mssql usato per eseguire il servizio SQL Server. Questa operazione è necessaria se la configurazione non è stata eseguita in precedenza.

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

3. Abilitare l'accesso alla rete in uscita. L'accesso alla rete in uscita è disabilitato per impostazione predefinita. Per abilitare le richieste in uscita, impostare la proprietà booleana outboundnetworkaccess usando lo strumento mssql-conf. Per altre informazioni, vedere Configurare SQL Server in Linux con mssql conf.

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

4. Riavviare il servizio Launchpad di SQL Server e l'istanza del motore di database per leggere i valori aggiornati dal file INI. Un messaggio di riavvio avverte ogni volta che viene modificata un'impostazione relativa all'estendibilità.

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

5. Abilitare l'esecuzione di script esterni usando Azure Data Studio o un altro strumento come SQL Server Management Studio (solo Windows) che esegue T-SQL.

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

6. Riavviare nuovamente il servizio mssql-launchpadd.

7. Per ogni database in cui si vogliono usare le estensioni del linguaggio, è necessario registrare il linguaggio esterno con CREATE EXTERNAL LANGUAGE. Vedere la procedura nella sezione successiva.

Registrare il linguaggio esterno

Per ogni database in cui si vogliono usare le estensioni del linguaggio, è necessario registrare il linguaggio esterno con CREATE EXTERNAL LANGUAGE.

L'esempio seguente aggiunge un linguaggio esterno denominato Java a un database in 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"}');

Per l'estensione Java, viene usata la variabile di ambiente JRE_HOME per determinare il percorso da cui trovare e inizializzare JVM.

L'istruzione DDL CREATE EXTERNAL LANGUAGE include un parametro (ENVIRONMENT_VARIABLES) per impostare le variabili di ambiente in modo specifico per il processo che ospita l'estensione. Si tratta del metodo consigliato e più efficace per impostare le variabili di ambiente richieste dalle estensioni di linguaggio esterno.

Per altre informazioni, vedere CREATE EXTERNAL LANGUAGE.

Verifica l'installazione

L'integrazione delle funzionalità Java non include librerie, ma è possibile eseguire grep -r JRE_HOME /etc per verificare che sia stata creata la variabile di ambiente JAVA_HOME.

Per convalidare l'installazione, eseguire uno script T-SQL che esegue una stored procedure di sistema richiamando Java. Per questa attività è necessario uno strumento di query. Azure Data Studio è una scelta ottimale. Altri strumenti di uso comune, ad esempio SQL Server Management Studio, sono solo per Windows. Se si ha un computer Windows con questi strumenti, usarlo per connettersi all'installazione Linux del motore di database.

Limiti

L'autenticazione implicita attualmente non è disponibile in Linux. Ciò significa che non è possibile connettersi al server da Java in esecuzione per accedere ai dati o ad altre risorse.

Governance delle risorse

Esiste parità tra Linux e Windows per la governance delle risorse per i pool di risorse esterni, ma le statistiche per sys.dm_resource_governor_external_resource_pools hanno attualmente unità diverse in Linux.

Contenuto correlato

• Esercitazione: Cercare una stringa usando espressioni regolari (regex) in Java