Instalar a Extensão de Linguagem Java do SQL Server no Linux

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

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

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

Pré-requisitos

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

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

• Você precisa 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 roda no Linux.

• As extensões de linguagem também são compatíveis com contêineres do Linux. Contêineres pré-construídos com Extensões de Linguagem não estão disponíveis, mas você pode criar um a partir dos contêineres do SQL Server usando um modelo de exemplo disponível no GitHub.

• As Extensões de Linguagem e os Serviços de Machine Learning 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 deste artigo.

Lista de pacotes

Em um dispositivo conectado à internet, você baixa e instala pacotes independentemente do Mecanismo de Banco de Dados usando o instalador de pacotes para cada sistema operacional. A tabela a seguir descreve todos os pacotes disponíveis.

Instalar a 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 precisará 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 arquivo, veja CREATE EXTERNAL LIBRARY.

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

   Para conceder acesso de leitura e execução a um jar arquivo, execute o seguinte chmod comando no jar arquivo. Sempre coloque seus arquivos de classe quando jar trabalhar com SQL Server. Para obter ajuda na criação de um jar, confira Criar um arquivo Java .jar com base em arquivos de classe.

   chmod ug+rx <MyJarFile.jar>
   

   Você também precisa dar mssql_satellite permissões para ler e executar o jar arquivo.

   chown mssql_satellite:mssql_satellite <MyJarFile.jar>
   

   A configuração adicional é principalmente por meio da ferramenta mssql-conf.

2. Adicione a conta de usuário mssql usada para executar o serviço SQL Server. Essa etapa é necessária se você não rodou a configuração antes.

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

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

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

5. Habilitar a execução de script externo. 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 serviço mssql-launchpadd novamente.

7. Para cada banco de dados onde você deseja usar extensões de linguagem, registre a linguagem externa com CREATE EXTERNAL LANGUAGE. Veja a próxima seção para os passos.

Registrar linguagem externa

Para cada banco de dados onde você deseja usar extensões de linguagem, registre 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 em 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 esse parâmetro para definir variáveis de ambiente que extensões externas de linguagem exigem.

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

Verifique a instalação

A integração com recursos do Java não inclui bibliotecas, mas você pode rodar 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 que invoca o 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. Código Java rodando no processo externo não consegue se conectar de volta ao servidor para acessar dados ou outros recursos.

Governança de recursos

Linux e Windows têm paridade para governança 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 regex (expressões regulares) em Java