Egyéni R-futtatókörnyezet telepítése AZ SQL Serverhez

A következőkre vonatkozik: SQL Server 2019 (15.x)

Megtudhatja, hogyan telepíthet egyéni R-futtatókörnyezetet külső R-szkriptek SQL Serveren való futtatásához:

• Windows
• Ubuntu Linux
• Red Hat Enterprise Linux (RHEL)
• SUSE Linux Enterprise Server (SLES) 12-es verzió

Az egyéni futtatókörnyezet futtathat gépi tanulási szkripteket, és használhatja az SQL Server nyelvi bővítményeit.

Az SQL Server Machine Learning Services szolgáltatással telepített alapértelmezett futtatókörnyezeti verzió helyett használja az R-futtatókörnyezet saját verzióját az SQL Serverrel.

Az SQL Server 2022 -től (16.x) kezdődően az R, Python és Java futtatókörnyezetek már nincsenek telepítve az SQL-beállítással. Ehelyett telepítse a kívánt egyéni R-futtatókörnyezetet és csomagokat. További információ: Az SQL Server 2022 Machine Learning Services (Python és R) telepítése Windows rendszeren vagy AZ SQL Server Machine Learning Services (Python és R) telepítése Linuxra.

Előfeltételek

Egyéni R-futtatókörnyezet telepítése előtt telepítse a következőket:

• Ha meglévő SQL Server-példányt használ, telepítse az SQL Server 2019 3- vagy újabb kumulatív frissítését (CU ).

Nyelvi bővítmények telepítése

Megjegyzés:

Ha a Machine Learning Services telepítve van az SQL Server 2019-ben, a Language Extensions már telepítve van, és kihagyhatja ezt a lépést.

Kövesse az alábbi lépéseket az EGYÉNI R-futtatókörnyezethez használt SQL Server Language Extensions telepítéséhez.

1. Indítsa el az SQL Server 2019 telepítővarázslót.

2. A Telepítés lapon válassza az Új SQL Server önálló telepítését, vagy adjon hozzá funkciókat egy meglévő telepítéshez.

3. A Funkciókijelölés lapon válassza az alábbi beállításokat:

   • Adatbázismotor-szolgáltatások

     A Language Extensions SQL Serverrel való használatához telepítenie kell az adatbázismotor egy példányát. Használhat új vagy meglévő példányt is.

   • Machine Learning Services és nyelvi bővítmények

     Válassza a Machine Learning Services és a Nyelvi bővítmények lehetőséget. Ne válassza az R lehetőséget, mert az egyéni R-futtatókörnyezetet később telepíti.

     

4. A Telepítésre kész lapon ellenőrizze, hogy ezek a beállítások szerepelnek-e, majd válassza a Telepítés lehetőséget.

   • Adatbázismotor-szolgáltatások
   • Machine Learning Services és nyelvi bővítmények

5. Ha a telepítés befejeződött, indítsa újra a gépet, ha erre kérik.

Fontos

Ha az SQL Server 2019 új példányát nyelvi bővítményekkel telepíti, akkor a következő lépés folytatása előtt telepítse a 3. kumulatív frissítést (CU ).

Az R telepítése

Töltse le és telepítse az egyéni futtatókörnyezetként használni kívánt R-verziót. Az R 3.3-es vagy újabb verziója támogatott.

1. Töltse le az R 3.3-es vagy újabb verzióját.

2. Futtassa az R-beállítást.

3. Jegyezze fel az R telepítésének elérési útját. Például ebben a cikkben az C:\Program Files\R\R-4.0.3.

   

A rendszer környezeti változóinak frissítése

Kövesse az alábbi lépéseket a PATH rendszer környezeti változóinak módosításához.

1. A Windows keresőmezőjében keresse meg A rendszerkörnyezet változóinak szerkesztése elemet, majd nyissa meg.

2. A Speciális területen válassza a Környezeti változók lehetőséget.

3. Módosítsa a PATH rendszer környezeti változót.

   Válassza a PATH lehetőséget, és kattintson a Szerkesztés gombra.

   Válassza az Új lehetőséget, és adja hozzá az elérési utat a \bin\x64 mappához az R telepítési útvonalán. Például: C:\Program Files\R\R-4.0.3\bin\x64.

Rcpp-csomag telepítése

Az Rcpp-csomag telepítéséhez kövesse az alábbi lépéseket.

1. Rendszergazdai jogú parancssor indítása (futtatás rendszergazdaként).

2. Indítsa el az R parancsot a parancssorból. Futtassa \bin\R.exe az R telepítési útvonalán lévő mappában. Például: C:\Program Files\R\R-4.0.3\bin\R.exe.

   "C:\Program Files\R\R-4.0.3\bin\R.exe"
   

3. Futtassa a következő szkriptet, hogy telepítse az Rcpp csomagot az R telepítési útvonalában található \library mappába. Például: C:\Program Files\R\R-4.0.3\library.

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

Hozzáférés biztosítása az R mappához

Megjegyzés:

Ha az R-t az alapértelmezett helyen (például) telepítette C:\Program Files\R\R-version , C:\Program Files\R\R-4.0.3kihagyhatja ezt a lépést.

Futtassa a következő icacls-parancsokat egy új rendszergazda jogú parancssorból, hogy READ & EXECUTE hozzáférést biztosítson az SQL Server Launchpad Service felhasználónevének és a SID S-1-15-2-1 (MINDEN ALKALMAZÁSCSOMAG). A launchpad szolgáltatás felhasználóneve olyan formátumú, mint NT Service\MSSQLLAUNCHPAD$INSTANCENAME, ahol INSTANCENAME az SQL Server példányneve.

A parancsok rekurzív módon biztosítják a hozzáférést az adott könyvtár elérési útja alatt lévő összes fájlhoz és mappához.

1. Adjon engedélyeket az SQL Server Launchpad Service felhasználónevének az R telepítési útvonalához. Például: 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
   

   Az elnevezett példány esetében a parancs egy icacls "C:\Program Files\R\R-4.0.3" /grant "NT Service\MSSQLLAUNCHPAD$SQL01":(OI)(CI)RX /T nevű példányhoz lesz.

2. Adjon engedélyeket a SID S-1-15-2-1-nek az R telepítési útvonalához. Például: 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
   

   Az előző parancs engedélyeket ad a SID S-1-15-2-1 számítógépnek, amely egyenértékű a Windows angol verziójában elérhető ÖSSZES ALKALMAZÁSCSOMAGgal . Másik lehetőségként használhatja icacls "C:\Program Files\R\R-4.0.3" /grant "ALL APPLICATION PACKAGES":(OI)(CI)RX /T a Windows angol verzióját is.

Az SQL Server launchpad újraindítása

Kövesse az alábbi lépéseket az SQL Server Launchpad szolgáltatás újraindításához.

1. Nyissa meg SQL Server Configuration Manager.

2. Az SQL Server Services területen kattintson a jobb gombbal az SQL Server Launchpadre (MSSQLSERVER), és válassza az Újraindítás lehetőséget. Ha nevesített példányt használ, a példány neve az (MSSQLSERVER) helyett jelenik meg.

Nyelvi bővítmény regisztrálása

Ezeket a lépéseket követve töltse le és regisztrálja az R egyéni futtatókörnyezethez használt R nyelvi bővítményt.

1. Töltse le a R-lang-extension-windows-release.zip fájlt az SQL Server Language Extensions GitHub-adattárból.

   A hibakeresési verziót (R-lang-extension-windows-debug.zip) fejlesztési vagy tesztelési környezetben is használhatja. A hibakeresési verzió részletes naplózási információkat biztosít a hibák kivizsgálásához, és éles környezetekben nem ajánlott.

2. Az Azure Data Studio használatával csatlakozzon az SQL Server-példányhoz, és futtassa a következő T-SQL-parancsot az R nyelvi bővítmény regisztrálásához a CREATE EXTERNAL LANGUAGE használatával.

   Módosítsa az ebben az utasításban szereplő elérési utat úgy, hogy tükrözze a letöltött nyelvbővítmény zip-fájljának helyét (R-lang-extension-windows-release.zip) és az R-telepítés helyét (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
   

   Hajtsa végre az utasítást minden olyan adatbázishoz, amelyben az R nyelvi bővítményt használni szeretné.

   Megjegyzés:

   Az R egy fenntartott szó, és nem használható új külső nyelvnév neveként. Ehelyett használjon másik nevet. A fenti utasítás például a myR-t használja.

Előfeltételek

Egyéni R-futtatókörnyezet telepítése előtt telepítse a következő előfeltételeket:

• Telepítse az SQL Server 2019-et (15.x) Linuxhoz. Az SQL Servert a Red Hat Enterprise Linux (RHEL), a SUSE Linux Enterprise Server (SLES) és az Ubuntu rendszerre is telepítheti. További információkért tekintse meg a Linuxon futó SQL Server telepítési útmutatóját.

• Frissítés az SQL Server 2019 3- vagy újabb kumulatív frissítésére (CU) (15.x). Kövesse az alábbi lépéseket:

  1. Konfigurálja a kumulatív frissítések adattárait. További információ: Adattárak konfigurálása az SQL Server linuxosvaló telepítéséhez és frissítéséhez.

  2. Frissítse az mssql-server csomagot a legújabb összegző frissítésre. További információkért tekintse meg a Linuxon futó SQL Server telepítési útmutatójának SQL Server frissítésével vagy frissítésével foglalkozó szakaszát.

Nyelvi bővítmények telepítése

Megjegyzés:

Ha a Machine Learning Services telepítve van az SQL Server 2019-en, a Language Extensions mssql-server bővíthetőségi csomagja már telepítve van, és kihagyhatja ezt a lépést.

Futtassa az alábbi parancsokat az SQL Server Language Extensions Ubuntu Linux rendszeren való telepítéséhez, amely az R egyéni futtatókörnyezetéhez használatos.

1. Ha lehetséges, futtassa ezt a parancsot a csomagok frissítéséhez a rendszeren a telepítés előtt.

   # Install as root or sudo
   sudo apt-get update
   

2. Telepítse az mssql-server-bővíthetőséget ezzel a paranccsal.

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

Az R telepítése

1. Ha telepítve van a Machine Learning Services, az R már telepítve van./opt/microsoft/ropen/3.5.2/lib64/R Ha továbbra is ezt az elérési utat szeretné használni R_HOME, kihagyhatja ezt a lépést.

   Ha más R-futtatókörnyezetet szeretne használni, először el kell távolítania microsoft-r-open-mro mielőtt folytatná az új verzió telepítését.

   sudo apt remove microsoft-r-open-mro-3.5.2
   

2. Telepítse az R -t (3.3 vagy újabb) az Ubuntu-hoz. Alapértelmezés szerint az R telepítve van a /usr/lib/R fájlban. Ez az elérési út a R_HOME. Ha az R-t egy másik helyre telepíti, jegyezze fel ezt az útvonalat R_HOME.

   Az alábbiakban az Ubuntura vonatkozó példautasítások találhatók. Módosítsa az alábbi adattár URL-címét az R verziójához.

   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
   

Az R egyéni telepítése

Megjegyzés:

Ha az R-t az /usr/lib/R alapértelmezett helyén telepítette, kihagyhatja ezt a szakaszt, és továbbléphet az Rcpp-csomag telepítése szakaszra.

A környezeti változók frissítése

Először szerkessze az mssql-launchpadd szolgáltatást a R_HOME környezeti változó fájlhoz való hozzáadásához /etc/systemd/system/mssql-launchpadd.service.d/override.conf

1. A fájl megnyitása systemctl használatával

   sudo systemctl edit mssql-launchpadd
   

2. Szúrja be a következő szöveget a /etc/systemd/system/mssql-launchpadd.service.d/override.conf megnyíló fájlba. Állítsa be a R_HOME értékét az egyéni R telepítési útvonalra.

   [Service]
   Environment="R_HOME=<path to R>"
   

3. Mentse el és zárja be.

Ezután győződjön meg arról, hogy libR.so betölthető.

1. Hozzon létre egy custom-r.conf fájlt a /etc/ld.so.conf.d fájlban.

   sudo vi /etc/ld.so.conf.d/custom-r.conf
   

2. A megnyíló fájlban adja hozzá a libR.so elérési útját az egyéni R-telepítésből.

   <path to the R lib>
   

3. Mentse az új fájlt, és zárja be a szerkesztőt.

4. Futtassa ldconfig, és ellenőrizze, hogy a libR.so betölthető-e az alábbi parancs segítségével, valamint győződjön meg róla, hogy az összes függő kódtár elérhető.

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

Hozzáférés biztosítása az egyéni R telepítési mappához

Állítsa be a datadirectories fájl bővíthetőségi szakaszában /var/opt/mssql/mssql.conf opciót az egyéni R-telepítésre.

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

Az mssql-launchpadd szolgáltatás újraindítása

Futtassa a következő parancsot az mssql-launchpadd újraindításához.

sudo systemctl restart mssql-launchpadd

Rcpp-csomag telepítése

Az Rcpp-csomag telepítéséhez kövesse az alábbi lépéseket.

1. Indítsa el az R-t egy parancssorból.

   sudo ${R_HOME}/bin/R
   

2. Futtassa a következő szkriptet az Rcpp-csomag telepítéséhez a ${R_HOME}\library mappában.

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

Nyelvi bővítmény regisztrálása

Ezeket a lépéseket követve töltse le és regisztrálja az R egyéni futtatókörnyezethez használt R nyelvi bővítményt.

1. Töltse le a R-lang-extension-linux-release.zip fájlt az SQL Server Language Extensions GitHub-adattárból.

   A hibakeresési verziót (R-lang-extension-linux-debug.zip) fejlesztési vagy tesztelési környezetben is használhatja. A hibakeresési verzió részletes naplózási információkat biztosít a hibák kivizsgálásához, és éles környezetekben nem ajánlott.

2. Az Azure Data Studio használatával csatlakozzon az SQL Server-példányhoz, és futtassa a következő T-SQL-parancsot az R nyelvi bővítmény regisztrálásához a CREATE EXTERNAL LANGUAGE használatával.

   Módosítsa az ebben az utasításban szereplő elérési utat a letöltött nyelvbővítmény zip-fájljának (R-lang-extension-linux-release.zip) helyének megfelelően.

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

   Hajtsa végre az utasítást minden olyan adatbázishoz, amelyben az R nyelvi bővítményt használni szeretné.

   Megjegyzés:

   Az R egy fenntartott szó, és nem használható új külső nyelvnév neveként. Ehelyett használjon másik nevet. A fenti utasítás például a myR-t használja.

Előfeltételek

Egyéni R-futtatókörnyezet telepítése előtt telepítse a következő előfeltételeket:

• Telepítse az SQL Server 2019-et (15.x) Linuxhoz. Az SQL Servert a Red Hat Enterprise Linux (RHEL), a SUSE Linux Enterprise Server (SLES) és az Ubuntu rendszerre is telepítheti. További információkért tekintse meg a Linuxon futó SQL Server telepítési útmutatóját.

• Frissítés az SQL Server 2019 3- vagy újabb kumulatív frissítésére (CU) (15.x). Kövesse az alábbi lépéseket:

  1. Konfigurálja a kumulatív frissítések adattárait. További információ: Adattárak konfigurálása az SQL Server linuxosvaló telepítéséhez és frissítéséhez.

  2. Frissítse az mssql-server csomagot a legújabb összegző frissítésre. További információkért tekintse meg a Linuxon futó SQL Server telepítési útmutatójának SQL Server frissítésével vagy frissítésével foglalkozó szakaszát.

• Az RExtension használatához GLIBCXX_3.4.20 szükséges. Győződjön meg arról, hogy a Red Hat Enterprise Linux (RHEL) telepítésekor a libstdc++.so.6 verzió biztosítja ezt.

Nyelvi bővítmények telepítése

Megjegyzés:

Ha a Machine Learning Services telepítve van az SQL Server 2019-en, a Language Extensions mssql-server bővíthetőségi csomagja már telepítve van, és kihagyhatja ezt a lépést.

Futtassa az alábbi parancsot az SQL Server Language Extensions Red Hat Enterprise Linuxra (RHEL) való telepítéséhez, amelyet az R egyéni futtatókörnyezetéhez használnak.

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

Az R telepítése

1. Ha telepítve van a Machine Learning Services, az R már telepítve van./opt/microsoft/ropen/3.5.2/lib64/R Ha továbbra is ezt az elérési utat szeretné használni R_HOME, kihagyhatja ezt a lépést.

   Ha más R-futtatókörnyezetet szeretne használni, először el kell távolítania microsoft-r-open-mro mielőtt folytatná az új verzió telepítését.

   sudo yum erase microsoft-r-open-mro-3.5.2
   

2. Telepítse az R -t (3.3 vagy újabb) Red Hat Enterprise Linuxhoz (RHEL). Alapértelmezés szerint az R telepítve van a /usr/lib64/R fájlban. Ez az elérési út a R_HOME. Ha az R-t egy másik helyre telepíti, jegyezze fel ezt az útvonalat R_HOME.

   sudo yum install -y R
   

Az R egyéni telepítése

Megjegyzés:

Ha az R-t az /usr/lib/R alapértelmezett helyén telepítette, kihagyhatja ezt a szakaszt, és továbbléphet az Rcpp-csomag telepítése szakaszra.

A környezeti változók frissítése

Először szerkessze az mssql-launchpadd szolgáltatást a R_HOME környezeti változó fájlhoz való hozzáadásához /etc/systemd/system/mssql-launchpadd.service.d/override.conf

1. A fájl megnyitása systemctl használatával

   sudo systemctl edit mssql-launchpadd
   

2. Szúrja be a következő szöveget a /etc/systemd/system/mssql-launchpadd.service.d/override.conf megnyíló fájlba. Állítsa be a R_HOME értékét az egyéni R telepítési útvonalra.

   [Service]
   Environment="R_HOME=<path to R>"
   

3. Mentse el és zárja be.

Ezután győződjön meg arról, hogy libR.so betölthető.

1. Hozzon létre egy custom-r.conf fájlt a /etc/ld.so.conf.d fájlban.

   sudo vi /etc/ld.so.conf.d/custom-r.conf
   

2. A megnyíló fájlban adja hozzá a libR.so elérési útját az egyéni R-telepítésből.

   <path to the R lib>
   

3. Mentse az új fájlt, és zárja be a szerkesztőt.

4. Futtassa ldconfig, és ellenőrizze, hogy a libR.so betölthető-e az alábbi parancs segítségével, valamint győződjön meg róla, hogy az összes függő kódtár elérhető.

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

Hozzáférés biztosítása az egyéni R telepítési mappához

Állítsa be a datadirectories fájl bővíthetőségi szakaszában /var/opt/mssql/mssql.conf opciót az egyéni R-telepítésre.

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

Az mssql-launchpadd szolgáltatás újraindítása

Futtassa a következő parancsot az mssql-launchpadd újraindításához.

sudo systemctl restart mssql-launchpadd

Rcpp-csomag telepítése

Az Rcpp-csomag telepítéséhez kövesse az alábbi lépéseket.

1. Indítsa el az R-t egy parancssorból.

   sudo ${R_HOME}/bin/R
   

2. Futtassa a következő szkriptet az Rcpp-csomag telepítéséhez a ${R_HOME}\library mappában.

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

Nyelvi bővítmény regisztrálása

Ezeket a lépéseket követve töltse le és regisztrálja az R egyéni futtatókörnyezethez használt R nyelvi bővítményt.

1. Töltse le a R-lang-extension-linux-release.zip fájlt az SQL Server Language Extensions GitHub-adattárból.

   A hibakeresési verziót (R-lang-extension-linux-debug.zip) fejlesztési vagy tesztelési környezetben is használhatja. A hibakeresési verzió részletes naplózási információkat biztosít a hibák kivizsgálásához, és éles környezetekben nem ajánlott.

2. Az Azure Data Studio használatával csatlakozzon az SQL Server-példányhoz, és futtassa a következő T-SQL-parancsot az R nyelvi bővítmény regisztrálásához a CREATE EXTERNAL LANGUAGE használatával.

   Módosítsa az ebben az utasításban szereplő elérési utat a letöltött nyelvbővítmény zip-fájljának (R-lang-extension-linux-release.zip) helyének megfelelően.

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

   Hajtsa végre az utasítást minden olyan adatbázishoz, amelyben az R nyelvi bővítményt használni szeretné.

   Megjegyzés:

   Az R egy fenntartott szó, és nem használható új külső nyelvnév neveként. Ehelyett használjon másik nevet. A fenti utasítás például a myR-t használja.

Előfeltételek

Egyéni R-futtatókörnyezet telepítése előtt telepítse a következő előfeltételeket:

• Telepítse az SQL Server 2019-et (15.x) Linuxhoz. Az SQL Servert a Red Hat Enterprise Linux (RHEL), a SUSE Linux Enterprise Server (SLES) és az Ubuntu rendszerre is telepítheti. További információkért tekintse meg a Linuxon futó SQL Server telepítési útmutatóját.

• Frissítés az SQL Server 2019 3- vagy újabb kumulatív frissítésére (CU) (15.x). Kövesse az alábbi lépéseket:

  1. Konfigurálja a kumulatív frissítések adattárait. További információ: Adattárak konfigurálása az SQL Server linuxosvaló telepítéséhez és frissítéséhez.

  2. Frissítse az mssql-server csomagot a legújabb összegző frissítésre. További információkért tekintse meg a Linuxon futó SQL Server telepítési útmutatójának SQL Server frissítésével vagy frissítésével foglalkozó szakaszát.

Nyelvi bővítmények telepítése

Megjegyzés:

Ha a Machine Learning Services telepítve van az SQL Server 2019-en, a Language Extensions mssql-server bővíthetőségi csomagja már telepítve van, és kihagyhatja ezt a lépést.

Futtassa az alábbi parancsot az SQL Server Language Extensions SUSE Linux Enterprise Serverre (SLES) való telepítéséhez, amelyet az R egyéni futtatókörnyezetéhez használ.

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

Az R telepítése

1. Ha telepítve van a Machine Learning Services, az R már telepítve van./opt/microsoft/ropen/3.5.2/lib64/R Ha továbbra is ezt az elérési utat szeretné használni R_HOME, kihagyhatja ezt a lépést.

   Ha más R-futtatókörnyezetet szeretne használni, először el kell távolítania microsoft-r-open-mro mielőtt folytatná az új verzió telepítését.

   sudo zypper remove microsoft-r-open-mro-3.4.4
   

2. Telepítse az R -t (3.3 vagy újabb) a SUSE Linux Enterprise Serverhez (SLES). Alapértelmezés szerint az R telepítve van a /usr/lib64/R fájlban. Ez az elérési út a R_HOME. Ha az R-t egy másik helyre telepíti, jegyezze fel ezt az útvonalat R_HOME.

   Az R telepítéséhez kövesse az alábbi lépéseket:

   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
   

   Az R-tcltk-3.6.1 figyelmeztetéseit figyelmen kívül hagyhatja, hacsak nincs szüksége erre a csomagra.

A gcc-c++ telepítése

Telepítse a gcc-c++-t a(z) SUSE Linux Enterprise Serverre (SLES). Ez az Rcpp esetében használatos, amelyet később telepítenek.

sudo zypper install gcc-c++

Az R egyéni telepítése

Megjegyzés:

Ha az R-t az /usr/lib/R alapértelmezett helyén telepítette, kihagyhatja ezt a szakaszt, és továbbléphet az Rcpp-csomag telepítése szakaszra.

A környezeti változók frissítése

Először szerkessze az mssql-launchpadd szolgáltatást a R_HOME környezeti változó fájlhoz való hozzáadásához /etc/systemd/system/mssql-launchpadd.service.d/override.conf

1. A fájl megnyitása systemctl használatával

   sudo systemctl edit mssql-launchpadd
   

2. Szúrja be a következő szöveget a /etc/systemd/system/mssql-launchpadd.service.d/override.conf megnyíló fájlba. Állítsa be a R_HOME értékét az egyéni R telepítési útvonalra.

   [Service]
   Environment="R_HOME=<path to R>"
   

3. Mentse el és zárja be.

Ezután győződjön meg arról, hogy libR.so betölthető.

1. Hozzon létre egy custom-r.conf fájlt a /etc/ld.so.conf.d fájlban.

   sudo vi /etc/ld.so.conf.d/custom-r.conf
   

2. A megnyíló fájlban adja hozzá a libR.so elérési útját az egyéni R-telepítésből.

   <path to the R lib>
   

3. Mentse az új fájlt, és zárja be a szerkesztőt.

4. Futtassa ldconfig, és ellenőrizze, hogy a libR.so betölthető-e az alábbi parancs segítségével, valamint győződjön meg róla, hogy az összes függő kódtár elérhető.

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

Hozzáférés biztosítása az egyéni R telepítési mappához

Állítsa be a datadirectories fájl bővíthetőségi szakaszában /var/opt/mssql/mssql.conf opciót az egyéni R-telepítésre.

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

Az mssql-launchpadd szolgáltatás újraindítása

Futtassa a következő parancsot az mssql-launchpadd újraindításához.

sudo systemctl restart mssql-launchpadd

Rcpp-csomag telepítése

Az Rcpp-csomag telepítéséhez kövesse az alábbi lépéseket.

1. Indítsa el az R-t egy parancssorból.

   sudo ${R_HOME}/bin/R
   

2. Futtassa a következő szkriptet az Rcpp-csomag telepítéséhez a ${R_HOME}\library mappában.

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

Nyelvi bővítmény regisztrálása

Ezeket a lépéseket követve töltse le és regisztrálja az R egyéni futtatókörnyezethez használt R nyelvi bővítményt.

1. Töltse le a R-lang-extension-linux-release.zip fájlt az SQL Server Language Extensions GitHub-adattárból.

   A hibakeresési verziót (R-lang-extension-linux-debug.zip) fejlesztési vagy tesztelési környezetben is használhatja. A hibakeresési verzió részletes naplózási információkat biztosít a hibák kivizsgálásához, és éles környezetekben nem ajánlott.

2. Az Azure Data Studio használatával csatlakozzon az SQL Server-példányhoz, és futtassa a következő T-SQL-parancsot az R nyelvi bővítmény regisztrálásához a CREATE EXTERNAL LANGUAGE használatával.

   Módosítsa az ebben az utasításban szereplő elérési utat a letöltött nyelvbővítmény zip-fájljának (R-lang-extension-linux-release.zip) helyének megfelelően.

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

   Hajtsa végre az utasítást minden olyan adatbázishoz, amelyben az R nyelvi bővítményt használni szeretné.

   Megjegyzés:

   Az R egy fenntartott szó, és nem használható új külső nyelvnév neveként. Ehelyett használjon másik nevet. A fenti utasítás például a myR-t használja.

Külső szkript engedélyezése

Az R külső scriptet a tárolt eljárással sp_execute_external script hajthatja végre.

A külső szkriptek engedélyezéséhez az Azure Data Studio használatával hajtsa végre az alábbi utasítást.

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

Telepítés ellenőrzése

Az R egyéni futtatókörnyezet telepítésének és működésének ellenőrzéséhez használja az alábbi SQL-szkriptet. Az alábbi példaszkript nyelvnévként használatos, myR mivel az alapértelmezett nyelvnév R nem adható meg egyéni futtatókörnyezethez.

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!");'

Ismert problémák

Ha az SQL Server Machine Learning Services részeként biztosított R-futtatókörnyezetet használja, amikor a nyelvi bővítményt regisztrálja, a következő hibába ütközhet, amikor bármilyen külső egyéni R-szkriptet hajt végre az sp_execute_external script parancs segítségével.

Hiba: a memória kimerült (elérte a korlátot?)

A probléma megoldása:

1. Állítsa be a rögzített méretű objektumokR_NSIZE () számát jelző környezeti változót cons cells ésszerű értékre, például200000.
2. Indítsa újra a Launchpad szolgáltatást, és próbálkozzon újra a szkript végrehajtásával.

Ismert problémák

Ha a libstdc++.so.6 nem a megfelelő verzió, a következő hibaüzenet jelenik meg:

Exthost: A bővítmény betöltése sikertelen volt /lib64/libstdc++.so.6: a "GLIBCXX_3.4.20" verzió nem található (által igényelt a /home/mssql_satellite/externallanguagessandboxpath/libRExtension.so.1.1)

Következő lépések

• Egyéni Python-futtatókörnyezet telepítése AZ SQL Serverhez
• Bővíthetőségi keretrendszer az SQL Serveren
• Nyelvi bővítmények áttekintése