Partilhar via

Alterar a versão padrão do tempo de execução da linguagem R ou Python

Aplica-se a: SQL Server 2016 (13.x) SQL Server 2017 (14.x)

Este artigo descreve como alterar a versão padrão do R ou Python usada no SQL Server 2016 R Services ou no SQL Server Machine Learning Services com Python e R.

A lista a seguir lista as versões do tempo de execução R e Python incluídas nas diferentes versões do SQL Server.

Versão do SQL Server Serviço Atualização cumulativa Versões de tempo de execução R Versão do tempo de execução do Python
SQL Server 2016 (13.x) Serviços R RTM - SP2 CU13 3.2.2 Não disponível
SQL Server 2016 (13.x) Serviços R SP2 CU14 e posteriores 3.2.2 e 3.5.2 Não disponível
SQL Server 2017 (14.x) Serviços de Aprendizagem Automática RTM - CU21 3.3.3 3.5.2
SQL Server 2017 (14.x) Serviços de Aprendizagem Automática CU22 e posteriores 3.3.3 e 3.5.2 3.5.2 e 3.7.2

Pré-requisitos

Você precisa instalar uma atualização cumulativa () para alterar a versão padrão do tempo de execução da linguagem R ou Python:

  • SQL Server 2016: Atualização Cumulativa (CU) 14 ou posterior do Service Pack (SP) 2
  • SQL Server 2017: Atualização Cumulativa (CU) 22 ou posterior

Para baixar a atualização cumulativa mais recente, consulte as atualizações mais recentes para o Microsoft SQL Server.

Observação

Se você associar a Atualização Cumulativa a uma nova instalação do SQL Server, somente as versões mais recentes do tempo de execução do R e Python serão instaladas.

Alterar a versão do tempo de execução do R

Se você tiver instalado uma das atualizações cumulativas acima para SQL Server 2016 ou 2017, poderá ter várias versões do R em uma instância do SQL Server. Cada versão está contida em uma subpasta da pasta da instância com o nome R_SERVICES.<major>.<minor> (a pasta da instalação original pode não ter um número de versão anexado ao nome da pasta).

Se instalar um CU contendo R 3.5, a nova R_SERVICES pasta é:

  • SQL Server 2016: C:\Program Files\Microsoft SQL Server\MSSQL13.<INSTANCE_NAME>\R_SERVICES.3.5
  • SQL Server 2017: C:\Program Files\Microsoft SQL Server\MSSQL14.<INSTANCE_NAME>\R_SERVICES.3.5

Cada instância do SQL Server usa uma dessas versões como a versão padrão do R. Você pode alterar a versão padrão usando o utilitário de linha de RegisterRext.exe comando. O utilitário está localizado na pasta R em cada instância do SQL Server:

<Instância do SQL Server caminho>\R_SERVICES.n.n\library\RevoScaleR\rxLibs\x64\RegisterRext.exe

Observação

A funcionalidade descrita neste artigo está disponível somente com a cópia do RegisterRext.exe incluído nas UCs SQL. Não use a cópia que acompanha a instalação original do SQL Server.

Para alterar a versão de tempo de execução do R, passe os seguintes argumentos de linha de comando para RegisterRext.exe:

  • /configure - Obrigatório, especifica que você está configurando a versão R padrão.

  • /instance: <instance name> - Opcional, a instância que você deseja configurar. Se não for especificado, a instância padrão será configurada.

  • /rhome: <path to the R_SERVICES[n.n] folder> - Opcional, caminho para a pasta da versão de tempo de execução que você deseja definir como a versão R padrão.

    Se você não especificar /rhome, o caminho configurado será o caminho sob o qual RegisterRext.exe está localizado.

Examples

A seguir estão exemplos de como alterar a versão de tempo de execução do R no SQL Server 2016 e 2017.

Alterar a versão de tempo de execução do R no SQL Server 2016

Por exemplo, para configurar o R 3.5 como a versão padrão do R para a instância MSSQLSERVER01 no SQL Server 2016:

cd "C:\Program Files\Microsoft SQL Server\MSSQL13.MSSQLSERVER01\R_SERVICES.3.5\library\RevoScaleR\rxLibs\x64"

.\RegisterRext.exe /configure /rhome:"C:\Program Files\Microsoft SQL Server\MSSQL13.MSSQLSERVER01\R_SERVICES.3.5" /instance:MSSQLSERVER01

Alterar a versão do tempo de execução do R no SQL Server 2017

Por exemplo, para configurar o R 3.5 como a versão padrão do R para a instância MSSQLSERVER01 no SQL Server 2017:

cd "C:\Program Files\Microsoft SQL Server\MSSQL14.MSSQLSERVER01\R_SERVICES.3.5\library\RevoScaleR\rxLibs\x64"

.\RegisterRext.exe /configure /rhome:"C:\Program Files\Microsoft SQL Server\MSSQL14.MSSQLSERVER01\R_SERVICES.3.5" /instance:MSSQLSERVER01

Nesses exemplos, você não precisa incluir o /rhome argumento, pois está especificando a mesma pasta onde RegisterRext.exe está localizado.

Alterar a versão do runtime do Python

Se você instalou o SQL Server 2017 (14.x) CU22 ou uma versão posterior, talvez tenha várias versões do Python em uma instância do SQL Server. Cada versão está contida em uma subpasta da pasta da instância com o nome PYTHON_SERVICES.<major>.<minor> (a pasta da instalação original pode não ter um número de versão anexado ao nome da pasta).

Por exemplo, se instalares um CU contendo Python 3.7, será criada uma nova pasta PYTHON_SERVICES.

C:\Program Files\Microsoft SQL Server\MSSQL14.<INSTANCE_NAME>\PYTHON_SERVICES.3.7

Cada instância do SQL Server usa uma dessas versões como a versão padrão do Python. Você pode alterar a versão padrão usando o utilitário de linha de comando RegisterRext.exe. O utilitário está localizado sob as pastas Python em cada instância do SQL Server:

<Caminho de instância do SQL Server>\PYTHON_SERVICES.n.n\Lib\site-packages\revoscalepy\rxLibs\RegisterRExt.exe

Observação

A funcionalidade descrita neste artigo está disponível apenas com a cópia de RegisterRext.exe incluída nos CUs SQL. Não use a cópia que acompanha a instalação original do SQL Server.

Para alterar a versão do tempo de execução do Python, passe os seguintes argumentos de linha de comando para RegisterRext.exe:

  • /configure - Obrigatório, especifica que você está configurando a versão padrão do Python.

  • /python - Especifica que você está configurando a versão padrão do Python. Opcional se você especificar /pythonhome.

  • /instance: <instance name> - Opcional, a instância que você deseja configurar. Se não for especificado, a instância padrão será configurada.

  • /pythonhome: <path to the PYTHON_SERVICES[n.n] folder> - Opcional, caminho para a pasta de versão de tempo de execução que você deseja definir como a versão padrão do Python.

    Se você não especificar /pythonhome, o caminho configurado será o caminho sob o qual RegisterRext.exe está localizado.

Example

Por exemplo, para configurar o Python 3.7 como a versão padrão do Python para a instância MSSQLSERVER01 no SQL Server 2017:

cd "C:\Program Files\Microsoft SQL Server\MSSQL14.MSSQLSERVER01\PYTHON_SERVICES.3.7\Lib\site-packages\revoscalepy\rxLibs"

.\RegisterRext.exe /configure /pythonhome:"C:\Program Files\Microsoft SQL Server\MSSQL14.MSSQLSERVER\PYTHON_SERVICES.3.7" /instance:MSSQLSERVER01

Neste exemplo, você não precisa incluir o /pythonhome argumento, pois está especificando a mesma pasta onde RegisterRext.exe está localizado.

Remover uma versão de runtime

Para remover uma versão do R ou Python, use RegisterRext.exe com o argumento /cleanup linha de comando, usando o mesmo /rhome, /pythonhome, e /instance argumentos descritos anteriormente.

Por exemplo, para remover a pasta R 3.2 da instância MSSQLSERVER01:

.\RegisterRext.exe /cleanup /rhome:"C:\Program Files\Microsoft SQL Server\MSSQL13.MSSQLSERVER01\R_SERVICES" /instance:MSSQLSERVER01

Por exemplo, para remover a pasta Python 3.7 da instância MSSQLSERVER01:

.\RegisterRExt.exe /cleanup /python /pythonhome:"C:\Program Files\Microsoft SQL Server\MSSQL14.MSSQLSERVER01\PYTHON_SERVICES.3.7" /instance:MSSQLSERVER01

RegisterRext.exe solicita que você confirme a limpeza do tempo de execução R especificado:

Tem certeza de que deseja excluir permanentemente o tempo de execução fornecido junto com todos os pacotes instalados nele? [Sim(Y)/Não(N)/Predefinição(Sim)]:

Para confirmar, responda Y ou pressione enter. Como alternativa, pode ignorar este prompt passando /y ou /Yes ou a opção /cleanup.

Observação

Você pode remover uma versão somente se ela não estiver configurada como padrão e não estiver sendo usada para executar RegisterRext.exe.

Conteúdo relacionado

  • Last updated on