Przejście do głównej treści

Wymagania dla AI-Analiz

AI-Analizy wymagają środowiska SQL, które jest w stanie wykonywać skrypty R z Machine Learning Services.

Ważne

AI-Analizy mogą być uruchomione jedynie wtedy, gdy możliwe jest wykonanie R, a przetwarzany zbiór danych mieści się w pamięci dostępnej dla środowiska R.

Obsługiwane środowiska SQL​

ŚrodowiskoObsługiwaneUwagi
SQL Server 2019 / 2022 na WindowsTakWymagane Machine Learning Services z R
SQL Server na Azure Virtual Machine (Windows)TakWymagane Machine Learning Services z R
Azure SQL Managed InstanceTakPlatforma obsługuje Machine Learning Services z R
Azure SQL DatabaseNieBrak obsługi Machine Learning Services z R
SQL Server ExpressNieNieobsługiwane
SQL Server na LinuxNieNieobsługiwane

Wskazówka

Informacje dotyczące wymiarowania RAM, zalecenia odnośnie CPU i rekomendacji sprzętowych dla Azure SQL Managed Instance można znaleźć w Wymaganiach zasobów dla AI-Analiz opartych o R.

1. Wybór platformy​

1.1 SQL Server On-Premise lub Azure Virtual Machine​

Z tego wariantu warto skorzystać, jeśli zależy Państwu na pełnej kontroli nad alokacją pamięci, konfiguracją SQL Server oraz środowiskiem R.

  • Obsługiwane wersje: SQL Server 2019 oraz SQL Server 2022 na Windows
  • Należy zainstalować Machine Learning Services z R
  • Rekomendowane jest użycie preinstalowanego środowiska dab R
  • max server memory oraz Resource Governor pozwalają zapewnić wystarczającą ilość pamięci dla R

Dokumentacja Microsoft

1.2 Azure SQL Managed Instance​

To rozwiązanie warto wybrać, jeżeli oczekują Państwo zarządzanej platformy Azure SQL i akceptują ograniczenia platformowe Machine Learning Services.

  • Machine Learning Services z R są obsługiwane przez Azure SQL Managed Instance
  • Podstawowe środowisko R dostarcza Azure SQL Managed Instance
  • Nie należy korzystać z RegisterRext.exe ani operacji serwisowych Windows na Azure SQL Managed Instance
  • Zewnętrzne pule Resource Governor nie są obsługiwane przez Azure SQL Managed Instance
  • Domyślnie R może wykorzystać maksymalnie 20% zasobów Managed Instance
  • Wymagane pakiety instalowane są za pomocą sqlmlutils

Dokumentacja Microsoft


2. Włączenie Machine Learning Services​

2.1 SQL Server On-Premise lub Azure Virtual Machine​

Proszę uruchomić poniższą komendę na instancji SQL:

sp_configure 'external scripts enabled', 1;
RECONFIGURE;

Po jej wykonaniu należy zrestartować usługę SQL Server Launchpad.

2.2 Azure SQL Managed Instance​

Analogiczną komendę należy wykonać na Managed Instance:

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

Podczas zmiany Azure SQL Managed Instance automatycznie restartuje instancję i przez krótki czas będzie niedostępne. Nie występuje tutaj usługa Launchpad do manualnego restartu.


3. Instalacja wymaganych pakietów R​

3.1 SQL Server On-Premise lub Azure Virtual Machine​

Najlepszym rozwiązaniem jest użycie preinstalowanego środowiska dab R.

  1. Pobierz środowisko z dab Portal
  2. Przenieś plik na SQL Server i rozpakuj archiwum zip
  3. Uruchom instalator za pomocą podwójnego kliknięcia
  4. Wybierz lokalizację instalacji: dostosuj domyślny katalog docelowy (jeśli zachodzi taka potrzeba) — zalecamy użycie ustawień domyślnych
  5. Wybierz narzędzia — zalecamy zaznaczenie wszystkich opcji
  • ACL Analytics
    • SQL Server
    • Dodać do systemowego PATH

  1. Wskazać instancję SQL Server — proszę wybrać tutaj swoją bazę CONTENT

  2. Ponownie zarejestrować instancję SQL Server — zalecane: Jeżeli ta opcja zostanie odznaczona, należy ręcznie zarejestrować ją w SQL Server (uruchomić CMD jako Admin):

    cd "C:\Program Files\dabGmbH\AnalyticSuiteR\library\RevoScaleR\rxLibs\x64"
    RegisterRext.exe /configure /rhome:"C:\Program Files\dabGmbH\AnalyticSuiteR" /instance:"MSSQLSERVER"

  3. Rozpocząć instalację i poczekać na jej zakończenie

  4. Otworzyć usługę i zrestartować usługę SQL Server Launchpad (CONTENT)

  5. Zweryfikować instalację oraz działanie zgodnie z opisem w 4. Verify R execution

Ważne

Proces rejestracji środowiska dotyczy wyłącznie instancji SQL Server na Windows zarządzanych samodzielnie oraz SQL Server na Azure Virtual Machine. Nie dotyczy Azure SQL Managed Instance.

3.2 Azure SQL Managed Instance​

W Azure SQL Managed Instance środowisko bazowe R jest już dostępne. Należy jedynie zainstalować wymagane pakiety.

  • Instalacja wymaganych pakietów odbywa się przy użyciu sqlmlutils z maszyny klienckiej
  • Nie należy kopiować lokalnego środowiska R do usługi
  • W przypadku grup failover zaleca się instalację pakietów bezpośrednio do bazy użytkownika, a nie do master

Należy postępować zgodnie z przewodnikiem zarządzania pakietami Microsoft:


4. Weryfikacja wykonania R​

Należy wykonać poniższą komendę w środowisku SQL:

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

Oczekiwany wynik:

OK

Aby sprawdzić zainstalowaną wersję R:

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

Lista zainstalowanych pakietów:

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

Rozwiązywanie problemów​

ProblemPotencjalna przyczynaRozwiązanie
Nie działają skrypty RWyłączone ustawienie external scripts enabledWłącz odpowiednie ustawienie i spróbuj ponownie
Błąd braku pamięci podczas analizyZbiór danych nie mieści się w dostępnej pamięci RZmniejsz rozmiar datasetu lub zwiększ dostępny RAM. Zobacz: Wymagania zasobów dla AI-Analiz opartych o R
Nie startuje LaunchpadNieprawidłowa konfiguracja usługi WindowsNależy sprawdzić usługę SQL Server Launchpad. Dotyczy jedynie instancji SQL Server zarządzanych samodzielnie
RegisterRext.exe nie działaNieprawidłowa platformaUżywać wyłącznie na instancjach SQL Server na Windows lub Azure VM zarządzanych samodzielnie
Nie działa instalacja pakietu w Azure SQL Managed InstanceNieprawidłowa metoda instalacji pakietuNależy użyć sqlmlutils
dab Nexus nie może się połączyćBrak włączonego SQL Auth lub restrykcje siecioweWłącz SQL Auth oraz otwórz wymagany port w sieci