Solucionar problemas com o serviço Launchpad executando scripts Python e R nos Serviços de Machine Learning do SQL Server

Aplica-se a: SQL Server 2016 (13.x) e versões posteriores

Este artigo fornece diretrizes para solucionar problemas que envolvem o serviço do SQL Server Launchpad usado com Serviços de Machine Learning. O serviço do Launchpad é compatível com a execução do script externo para R e para Python. Vários problemas podem impedir que o Launchpad inicie, incluindo problemas de configuração, alterações ou protocolos de rede ausentes.

Determinar se o Launchpad está em execução

1. Abra o SQL Server Configuration Manager. Na linha de comando, digite SQLServerManager13.msc, SQLServerManager14.msc ou SQLServerManager15.msc.

2. Anote a conta de serviço em que o Launchpad está sendo executado. Cada instância em que R ou Python estiverem habilitados deve ter sua própria instância do serviço Launchpad. Por exemplo, o serviço de uma instância nomeada pode ser algo como MSSQLLaunchpad$InstanceName.

3. Se tiver sido interrompido, reinicie o serviço. Ao reiniciar, se houver algum problema com a configuração, uma mensagem será publicada no log de eventos do sistema e o serviço será interrompido novamente. Verifique o log de eventos do sistema para ver detalhes sobre por que o serviço parou.

4. Examine o conteúdo de RSetup.log e certifique-se de que não haja nenhum erro na instalação. Por exemplo, a mensagem Saindo do processo com o código de erro 0 indica falha do serviço a ser iniciado.

5. Para procurar outros erros, examine o conteúdo de rlauncher.log.

Verificar a conta de serviço do Launchpad

A conta de serviço padrão pode ser "NT Service$SQL2016", "NT Service$SQL2017", ou "NT Service$SQL2019". A parte final pode variar, dependendo do nome da instância do SQL.

O serviço do Launchpad (Launchpad.exe) será executado usando uma conta de serviço de baixo privilégio. No entanto, para iniciar R e Python e se comunicar com a instância do banco de dados, a conta de serviço do Launchpad requer os seguintes direitos de usuário:

• Fazer logon como um serviço (SeServiceLogonRight)
• Substituir um token no nível de processo (SeAssignPrimaryTokenPrivilege)
• Ignorar verificação completa (SeChangeNotifyPrivilege)
• Ajustar cotas de memória para um processo (SeIncreaseQuotaSizePrivilege)

Para saber mais sobre esses direitos de usuário, confira a seção "Privilégios e direitos do Windows" em Configurar contas de serviço e permissões do Windows.

O grupo de usuários do Launchpad não pode fazer logon localmente

Durante a instalação dos Serviços de Machine Learning, o SQL Server cria o grupo de usuários do Windows, SQLRUserGroup. Em seguida, provisiona a ele todos os direitos necessários para o Launchpad conectar-se ao SQL Server e executar trabalhos de script externo. Se esse grupo de usuários estiver habilitado, ele também será usado para executar scripts Python.

No entanto, em organizações em que políticas de segurança mais restritivas são impostas, os direitos exigidos por esse grupo podem ter sido removidos manualmente ou revogados automaticamente pela política. Se os direitos tiverem sido removidos, o Launchpad não poderá mais se conectar ao SQL Server e o SQL Server não poderá chamar o runtime externo.

Para corrigir o problema, garanta que o SQLRUserGroup tenha o direito de sistema Permitir logon local.

Para saber mais, leia o tópico Configurar contas de serviço e permissões do Windows.

Permissões para executar scripts externos

Mesmo que o Launchpad esteja configurado corretamente, ele retornará um erro se o usuário não tiver permissão para executar scripts de R ou Python.

Se você tiver instalado o SQL Server como um administrador de banco de dados ou se for um proprietário de banco de dados, receberá essa permissão automaticamente. No entanto, outros usuários geralmente têm permissões mais limitadas. Se eles tentarem executar um script do R, receberão um erro do Launchpad.

Para corrigir o problema, no SQL Server Management Studio, um administrador de segurança pode modificar o logon do SQL ou a conta de usuário do Windows executando o seguinte script:

GRANT EXECUTE ANY EXTERNAL SCRIPT TO <username>

Para saber mais, confira GRANT (Transact-SQL.

Erros comuns do Launchpad

Nesta seção, você verá uma lista das mensagens de erro mais comuns retornadas pelo Launchpad.

"Falha de logon: não foi concedido ao usuário o tipo de logon solicitado"

Por padrão, SQL Server Launchpad usa a seguinte conta na inicialização: NT Service\MSSQLLaunchpad. A conta é configurada pela instalação de SQL Server para ter todas as permissões necessárias.

Se você atribuir uma conta diferente ao Launchpad ou o direito for removido por uma política no computador do SQL Server, talvez conta não tenha as permissões necessárias e você poderá ver este erro:

ERROR_LOGON_TYPE_NOT_GRANTED 1385 (0x569) Falha de logon: o usuário não recebeu o tipo de logon solicitado neste computador.

Para conceder as permissões necessárias à nova conta de serviço, use o aplicativo Política de Segurança Local e atualize as permissões na conta para incluir estas permissões:

• Ajustar cotas de memória para um processo (SeIncreaseQuotaPrivilege)
• Ignorar verificação completa (SeChangeNotifyPrivilege)
• Fazer logon como um serviço (SeServiceLogonRight)
• Substituir um token de nível de processo (SeAssignPrimaryTokenPrivilege)

"Não é possível se comunicar com o serviço Launchpad"

Se você tiver instalado e habilitado o aprendizado de máquina, mas receber esse erro ao tentar executar um script R ou Python, a execução do serviço do Launchpad da instância poderá ter sido interrompida.

1. Em um prompt de comando do Windows, abra o SQL Server Configuration Manager. Para obter mais informações, consulte SQL Server Configuration Manager.

2. Clique com o botão direito do mouse no SQL Server Launchpad da instância e, em seguida, selecione Propriedades.

3. Selecione a guia Serviço e verifique se o serviço está em execução. Se não estiver, altere o Modo Inicial para Automático e clique em Aplicar.

4. A reinicialização do serviço geralmente corrige o problema para que os scripts de aprendizado de máquina possam ser executados. Se a reinicialização não corrigir o problema, observe o caminho e os argumentos na propriedade Caminho Binário e faça o seguinte:

   a. Examine o arquivo .config do inicializador e verifique se o diretório de trabalho é válido.

   b. Verifique se o grupo do Windows usado pelo Launchpad pode se conectar à instância do SQL Server.

   c. Se você alterar qualquer uma das propriedades do serviço, reinicie o serviço Launchpad.

"Erro fatal: falha na criação do tmpFile"

Nesse cenário, você instalou com êxito os recursos de aprendizado de máquina e o Launchpad está em execução. Você tenta executar alguns códigos simples de R ou Python, mas o Launchpad falha com um erro semelhante ao seguinte:

Não é possível se comunicar com o runtime do script R. Verifique os requisitos do runtime do R.

Ao mesmo tempo, o runtime do script externo grava a seguinte mensagem como parte da mensagem STDERR:

Erro fatal: falha na criação do tmpfile.

Esse erro indica que a conta que o Launchpad está tentando usar não tem permissão para fazer logon no banco de dados. Essa situação pode ocorrer quando políticas de segurança rigorosas são implementadas. Para determinar se esse é o caso, examine os logs do SQL Server e verifique se a conta MSSQLSERVER01 foi negada no logon. As mesmas informações são fornecidas nos logs específicos do R_SERVICES ou do PYTHON_SERVICES. Procure ExtLaunchError.log.

Por padrão, 20 contas são configuradas e associadas ao processo Launchpad.exe, com os nomes MSSQLSERVER01 por meio de MSSQLSERVER20. Se você fizer uso intensivo de R ou Python, poderá aumentar o número de contas.

Para resolver o problema, verifique se o grupo tem as permissões Permitir logon local para a instância local em que os recursos de aprendizado de máquina foram instalados e habilitados. Em alguns ambientes, esse nível de permissão pode exigir uma exceção de GPO do administrador de rede.

"Não há cota suficiente para processar este comando"

Esse erro pode significar uma entre várias coisas:

• O Launchpad pode ter usuários externos insuficientes para executar a consulta externa. Por exemplo, se você estiver executando mais de 20 consultas externas simultaneamente e houver apenas 20 usuários padrão, uma ou mais consultas poderão falhar.

• Memória insuficiente disponível para processar a tarefa do R. Esse erro ocorre com mais frequência em um ambiente padrão, em que o SQL Server pode estar usando até 70% dos recursos do computador. Para saber mais sobre como modificar a configuração do servidor usar mais recursos no R, confira Operacionalização do código R.

"Não é possível encontrar o pacote"

Se você executar o código R no SQL Server e receber essa mensagem, mas não recebê-la ao executar o mesmo código fora do SQL Server, isso significa que o pacote não foi instalado na localização da biblioteca padrão usada pelo SQL Server.

Esse erro pode ocorrer de várias maneiras:

• Você instalou um novo pacote no servidor, mas o acesso foi negado, então o R instalou o pacote em uma biblioteca de usuários.

• Você instalou os Serviços do R e depois instalou outra ferramenta ou conjunto de bibliotecas do R, como o RStudio.

Para determinar a localização da biblioteca de pacotes do R usada pela instância, abra o SQL Server Management Studio (ou qualquer outra ferramenta de consulta de banco de dados), conecte-se à instância e execute o seguinte procedimento armazenado:

EXEC sp_execute_external_script @language = N'R',  
@script = N' print(normalizePath(R.home())); print(.libPaths());'; 

Resultados de exemplo

Mensagem(ns) STDOUT do script externo:

[1] "C:\Program Files\Microsoft SQL Server\MSSQL13.SQL2016\R_SERVICES"

[1] "C:/Program Files/Microsoft SQL Server/MSSQL13.SQL2016/R_SERVICES/library"

Para resolver o problema, você deve reinstalar o pacote na biblioteca da instância do SQL Server.

Próximas etapas

Coleta de dados para a solução de problemas de aprendizado de máquina

Instalar os Serviços de Machine Learning do SQL Server

Solucionar problemas de conexões de mecanismo de banco de dados