Installation de l’extension de langage Java SQL Server sur Linux

S’applique à : SQL Server 2019 (15.x) sur Linux et versions ultérieures

Découvrez comment installer le composant Extension de langage Java pour SQL Server sur Linux. L'extension de langage Java fait partie des Extensions de langage SQL Server. Il s'agit d'un module complémentaire du moteur de base de données.

Bien que vous puissiez installer le moteur de base de données et les extensions de langage simultanément, il est recommandé d'installer et de configurer le moteur de base de données SQL Server en premier afin de pouvoir résoudre les problèmes avant d'ajouter d'autres composants.

Prerequisites

• Votre distribution Linux doit être prise en charge par SQL Server. Les contenants sont couverts séparément dans une balle ultérieure. Les distributions prises en charge incluent :

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

• Vous avez besoin d’un éditeur de requêtes pour exécuter Transact-SQL commandes (T-SQL) pour la configuration et la validation post-installation. Nous recommandons l’extension MSSQL pour Visual Studio Code. C’est un téléchargement gratuit qui fonctionne sous Linux.

• Les extensions de langage sont également prises en charge sur les conteneurs Linux. Les conteneurs préconstruits avec extensions de langage ne sont pas disponibles, mais vous pouvez en créer un à partir des conteneurs SQL Server en utilisant un modèle d'exemple disponible sur GitHub.

• Les extensions de langage et Machine Learning Services sont installés par défaut sur Clusters Big Data SQL Server. Si vous utilisez Clusters Big Data, vous n’avez pas besoin de suivre les étapes décrites dans cet article.

Liste des paquets

Sur un appareil connecté à Internet, vous téléchargez et installez des packages indépendamment du Moteur de base de données en utilisant l’installateur de packages pour chaque système d’exploitation. Le tableau suivant décrit tous les packages disponibles.

Installer l’extension de langage 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

Configuration post-installation (requise)

1. Accorder des autorisations sur Linux

   Cette étape n'est pas nécessaire si vous utilisez des bibliothèques externes. Les bibliothèques externes sont l’approche recommandée. Pour obtenir de l’aide dans la création d’une bibliothèque externe à partir de votre jar fichier, voir CREATE EXTERNAL LIBRARY.

   Si vous n'utilisez pas de bibliothèques externes, vous devez fournir à SQL Server les autorisations nécessaires pour exécuter les classes Java dans votre fichier jar.

   Pour accorder un accès en lecture et exécution à un jar fichier, exécutez la commande suivante chmod sur le jar fichier. Mettez toujours vos fichiers de cours dans un jar fichier lorsque vous travaillez avec SQL Server. Pour obtenir de l’aide sur la création d’un jar, consultez Créer un fichier Java .jar à partir de fichiers de classe.

   chmod ug+rx <MyJarFile.jar>
   

   Vous devez également donner mssql_satellite des autorisations pour lire et exécuter le jar fichier.

   chown mssql_satellite:mssql_satellite <MyJarFile.jar>
   

   La configuration supplémentaire s’effectue principalement avec l’outil mssql-conf.

2. Ajoutez le compte d'utilisateur mssql utilisé pour exécuter le service SQL Server. Cette étape est nécessaire si vous n’avez pas encore lancé la configuration auparavant.

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

3. Activez l’accès réseau sortant. L’accès réseau sortant est désactivé par défaut. Pour activer les requêtes sortantes, activez la outboundnetworkaccess propriété booléenne avec l’outil mssql-conf . Pour plus d’informations, consultez Configurer SQL Server sur Linux avec mssql-conf.

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

4. Redémarrez le service SQL Server Launchpad et l'instance du moteur de base de données pour lire les valeurs mises à jour à partir du fichier INI. Un message de redémarrage vous rappelle chaque fois que vous modifiez un paramètre lié à l’extensibilité.

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

5. Activez l’exécution de script externe. Vous pouvez vous connecter à une instance de SQL Server à l’aide de n’importe quel outil client SQL Server familier, tel que sqlcmd, SQL Server Management Studio (SSMS) ou l’extension MSSQL pour Visual Studio Code.

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

6. Redémarrez le service mssql-launchpadd.

7. Pour chaque base de données où vous souhaitez utiliser des extensions de langage, enregistrez le langage externe avec CREATE EXTERNAL LANGUAGE. Voir la section suivante pour les étapes.

Inscrire le langage externe

Pour chaque base de données où vous souhaitez utiliser des extensions de langage, enregistrez le langage externe avec CREATE EXTERNAL LANGUAGE.

L’exemple suivant ajoute un langage externe appelé Java à une base de données sur SQL Server sur 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"}'
);

Pour l’extension Java, la variable JRE_HOME environnement détermine le chemin pour trouver et initialiser la JVM.

Le CREATE EXTERNAL LANGUAGE DDL fournit un ENVIRONMENT_VARIABLES paramètre pour définir les variables d’environnement du processus qui héberge l’extension. Utilisez ce paramètre pour définir les variables d’environnement requises par les extensions de langage externes.

Pour plus d’informations, consultez CREATE EXTERNAL LANGUAGE.

Vérifier l’installation

L'intégration des fonctionnalités Java n'inclut pas les bibliothèques, mais vous pouvez vérifier grep -r JRE_HOME /etc que la JRE_HOME variable d'environnement existe.

Pour valider l’installation, exécutez un script T-SQL qui exécute une procédure stockée système qui appelle Java. Vous avez besoin d'un outil de requête pour cette tâche. Vous pouvez vous connecter à une instance de SQL Server à l’aide de n’importe quel outil client SQL Server familier, tel que sqlcmd, SQL Server Management Studio (SSMS) ou l’extension MSSQL pour Visual Studio Code.

Limitations

L’authentification implicite n’est pas disponible sur Linux. Le code Java qui tourne dans le processus externe ne peut pas se reconnecter au serveur pour accéder aux données ou à d'autres ressources.

Gouvernance des ressources

Linux et Windows ont la parité pour la gouvernance des ressources pour les pools externes, mais les statistiques pour sys.dm_resource_governor_external_resource_pools montrent actuellement des unités différentes sur Linux.

Contenu connexe

• Tutoriel : Rechercher une chaîne à l’aide d’expressions régulières (regex) en Java