Dicas para usar pacotes R

Aplica-se a: SQL Server 2016 (13.x) e versões posteriores Instância Gerenciada SQL do Azure

Este artigo fornece dicas úteis sobre como usar pacotes R no SQL Server. Essas dicas são para DBAs que não estão familiarizados com R e desenvolvedores experientes de R que não estão familiarizados com o acesso a pacotes em uma instância do SQL Server.

Se você é novo no R

Como administrador que instala pacotes R pela primeira vez, conhecer algumas noções básicas sobre o gerenciamento de pacotes R pode ajudá-lo a começar.

Dependências do pacote

Os pacotes R frequentemente dependem de vários outros pacotes, alguns dos quais podem não estar disponíveis na biblioteca R padrão usada pela instância. Às vezes, um pacote requer uma versão diferente de um pacote dependente do que já está instalado. As dependências do pacote são anotadas em um arquivo DESCRIPTION incorporado no pacote, mas às vezes estão incompletas. Você pode usar um pacote chamado iGraph para articular totalmente o gráfico de dependência.

Se você precisar instalar vários pacotes ou quiser garantir que todos na sua organização obtenham o tipo e a versão corretos do pacote, recomendamos que você use o pacote miniCRAN para analisar a cadeia de dependência completa. miniCRAN cria um repositório local que pode ser compartilhado entre vários usuários ou computadores.

Fontes, versões e formatos de pacotes

Existem várias fontes para pacotes R, como CRAN e Bioconductor. O sítio oficial da língua R (https://www.r-project.org/) enumera muitos destes recursos. Muitos pacotes são publicados no GitHub, onde os desenvolvedores podem obter o código-fonte.

Saiba em qual biblioteca você está instalando e quais pacotes já estão instalados

Se você tiver modificado anteriormente o ambiente R no computador, antes de instalar qualquer coisa, certifique-se de que a variável .libPath de ambiente R use apenas um caminho.

Esse caminho deve apontar para a pasta R_SERVICES da instância. Para obter mais informações, incluindo como determinar quais pacotes já estão instalados, consulte Obter informações sobre o pacote R.

Se você é novo no SQL Server

Como um desenvolvedor R trabalhando em código executado no SQL Server, as políticas de segurança que protegem o servidor restringem sua capacidade de controlar o ambiente R. As dicas a seguir descrevem situações típicas e fornecem sugestões para trabalhar nesse ambiente.

Bibliotecas de usuário R: sem suporte no SQL Server

Os desenvolvedores R que precisam instalar novos pacotes R estão acostumados a instalar pacotes à vontade, usando uma biblioteca de usuário privada sempre que a biblioteca padrão não estiver disponível ou quando o desenvolvedor não for um administrador no computador. Por exemplo, em um ambiente de desenvolvimento R típico, o usuário adicionaria o local do pacote à variável libPathde ambiente R ou faria referência ao caminho completo do pacote, desta forma:

library("c:/Users/<username>/R/win-library/packagename")

Isso não funciona ao executar soluções R no SQL Server, porque os pacotes R devem ser instalados em uma biblioteca padrão específica associada à instância. Quando um pacote não está disponível na biblioteca padrão, você recebe este erro ao tentar chamar o pacote:

Erro na biblioteca (xxx): não há nenhum pacote chamado 'package-name'

Para obter informações sobre como instalar pacotes R no SQL Server, consulte Instalar novos pacotes R no SQL Server Machine Learning Services ou SQL Server R Services.

Como evitar erros de "pacote não encontrado"

Usar as diretrizes a seguir irá ajudá-lo a evitar erros de "pacote não encontrado".

• Elimine as dependências das bibliotecas de usuários.

  É uma má prática de desenvolvimento instalar pacotes R necessários em uma biblioteca de usuário personalizada. Isso pode levar a erros se uma solução for executada por outro usuário que não tenha acesso ao local da biblioteca.

  Além disso, se um pacote estiver instalado na biblioteca padrão, o tempo de execução do R carregará o pacote da biblioteca padrão, mesmo que você especifique uma versão diferente no código R.

• Verifique se o código pode ser executado em um ambiente compartilhado.

• Evite instalar pacotes como parte de uma solução. Se você não tiver permissões para instalar pacotes, o código falhará. Mesmo que você tenha permissões para instalar pacotes, você deve fazê-lo separadamente de outro código que você deseja executar.

• Verifique seu código para certificar-se de que não há chamadas para pacotes desinstalados.

• Atualize seu código para remover referências diretas aos caminhos de pacotes R ou bibliotecas R.

• Saiba qual biblioteca de pacotes está associada à instância. Para obter mais informações, consulte Obter informações sobre o pacote R.

Consulte também