Configurare le impostazioni di SQL Server con variabili di ambiente in Linux

Si applica a: SQL Server - Linux

Per configurare SQL Server 2022 (16.x) in Linux è possibile usare diverse variabili di ambiente. Queste variabili vengono usate in due scenari:

• Per definire la configurazione iniziale con il comando mssql-conf setup.
• Per configurare un nuovo contenitore di SQL Server in Docker.

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	Consente di configurare la password dell'utente SA. La variabile di ambiente SA_PASSWORD è deprecata. Utilizzare invece MSSQL_SA_PASSWORD.
MSSQL_PID	Consente di impostare l'edizione o il codice Product Key di SQL Server. I valori possibili includono: Evaluation Developer Express Web Standard Enterprise 1 EnterpriseCore 1 A product key Se si specifica un codice Product Key, questo deve essere nel formato #####-#####-#####-#####-#####, 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 per SQL Server. In questo modo viene eseguito l'override del mapping predefinito dell'ID lingua (LCID) per le regole di confronto.
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	Consente di impostare l'indirizzo IP. Attualmente l'indirizzo IP deve essere nello stile IPv4 (0.0.0.0).
MSSQL_BACKUP_DIR	Consente di usare il percorso della directory di backup predefinito.
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	Consente di abilitare un 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.

¹ La licenza legacy Enterprise rappresenta l’edizione Enterprise con licenza basata su Server + Licenza CAL (Client Access License) ed è limitata a un massimo di 20 core per istanza di SQL Server. Enterprise non è disponibile per i nuovi contratti. Scegliere EnterpriseCore quando si vuole distribuire l’edizione Enterprise. EnterpriseCore rappresenta il modello di licenza del server basato su core senza limiti di core. Per altre informazioni, vedere Limiti della capacità di calcolo per edizione 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_EULA accetta il Contratto di Licenza con l'utente finale.
• MSSQL_PID specifica la Developer Edition di SQL Server con licenza gratuita per l'uso non in produzione.
• MSSQL_SA_PASSWORD imposta una password complessa.
• MSSQL_TCP_PORT consente di configurare la porta TCP su cui è in ascolto SQL Server su 1234.

sudo ACCEPT_EULA='Y' MSSQL_PID='Developer' MSSQL_SA_PASSWORD='<YourStrong!Passw0rd>' 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_EULA accetta il Contratto di Licenza con l'utente finale.
• MSSQL_PID specifica la Developer Edition di SQL Server con licenza gratuita per l'uso non in produzione.
• MSSQL_SA_PASSWORD imposta una password complessa.
• MSSQL_TCP_PORT consente 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:1234 riportato 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='<YourStrong!Passw0rd>' -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="<YourStrong!Passw0rd>" -e MSSQL_TCP_PORT=1234 -p 1234:1234 -d mcr.microsoft.com/mssql/server:2022-latest

Contenuto correlato

• Configurare SQL Server in Linux con lo strumento mssql-conf
• Installare SQL Server in Linux

Contribuire alla documentazione di SQL

Il contenuto SQL può essere modificato. L'autore delle modifiche contribuirà a migliorare la documentazione e verrà accreditato come collaboratore alla realizzazione della pagina.

Per maggiori informazioni, vedere Come contribuire alla documentazione di SQL Server