Установка пакетов с инструментами R
Область применения: SQL Server 2016 (13.x) SQL Server 2017 (14.x)
В этой статье описывается использование стандартных инструментов R для установки новых пакетов R в экземпляре Служб машинного обучения SQL Server или служб SQL Server R Services. Пакеты можно устанавливать на SQL Server как с подключенным Интернетом, так и без него.
Помимо стандартных средств R, пакеты R можно также установить с помощью:
- T-SQL (CREATE ANY EXTERNAL LIBRARY).
Общие рекомендации
Код R, выполняющийся в SQL Server, может использовать только пакеты, установленные в библиотеке экземпляра по умолчанию. SQL Server не может загружать пакеты из внешних библиотек, даже если эти библиотеки находятся на том же компьютере. В их число входят библиотеки R, установленные с другими продуктами Майкрософт.
Библиотека пакетов R находится в папке Program Files своего экземпляра SQL Server и по умолчанию для установки в этой папке требуются права администратора. Дополнительные сведения см. в статье Расположение библиотеки пакетов.
Пользователи без прав администратора могут устанавливать пакеты с помощью RevoScaleR 9.0.1 и более поздней версии или с помощью инструкции CREATE EXTERNAL LIBRARY. Пользователь dbo_owner или пользователь с разрешением на инструкцию CREATE EXTERNAL LIBRARY может устанавливать пакеты R в текущую базу данных. Дополнительные сведения см. в разделе:
Пользователи без прав администратора могут устанавливать пакеты с помощью RevoScaleR 9.0.1 и более поздней версии. Пользователь dbo_owner может устанавливать пакеты R в текущую базу данных. Дополнительные сведения см. в статье Установка пакетов R с помощью RevoScaleR.
В защищенной среде SQL Server может потребоваться отказаться от следующих пакетов:
- пакеты, которым требуется доступ к сети;
- пакеты, которым требуется доступ к файловой системе с повышенными правами;
- пакеты, используемые для веб-разработки или других задач, малоэффективных в SQL Server.
Оперативная установка (с доступом к Интернету)
Если SQL Server имеет доступ к Интернету, то для установки пакетов R можно использовать стандартные инструменты.
Определите расположение библиотеки экземпляра (см. статью о получении сведений о пакете R) и перейдите к папке, куда установлены инструменты R.
Например, путь по умолчанию для стандартного экземпляра SQL Server такой:
C:\Program Files\Microsoft SQL Server\MSSQL13.MSSQLSERVER\R_SERVICES\bin\x64\
Например, путь по умолчанию для стандартного экземпляра SQL Server такой:
C:\Program Files\Microsoft SQL Server\MSSQL14.MSSQLSERVER\R_SERVICES\bin\x64\
В этой папке от имени администратора запустите R или RGUI.
Запустите команду R
install.packages
и укажите имя пакета. Если у пакета есть зависимости, установщик автоматически скачает нужные зависимости и установит их.
При наличии нескольких параллельных экземпляров SQL Server запустите установку отдельно для каждого экземпляра, в котором будет использоваться пакет. Пакеты не могут совместно использоваться разными экземплярами.
Автономная установка (без доступа к Интернету)
Часто на серверах, где размещены рабочие базы данных, нет подключения к Интернету. Для установки пакетов R в этой среде необходимо заранее скачать и подготовить пакеты и зависимости (в виде ZIP-файлов), а затем скопировать файлы в папку на сервере. После размещения этих файлов пакеты можно устанавливать в автономном режиме.
Могут возникнуть сложности с определением всех зависимостей. Для R рекомендуется создать локальный репозиторий с помощью miniCRAN. miniCRAN принимает список пакетов, которые необходимо установить, анализирует зависимости и собирает все необходимые ZIP-файлы. Затем он создает один репозиторий, который можно скопировать в изолированный экземпляр SQL Server. Пакет igraph также полезен при анализе зависимостей пакетов.
Дополнительные сведения см. в статье Create a local R package repository using miniCRAN (Создание локального репозитория пакетов R с помощью miniCRAN).
Когда ZIP-файл будет в экземпляре SQL Server, его можно установить на сервере с помощью стандартных инструментов R.
Определите расположение библиотеки экземпляра (см. статью о получении сведений о пакете R) и перейдите к папке, куда установлены инструменты R.
Например, путь по умолчанию для стандартного экземпляра SQL Server такой:
C:\Program Files\Microsoft SQL Server\MSSQL13.MSSQLSERVER\R_SERVICES\bin\x64\
Например, путь по умолчанию для стандартного экземпляра SQL Server такой:
C:\Program Files\Microsoft SQL Server\MSSQL14.MSSQLSERVER\R_SERVICES\bin\x64\
В этой папке от имени администратора запустите R или RGUI.
Выполните команду R
install.packages
и укажите имя пакета или репозитория, а также расположение ZIP-файлов. Например:install.packages("C:\\Temp\\Downloaded packages\\mynewpackage.zip", repos=NULL)
Эта команда извлекает пакет R
mynewpackage
из локального ZIP-файла и устанавливает его. Если у пакета есть зависимости, установщик проверяет наличие существующих пакетов в библиотеке. Если вы создали репозиторий, включающий зависимости, установщик также установит необходимые пакеты.Примечание.
Если необходимые пакеты отсутствуют в библиотеке экземпляров и не найдены в ZIP-файлах, установка целевого пакета завершается сбоем.
В качестве альтернативы использованию miniCRAN, можно выполнить следующие действия вручную:
- Определите все зависимости пакета.
- Проверьте, установлены ли на сервере необходимые пакеты. Если пакет установлен, проверьте правильность версии.
- Загрузите пакет и все зависимости на отдельный компьютер с доступом к Интернету.
- Разместите пакет и зависимости в одном архиве.
- Создайте ZIP-файл, если его еще нет.
- Переместите файлы в папку, доступную для сервера.
- Запустите поддерживаемую команду установки или инструкцию DDL, чтобы установить пакет в библиотеку экземпляров.