在 Linux 上安装 SQL Server Java 语言扩展

适用于：SQL Server 2019 (15.x) - Linux 及更高版本

了解如何为 Linux 上的 SQL Server 安装 Java 语言扩展组件。 Java 语言扩展是 SQL Server 语言扩展的一部分，也是数据库引擎的一个加载项。

尽管可以同时安装数据库引擎和语言扩展，但最好先安装并配置 SQL Server 数据库引擎，以便在添加更多组件之前解决所有问题。

先决条件

• Linux 版本必须受 SQL Server 支持，但不包括 Docker 引擎。 受支持的版本包括：

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

• 应有用于运行 Transact-SQL (T-SQL) 命令的工具。 需要使用查询编辑器进行安装后配置和验证。 我们建议使用 Azure Data Studio，它是在 Linux 上运行的免费下载。

• Linux 容器也支持语言扩展。 我们不提供带有语言扩展的预生成容器，但你可以使用 GitHub 中提供的示例模板通过 SQL Server 容器创建一个。

• 默认情况下，语言扩展和机器学习服务安装在 SQL Server 大数据群集上。 如果使用大数据群集，则无需按照本文中的步骤进行操作。 有关详细信息，请参阅通过机器学习服务在 SQL Server 2019 大数据群集上运行 Python 和 R 脚本。

包列表

在已连接 Internet 的设备上，将根据设备各自的操作系统使用包安装程序独立于数据库引擎下载和安装相应的包。 下表列出了所有可用的包。

安装 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

安装后配置（必需）

1. 授予对 Linux 的权限

   如果使用外部库，则无需执行此步骤。 建议的工作方式为使用外部库。 有关通过 jar 文件创建外部库的帮助信息，请参阅 CREATE EXTERNAL LIBRARY

   如果不使用外部库，则需要为 SQL Server 提供在 jar 中执行 Java 类的权限。

   若要授予对 jar 文件的读取和执行访问权限，请在 文件上运行以下 chmod 命令jar。 我们建议在使用 SQL Server 时始终将类文件放在 jar 中。 有关创建 jar 的帮助，请参阅从类文件创建 Java .jar 文件。

   chmod ug+rx <MyJarFile.jar>
   

   你还需要为 mssql_satellite 文件提供 jar 读取/执行权限。

   chown mssql_satellite:mssql_satellite <MyJarFile.jar>
   

   其他配置主要通过 mssql-conf 工具完成。

2. 添加用于运行 SQL Server 服务的 mssql 用户帐户。 如果之前未运行过该安装程序，则必须这样做。

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

3. 启用出站网络访问。 默认情况下，出站网络访问处于禁用状态。 若要启用出站请求，请使用 mssql-conf outboundnetworkaccess工具设置 布尔属性。 有关详细信息，请参阅使用 mssql-conf 配置 Linux 上的 SQL Server。

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

4. 重启 SQL Server Launchpad 服务和数据库引擎实例，以从 INI 文件中读取更新后的值。 每当修改与扩展性相关的设置时，都会收到重启消息提醒。

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

5. 使用 Azure Data Studio 或使用运行 T-SQL 的其他工具（如 SQL Server Management Studio，仅限 Windows）来启用外部脚本执行。

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

6. 再次重启 mssql-launchpadd 服务。

7. 对于想要在其中使用语言扩展的每个数据库，需要使用 CREATE EXTERNAL LANGUAGE 注册外部语言。 请参阅下一部分中的步骤。

注册外部语言

对于想要在其中使用语言扩展的每个数据库，需要使用 CREATE EXTERNAL LANGUAGE 注册外部语言。

以下示例将名为 Java 的外部语言添加到 Linux 上的 SQL Server 的数据库中。

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"}'
);

对于 Java 扩展，环境变量 JRE_HOME 用于确定从中查找和初始化 JVM 的路径。

CREATE EXTERNAL LANGUAGE DDL 提供参数 (ENVIRONMENT_VARIABLES) 来为专门用于托管扩展的进程设置环境变量。 这是推荐的也是最有效的设置外部语言扩展所需的环境变量的方法。

有关详细信息，请参阅 CREATE EXTERNAL LANGUAGE。

验证安装

Java 功能集成不包含库，但你可以运行 grep -r JRE_HOME /etc 来确认 JAVA_HOME 环境变量的创建。

若要验证安装，请运行执行调用 Java 的系统存储过程的 T-SQL 脚本。 需要使用查询工具来完成此任务。 Azure Data Studio 就是不错的选择。 其他常用工具（如 SQL Server Management Studio）仅适用于 Windows。 如果您在 Windows 计算机上具备这些工具，请使用该计算机连接到数据库引擎的 Linux 系统。

限制

目前，Linux 中不提供默示的身份验证，这意味着无法从正在执行的 Java 连接回服务器来访问数据或其他资源。

资源治理

Linux 和 Windows 在资源管理方面对外部资源池是相等的，但 sys.dm_resource_governor_external_resource_pools 的统计信息目前在 Linux 上使用不同的单位。

相关内容

• 教程：在 Java 中使用正则表达式 (regex) 搜索字符串