Installare SQL Server 2016 R Services

Si applica a: Solo SQL Server 2016 (13.x)

Informazioni su come installare R Services per SQL Server 2016 in Windows. È possibile usare R Services per eseguire script R all'interno del database.

Nota

In SQL Server 2017 e versioni successive R è incluso in Machine Learning Services insieme a Python. Se si vuole R e si dispone di SQL Server 2017 o versione successiva, vedere Installare Machine Learning Services di SQL Server per aggiungere la funzionalità.

Elenco di controllo preliminare all'installazione

  • È necessaria un'istanza del motore di database. Non è possibile installare solo R, ma è possibile aggiungerlo in modo incrementale a un'istanza esistente.

  • Per assicurare la continuità aziendale, per R Services è disponibile il supporto di Gruppi di disponibilità AlwaysOn. È necessario installare R Services e configurare i pacchetti in ogni nodo.

  • Non installare R Services in un'istanza del cluster di failover Always On di SQL Server. Il meccanismo di sicurezza usato per isolare i processi R non è compatibile con un ambiente con istanza del cluster di failover Always On di SQL Server.

  • Non installare R Services in un controller di dominio. La parte del programma di installazione relativa a R Services avrà esito negativo.

  • Non installare Funzionalità condivise>R Server (Standalone) nello stesso computer in cui è in esecuzione un'istanza di tipo In-Database.

  • L'installazione side-by-side con altre versioni di R è supportata ma non consigliata. È supportata perché l'istanza di SQL Server usa le proprie copie della distribuzione R open source. Tuttavia, l'esecuzione di codice che usa R nel computer SQL Server al di fuori di SQL Server può causare diversi problemi:

    • Si usano una libreria e un file eseguibile diverso e quindi si ottengono risultati diversi rispetto all'esecuzione del codice in SQL Server.
    • Gli script R in esecuzione nelle librerie esterne non possono essere gestiti da SQL Server, con conseguente contesa di risorse.

Importante

Al termine dell'installazione, assicurarsi di completare i passaggi aggiuntivi di post-configurazione descritti in questo articolo, tra cui l'abilitazione di SQL Server per l'uso di script esterni e l'aggiunta degli account necessari per consentire a SQL Server di eseguire i processi R per conto dell'utente. Per completare le modifiche alla configurazione è in genere necessario riavviare l'istanza o riavviare il servizio Launchpad.

Ottenere il supporto di installazione

Il percorso per il download di SQL Server dipende dall'edizione:

  • Edizioni Enterprise, Standard ed Express di SQL Server. Queste edizioni sono concesse in licenza per l'uso in produzione. Per Enterprise Edition e Standard Edition, contattare il fornitore software di fiducia per richiedere il supporto di installazione. È possibile trovare informazioni sull'acquisto e una directory per i partner Microsoft nel sito Web Microsoft per gli acquisti.
  • L'edizione gratuita più recente.

Requisito di installazione di patch

Microsoft ha rilevato un problema con una versione specifica dei file binari di Microsoft VC++ 2013 Runtime installati come prerequisito da SQL Server. Se l'aggiornamento dei file binari di VC++ Runtime non viene installato, potrebbero verificarsi problemi di stabilità di SQL Server in determinati scenari. Prima di installare SQL Server, seguire le istruzioni in Note sulla versione di SQL Server per vedere se il computer richiede una patch per i file binari di VC++ Runtime.

Eseguire l'installazione.

Per le installazioni locali, è necessario eseguire il programma di installazione di come amministratore. Se si installa SQL Server da una condivisione remota, è necessario utilizzare un account di dominio che disponga di autorizzazioni di lettura ed esecuzione per tale condivisione.

  1. Avviare l'Installazione guidata di SQL Server 2016.

  2. Nella scheda Installazione selezionare Nuova installazione autonoma di SQL Server o aggiunta di funzionalità a un'installazione esistente.

    Install R Services (In-Database)

  3. Nella pagina Selezione funzionalità selezionare le opzioni seguenti:

    • Selezionare Servizi motore di database. Il motore di database è necessario in ogni istanza che usa funzionalità di Machine Learning.
    • Selezionare R Services (In-Database). Questa opzione consente di installare il supporto per l'uso nel database di R.

    R Services feature selection

    Importante

    Non installare contemporaneamente R Server e R Services.

  4. Nella pagina Consenso per installare Microsoft R Open fare clic su Accetto.

    Questo contratto di licenza deve essere accettato per il download di Microsoft R Open, che include una distribuzione di pacchetti e strumenti R open source di base, insieme a pacchetti R avanzati e a provider di connettività del team Microsoft dedicato allo sviluppo di soluzioni R.

  5. Dopo l'accettazione del contratto di licenza, si verifica una breve pausa di preparazione del programma di installazione. Quando il pulsante diventa disponibile, fare clic su Avanti.

  6. Nella pagina Inizio installazione verificare che siano incluse le opzioni seguenti e selezionare Installa.

    • Servizi motore di database
    • R Services (In-Database)
  7. Dopo che l'installazione è completata, riavviare il computer, se richiesto. È importante leggere il messaggio visualizzato nell'Installazione guidata al termine dell'installazione. Per altre informazioni, vedere Visualizzare e leggere i file di log del programma di installazione di SQL Server.

Impostare le variabili di ambiente

Per integrare solo le funzionalità di R, è necessario impostare la variabile di ambiente MKL_CBWR per avere la certezza di ottenere un output coerente dai calcoli di Intel Math Kernel Library (MKL).

  1. Nel Pannello di controllo fare clic su Sistema e sicurezza>Sistema>Impostazioni di sistema avanzate>Variabili d'ambiente.

  2. Creare una nuova variabile dell'utente o di sistema.

    • Impostare MKL_CBWR come nome della variabile
    • Impostare AUTO come valore della variabile

Per questo passaggio è necessario riavviare il server. È possibile rimandare il riavvio fino a quando non sono state completate tutte le operazioni di configurazione.

Abilitare l'esecuzione di script

  1. Aprire SQL Server Management Studio (SSMS) o Azure Data Studio.

  2. Connettersi all'istanza in cui è stato installato R Services, fare clic su Nuova query per aprire una finestra di query ed eseguire il comando seguente:

    sp_configure
    

    A questo punto, il valore della proprietà external scripts enabled deve essere 0. Questo perché la funzionalità è disattivata per impostazione predefinita. Per poter eseguire script R, la funzionalità deve essere abilitata in modo esplicito da un amministratore.

  3. Per abilitare la funzionalità per script esterni, eseguire l'istruzione seguente:

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

Riavvia il servizio

Al termine dell'installazione, riavviare il motore di database prima di continuare con il passaggio successivo, abilitando l'esecuzione degli script.

Il riavvio del servizio ha l'effetto di riavviare automaticamente anche il servizio Launchpad di SQL Server correlato.

È possibile riavviare il servizio facendo clic con il pulsante destro del mouse sul comando Riavvia per l'istanza in SSMS o usando Gestione configurazione SQL Server.

Verifica l'installazione

Usare la procedura seguente per verificare che tutti i componenti usati per avviare lo script esterno siano in esecuzione.

  1. In SQL Server Management Studio aprire una nuova finestra di query ed eseguire il comando seguente:

    EXEC sp_configure 'external scripts enabled'
    

    Il valore di run_value dovrebbe ora essere impostato su 1.

  2. Aprire Gestione configurazione SQL Server e verificare che il servizio Launchpad di SQL Server sia in esecuzione. Sarà presente un servizio per ogni istanza del motore di database in cui è installato R. Per altre informazioni sul servizio, vedere Framework di estendibilità.

  3. Se Launchpad è in esecuzione, dovrebbe essere possibile eseguire codice R semplice per verificare che i runtime di script esterni possano comunicare con SQL Server.

    Aprire una nuova finestra Query in SQL Server Management Studio o Azure Data Studio e quindi eseguire uno script come il seguente:

    EXEC sp_execute_external_script  @language =N'R',
    @script=N'
    OutputDataSet <- InputDataSet;
    ',
    @input_data_1 =N'SELECT 1 AS hello'
    WITH RESULT SETS (([hello] int not null));
    GO
    

    La prima volta che viene caricato il runtime di uno script esterno, l'esecuzione dello script può richiedere un po' di tempo. I risultati saranno simili ai seguenti:

    hello
    1

Applica aggiornamenti

È consigliabile applicare il Service Pack e l'aggiornamento cumulativo più recenti sia al motore di database sia ai componenti di Machine Learning.

Nei dispositivi connessi a Internet, gli aggiornamenti cumulativi vengono in genere applicati tramite Windows Update, ma è anche possibile usare la procedura seguente per eseguire aggiornamenti controllati. Quando si applica l'aggiornamento per il motore di database, il programma di installazione esegue il pull degli aggiornamenti cumulativi per le librerie R installate nella stessa istanza.

Nei server che non sono connessi a Internet sono necessari alcuni passaggi aggiuntivi. Per altre informazioni, vedere Installare in computer senza accesso a Internet > Applicare aggiornamenti cumulativi.

  1. Iniziare con un'istanza di base già installata: versione iniziale di SQL Server 2016, SQL Server 2016 SP 1 o SQL Server 2016 SP 2.

  2. Passare all'elenco degli aggiornamenti cumulativi: Aggiornamenti più recenti per Microsoft SQL Server

  3. Selezionare le versioni più recenti del Service Pack (se non è già installato come istanza di base) e dell'aggiornamento cumulativo. L'eseguibile viene scaricato ed estratto automaticamente.

  4. Eseguire il programma di installazione. Accettare le condizioni di licenza e nella pagina Selezione funzionalità esaminare le funzionalità per le quali vengono applicati gli aggiornamenti cumulativi. Dovrebbero essere visualizzate tutte le funzionalità installate per l'istanza corrente, incluso R Services. Il programma di installazione scarica i file CAB necessari per aggiornare tutte le funzionalità.

  5. Continuare con la procedura guidata, accettando le condizioni di licenza per la distribuzione R.

Nota

L'aggiornamento cumulativo 14 e le versioni successive per SQL Server 2016 SP2 includono una versione più recente del runtime di R. Per altre informazioni, vedere Modificare la versione predefinita di runtime del linguaggio.

Configurazione aggiuntiva

Se il passaggio di verifica degli script esterni ha avuto esito positivo, è possibile eseguire comandi R da SQL Server Management Studio, Azure Data Studio o qualsiasi altro client che può inviare istruzioni T-SQL al server.

Se durante l'esecuzione del comando è stato restituito un errore, rivedere i passaggi di configurazione aggiuntivi in questa sezione. Potrebbe essere necessario eseguire specifiche configurazioni aggiuntive per il servizio o il database.

A livello di istanza, la configurazione aggiuntiva può includere:

Nel database potrebbero essere necessari gli aggiornamenti di configurazione seguenti:

Nota

Non tutte le modifiche elencate sono obbligatorie ed è anche possibile che nessuna di queste lo sia. I requisiti dipendono dallo schema di sicurezza, dal percorso in cui è stato installato SQL Server e dalla modalità presumibilmente adottata dagli utenti per connettersi al database ed eseguire script esterni. Altre indicazioni sull'installazione sono disponibili qui: Installare Servizi di Machine Learning per SQL Server

Ottimizzazioni suggerite

È anche possibile ottimizzare il server per supportare le funzionalità di Machine Learning con R o installare modelli già sottoposti a training.

Aggiungere altri account di lavoro

Se si pensa di usare R in modo intensivo o si prevede che molti utenti eseguano script contemporaneamente, è possibile aumentare il numero di account di lavoro assegnati al servizio Launchpad. Per altre informazioni, vedere Ridimensionare l'esecuzione simultanea di script esterni in SQL Server Machine Learning Services.

Ottimizzare il server per l'esecuzione di script esterni

Le impostazioni predefinite per il programma di installazione di SQL Server consentono di ottimizzare il bilanciamento del server per un'ampia gamma di servizi supportati dal motore di database, che possono includere processi di estrazione, trasformazione e caricamento (ETL), creazione di report, controllo e applicazioni che usano dati di SQL Server. Di conseguenza, con le impostazioni predefinite, è possibile che alle risorse per il Machine Learning siano applicate restrizioni o limitazioni, in particolare nel caso di operazioni che richiedono molta memoria.

Per assicurarsi che i processi di Machine Learning siano considerati come prioritari e dispongano delle risorse appropriate, è consigliabile usare la funzionalità Resource Governor di SQL Server per configurare un pool di risorse esterne. Può inoltre essere opportuno modificare la quantità di memoria allocata al motore di database di SQL Server o aumentare il numero di account eseguiti con il servizio Launchpad di SQL Server.

Se si usa l'edizione Standard e non è disponibile Resource Governor, per gestire le risorse del server usate da R è possibile usare le viste a gestione dinamica (DMV) e gli eventi estesi, oltre al monitoraggio eventi di Windows.

Installare pacchetti R aggiuntivi

Le soluzioni R create per SQL Server possono chiamare funzioni R di base, funzioni dei pacchetti proprietari installati con SQL Server e pacchetti R di terze parti compatibili con la versione di R open source installata da SQL Server.

I pacchetti di SQL Server da usare devono essere installati nella libreria predefinita usata dall'istanza. Se si ha un'installazione separata di R nel computer oppure se i pacchetti sono stati installati nelle librerie utente, non sarà possibile usare tali pacchetti da T-SQL.

Il processo di installazione e gestione dei pacchetti R in SQL Server 2016 è diverso da quello in SQL Server 2017. In SQL Server 2016, un amministratore di database deve installare i pacchetti R necessari agli utenti. In SQL Server 2017, è possibile configurare gruppi di utenti per condividere i pacchetti a livello di singolo database oppure configurare ruoli di database per consentire agli utenti di installare i propri pacchetti. Per altre informazioni, vedere Installare i pacchetti con gli strumenti R.

Passaggi successivi

Gli sviluppatori R possono iniziare alcuni semplici esempi e con le nozioni di base sul funzionamento di R con SQL Server. Per il passaggio successivo, vedere i collegamenti seguenti: