Instalación de la extensión de lenguaje Java de SQL Server en Linux

Se aplica a: SQL Server 2019 (15.x) en Linux y versiones posteriores

Aprenda a instalar el componente de extensión de lenguaje Java para SQL Server en Linux. La extensión de lenguaje Java forma parte de las extensiones de lenguaje de SQL Server y un complemento para el motor de base de datos.

Aunque puede instalar el motor de base de datos y extensiones de lenguaje de forma simultánea, el procedimiento recomendado es instalar y configurar primero el motor de base de datos de SQL Server para poder resolver cualquier problema antes de agregar más componentes.

Prerequisites

• Tu distribución Linux debe ser compatible con SQL Server. Los contenedores se cubren por separado en una bala posterior. Las distribuciones soportadas incluyen:

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

• Necesitas un editor de consultas para ejecutar comandos Transact-SQL (T-SQL) para la configuración y validación posterior a la instalación. Recomendamos la extensión MSSQL para Visual Studio Code. Es una descarga gratuita que funciona en Linux.

• Extensiones de lenguaje también se admiten en contenedores de Linux. No hay contenedores preconstruidos con extensiones de lenguaje, pero puedes crear uno a partir de los contenedores de SQL Server usando una plantilla de ejemplo disponible en GitHub.

• Las extensiones de lenguaje y Machine Learning Services se instalan de forma predeterminada en Clústeres de macrodatos de SQL Server. Si usa Clústeres de macrodatos, no es necesario que siga los pasos de este artículo.

Lista de paquetes

En un dispositivo conectado a internet, descargas e instalas paquetes de forma independiente del Motor de base de datos usando el instalador de paquetes de cada sistema operativo. En la tabla siguiente se indican todos los paquetes disponibles.

Instalación de la extensión de lenguaje 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

Configuración posterior a la instalación (requerida)

1. Conceda permisos en Linux

   No es necesario realizar este paso si usas bibliotecas externas. Las bibliotecas externas son el enfoque recomendado. Para ayuda con la creación de una biblioteca externa a partir de tu jar archivo, consulta CREATE EXTERNAL LIBRARY.

   Si no usa bibliotecas externas, debe proporcionar permisos a SQL Server para ejecutar las clases de Java en el archivo jar.

   Para conceder acceso de lectura y ejecución a un jar archivo, ejecuta el siguiente chmod comando en el jar archivo. Siempre guarda tus archivos de clase cuando jar trabajes con SQL Server. Para obtener ayuda con la creación de un jar, consulte Creación de un archivo JAR de Java a partir de archivos de clase.

   chmod ug+rx <MyJarFile.jar>
   

   También necesitas dar mssql_satellite permisos para leer y ejecutar el jar archivo.

   chown mssql_satellite:mssql_satellite <MyJarFile.jar>
   

   La configuración adicional se realiza principalmente a través de la herramienta mssql-conf.

2. Añada la cuenta de usuario de mssql usada para ejecutar el servicio SQL Server. Este paso es necesario si no has ejecutado la configuración antes.

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

3. Habilite el acceso de red saliente. El acceso de red saliente está deshabilitado de forma predeterminada. Para habilitar las solicitudes salientes, establece la outboundnetworkaccess propiedad booleana con la mssql-conf herramienta. Para más información, vea Configuración de SQL Server en 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. Reinicie el servicio SQL Server Launchpad y la instancia del motor de base de datos para leer los valores actualizados del archivo INI. Un mensaje de reinicio te recuerda cada vez que modificas una configuración relacionada con la extensibilidad.

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

5. Habilite la ejecución de scripts externos. Puede conectarse a una instancia de SQL Server mediante cualquier herramienta de cliente SQL Server conocida, como sqlcmd, SQL Server Management Studio (SSMS) o la extensión MSSQL para Visual Studio Code.

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

6. Vuelva a reiniciar el servicio mssql-launchpadd.

7. Para cada base de datos donde quieras usar extensiones de lenguaje, registra el lenguaje externo con CREATE EXTERNAL LANGUAGE. Consulta la siguiente sección para los pasos.

Registrar lenguaje externo

Para cada base de datos donde quieras usar extensiones de lenguaje, registra el lenguaje externo con CREATE EXTERNAL LANGUAGE.

En el ejemplo siguiente se agrega un lenguaje externo denominada Java a una base de datos en SQL Server en 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"}'
);

Para la extensión Java, la variable JRE_HOME de entorno determina el camino para encontrar e inicializar la JVM.

El CREATE EXTERNAL LANGUAGE DDL proporciona un ENVIRONMENT_VARIABLES parámetro para establecer variables de entorno para el proceso que aloja la extensión. Utiliza este parámetro para establecer variables de entorno que requieren las extensiones de lenguaje externas.

Para obtener más información, consulte CREATE EXTERNAL LANGUAGE.

Comprobación de la instalación

La integración de funciones de Java no incluye librerías, pero puedes ejecutar grep -r JRE_HOME /etc para confirmar que existe la JRE_HOME variable de entorno.

Para validar la instalación, ejecute un script de T-SQL que ejecute un procedimiento almacenado del sistema que invoque a Java. Necesita una herramienta de consulta para esta tarea. Puede conectarse a una instancia de SQL Server mediante cualquier herramienta de cliente SQL Server conocida, como sqlcmd, SQL Server Management Studio (SSMS) o la extensión MSSQL para Visual Studio Code.

Limitaciones

La autenticación implícita no está disponible en Linux. El código Java que se ejecuta en el proceso externo no puede volver a conectarse al servidor para acceder a datos u otros recursos.

Gobernanza de recursos

Linux y Windows tienen paridad en la gobernanza de recursos para pools externos, pero las estadísticas de sys.dm_resource_governor_external_resource_pools actualmente tienen unidades diferentes en Linux.

Contenido relacionado

• Tutorial: Búsqueda de una cadena mediante expresiones regulares (regex) en Java