Instalace balíčků pomocí nástrojů R

platí pro: SQL Server 2016 (13.x) SQL Server 2017 (14.x)

Tento článek popisuje, jak pomocí standardních nástrojů R nainstalovat nové balíčky R do instance SQL Server Machine Learning Services nebo SQL Server R Services. Balíčky můžete nainstalovat na SQL Server, který má připojení k internetu, a také balíčky, které jsou izolované od internetu.

Kromě standardních nástrojů R můžete balíčky R nainstalovat pomocí:

  • T-SQL (CREATE EXTERNAL LIBRARY)

Obecné aspekty

  • Kód R spuštěný v SQL Server může používat pouze balíčky nainstalované ve výchozí knihovně instancí. SQL Server nemůže načíst balíčky z externích knihoven, i když je tato knihovna na stejném počítači. To zahrnuje knihovny R nainstalované s jinými produkty Microsoftu.

  • Knihovna balíčků R se nachází ve složce Program Files vaší instance SQL Server a ve výchozím nastavení instalace v této složce vyžaduje oprávnění správce. Další informace viz Umístění knihovny balíčků.

    Nesprávci mohou instalovat balíčky pomocí RevoScaleR 9.0.1 a novější nebo pomocí CREATE EXTERNAL LIBRARY. Dbo_owner uživatel nebo uživatel s oprávněním CREATE EXTERNAL LIBRARY může instalovat balíčky R do aktuální databáze. Další informace najdete tady:

  • V zabezpečeném prostředí serveru SQL se můžete chtít vyhnout následujícímu:

    • Balíčky, které vyžadují síťový přístup
    • Balíčky, které vyžadují přístup systému souborů se zvýšenými oprávněními
    • Balíčky používané pro vývoj webu nebo jiné úlohy, které nemají prospěch spuštěním na SQL Serveru

Online instalace (s přístupem k internetu)

Pokud SQL Server má přístup k internetu, můžete k instalaci balíčků R použít standardní instalační nástroje balíčků.

  1. Určete umístění knihovny instancí (viz Získání informací o balíčku jazyka R) a přejděte do složky, ve které jsou nainstalované nástroje R.

    Například výchozí cesta pro výchozí instanci serveru SQL Server je:

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

  2. Z této složky spusťte R nebo Rgui jako správce.

  3. Spusťte příkaz install.packages R a zadejte název balíčku. Pokud balíček obsahuje nějaké závislosti, instalační program automaticky stáhne závislosti a nainstaluje je.

Pokud máte více souběžných instancí SQL Server, spusťte instalaci pro každou instanci, ve které chcete balíček použít. Balíčky nelze sdílet mezi instancemi.

Offline instalace (bez přístupu k internetu)

Servery, které hostují produkční databáze, často nemají připojení k internetu. Chcete-li nainstalovat balíčky R v daném prostředí, stáhněte a připravte předem balíčky a závislosti (jako zazipované soubory) a potom soubory zkopírujte do složky na serveru. Jakmile jsou soubory na místě, můžete balíčky nainstalovat offline.

Identifikace všech závislostí je složitá. Pro R doporučujeme použít miniCRAN k vytvoření místního úložiště. miniCRAN přebírá seznam balíčků, které chcete nainstalovat, analyzuje závislosti a shromažďuje všechny potřebné komprimované soubory. Potom vytvoří jedno úložiště, které můžete zkopírovat do izolované instance SQL Server. Balíček igraph je také užitečný při analýze závislostí balíčku.

Další informace najdete v tématu Vytvoření místního úložiště balíčků R pomocí miniCRAN.

Jakmile je soubor ZIP v instanci SQL Server, můžete ho nainstalovat pomocí standardních nástrojů R na serveru.

  1. Určete umístění knihovny instancí (viz Získání informací o balíčku jazyka R) a přejděte do složky, ve které jsou nainstalované nástroje R.

    Například výchozí cesta pro výchozí instanci serveru SQL Server je:

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

  2. Z této složky spusťte R nebo Rgui jako správce.

  3. Spusťte příkaz install.packages R a zadejte název balíčku nebo úložiště a umístění zazipovaných souborů. Příklad:

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

    Tento příkaz extrahuje balíček mynewpackage R z místního souboru ZIP a nainstaluje balíček. Pokud má balíček nějaké závislosti, instalační program zkontroluje existující balíčky v knihovně. Pokud jste vytvořili úložiště, které obsahuje závislosti, instalační program nainstaluje také požadované balíčky.

    Note

    Pokud v knihovně instancí nejsou přítomny žádné požadované balíčky a nelze je najít v zazipovaných souborech, instalace cílového balíčku selže.

Jako alternativu k miniCRAN můžete ručně provést tyto kroky:

  1. Identifikujte všechny závislosti balíčků.
  2. Zkontrolujte, jestli jsou na serveru už nainstalované nějaké požadované balíčky. Pokud je balíček nainstalovaný, ověřte, že je verze správná.
  3. Stáhněte balíček a všechny závislosti do samostatného počítače s přístupem k internetu.
  4. Umístěte balíček a závislosti do jediného archivu balíčku.
  5. Archiv zazipujte, pokud ještě není v komprimovaném formátu.
  6. Přesuňte soubory do složky přístupné ze serveru.
  7. Spuštěním podporovaného instalačního příkazu nebo příkazu DDL nainstalujte balíček do knihovny instancí.