Wymagania dotyczace analiz AI

Aby przeprowadzic analizy bazujace na AI w dab Nexus, wymagany jest SQL Server z mozliwoscia obslugi uslug uczenia maszynowego opartych o R. W tym artykule przedstawiono niezbedne warunki oraz opisano przygotowanie srodowiska SQL Server.

Obslugiwane srodowiska SQL Server

dab Nexus obsluguje ponizsze srodowiska dla analiz AI:

• SQL Server 2019 (Standard / Enterprise)
• SQL Server 2022
• SQL Server na Windows Server wewnatrz Azure Virtual Machine
• Zainstalowane oraz skonfigurowane uslugi uczenia maszynowego

Brak obslugi

• Azure SQL Database
• Azure SQL Managed Instance
• SQL Server Express
• SQL Server na Linux

1. Przygotowanie SQL Server

Do wykonania skryptow R uzywanych przez analizy AI potrzebna jest instancja SQL Server. Nalezy wybrac jedna z ponizszych obsugiwanych opcji wdrozenia.

1.1 Instalacja SQL Server On-Premise

Podczas instalacji SQL Server nalezy zaznaczyc nastepujace komponenty:

• Machine Learning Services

Dokumentacja Microsoft:

• Instalacja SQL Server

1.2 SQL Server na Azure Virtual Machine

Jesli srodowisko dab Nexus funkcjonuje w Azure jako Managed Application, mozna wdrozyc SQL Server na maszynie wirtualnej Azure.

Rekomendowany obraz z Marketplace

• SQL Server 2019 / 2022 na Windows Server
• Obrazy SQL Server 2025 obecnie nie sa wspierane
• Zaleca sie nie korzystac z obrazow Marketplace z opcjami „pre-configured”

Wymagana konfiguracja podczas wdrazania maszyny wirtualnej

• Aktywna usluga R Services (Advanced Analytics)

Jesli uslugi uczenia maszynowego nie zostaly wybrane podczas wdrozenia, nalezy je zainstalowac po zakonczeniu instalacji (zobacz krok 2).

Dokumentacja Microsoft:

• SQL Server na Azure Virtual Machines
• Instalacja Machine Learning Services

1.3 Dodanie Machine Learning Services do istniejacej instancji SQL Server

Ten proces zostal udokumentowany dla ponizszych wspieranych wersji SQL Server. Prosze wykonac instrukcje tylko do momentu „Run setup”; konfiguracja R nastepuje pozniej w kroku 2.

Wersja	Dokumentacja
SQL Server 2017	Instalacja SQL Server Machine Learning Services na Windows - SQL Server Machine Learning Services : Microsoft Learn
SQL Server 2019	Instalacja SQL Server Machine Learning Services na Windows - SQL Server Machine Learning Services : Microsoft Learn
SQL Server 2022	Instalacja SQL Server 2022 Machine Learning Services na Windows - SQL Server Machine Learning Services : Microsoft Learn

2. Aktywacja uslug Machine Learning

Aby analizy AI mogly funkcjonowac, uslugi uczenia maszynowego oparte o R musza byc aktywne oraz prawidlowo dzialac na SQL Server.

2.1 Aktywacja wykonywania zewnetrznych skryptow

Proszę uruchomić poniższe polecenie na instancji SQL:

sp_configure 'external scripts enabled', 1;
RECONFIGURE;

Nastepnie nalezy zrestartowac nastepujaca usluge: SQL Server Launchpad

2.2 Weryfikacja

Proszę wykonac nastepujace polecenie na instancji SQL Server:

EXEC sp_execute_external_script @language = N'R', @script = N'print("OK")';

Oczekiwany rezultat: OK

Rozwiazywanie problemow: Znane problemy dla SQL Server Machine Learning Services

Weryfikacja

EXEC sp_execute_external_script @language = N'R', @script = N'str(installed.packages( [,c("Package","Version")])';

3. Instalacja srodowiska R Runtime

Aby mozliwe bylo przeprowadzenie analiz AI, srodowisko R Runtime musi funkcjonowac na SQL Server. Mozna wykorzystac gotowy pakiet R runtime udostepniony przez dab lub przeprowadzic reczna instalacje srodowiska R, jednak rekomendowane jest wykorzystanie pierwszej opcji.

3.1 Wykorzystanie gotowego pakietu R runtime (rekomendowane)

Udostepniamy gotowy R runtime, zawierajacy komplet niezbednych bibliotek dla analiz AI. Jest to zalecana opcja, jezeli nie planuja Panstwo samodzielnie instalowac lub konserwowac srodowiska R.

1. Pobierz pakiet R Runtime z Portal

   • Przejdz do dab Portal
   • Przejdz do: Portal → Produkty
   • Pobierz: dab AnalyticSuite R Runtime

2. Skopiuj pakiet do SQL Server Dostepne metody:

   • kopiowanie przez RDP
   • Azure Storage Explorer (rekomendowane dla maszyn wirtualnych Azure)
   • udostepnianie plikow Windows
   • SFTP lub narzedzia transferowe
   Uwaga

   Upewnic sie, ze folder runtime znajduje sie na lokalnym dysku, do ktorego konto uslugi SQL Server ma dostep.

3. Utworzyc folder instalacyjny recznie Nalezy utworzyc folder, w ktorym zostanie zainstalowany pakiet runtime R. Przyklad: C:\Program Files\R\R-4.x.x>

   Prosze podmienic R-4.x.x na wersje z pliku ZIP.

   Wazne

   Ten folder musi znajdowac sie w katalogu, do ktorego konto uslugi SQL Server ma dostep (np. NT Service\MSSQLSERVER). Nie nalezy korzystac z folderow profilu uzytkownika (Desktop, Downloads, Documents) ani folderow tymczasowych.

4. Rozpakuj pakiet runtime do folderu instalacyjnego Nalezy wypakowac wszystkie pliki z archiwum ZIP do utworzonego folderu. W rezultacie folder bedzie zawieral kompletna strukture srodowiska R runtime (bin, library, itp.).

5. Uruchom Wiersz Polecen jako Administrator i przejdz do folderu instalacyjnego Nalezy otworzyc Wiersz Polecen z prawami administratora, a nastepnie ustawic jako katalog roboczy folder, do ktorego wypakowano pakiet R runtime. Przyklad: cd "C:\Program Files\R\R-4.x.x"

6. Zarejestruj srodowisko R runtime w SQL Server Nalezy uruchomic polecenie rejestracji:

   RegisterRext.exe /configure /rhome:"C:\Program Files\R\R-4.x.x" /instance:"MSSQLSERVER"

Prosze podmienic R-4.x.x oraz MSSQLSERVER jezeli instalacja wykorzystuje inne sciezki lub alternatywna nazwe instancji.

7. Zrestartuj usluge SQL Server Launchpad Upewnic sie, czy usluga o nazwie SQL Server Launchpad jest uruchomiona i posiada typ Automatyczny. W razie potrzeby nalezy zrestartowac usluge.

8. Zweryfikuj dzialanie srodowiska R runtime Wykonac prosty skrypt testowy R na SQL Server:

   EXEC sp_execute_external_script @language = N'R', @script = N'print("Runtime OK")';

   Rezultat "Runtime OK" potwierdza, ze SQL Server moze wykonywac skrypty R.

3.2 Instalacja (On-Premise)

3.3 Instalacja na Azure SQL Server Virtual Machine (opcjonalnie)

1. Polacz sie z maszyna wirtualna Azure Portal → Connect → Download RDP File Prosze zalogowac sie na konto administratora.

2. Przeslij pakiet R

   • kopiowanie przez RDP
   • Azure Storage Explorer
   • udostepnianie plikow

3. Zainstaluj pakiet R Uruchom Wiersz Polecen jako Administrator:

   .\RegisterRext.exe /configure .\RegisterRext.exe /configure /rhome:"C:\Program Files\R\R-4.5.0.12" /instance:"MYSQLSERVER"

   Sprawdz nazwe instancji:

   SELECT @@SERVICENAME;

4. Weryfikacja R

   EXEC sp_execute_external_script @language = N'R', @script = N'print("AI Ready")';

5. Wyswietl zainstalowane pakiety

   EXEC sp_execute_external_script @language = N'R', @script = N'print(installed.packages())';

Rozwiazywanie problemow

Problem	Przyczyna	Rozwiazanie
Skrypty R nie dzialaja	external scripts enabled nieaktywne	Aktywowac ustawienie + zrestartowac Launchpad
Launchpad nie uruchamia sie	Bledna konfiguracja uslugi	Sprawdz uslugi Windows
Brak R	ML Services nie sa zainstalowane	Zainstaluj ML Services
Nexus nie moze polaczyc się	SQL Auth wylaczony / zapora sieciowa	Aktywowac SQL Auth, otworzyc port 1433
Azure VM zablokowana	Reguly NSG	Dopuscic ruch z podsieci Nexus