Sdílet prostřednictvím


Instalace vlastního modulu runtime R pro SQL Server

platí pro: SQL Server 2019 (15.x)

Zjistěte, jak nainstalovat vlastní modul runtime jazyka R pro spouštění externích skriptů R s SQL Serverem na:

  • Windows
  • Ubuntu Linux
  • Red Hat Enterprise Linux (RHEL)
  • SUSE Linux Enterprise Server (SLES) verze 12

Vlastní runtime může spouštět skripty strojového učení a používat SQL Server Language Extensions.

Použijte vlastní verzi modulu runtime R s SQL Serverem místo výchozí verze modulu runtime nainstalovanou se službou SQL Server Machine Learning Services.

Počínaje SQL Serverem 2022 (16.x) se moduly runtime pro R, Python a Java už s instalací SQL nenainstalují. Místo toho nainstalujte požadované vlastní prostředí runtime pro jazyk R a sady balíčků. Další informace najdete v tématu Instalace služby SQL Server 2022 Machine Learning Services (Python a R) ve Windows nebo instalace služby SQL Server Machine Learning Services (Python a R) v Linuxu.

Požadavky

Před instalací vlastního modulu runtime jazyka R nainstalujte následující:

Instalace jazykových rozšíření

Poznámka:

Pokud máte na SQL Serveru 2019 nainstalovanou službu Machine Learning Services , je už nainstalovaná jazyková rozšíření a můžete tento krok přeskočit.

Postupujte podle následujících kroků a nainstalujte SQL Server Language Extensions, které se používají pro vlastní runtime prostředí jazyka R.

  1. Spusťte průvodce instalací pro SQL Server 2019.

  2. Na kartě Instalace vyberte Samostatná instalace Nového SQL Serveru nebo přidejte funkce do existující instalace.

  3. Na stránce Výběr funkcí vyberte tyto možnosti:

    • Služby databázového stroje

      Pokud chcete používat jazyková rozšíření s SQL Serverem, musíte nainstalovat instanci databázového stroje. Můžete použít novou nebo existující instanci.

    • Služby strojového učení a rozšíření jazyka

      Vyberte Machine Learning Services a Jazykové rozšíření. Nevybírejte R, protože později nainstalujete vlastní prostředí runtime pro R.

      Nastavení jazykových rozšíření SQL Serveru 2019

  4. Na stránce Připraveno k instalaci ověřte, že jsou tyto možnosti zahrnuté, a vyberte Nainstalovat.

    • Služby databázového stroje
    • Machine Learning Services a rozšíření jazyka
  5. Po dokončení instalace restartujte počítač, pokud se k tomu zobrazí výzva.

Důležité

Pokud nainstalujete novou instanci SQL Serveru 2019 s jazykovými rozšířeními, nainstalujte kumulativní aktualizaci (CU) 3 nebo novější , než budete pokračovat dalším krokem.

Nainstalovat R

Stáhněte a nainstalujte verzi jazyka R, kterou použijete jako vlastní modul runtime. Podporuje se R verze 3.3 nebo novější.

  1. Stáhněte si R verze 3.3 nebo novější.

  2. Spusťte instalační program jazyka R.

  3. Poznamenejte si cestu, kde je nainstalovaný jazyk R. Například v tomto článku je to C:\Program Files\R\R-4.0.3.

    Nastavení jazyka R

Aktualizace proměnné systémového prostředí

Pomocí těchto kroků upravte proměnné systémového prostředí PATH .

  1. Ve vyhledávacím poli systému Windows vyhledejte upravit proměnné systémového prostředí a otevřete ho.

  2. V části Upřesnit vyberte Proměnné prostředí.

  3. Upravte systémovou proměnnou prostředí PATH .

    Vyberte PATH a klikněte na Upravit.

    Vyberte Nový a přidejte cestu ke \bin\x64 složce v instalační cestě R. Například: C:\Program Files\R\R-4.0.3\bin\x64.

Instalace balíčku Rcpp

Pokud chcete nainstalovat balíček Rcpp , postupujte podle těchto kroků.

  1. Spusťte příkazový řádek se zvýšenými oprávněními (spusťte ho jako správce).

  2. Spusťte R z příkazového řádku. Spusťte \bin\R.exe ve složce v instalační cestě R. Například: C:\Program Files\R\R-4.0.3\bin\R.exe.

    "C:\Program Files\R\R-4.0.3\bin\R.exe"
    
  3. Spuštěním následujícího skriptu nainstalujte balíček Rcpp do \library složky v instalační cestě R. Například: C:\Program Files\R\R-4.0.3\library.

    install.packages("Rcpp", lib="C:\\Program Files\\R\\R-4.0.3\\library");
    

Udělení přístupu ke složce R

Poznámka:

Pokud jste jazyk R nainstalovali do výchozího C:\Program Files\R\R-version umístění (například C:\Program Files\R\R-4.0.3), můžete tento krok přeskočit.

Spuštěním následujících příkazů icacls z nového příkazového řádku se zvýšenými oprávněními udělte oprávnění READ &EXECUTE k uživatelskému jménu služby LAUNCHPAD SYSTÉMU SQL Server a identifikátoru SID S-1-15-2-1 (všechny balíčky aplikací). Uživatelské jméno služby launchpad je ve formuláři NT Service\MSSQLLAUNCHPAD$INSTANCENAME , kde INSTANCENAME je název instance vašeho SQL Serveru.

Příkazy rekurzivně udělují přístup ke všem souborům a složkám v dané cestě k adresáři.

  1. Udělte oprávnění uživatelskému jménu služby SQL Server Launchpad k instalační cestě R. Například: C:\Program Files\R\R-4.0.3.

    icacls "C:\Program Files\R\R-4.0.3" /grant "NT Service\MSSQLLAUNCHPAD":(OI)(CI)RX /T
    

    Pro pojmenovanou instanci, kde je příkaz icacls "C:\Program Files\R\R-4.0.3" /grant "NT Service\MSSQLLAUNCHPAD$SQL01":(OI)(CI)RX /T, platí pro instanci nazvanou SQL01.

  2. Udělte oprávnění SID S-1-15-2-1 k instalační cestě R. Například: C:\Program Files\R\R-4.0.3.

    icacls "C:\Program Files\R\R-4.0.3" /grant *S-1-15-2-1:(OI)(CI)RX /T
    

    Předchozí příkaz uděluje oprávnění k identifikátoru SID počítače S-1-15-2-1, což odpovídá všem balíčkům aplikací v anglické verzi Systému Windows. Alternativně můžete použít icacls "C:\Program Files\R\R-4.0.3" /grant "ALL APPLICATION PACKAGES":(OI)(CI)RX /T v anglické verzi Windows.

Restartování spouštěcího panelu SQL Serveru

Chcete-li restartovat službu Launchpad SYSTÉMU SQL Server, postupujte podle těchto kroků.

  1. Otevřete SQL Server Configuration Manager.

  2. V části Služby SQL Serveru klikněte pravým tlačítkem na SQL Server Launchpad (MSSQLSERVER) a vyberte Restartovat. Pokud používáte pojmenovanou instanci, zobrazí se místo (MSSQLSERVER) název instance.

Registrace rozšíření jazyka

Podle těchto kroků stáhněte a zaregistrujte rozšíření jazyka R, které se používá pro vlastní modul runtime jazyka R.

  1. Stáhněte si souborR-lang-extension-windows-release.zip z úložiště SQL Server Language Extensions na GitHubu.

    Alternativně můžete použít ladicí verzi (R-lang-extension-windows-debug.zip) ve vývojovém nebo testovacím prostředí. Ladicí verze poskytuje podrobný protokolovací výstup pro zkoumání chyb a nedoporučuje se pro produkční prostředí.

  2. Pomocí nástroje Azure Data Studio se připojte k instanci SQL Serveru a spuštěním následujícího příkazu T-SQL zaregistrujte rozšíření jazyka R v jazyce CREATE EXTERNAL LANGUAGE.

    Upravte cestu v tomto příkazu tak, aby odrážela umístění staženého souboru ZIP s příponou jazyka (R-lang-extension-windows-release.zip) a umístění vaší instalace jazyka R (C:\\Program Files\\R\\R-4.0.3).

    CREATE EXTERNAL LANGUAGE [myR]
    FROM (CONTENT = N'C:\path\to\R-lang-extension-windows-release.zip', 
        FILE_NAME = 'libRExtension.dll',
        ENVIRONMENT_VARIABLES = N'{"R_HOME": "C:\\Program Files\\R\\R-4.0.3"}');
    GO
    

    Spusťte příkaz pro každou databázi, ve které chcete použít rozšíření jazyka R.

    Poznámka:

    R je rezervované slovo a nedá se použít jako název nového názvu externího jazyka. Místo toho použijte jiný název. Například výše uvedený příkaz používá myR.

Požadavky

Před instalací vlastního modulu runtime R nainstalujte následující požadavky:

Instalace jazykových rozšíření

Poznámka:

Pokud máte na SQL Serveru 2019 nainstalovanou službu Machine Learning Services , je už nainstalovaný balíček rozšíření mssql-server pro rozšíření jazyka a můžete tento krok přeskočit.

Spuštěním následujících příkazů nainstalujte sql Server Language Extensions v Ubuntu Linuxu, který se používá pro vlastní modul runtime jazyka R.

  1. Pokud je to možné, spusťte tento příkaz a aktualizujte balíčky v systému před instalací.

    # Install as root or sudo
    sudo apt-get update
    
  2. Pomocí tohoto příkazu nainstalujte mssql-server-extensibility.

    # Install as root or sudo
    sudo apt-get install mssql-server-extensibility
    

Nainstalovat R

  1. Pokud máte službu Machine Learning Services nainstalovanou, jazyk R je již nainstalován v /opt/microsoft/ropen/3.5.2/lib64/Rsystému . Pokud chcete tuto cestu dál používat jako R_HOME, můžete tento krok přeskočit.

    Pokud chcete použít jiný modul runtime jazyka R, musíte nejprve odebrat microsoft-r-open-mro , než budete pokračovat v instalaci nové verze.

    sudo apt remove microsoft-r-open-mro-3.5.2
    
  2. Nainstalujte R (3.3 nebo novější) pro Ubuntu. Ve výchozím nastavení je jazyk R nainstalovaný v /usr/lib/R. Tato cesta je vaše R_HOME. Pokud R nainstalujete do jiného umístění, poznamenejte si tuto cestu jako R_HOME.

    Níže jsou uvedeny ukázkové pokyny pro Ubuntu. Změňte níže adresu URL úložiště pro vaši verzi jazyka R.

    export DEBIAN_FRONTEND=noninteractive
    sudo apt-get update
    sudo apt-get --no-install-recommends -y install curl zip unzip apt-transport-https libstdc++6
    
    # Add R CRAN repository. This repository works for R 4.0.x.
    #
    sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys E298A3A825C0D65DFD57CBB651716619E084DAB9
    sudo add-apt-repository 'deb https://cloud.r-project.org/bin/linux/ubuntu xenial-cran40/'
    sudo apt-get update
    
    # Install R runtime.
    #
    sudo apt-get -y install r-base-core
    

Vlastní instalace jazyka R

Poznámka:

Pokud jste jazyk R nainstalovali do výchozího umístění /usr/lib/R, můžete tuto část přeskočit a přejít k části Instalace balíčku Rcpp .

Aktualizace proměnných prostředí

Nejprve upravte službu mssql-launchpadd a přidejte do souboru proměnnou prostředí R_HOME . /etc/systemd/system/mssql-launchpadd.service.d/override.conf

  1. Otevření souboru pomocí systemctl

    sudo systemctl edit mssql-launchpadd
    
  2. Do souboru, který se otevře, vložte následující text /etc/systemd/system/mssql-launchpadd.service.d/override.conf . Nastavte hodnotu R_HOME na vlastní instalační cestu jazyka R.

    [Service]
    Environment="R_HOME=<path to R>"
    
  3. Uložte a zavřete.

Dále se ujistěte, že libR.so je možné načíst.

  1. Vytvořte soubor custom-r.conf v souboru /etc/ld.so.conf.d.

    sudo vi /etc/ld.so.conf.d/custom-r.conf
    
  2. Do souboru, který se otevře, přidejte cestu k libR.so z vlastní instalace jazyka R.

    <path to the R lib>
    
  3. Uložte nový soubor a zavřete editor.

  4. Spusťte ldconfig a ověřte, že pomocí následujícího příkazu lze načíst libR.so a že všechny závislé knihovny mohou být nalezeny.

    sudo ldconfig
    ldd <path to the R lib>/libR.so
    

Udělení přístupu k vlastní instalační složce jazyka R

Nastavte možnost datadirectories v oddílu rozšiřitelnosti souboru /var/opt/mssql/mssql.conf na vlastní instalaci jazyka R.

sudo /opt/mssql/bin/mssql-conf set extensibility.datadirectories <path to R>

Restartování služby mssql-launchpadd

Spuštěním následujícího příkazu restartujte mssql-launchpadd.

sudo systemctl restart mssql-launchpadd

Instalace balíčku Rcpp

Pokud chcete nainstalovat balíček Rcpp , postupujte podle těchto kroků.

  1. Spusťte R z příkazového řádku:

    sudo ${R_HOME}/bin/R
    
  2. Spuštěním následujícího skriptu nainstalujte balíček Rcpp do složky ${R_HOME}\library.

install.packages("Rcpp", lib = "${R_HOME}/library");

Zaregistrujte rozšíření jazyka

Podle těchto kroků stáhněte a zaregistrujte rozšíření jazyka R, které se používá pro vlastní modul runtime jazyka R.

  1. Stáhněte si souborR-lang-extension-linux-release.zip z úložiště SQL Server Language Extensions na GitHubu.

    Alternativně můžete použít ladicí verzi (R-lang-extension-linux-debug.zip) ve vývojovém nebo testovacím prostředí. Ladicí verze poskytuje podrobný protokolovací výstup pro analýzu chyb a nedoporučuje se pro produkční prostředí.

  2. Pomocí nástroje Azure Data Studio se připojte k instanci SQL Serveru a spuštěním následujícího příkazu T-SQL zaregistrujte rozšíření jazyka R v jazyce CREATE EXTERNAL LANGUAGE.

    Upravte cestu v tomto příkazu tak, aby odrážela umístění staženého souboru ZIP s příponou jazyka (R-lang-extension-linux-release.zip).

    CREATE EXTERNAL LANGUAGE [myR]
    FROM (CONTENT = N'/path/to/R-lang-extension-linux-release.zip', FILE_NAME = 'libRExtension.so.1.1');
    GO
    

    Spusťte příkaz pro každou databázi, ve které chcete použít rozšíření jazyka R.

    Poznámka:

    R je rezervované slovo a nedá se použít jako název nového názvu externího jazyka. Místo toho použijte jiný název. Například výše uvedený příkaz používá myR.

Požadavky

Před instalací vlastního modulu runtime R nainstalujte následující požadavky:

  • RExtension vyžaduje GLIBCXX_3.4.20. Ujistěte se, že verze knihovny libstdc++.so.6 na vaší instalaci Red Hat Enterprise Linux (RHEL) toto poskytuje.

Instalace jazykových rozšíření

Poznámka:

Pokud máte na SQL Serveru 2019 nainstalovanou službu Machine Learning Services , je už nainstalovaný balíček rozšíření mssql-server pro rozšíření jazyka a můžete tento krok přeskočit.

Spuštěním následujícího příkazu nainstalujte sql Server Language Extensions na Red Hat Enterprise Linux (RHEL), který se používá pro vlastní modul runtime jazyka R.

# Install as root or sudo
sudo yum install mssql-server-extensibility

Nainstalujte R

  1. Pokud máte službu Machine Learning Services nainstalovanou, jazyk R je již nainstalován v /opt/microsoft/ropen/3.5.2/lib64/Rsystému . Pokud chcete tuto cestu dál používat jako R_HOME, můžete tento krok přeskočit.

    Pokud chcete použít jiný modul runtime jazyka R, musíte nejprve odebrat microsoft-r-open-mro, předtím, než budete pokračovat v instalaci nové verze.

    sudo yum erase microsoft-r-open-mro-3.5.2
    
  2. Nainstalujte R (3.3 nebo novější) pro Red Hat Enterprise Linux (RHEL). Ve výchozím nastavení je jazyk R nainstalovaný v /usr/lib64/R. Tato cesta je vaše R_HOME. Pokud R nainstalujete do jiného umístění, poznamenejte si tuto cestu jako R_HOME.

    sudo yum install -y R
    

Vlastní instalace jazyka R

Poznámka:

Pokud jste jazyk R nainstalovali do výchozího umístění /usr/lib/R, můžete tuto část přeskočit a přejít k části Instalace balíčku Rcpp .

Aktualizace proměnných prostředí

Nejprve upravte službu mssql-launchpadd a přidejte do souboru proměnnou prostředí R_HOME . /etc/systemd/system/mssql-launchpadd.service.d/override.conf

  1. Otevření souboru pomocí systemctl

    sudo systemctl edit mssql-launchpadd
    
  2. Do souboru, který se otevře, vložte následující text /etc/systemd/system/mssql-launchpadd.service.d/override.conf . Nastavte hodnotu R_HOME na vlastní instalační cestu jazyka R.

    [Service]
    Environment="R_HOME=<path to R>"
    
  3. Uložte a zavřete.

Dále se ujistěte, že libR.so je možné načíst.

  1. Vytvořte soubor custom-r.conf v souboru /etc/ld.so.conf.d.

    sudo vi /etc/ld.so.conf.d/custom-r.conf
    
  2. Do souboru, který se otevře, přidejte cestu k libR.so z vlastní instalace jazyka R.

    <path to the R lib>
    
  3. Uložte nový soubor a zavřete editor.

  4. Spusťte ldconfig a ověřte, že načtení libR.so je možné, spuštěním následujícího příkazu a kontrolou, zda mohou být nalezeny všechny závislé knihovny.

    sudo ldconfig
    ldd <path to the R lib>/libR.so
    

Udělení přístupu k vlastní instalační složce jazyka R

Nastavte možnost datadirectories v oddílu rozšiřitelnosti /var/opt/mssql/mssql.conf souboru na vlastní instalaci jazyka R.

sudo /opt/mssql/bin/mssql-conf set extensibility.datadirectories <path to R>

Restartování služby mssql-launchpadd

Spuštěním následujícího příkazu restartujte mssql-launchpadd.

sudo systemctl restart mssql-launchpadd

Instalace balíčku Rcpp

Pokud chcete nainstalovat balíček Rcpp , postupujte podle těchto kroků.

  1. Spusťte R z příkazového řádku:

    sudo ${R_HOME}/bin/R
    
  2. Spuštěním následujícího skriptu nainstalujte balíček Rcpp do složky ${R_HOME}\library.

install.packages("Rcpp", lib = "${R_HOME}/library");

Registrace jazykového rozšíření

Podle těchto kroků stáhněte a zaregistrujte rozšíření jazyka R, které se používá pro vlastní modul runtime jazyka R.

  1. Stáhněte si souborR-lang-extension-linux-release.zip z úložiště SQL Server Language Extensions na GitHubu.

    Alternativně můžete použít ladicí verzi (R-lang-extension-linux-debug.zip) ve vývojovém nebo testovacím prostředí. Ladicí verze poskytuje podrobné informace o protokolování pro zkoumání chyb a nedoporučuje se pro produkční prostředí.

  2. Pomocí nástroje Azure Data Studio se připojte k instanci SQL Serveru a spuštěním následujícího příkazu T-SQL zaregistrujte rozšíření jazyka R v jazyce CREATE EXTERNAL LANGUAGE.

    Upravte cestu v tomto příkazu tak, aby odrážela umístění staženého souboru ZIP s příponou jazyka (R-lang-extension-linux-release.zip).

    CREATE EXTERNAL LANGUAGE [myR]
    FROM (CONTENT = N'/path/to/R-lang-extension-linux-release.zip', FILE_NAME = 'libRExtension.so.1.1');
    GO
    

    Spusťte příkaz pro každou databázi, ve které chcete použít rozšíření jazyka R.

    Poznámka:

    R je rezervované slovo a nedá se použít jako název nového názvu externího jazyka. Místo toho použijte jiný název. Například výše uvedený příkaz používá myR.

Požadavky

Před instalací vlastního modulu runtime R nainstalujte následující požadavky:

Instalace jazykových rozšíření

Poznámka:

Pokud máte na SQL Serveru 2019 nainstalovanou službu Machine Learning Services , je už nainstalovaný balíček rozšíření mssql-server pro rozšíření jazyka a můžete tento krok přeskočit.

Spuštěním následujícího příkazu nainstalujte sql Server Language Extensions na SUSE Linux Enterprise Server (SLES), který se používá pro vlastní modul runtime jazyka R.

# Install as root or sudo
sudo zypper install mssql-server-extensibility

Nainstalovat R

  1. Pokud máte službu Machine Learning Services nainstalovanou, jazyk R je již nainstalován v /opt/microsoft/ropen/3.5.2/lib64/Rsystému . Pokud chcete tuto cestu dál používat jako R_HOME, můžete tento krok přeskočit.

    Pokud chcete použít jiný modul runtime jazyka R, musíte nejprve odebrat microsoft-r-open-mro , než budete pokračovat v instalaci nové verze.

    sudo zypper remove microsoft-r-open-mro-3.4.4
    
  2. Nainstalujte R (3.3 nebo novější) pro SUSE Linux Enterprise Server (SLES). Ve výchozím nastavení je jazyk R nainstalovaný v /usr/lib64/R. Tato cesta je vaše R_HOME. Pokud R nainstalujete do jiného umístění, poznamenejte si tuto cestu jako R_HOME.

    Při instalaci jazyka R postupujte takto:

    sudo zypper ar -f http://download.opensuse.org/repositories/devel:/languages:/R:/patched/openSUSE_12.3/ R-patched
    sudo zypper --gpg-auto-import-keys ref
    sudo zypper install R-core-libs R-core R-core-doc R-patched
    

    Upozornění pro R-tcltk-3.6.1 můžete ignorovat, pokud tento balíček nepotřebujete.

Instalace knihovny gcc-c++

Nainstalujte gcc-c++ na SUSE Linux Enterprise Server (SLES). Používá se pro Rcpp, který se nainstaluje později.

sudo zypper install gcc-c++

Vlastní instalace jazyka R

Poznámka:

Pokud jste jazyk R nainstalovali do výchozího umístění /usr/lib/R, můžete tuto část přeskočit a přejít k části Instalace balíčku Rcpp .

Aktualizace proměnných prostředí

Nejprve upravte službu mssql-launchpadd a přidejte do souboru proměnnou prostředí R_HOME . /etc/systemd/system/mssql-launchpadd.service.d/override.conf

  1. Otevření souboru pomocí systemctl

    sudo systemctl edit mssql-launchpadd
    
  2. Do souboru, který se otevře, vložte následující text /etc/systemd/system/mssql-launchpadd.service.d/override.conf . Nastavte hodnotu R_HOME na vlastní instalační cestu jazyka R.

    [Service]
    Environment="R_HOME=<path to R>"
    
  3. Uložte a zavřete.

Dále se ujistěte, že libR.so je možné načíst.

  1. Vytvořte soubor custom-r.conf v souboru /etc/ld.so.conf.d.

    sudo vi /etc/ld.so.conf.d/custom-r.conf
    
  2. Do souboru, který se otevře, přidejte cestu k libR.so z vlastní instalace jazyka R.

    <path to the R lib>
    
  3. Uložte nový soubor a zavřete editor.

  4. Spusťte ldconfig a ověřte načtení libR.so tím, že zkontrolujete, zda je možné najít všechny závislé knihovny po spuštění následujícího příkazu.

    sudo ldconfig
    ldd <path to the R lib>/libR.so
    

Udělení přístupu k vlastní instalační složce jazyka R

Nastavte možnost datadirectories v sekci rozšiřitelnosti souboru /var/opt/mssql/mssql.conf na vlastní instalaci R.

sudo /opt/mssql/bin/mssql-conf set extensibility.datadirectories <path to R>

Restartování služby mssql-launchpadd

Spuštěním následujícího příkazu restartujte mssql-launchpadd.

sudo systemctl restart mssql-launchpadd

Instalace balíčku Rcpp

Pokud chcete nainstalovat balíček Rcpp , postupujte podle těchto kroků.

  1. Spusťte R z příkazového řádku:

    sudo ${R_HOME}/bin/R
    
  2. Spuštěním následujícího skriptu nainstalujte balíček Rcpp do složky ${R_HOME}\library.

install.packages("Rcpp", lib = "${R_HOME}/library");

Registrace jazykového rozšíření

Podle těchto kroků stáhněte a zaregistrujte rozšíření jazyka R, které se používá pro vlastní modul runtime jazyka R.

  1. Stáhněte si souborR-lang-extension-linux-release.zip z úložiště SQL Server Language Extensions na GitHubu.

    Alternativně můžete použít ladicí verzi (R-lang-extension-linux-debug.zip) ve vývojovém nebo testovacím prostředí. Ladicí verze poskytuje podrobné informace o protokolování pro zkoumání chyb a nedoporučuje se pro produkční prostředí.

  2. Pomocí nástroje Azure Data Studio se připojte k instanci SQL Serveru a spuštěním následujícího příkazu T-SQL zaregistrujte rozšíření jazyka R v jazyce CREATE EXTERNAL LANGUAGE.

    Upravte cestu v tomto příkazu tak, aby odrážela umístění staženého souboru ZIP s příponou jazyka (R-lang-extension-linux-release.zip).

    CREATE EXTERNAL LANGUAGE [myR]
    FROM (CONTENT = N'/path/to/R-lang-extension-linux-release.zip', FILE_NAME = 'libRExtension.so.1.1');
    GO
    

    Spusťte příkaz pro každou databázi, ve které chcete použít rozšíření jazyka R.

    Poznámka:

    R je rezervované slovo a nedá se použít jako název nového názvu externího jazyka. Místo toho použijte jiný název. Například výše uvedený příkaz používá myR.

Povolení externího skriptu

Externí skript jazyka R můžete spustit pomocí uložené procedury sp_execute_external skriptu.

Pokud chcete povolit externí skripty, spusťte následující příkaz pomocí nástroje Azure Data Studio .

sp_configure 'external scripts enabled', 1;
RECONFIGURE WITH OVERRIDE;  

Ověření instalace

Pomocí následujícího skriptu SQL ověřte instalaci a funkčnost vlastního modulu runtime jazyka R. V následujícím ukázkovém skriptu se jako název jazyka používá myR, protože výchozí název jazyka R nelze pro vlastní modul runtime poskytnout.

EXEC sp_execute_external_script
    @language =N'myR',
    @script=N'
print(R.home());
print(file.path(R.home("bin"), "R"));
print(R.version);
print("Hello RExtension!");'

Známé problémy

Pokud používáte runtime R poskytovaný jako součást SQL Server Machine Learning Services nastavením R_HOME při C:\Program Files\Microsoft SQL Server\MSSQL15.<INSTANCE_NAME>\R_SERVICES registraci rozšíření jazyka, můžete při spuštění jakéhokoli externího vlastního skriptu R pomocí sp_execute_external skript narazit na následující chybu.

Chyba: Konzolová paměť vyčerpána (dosažen limit?)

Řešení tohoto problému:

  1. Nastavte proměnnou R_NSIZE prostředí označující počet objektů s pevnou velikostí (cons cells) na přiměřenou hodnotu, 200000například .
  2. Restartujte službu Launchpad a opakujte spuštění skriptu.

Známé problémy

Pokud libstdc++.so.6 není správná verze, zobrazí se tato chyba:

Exthost: Načtení rozšíření selhalo /lib64/libstdc++.so.6: verze GLIBCXX_3.4.20 nebyla nalezena (požadováno uživatelem /home/mssql_satellite/externallanguagessandboxpath/libRExtension.so.1.1)

Další kroky