Upgrade běhového prostředí Pythonu a R pomocí vazby ve službě SQL Server Machine Learning Services

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

Důležité

Podpora pro Machine Learning Server (dříve označovaný jako R Server) skončila 1. července 2022. Další informace najdete v tématu Co se děje se službou Machine Learning Server?

Tento článek popisuje, jak používat instalační proces am nazývaný binding k upgradu běhových prostředí R nebo Python ve službě SQL Server 2016 R Services nebo SQL Server 2017 Machine Learning Services. Novější verze jazyků Python a R můžete získat vytvořením vazby na Microsoft Machine Learning Server.

Důležité

Tento článek popisuje starou metodu upgradu běhových prostředí R a Python, která se nazývá vazba. Pokud jste nainstalovali kumulativní aktualizaci (CU) 14 nebo novější pro SQL Server 2016 Services Pack (SP) 2nebo kumulativní aktualizaci (CU) 22 nebo novější pro SQL Server 2017, přečtěte si, jak místo toho změnit výchozí modul runtime jazyka R nebo Python na novější verzi .

Co je vazba?

Vazba je instalační proces, který nahradí obsah složek R_SERVICES a PYTHON_SERVICES novějšími spustitelnými soubory, knihovnami a nástroji ze služby Microsoft Machine Learning Server.

Nahrané komponenty, které jsou součástí modelu údržby, se změnily. Aktualizace služby odpovídají časové ose podpory pro Microsoft R Server & Machine Learning Server v moderním životním cyklu.

S výjimkou verzí komponent a aktualizací služeb nemění vazba základy instalace:

• Integrace Pythonu a R je stále součástí instance databázového stroje.
• Licencování se nemění (s vazbou nejsou spojeny žádné další náklady).
• Zásady podpory SQL Server pro databázový stroj stále platí.

Zbývající část tohoto článku vysvětluje mechanismus vazby a jeho fungování pro jednotlivé verze SQL Server.

Poznámka:

Vazba se vztahuje pouze na instance v databázi, které jsou vázány na instance SQL Server. V tomto případě není vazba pro samostatnou instalaci nutná.

Mapa verzí

Následující tabulky jsou mapy verzí. Každá mapa zobrazuje verze balíčků napříč verzemi. Způsoby upgradu si můžete prohlédnout při vytvoření vazby na Microsoft Machine Learning Server (dříve známý jako R Server, před přidáním podpory Pythonu od verze Machine Learning Server 9.2.1).

Vazba nezaručuje nejnovější verzi R nebo Anaconda. Když vytvoříte vazbu k serveru Microsoft Machine Learning Server, získáte verzi R nebo Python nainstalovanou prostřednictvím instalačního programu, což nemusí být nejnovější verze dostupná na webu.

Služby strojového učení SQL Server 2017

Součást	První vydání	Machine Learning Server 9.3	Machine Learning Server 9.4.7
Microsoft R Open (MRO) přes R	Pravidlo 3.3.3	Pravidlo 3.4.3	Pravidlo 3.5.2
RevoScaleR	9.2	9.3	9.4.7
Jazyk MicrosoftML	9.2	9.3	9.4.7
sqlrutils	1.0	1.0	1.0
olapR	1.0	1.0	1.0
Anaconda 4.2 přes Python 3.5	4.2/3.5.2	4.2/3.5.2
revoscalepy	9.2	9.3	9.4.7
Jazyk MicrosoftML	9.2	9.3	9.4.7
Předtrénované modely	9.2	9.3	9.4.7

Jak funguje upgrade komponent

Spustitelné soubory, knihovny Pythonu a R se upgradují, když navážete existující instalaci Pythonu a R na Machine Learning Server.

Vazbu spustí instalační program serveru Microsoft Machine Learning Server při spuštění instalačního programu na existující instanci databázového stroje SQL Server s integrací jazyka Python nebo R.

Instalační program zjistí stávající funkce a vyzve vás k opětovnému připojení k serveru Machine Learning Server.

Během vazby je obsah a C:\Program Files\Microsoft SQL Server\MSSQL14.MSSQLSERVER\R_SERVICES\PYTHON_SERVICES přepsán novějšími spustitelnými soubory a knihovnami C:\Program Files\Microsoft\ML Server\R_SERVER a \PYTHON_SERVER.

Vazba se vztahuje pouze na funkce Pythonu a R. Open-source balíčky pro Python a R se skládají z:

• Anakonda
• Microsoft R Open
• Proprietární balíčky RevoScaleR
• Revoscalepy

Vazba nemění model podpory pro instanci databázového stroje ani verzi SQL Server.

Vazba je reverzibilní. Ke službě SQL Server se můžete vrátit zrušením vazby instance a opravou instance databázového stroje SQL Server.

Vytvoření vazby k serveru Machine Learning Server pomocí instalačního programu

Postupujte podle pokynů pro vytvoření vazby SQL Serveru se serverem Microsoft Machine Learning Server pomocí instalačního programu.

1. V SSMS spusťte SELECT @@version a ověřte, zda server splňuje minimální požadavky na sestavení.

   Pro SQL Server 2016 R Services je minimum Service Pack 1 s CU3.

2. Zkontrolujte verzi balíčků R base a RevoScaleR a ujistěte se, že stávající verze jsou nižší, než jakou je plánujete nahradit.

   EXECUTE sp_execute_external_script
   @language=N'R'
   ,@script = N'str(OutputDataSet);
   packagematrix <- installed.packages();
   Name <- packagematrix[,1];
   Version <- packagematrix[,3];
   OutputDataSet <- data.frame(Name, Version);'
   , @input_data_1 = N''
   WITH RESULT SETS ((PackageName nvarchar(250), PackageVersion nvarchar(max) ))
   

3. Zavřete SSMS a všechny další nástroje s otevřeným připojením k SQL Server. Vazba přepíše programové soubory. Pokud má SQL Server otevřené relace, vazba selže s kódem chyby vazby 6.

4. Stáhněte Microsoft Machine Learning Server do počítače, který obsahuje instanci, kterou chcete upgradovat. Doporučujeme nejnovější verzi.

5. Rozbalte složku a spusťte ServerSetup.exe, který se nachází v části MLSWIN93.

6. V části Konfigurovat instalaci potvrďte komponenty, které chcete upgradovat, a prohlédněte si seznam kompatibilních instancí.

7. Na stránce Licenční smlouva vyberte možnost Souhlasím s těmito podmínkami a přijměte tak licenční podmínky pro Machine Learning Server.

8. Na následujících stránkách vyjádřete souhlas s dalšími licenčními podmínkami pro všechny opensourcové komponenty, které jste vybrali, jako je Microsoft R Open nebo distribuce Python Anaconda.

9. Na stránce Už je to skoro si poznamenejte instalační složku. Výchozí složka je \Program Files\Microsoft\ML Server.

   Pokud chcete změnit instalační složku, vyberte Další volby a vraťte se na první stránku průvodce. Musíte však opakovat všechny předchozí výběry.

Pokud se upgrade nezdaří, další informace najdete v kódech chyb SqlBindR .

Offline vazba (bez přístupu k internetu)

U systémů bez připojení k internetu můžete stáhnout instalační program a .cab soubory do počítače připojeného k internetu a poté soubory přenést na izolovaný server.

Instalační program (ServerSetup.exe) obsahuje balíčky společnosti Microsoft (RevoScaleR, MicrosoftML, olapR, sqlRUtils). Soubory .cab poskytují další základní komponenty. Například kabina "SRO" poskytuje R Open, distribuci open-source R od Microsoftu.

Následující pokyny vysvětlují, jak umístit soubory pro offline instalaci.

1. Stáhněte si instalační program MLSWIN93. Stáhne se jako jeden komprimovaný soubor. Doporučujeme nejnovější verzi, ale můžete nainstalovat i starší verze.

2. Stáhněte si .cab soubory. Následující odkazy jsou určeny pro verzi 9.3. Pokud požadujete starší verze, další odkazy najdete v R Serveru 9.1. Připomeňme, že Python/Anaconda lze přidat pouze do instance SQL Server Machine Learning Services. Pro Python i R existují předtrénované modely. .cab poskytuje modely v jazycích, které používáte.

   Vlastnost	Stáhnout
   R	SRO_3.4.3.0_1033.cab
   Krajta	SPO_9.3.0.0_1033.cab
   Předem natrénované modely	MLM_9.3.0.0_1033.cab

3. Přeneste .zip a .cab soubory na cílový server.

4. Na serveru zadejte %temp% příkaz Spustit, abyste získali fyzické umístění dočasného adresáře. Fyzická cesta se liší podle stroje, ale obvykle C:\Users\<your-user-name>\AppData\Local\Tempje to .

5. Umístěte soubory .cab do složky %temp%.

6. Rozbalte instalační program.

7. Spusťte ServerSetup.exe a dokončete instalaci podle pokynů na obrazovce.

Operace příkazového řádku

Návod

Nemůžete najít SqlBindR? Pravděpodobně jste nespustili instalační program. SqlBindR je k dispozici pouze po spuštění instalačního programu serveru Machine Learning.

1. Otevřete příkazový řádek jako správce a přejděte do složky obsahující sqlbindr.exe. Výchozí umístění je C:\Program Files\Microsoft\MLServer\Setup

2. Zadáním následujícího příkazu zobrazíte seznam dostupných instancí: SqlBindR.exe /list

   Poznamenejte si úplný název instance tak, jak je uveden. Název instance může být například MSSQL14. MSSQLSERVER pro výchozí instanci, nebo něco jako SERVERNAME. MYNAMEDINSTANCE.

3. Spusťte SqlBindR.exe příkaz s argumentem /bind . Zadejte název instance, která se má upgradovat, pomocí názvu instance, který byl vrácen v předchozím kroku.

   Chcete-li například upgradovat výchozí instanci, zadejte: SqlBindR.exe /bind MSSQL14.MSSQLSERVER

4. Po dokončení upgradu restartujte službu Launchpad spojenou se všemi změněnými instancemi.

Vrácení nebo zrušení vazby instance

Vázanou instanci můžete obnovit do počáteční instalace komponent Python a R, která byla vytvořena instalačním programem SQL Serveru. Návrat k údržbě SQL Server se skládá ze tří částí.

• Krok 1: Zrušení vazby od služby Microsoft Machine Learning Server
• Krok 2: Obnovte instanci do původního stavu
• Krok 3: Znovu nainstalujte všechny balíčky, které jste přidali do instalace

Krok 1: Rozvázání

Máte dvě možnosti, jak vazbu vrátit zpět: znovu spustit instalační program nebo použít nástroj příkazového řádku SqlBindR.

Zrušení vazby pomocí instalačního programu

1. Vyhledejte instalační program pro Machine Learning Server. Pokud jste instalační program odebrali, možná jej budete muset stáhnout znovu nebo zkopírovat z jiného počítače.
2. Instalační program spustíte v počítači, který obsahuje instanci, jejíž vazbu chcete zrušit.
3. Instalační program identifikuje místní instance, které jsou kandidáty na zrušení vazby.
4. Zrušte zaškrtnutí políčka vedle instance, u které se chcete vrátit k původní konfiguraci.
5. Přijměte všechny licenční smlouvy.
6. Vyberte Dokončit. Proces chvíli trvá.

Zrušení vazby pomocí příkazového řádku

1. Otevřete příkazový řádek a přejděte do složky, která obsahuje sqlbindr.exe, jak je popsáno v předchozí části.

2. Spusťte příkaz SqlBindR.exe s argumentem /unbind a určete instanci.

   Například následující příkaz vrátí výchozí instanci:

   SqlBindR.exe /unbind MSSQL14.MSSQLSERVER

Krok 2: Opravte instanci SQL Server

Spuštěním instalačního programu SQL Serveru opravte instanci databázového stroje s funkcemi Python a R. Stávající aktualizace jsou zachovány. Další krok platí v případě, že došlo k vynechání aktualizace servisních aktualizací balíčků Pythonu a R.

Alternativní řešení: Plně odinstalujte a znovu nainstalujte instanci databázového stroje a poté nainstalujte všechny aktualizace služby.

Krok 3: Přidejte všechny balíčky třetích stran

Je možné, že jste do knihovny balíčků přidali další opensourcové balíčky nebo balíčky třetích stran. Vzhledem k tomu, že obrácení vazby přepne umístění výchozí knihovny balíčků, je nutné balíčky přeinstalovat do knihovny, kterou nyní používají Python a R. Další informace najdete v tématech Informace o balíčku Rainstalaci a Informace o balíčku Pythonu a jeho instalaci.

SqlBindR.exe syntaxe příkazu

Použití

sqlbindr [/list] [/bind <SQL_instance_ID>] [/unbind <SQL_instance_ID>]

Parametry

Název	Popis
seznam	Zobrazí seznam všech ID instancí SQL Server v aktuálním počítači
připojit	Upgraduje určenou instanci SQL Serveru na nejnovější verzi R Serveru a zajistí, aby instance automaticky dostávala budoucí upgrady R Serveru
odvázat	Odinstaluje nejnovější verzi R Serveru ze zadané instance SQL Serveru a zabrání budoucím upgradům R Serveru, aby ovlivnily instanci

Chyby vazby

Instalační program Machine Learning Serveru i SqlBindR vracejí následující kódy chyb a zprávy.

Kód chyby	Zpráva	Podrobnosti
Chyba vazby 0	Ok (úspěch)	Vazba proběhla bez chyb.
Chyba vazby 1	Neplatné argumenty	Chyba syntaxe.
Chyba vazby 2	Neplatná akce	Chyba syntaxe.
Chyba vazby 3	Neplatná instance	Instance existuje, ale není platná pro vazbu.
Chyba vazby 4	Nelze svázat
Chyba vazby 5	Již svázaný	Spustili jste příkaz bind , ale zadaná instance je již svázána.
Chyba vazby 6	Vytvoření vazby se nezdařilo	Při rušení vazby instance došlo k chybě. K této chybě může dojít, pokud spustíte instalační program služby Machine Learning Server bez výběru jakýchkoli funkcí. Vazba vyžaduje, abyste vybrali instanci MSSQL i Python a R za předpokladu, že se jedná o instanci SQL Server 2017. K této chybě dochází také v případě, že SqlBindR nemohl zapisovat do složky Program Files. Otevřené relace nebo popisovače serveru SQL Server způsobí výskyt této chyby. Pokud se zobrazí tato chyba, restartujte počítač a před zahájením nových relací proveďte kroky pro vytvoření vazby znovu.
Chyba vazby 7	Není vázán	Instance databázového stroje má službu R Services nebo SQL Server Machine Learning Services. Instance není svázána se serverem Microsoft Machine Learning.
Chyba vazby 8	Zrušení vazby se nezdařilo	Při rušení vazby instance došlo k chybě.
Chyba vazby 9	Nebyly nalezeny žádné instance	V tomto počítači nebyly nalezeny žádné instance databázového stroje.

Známé problémy

V této části jsou uvedeny známé problémy specifické pro používání nástroje SqlBindR.exe nebo upgrady serveru Machine Learning Server, které mohou mít vliv na instance systému SQL Server.

Obnovení balíčků, které byly nainstalovány dříve

SqlBindR.exe se nepodaří obnovit původní balíčky nebo komponenty R s upgradem na Microsoft R Server 9.0.1. Použijte opravu SQL Serveru na instanci a použijte všechny aktualizace služby. Restartujte instanci.

Novější verze SqlBindR automaticky obnoví původní funkce jazyka R, takže není nutné přeinstalovat komponenty jazyka R nebo znovu odeslat server. Je ale nutné nainstalovat všechny aktualizace balíčků R, které mohly být přidány po počáteční instalaci.

Pomocí příkazů R synchronizujte nainstalované balíčky se souborovým systémem pomocí záznamů v databázi. Další informace naleznete v tématu Správa balíčků R pro SQL Server.

Problémy s přepsáním souboru sqlbinr.ini v SQL Serveru

Scénář: K tomuto problému dochází při vytváření vazby Machine Learning Server 9.4.7 na SQL Server 2017. Když je Python aktualizován a svázán nebo když aktualizujete na novou CU, nechápe, že je Python svázaný, a přepisuje soubory. S R není znám žádný problém.

Alternativním řešením je vytvořit sqlbindr.ini v adresáři PYTHON_SERVICES soubor, který není prázdný. Obsah nemá vliv na fungování souboru.

sqlbindr.ini Vytvořte soubor obsahující 9.4.7.82, uložte do tohoto umístění:

C:\Program Files\Microsoft SQL Server\MSSQL14.MSSQLSERVER\PYTHON_SERVICES

Problémy s vícenásobnými upgrady ze serveru SQL Server

Scénář: Dříve upgradovaná instance služby SQL Server 2016 R Services na verzi 9.0.1. Byl spuštěn nový instalační program pro Microsoft R Server 9.1.0. Instalační program zobrazí seznam všech platných instancí. Ve výchozím nastavení instalační program vybírá dříve svázané instance. Pokud budete pokračovat, dříve svázané instance se zruší. Výsledkem je, že se odebere starší instalace 9.0.1 a všechny související balíčky, ale nenainstaluje se nová verze Microsoft R Server (9.1.0).

Alternativním řešením je upravit stávající instalaci R Serveru následujícím způsobem:

1. V Ovládacích panelech otevřete panel Přidat nebo odebrat programy.
2. Vyhledejte Microsoft R Server a vyberte Změnit/upravit.
3. Po spuštění instalačního programu vyberte instance, ke kterým chcete vytvořit vazbu ve verzi 9.1.0.

Microsoft Machine Learning Server 9.2.1 a 9.3 tento problém nemají.

Při svázání nebo zrušení vazby se ponechá více dočasných složek

Po dokončení instalace odstraňte dočasné složky.

Poznámka:

Počkejte na dokončení instalace. Odebrání knihoven R přidružených k jedné verzi a následné přidání nových knihoven R může trvat dlouhou dobu. Po dokončení operace se dočasné složky odstraní.

Viz také

• Změna výchozí verze modulu runtime jazyka R nebo Python
• Instalace Machine Learning Serveru pro Windows (připojení k internetu)
• Instalace služby Machine Learning Server pro systém Windows (offline)
• Známé problémy v Machine Learning Serveru
• Oznámení funkcí z předchozí verze R Serveru
• Zastaralé, již nejsou podporovány nebo změněné funkce