Установка пакетов с инструментами R

Область применения: SQL Server 2016 (13.x) SQL Server 2017 (14.x)

В этой статье описывается использование стандартных инструментов R для установки новых пакетов R в экземпляре Служб машинного обучения SQL Server или служб SQL Server R Services. Пакеты можно устанавливать на SQL Server как с подключенным Интернетом, так и без него.

Помимо стандартных средств R, пакеты R можно также установить с помощью:

• RevoScaleR

• 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 в текущую базу данных. Дополнительные сведения см. в разделе:

  • Установка пакетов R с помощью RevoScaleR
  • Использование инструкции T-SQL (CREATE EXTERNAL LIBRARY) для установки пакетов R на SQL Server

• В защищенной среде SQL Server может потребоваться отказаться от следующих пакетов:

  • пакеты, которым требуется доступ к сети;
  • пакеты, которым требуется доступ к файловой системе с повышенными правами;
  • пакеты, используемые для веб-разработки или других задач, малоэффективных в SQL Server.

Оперативная установка (с доступом к Интернету)

Если SQL Server имеет доступ к Интернету, то для установки пакетов R можно использовать стандартные инструменты.

1. Определите расположение библиотеки экземпляра (см. статью о получении сведений о пакете R) и перейдите к папке, куда установлены инструменты R.

   Например, путь по умолчанию для стандартного экземпляра SQL Server такой:

   C:\Program Files\Microsoft SQL Server\MSSQL14.MSSQLSERVER\R_SERVICES\bin\x64\

2. В этой папке от имени администратора запустите R или RGUI.

3. Запустите команду 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.

1. Определите расположение библиотеки экземпляра (см. статью о получении сведений о пакете R) и перейдите к папке, куда установлены инструменты R.

   Например, путь по умолчанию для стандартного экземпляра SQL Server такой:

   C:\Program Files\Microsoft SQL Server\MSSQL14.MSSQLSERVER\R_SERVICES\bin\x64\

2. В этой папке от имени администратора запустите R или RGUI.

3. Выполните команду R install.packages и укажите имя пакета или репозитория, а также расположение ZIP-файлов. Например:

   install.packages("C:\\Temp\\Downloaded packages\\mynewpackage.zip", repos=NULL)
   

   Эта команда извлекает пакет R mynewpackage из локального ZIP-файла и устанавливает его. Если у пакета есть зависимости, установщик проверяет наличие существующих пакетов в библиотеке. Если вы создали репозиторий, включающий зависимости, установщик также установит необходимые пакеты.

   Примечание.

   Если необходимые пакеты отсутствуют в библиотеке экземпляров и не найдены в ZIP-файлах, установка целевого пакета завершается сбоем.

В качестве альтернативы использованию miniCRAN, можно выполнить следующие действия вручную:

1. Определите все зависимости пакета.
2. Проверьте, установлены ли на сервере необходимые пакеты. Если пакет установлен, проверьте правильность версии.
3. Загрузите пакет и все зависимости на отдельный компьютер с доступом к Интернету.
4. Разместите пакет и зависимости в одном архиве.
5. Создайте ZIP-файл, если его еще нет.
6. Переместите файлы в папку, доступную для сервера.
7. Запустите поддерживаемую команду установки или инструкцию DDL, чтобы установить пакет в библиотеку экземпляров.

См. также

• Получение сведений о пакете R
• Советы по использованию пакетов R
• Учебники по языку R в SQL Server