Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Si applica a:
SQL Server - Linux
È possibile usare diverse variabili di ambiente per configurare SQL Server in Linux. Queste variabili vengono usate in due scenari:
- Per definire la configurazione iniziale con il comando
mssql-conf setup. - Per configurare una nuova immagine del contenitore Linux di SQL Server.
Suggerimento
Se è necessario configurare scenari di SQL Server simili a questi scenari di installazione, vedere Configurare SQL Server in Linux con lo strumento mssql-conf.
Variabili di ambiente
| Variabile di ambiente | Descrizione |
|---|---|
ACCEPT_EULA |
Impostare la variabile ACCEPT_EULA su un valore qualsiasi per confermare l'accettazione del contratto di licenza con l'utente finale. Impostazione obbligatoria per l'immagine di SQL Server. |
MSSQL_SA_PASSWORD |
Configurare la sa password.La variabile di ambiente SA_PASSWORD è deprecata. Utilizzare invece MSSQL_SA_PASSWORD. |
MSSQL_PID |
Impostare l'edizione o il codice Product Key di SQL Server . I valori possibili sono elencati nella tabella delle edizioni di SQL Server seguenti. Se si specifica un codice Product Key, deve essere sotto forma di #####-#####-#####-#####-#####, dove # è un numero o una lettera. |
MSSQL_LCID |
Imposta l'ID della lingua da usare per SQL Server. Ad esempio, 1036 corrisponde al francese. |
MSSQL_COLLATION |
Imposta le regole di confronto predefinite per SQL Server. In questo modo viene sostituito il mapping predefinito dell'ID lingua (LCID) per la collation. |
MSSQL_MEMORY_LIMIT_MB |
Imposta la quantità massima di memoria (in MB) che SQL Server può usare. Per impostazione predefinita, corrisponde all'80% della memoria fisica totale. |
MSSQL_TCP_PORT |
Consente di configurare la porta TCP su cui è in ascolto SQL Server (impostazione predefinita: 1433). |
MSSQL_IP_ADDRESS |
Imposta l'indirizzo IP. Attualmente l'indirizzo IP deve essere nello stile IPv4 (0.0.0.0). |
MSSQL_BACKUP_DIR |
Imposta la posizione predefinita della directory di backup. |
MSSQL_DATA_DIR |
Consente di cambiare la directory in cui vengono creati i file di dati (con estensione .mdf) di un nuovo database di SQL Server. |
MSSQL_LOG_DIR |
Consente di cambiare la directory in cui vengono creati i file di log (con estensione .ldf) di un nuovo database di SQL Server. |
MSSQL_DUMP_DIR |
Consente di cambiare la directory in cui SQL Server deposita i dump della memoria e altri file per la risoluzione dei problemi per impostazione predefinita. |
MSSQL_ENABLE_HADR |
Attiva gruppo di disponibilità. Ad esempio, il valore '1' lo abilita e il valore '0' lo disabilita |
MSSQL_AGENT_ENABLED |
Abilitare SQL Server Agent. Ad esempio, il valore 'true' lo abilita e il valore 'false' lo disabilita. Per impostazione predefinita, l'agente è disabilitato. |
MSSQL_MASTER_DATA_FILE |
Imposta il percorso del file di dati del database master. Il nome del file deve essere master.mdf fino alla prima esecuzione di SQL Server. |
MSSQL_MASTER_LOG_FILE |
Imposta il percorso del file di log del database master. Il nome del file deve essere mastlog.ldf fino alla prima esecuzione di SQL Server. |
MSSQL_ERROR_LOG_FILE |
Imposta la posizione dei file errorlog. Ad esempio: /var/opt/mssql/log/errorlog. |
Edizioni di SQL Server
MSSQL_PID |
Edition |
|---|---|
Evaluation |
SQL Server Edizione di Valutazione |
Developer |
SQL Server Developer Edition |
Express |
SQL Server Express Edition |
Web |
Edizione Web di SQL Server |
Standard |
SQL Server Standard Edizione |
Enterprise |
Questa opzione legacy rappresenta le licenze basate su Enterprise Edition Server + Licenza CAL (Client Access License) ed è limitata a un massimo di 20 core per ogni istanza di SQL Server.
Enterprise non è disponibile per i nuovi contratti. Scegliere EnterpriseCore quando si vuole distribuire l’edizione Enterprise. |
EnterpriseCore |
SQL Server Enterprise Core Edition.
EnterpriseCore rappresenta il modello di licenza del server basato su core senza limiti. Per altre informazioni, vedere Limiti della capacità di calcolo per edizione di SQL Server. |
A product key |
Se si specifica un codice Product Key, deve essere sotto forma di #####-#####-#####-#####-#####, dove # è un numero o una lettera. |
Per altre informazioni su queste edizioni, vedere Edizioni di SQL Server.
MSSQL_PID |
Edition |
|---|---|
Evaluation |
SQL Server Edizione di Valutazione |
Express |
SQL Server Express Edition |
StandardDeveloper(Per i contenitori, usare DeveloperStandard) |
SQL Server Standard Developer Edition |
Standard |
SQL Server Standard Edizione |
EnterpriseDeveloper(Per i contenitori, usare Developer) |
SQL Server Enterprise Developer Edition |
Enterprise |
Questa opzione legacy rappresenta le licenze basate su Enterprise Edition Server + Licenza CAL (Client Access License) ed è limitata a un massimo di 20 core per ogni istanza di SQL Server.
Enterprise non è disponibile per i nuovi contratti. Scegliere EnterpriseCore quando si vuole distribuire l’edizione Enterprise. |
EnterpriseCore |
SQL Server Enterprise Core Edition.
EnterpriseCore rappresenta il modello di licenza del server basato su core senza limiti. Per altre informazioni, vedere Limiti della capacità di calcolo per edizione di SQL Server. |
A product key |
Se si specifica un codice Product Key, deve essere sotto forma di #####-#####-#####-#####-#####, dove # è un numero o una lettera. |
Per altre informazioni su queste edizioni, vedere Edizioni di SQL Server.
Usare con la configurazione iniziale
Questo esempio esegue mssql-conf setup con variabili di ambiente configurate. Vengono specificate le variabili di ambiente seguenti:
ACCEPT_EULAaccetta il Contratto di Licenza con l'utente finale.MSSQL_PIDspecifica la Developer Edition di SQL Server con licenza gratuita per l'uso non in produzione.MSSQL_SA_PASSWORDimposta una password forte. La password deve seguire i criteri password predefiniti di SQL Server. Per impostazione predefinita, la password deve essere composta da almeno otto caratteri e contenere caratteri di tre delle quattro categorie seguenti: lettere maiuscole, lettere minuscole, cifre in base 10 e simboli. Le password possono contenere fino a 128 caratteri. Usare password il più possibile lunghe e complesse.MSSQL_TCP_PORTconsente di configurare la porta TCP su cui è in ascolto SQL Server su 1234.
sudo ACCEPT_EULA='Y' MSSQL_PID='Developer' MSSQL_SA_PASSWORD='<password>' MSSQL_TCP_PORT=1234 /opt/mssql/bin/mssql-conf setup
Uso con Docker
Questo comando docker di esempio usa le variabili di ambiente seguenti per creare un nuovo contenitore di SQL Server:
ACCEPT_EULAaccetta il Contratto di Licenza con l'utente finale.MSSQL_PIDspecifica la Developer Edition di SQL Server con licenza gratuita per l'uso non in produzione.Quando si distribuisce un contenitore per SQL Server 2025 (17.x) o una versione successiva, usare
MSSQL_PID=DeveloperStandardper Standard Developer Edition eMSSQL_PID=Developerper Enterprise Developer Edition.MSSQL_SA_PASSWORDimposta una password forte. La password deve seguire i criteri password predefiniti di SQL Server. Per impostazione predefinita, la password deve essere composta da almeno otto caratteri e contenere caratteri di tre delle quattro categorie seguenti: lettere maiuscole, lettere minuscole, cifre in base 10 e simboli. Le password possono contenere fino a 128 caratteri. Usare password il più possibile lunghe e complesse.MSSQL_TCP_PORTconsente di configurare la porta TCP su cui è in ascolto SQL Server su 1234. Ciò significa che anziché eseguire il mapping della porta 1433 (impostazione predefinita) a una porta host, è necessario eseguire il mapping della porta TCP personalizzata con il comando-p 1234:1234riportato in questo esempio.
Se si esegue Docker in Linux, usare la sintassi seguente con virgolette singole:
docker run -e ACCEPT_EULA=Y -e MSSQL_PID='Developer' -e MSSQL_SA_PASSWORD='<password>' -e MSSQL_TCP_PORT=1234 -p 1234:1234 -d mcr.microsoft.com/mssql/server:2017-latest
Se si esegue Docker in Windows, usare la sintassi seguente con virgolette doppie:
docker run -e ACCEPT_EULA=Y -e MSSQL_PID="Developer" -e MSSQL_SA_PASSWORD="<password>" -e MSSQL_TCP_PORT=1234 -p 1234:1234 -d mcr.microsoft.com/mssql/server:2017-latest
Nota
Il processo di esecuzione delle edizioni di produzione nei contenitori è leggermente diverso. Per altre informazioni, vedere Run production container images (Eseguire immagini del contenitore di produzione).
Se si esegue Docker in Linux, usare la sintassi seguente con virgolette singole:
docker run -e ACCEPT_EULA=Y -e MSSQL_PID='Developer' -e MSSQL_SA_PASSWORD='<password>' -e MSSQL_TCP_PORT=1234 -p 1234:1234 -d mcr.microsoft.com/mssql/server:2019-latest
Se si esegue Docker in Windows, usare la sintassi seguente con virgolette doppie:
docker run -e ACCEPT_EULA=Y -e MSSQL_PID="Developer" -e MSSQL_SA_PASSWORD="<password>" -e MSSQL_TCP_PORT=1234 -p 1234:1234 -d mcr.microsoft.com/mssql/server:2019-latest
Se si esegue Docker in Linux, usare la sintassi seguente con virgolette singole:
docker run -e ACCEPT_EULA=Y -e MSSQL_PID='Developer' -e MSSQL_SA_PASSWORD='<password>' -e MSSQL_TCP_PORT=1234 -p 1234:1234 -d mcr.microsoft.com/mssql/server:2022-latest
Se si esegue Docker in Windows, usare la sintassi seguente con virgolette doppie:
docker run -e ACCEPT_EULA=Y -e MSSQL_PID="Developer" -e MSSQL_SA_PASSWORD="<password>" -e MSSQL_TCP_PORT=1234 -p 1234:1234 -d mcr.microsoft.com/mssql/server:2022-latest
Se si esegue Docker in Linux, usare la sintassi seguente con virgolette singole:
docker run -e ACCEPT_EULA=Y -e MSSQL_PID='Developer' -e MSSQL_SA_PASSWORD='<password>' -e MSSQL_TCP_PORT=1234 -p 1234:1234 -d mcr.microsoft.com/mssql/server:2025-latest
Se si esegue Docker in Windows, usare la sintassi seguente con virgolette doppie:
docker run -e ACCEPT_EULA=Y -e MSSQL_PID="Developer" -e MSSQL_SA_PASSWORD="<password>" -e MSSQL_TCP_PORT=1234 -p 1234:1234 -d mcr.microsoft.com/mssql/server:2025-latest
Quando si distribuisce un contenitore per SQL Server 2025 (17.x) o una versione successiva, usare MSSQL_PID=DeveloperStandard per Standard Developer Edition e MSSQL_PID=Developer per Enterprise Developer Edition.
Attenzione
La password deve seguire i criteri password predefiniti di SQL Server. Per impostazione predefinita, la password deve essere composta da almeno otto caratteri e contenere caratteri di tre delle quattro categorie seguenti: lettere maiuscole, lettere minuscole, cifre in base 10 e simboli. Le password possono contenere fino a 128 caratteri. Usare password il più possibile lunghe e complesse.
Contenuto correlato
- Configurare SQL Server in Linux con lo strumento mssql-conf
- Linee guida per l'installazione di SQL Server in Linux
Contribuire alla documentazione di SQL
Sapevi che puoi modificare tu stesso il contenuto SQL? L'autore delle modifiche contribuirà a migliorare la documentazione e verrà accreditato come collaboratore alla realizzazione della pagina.
Per altre informazioni, vedere Modificare la documentazione di Microsoft Learn.