Instalar a extensão de linguagem Java do SQL Server no Linux

Aplica-se a: SQL Server 2019 (15.x) em Linux e versões posteriores

Saiba como instalar o componente Java Language Extension para SQL Server no Linux. A Extensão de Linguagem Java faz parte das Extensões de Linguagem do SQL Server e é um complemento para o Mecanismo de Banco de Dados.

Embora você possa instalar o Mecanismo de Banco de Dados e as Extensões de Idioma simultaneamente, é uma prática recomendada instalar e configurar o Mecanismo de Banco de Dados do SQL Server primeiro para que você possa resolver quaisquer problemas antes de adicionar mais componentes.

Pré-requisitos

• A sua distribuição Linux deve ser suportada pelo SQL Server. Os recipientes são cobertos separadamente numa bala posterior. Distribuições suportadas incluem:

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

• Precisas de um editor de consultas para executar comandos Transact-SQL (T-SQL) para configuração e validação pós-instalação. Recomendamos a extensão MSSQL para Visual Studio Code. É um download gratuito que corre em Linux.

• Language Extensions também é suportado em contêineres Linux. Contentores pré-construídos com Extensões de Linguagem não estão disponíveis, mas podes criar um a partir dos contentores do SQL Server usando um modelo de exemplo disponível no GitHub.

• As Extensões de Linguagem e os Serviços de Aprendizado de Máquina são instalados por padrão em Clusters de Big Data do SQL Server. Se você usa clusters de Big Data, não precisa seguir as etapas neste artigo.

Lista de pacotes

Num dispositivo ligado à internet, descarrega e instala pacotes independentemente do Database Engine, usando o instalador de pacotes de cada sistema operativo. A tabela a seguir descreve todos os pacotes disponíveis.

Instalar extensão de linguagem 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

Configuração pós-instalação (obrigatória)

1. Conceder permissões no Linux

   Você não precisa executar esta etapa se usar bibliotecas externas. Bibliotecas externas são a abordagem recomendada. Para ajuda na criação de uma biblioteca externa a partir do seu jar ficheiro, consulte CREATE EXTERNAL LIBRARY.

   Se você não estiver usando bibliotecas externas, precisará fornecer permissões ao SQL Server para executar as classes Java em seu jar.

   Para conceder acesso de leitura e execução a um jar ficheiro, execute o seguinte chmod comando sobre o jar ficheiro. Coloca sempre os ficheiros das tuas aulas quando jar trabalhares com SQL Server. Para obter ajuda com a criação de um jararquivo , consulte Criar um arquivo Java .jar a partir de arquivos de classe.

   chmod ug+rx <MyJarFile.jar>
   

   Também precisa de dar mssql_satellite permissões para ler e executar o jar ficheiro.

   chown mssql_satellite:mssql_satellite <MyJarFile.jar>
   

   A configuração adicional é feita principalmente através da ferramenta mssql-conf.

2. Adicione a mssql conta de usuário usada para executar o serviço SQL Server. Este passo é obrigatório se ainda não tiver feito a configuração anteriormente.

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

3. Habilite o acesso à rede de saída. O acesso à rede de saída está desativado por padrão. Para permitir pedidos de saída, defina a outboundnetworkaccess propriedade Booleana com a mssql-conf ferramenta. Para mais informações, consulte Configurar SQL Server em Linux com 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 o serviço Barra Inicial do SQL Server e a instância do Mecanismo de Banco de Dados para ler os valores atualizados do arquivo INI. Uma mensagem de reinício lembra-o sempre que modifica uma configuração relacionada com extensibilidade.

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

5. Ativar a execução de scripts externos. Você pode se conectar a uma instância do SQL Server usando qualquer ferramenta de cliente familiar do SQL Server, como sqlcmd, SQL Server Management Studio (SSMS) ou a extensão MSSQL para Visual Studio Code.

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

6. Reinicie o mssql-launchpadd serviço novamente.

7. Para cada base de dados onde pretende usar extensões de linguagem, registe a linguagem externa com CREATE EXTERNAL LANGUAGE. Consulte a secção seguinte para os passos.

Registar língua externa

Para cada base de dados onde pretende usar extensões de linguagem, registe a linguagem externa com CREATE EXTERNAL LANGUAGE.

O exemplo a seguir adiciona uma linguagem externa chamada Java a um banco de dados no SQL Server no 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 a extensão Java, a variável JRE_HOME ambiente determina o caminho para encontrar e inicializar a JVM.

O CREATE EXTERNAL LANGUAGE DDL fornece um ENVIRONMENT_VARIABLES parâmetro para definir variáveis de ambiente para o processo que hospeda a extensão. Use este parâmetro para definir variáveis de ambiente que extensões externas de linguagem exigem.

Para obter mais informações, veja CREATE EXTERNAL LANGUAGE.

Verificar a instalação

A integração de funcionalidades em Java não inclui bibliotecas, mas podes correr grep -r JRE_HOME /etc para confirmar que a JRE_HOME variável de ambiente existe.

Para validar a instalação, execute um script T-SQL que executa um procedimento armazenado do sistema invocando Java. Você precisa de uma ferramenta de consulta para essa tarefa. Você pode se conectar a uma instância do SQL Server usando qualquer ferramenta de cliente familiar do SQL Server, como sqlcmd, SQL Server Management Studio (SSMS) ou a extensão MSSQL para Visual Studio Code.

Limitações

A autenticação implícita não está disponível no Linux. O código Java a correr no processo externo não consegue voltar a ligar-se ao servidor para aceder a dados ou outros recursos.

Governação dos recursos

Linux e Windows têm paridade na governação de recursos para pools externos, mas as estatísticas para sys.dm_resource_governor_external_resource_pools atualmente têm unidades diferentes no Linux.

Conteúdo relacionado

• Tutorial: Pesquisar uma cadeia de caracteres usando expressões regulares (regex) em Java