Configurare le impostazioni di SQL Server con variabili di ambiente in LinuxConfigure SQL Server settings with environment variables on Linux

SI APPLICA A: sìSQL Server (solo Linux) noDatabase SQL di Azure noAzure Synapse Analytics (SQL DW) noParallel Data Warehouse APPLIES TO: yesSQL Server (Linux only) noAzure SQL Database noAzure Synapse Analytics (SQL DW) noParallel Data Warehouse

Per configurare SQL Server 2017 in Linux è possibile usare diverse variabili di ambiente.You can use several different environment variables to configure SQL Server 2017 on Linux. Queste variabili vengono usate in due scenari:These variables are used in two scenarios:

Per configurare SQL Server 2019 in Linux è possibile usare diverse variabili di ambiente.You can use several different environment variables to configure SQL Server 2019 on Linux. Queste variabili vengono usate in due scenari:These variables are used in two scenarios:

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.If you need to configure SQL Server after these setup scenarios, see Configure SQL Server on Linux with the mssql-conf tool.

Variabili di ambienteEnvironment variables

Variabile di ambienteEnvironment variable DescrizioneDescription
ACCEPT_EULAACCEPT_EULA Impostare la variabile ACCEPT_EULA su qualsiasi valore per confermare l'accettazione delle condizioni di licenza .Set the ACCEPT_EULA variable to any value to confirm your acceptance of the End-User Licensing Agreement. Impostazione obbligatoria per l'immagine di SQL Server.Required setting for the SQL Server image.
MSSQL_SA_PASSWORDMSSQL_SA_PASSWORD Consente di configurare la password dell'utente SA.Configure the SA user password.
MSSQL_PIDMSSQL_PID Consente di impostare l'edizione o il codice Product Key di SQL Server.Set the SQL Server edition or product key. I valori possibili includono:Possible values include:
Copia di valutazioneEvaluation
SviluppatoreDeveloper
ExpressExpress
WebWeb
StandardStandard
EnterpriseEnterprise
Un codice Product KeyA product key

Se si specifica un codice Product Key, questo deve essere nel formato #####-#####-#####-#####-#####, dove '#' è un numero o una lettera.If specifying a product key, it must be in the form of #####-#####-#####-#####-#####, where '#' is a number or a letter.
MSSQL_LCIDMSSQL_LCID Imposta l'ID della lingua da usare per SQL Server.Sets the language ID to use for SQL Server. Ad esempio, 1036 corrisponde al francese.For example 1036 is French.
MSSQL_COLLATIONMSSQL_COLLATION Imposta le regole di confronto per SQL Server.Sets the default collation for SQL Server. In questo modo viene eseguito l'override del mapping predefinito dell'ID lingua (LCID) per le regole di confronto.This overrides the default mapping of language id (LCID) to collation.
MSSQL_MEMORY_LIMIT_MBMSSQL_MEMORY_LIMIT_MB Imposta la quantità massima di memoria (in MB) che SQL Server può usare.Sets the maximum amount of memory (in MB) that SQL Server can use. Per impostazione predefinita, corrisponde all'80% della memoria fisica totale.By default it is 80% of the total physical memory.
MSSQL_TCP_PORTMSSQL_TCP_PORT Consente di configurare la porta TCP su cui è in ascolto SQL Server (impostazione predefinita: 1433).Configure the TCP port that SQL Server listens on (default 1433).
MSSQL_IP_ADDRESSMSSQL_IP_ADDRESS Consente di impostare l'indirizzo IP.Set the IP address. Attualmente l'indirizzo IP deve essere nello stile IPv4 (0.0.0.0).Currently, the IP address must be IPv4 style (0.0.0.0).
MSSQL_BACKUP_DIRMSSQL_BACKUP_DIR Consente di usare il percorso della directory di backup predefinito.Set the Default backup directory location.
MSSQL_DATA_DIRMSSQL_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.Change the directory where the new SQL Server database data files (.mdf) are created.
MSSQL_LOG_DIRMSSQL_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.Change the directory where the new SQL Server database log (.ldf) files are created.
MSSQL_DUMP_DIRMSSQL_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.Change the directory where SQL Server will deposit the memory dumps and other troubleshooting files by default.
MSSQL_ENABLE_HADRMSSQL_ENABLE_HADR Consente di abilitare un gruppo di disponibilità.Enable Availability Group. Ad esempio, il valore '1' lo abilita e il valore '0' lo disabilitaFor example, '1' is enabled, and '0' is disabled
MSSQL_AGENT_ENABLEDMSSQL_AGENT_ENABLED Abilitare SQL Server Agent.Enable SQL Server Agent. Ad esempio, il valore 'true' lo abilita e il valore 'false' lo disabilita.For example, 'true' is enabled and 'false' is disabled. Per impostazione predefinita, l'agente è disabilitato.By default, agent is disabled.
MSSQL_MASTER_DATA_FILEMSSQL_MASTER_DATA_FILE Imposta il percorso del file di dati del database master.Sets the location of the master database data file. Il nome del file deve essere master.mdf fino alla prima esecuzione di SQL Server.Must be named master.mdf until first run of SQL Server.
MSSQL_MASTER_LOG_FILEMSSQL_MASTER_LOG_FILE Imposta il percorso del file di log del database master.Sets the location of the master database log file. Il nome del file deve essere mastlog.mdf fino alla prima esecuzione di SQL Server.Must be named mastlog.ldf until first run of SQL Server.
MSSQL_ERROR_LOG_FILEMSSQL_ERROR_LOG_FILE Imposta il percorso dei file di log degli errori.Sets the location of the errorlog files.
Variabile di ambienteEnvironment variable DescrizioneDescription
ACCEPT_EULAACCEPT_EULA Impostare la variabile ACCEPT_EULA su qualsiasi valore per confermare l'accettazione delle condizioni di licenza .Set the ACCEPT_EULA variable to any value to confirm your acceptance of the End-User Licensing Agreement. Impostazione obbligatoria per l'immagine di SQL Server.Required setting for the SQL Server image.
MSSQL_SA_PASSWORDMSSQL_SA_PASSWORD Consente di configurare la password dell'utente SA.Configure the SA user password.
MSSQL_PIDMSSQL_PID Consente di impostare l'edizione o il codice Product Key di SQL Server.Set the SQL Server edition or product key. I valori possibili includono:Possible values include:
Copia di valutazioneEvaluation
SviluppatoreDeveloper
ExpressExpress
WebWeb
StandardStandard
EnterpriseEnterprise
Un codice Product KeyA product key

Se si specifica un codice Product Key, questo deve essere nel formato #####-#####-#####-#####-#####, dove '#' è un numero o una lettera.If specifying a product key, it must be in the form of #####-#####-#####-#####-#####, where '#' is a number or a letter.
MSSQL_LCIDMSSQL_LCID Imposta l'ID della lingua da usare per SQL Server.Sets the language ID to use for SQL Server. Ad esempio, 1036 corrisponde al francese.For example 1036 is French.
MSSQL_COLLATIONMSSQL_COLLATION Imposta le regole di confronto per SQL Server.Sets the default collation for SQL Server. In questo modo viene eseguito l'override del mapping predefinito dell'ID lingua (LCID) per le regole di confronto.This overrides the default mapping of language id (LCID) to collation.
MSSQL_MEMORY_LIMIT_MBMSSQL_MEMORY_LIMIT_MB Imposta la quantità massima di memoria (in MB) che SQL Server può usare.Sets the maximum amount of memory (in MB) that SQL Server can use. Per impostazione predefinita, corrisponde all'80% della memoria fisica totale.By default it is 80% of the total physical memory.
MSSQL_TCP_PORTMSSQL_TCP_PORT Consente di configurare la porta TCP su cui è in ascolto SQL Server (impostazione predefinita: 1433).Configure the TCP port that SQL Server listens on (default 1433).
MSSQL_IP_ADDRESSMSSQL_IP_ADDRESS Consente di impostare l'indirizzo IP.Set the IP address. Attualmente l'indirizzo IP deve essere nello stile IPv4 (0.0.0.0).Currently, the IP address must be IPv4 style (0.0.0.0).
MSSQL_BACKUP_DIRMSSQL_BACKUP_DIR Consente di usare il percorso della directory di backup predefinito.Set the Default backup directory location.
MSSQL_DATA_DIRMSSQL_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.Change the directory where the new SQL Server database data files (.mdf) are created.
MSSQL_LOG_DIRMSSQL_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.Change the directory where the new SQL Server database log (.ldf) files are created.
MSSQL_DUMP_DIRMSSQL_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.Change the directory where SQL Server will deposit the memory dumps and other troubleshooting files by default.
MSSQL_ENABLE_HADRMSSQL_ENABLE_HADR Consente di abilitare un gruppo di disponibilità.Enable Availability Group. Ad esempio, il valore '1' lo abilita e il valore '0' lo disabilitaFor example, '1' is enabled, and '0' is disabled
MSSQL_AGENT_ENABLEDMSSQL_AGENT_ENABLED Abilitare SQL Server Agent.Enable SQL Server Agent. Ad esempio, il valore 'true' lo abilita e il valore 'false' lo disabilita.For example, 'true' is enabled and 'false' is disabled. Per impostazione predefinita, l'agente è disabilitato.By default, agent is disabled.
MSSQL_MASTER_DATA_FILEMSSQL_MASTER_DATA_FILE Imposta il percorso del file di dati del database master.Sets the location of the master database data file. Il nome del file deve essere master.mdf fino alla prima esecuzione di SQL Server.Must be named master.mdf until first run of SQL Server.
MSSQL_MASTER_LOG_FILEMSSQL_MASTER_LOG_FILE Imposta il percorso del file di log del database master.Sets the location of the master database log file. Il nome del file deve essere mastlog.mdf fino alla prima esecuzione di SQL Server.Must be named mastlog.ldf until first run of SQL Server.
MSSQL_ERROR_LOG_FILEMSSQL_ERROR_LOG_FILE Imposta il percorso dei file di log degli errori.Sets the location of the errorlog files.

Usare con la configurazione inizialeUse with initial setup

Questo esempio esegue mssql-conf setup con variabili di ambiente configurate.This example runs mssql-conf setup with configured environment variables. Vengono specificate le variabili di ambiente seguenti:The following environment variables are specified:

  • ACCEPT_EULA consente di accettare il contratto di licenza con l'utente finale.ACCEPT_EULA accepts the end user license agreement.
  • MSSQL_PID specifica la Developer Edition di SQL Server con licenza gratuita per l'uso non in produzione.MSSQL_PID specifies the freely licensed Developer Edition of SQL Server for non-production use.
  • MSSQL_SA_PASSWORD consente di impostare una password complessa.MSSQL_SA_PASSWORD sets a strong password.
  • MSSQL_TCP_PORT consente di configurare la porta TCP su cui è in ascolto SQL Server su 1234.MSSQL_TCP_PORT sets the TCP port that SQL Server listens on to 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 DockerUse with Docker

Questo comando Docker di esempio usa le variabili di ambiente seguenti per creare un nuovo contenitore di SQL Server:This example docker command uses the following environment variables to create a new SQL Server container:

  • ACCEPT_EULA consente di accettare il contratto di licenza con l'utente finale.ACCEPT_EULA accepts the end user license agreement.
  • MSSQL_PID specifica la Developer Edition di SQL Server con licenza gratuita per l'uso non in produzione.MSSQL_PID specifies the freely licensed Developer Edition of SQL Server for non-production use.
  • MSSQL_SA_PASSWORD consente di impostare una password complessa.MSSQL_SA_PASSWORD sets a strong password.
  • MSSQL_TCP_PORT consente di configurare la porta TCP su cui è in ascolto SQL Server su 1234.MSSQL_TCP_PORT sets the TCP port that SQL Server listens on to 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.This means that instead of mapping port 1433 (default) to a host port, the custom TCP port must be mapped with the -p 1234:1234 command in this example.

Se si esegue Docker in Linux o macOS, usare la sintassi seguente con virgolette singole:If you are running Docker on Linux/macOS, use the following syntax with single quotes:

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:2017-latest

Se si esegue Docker in Windows, usare la sintassi seguente con virgolette doppie:If you are running Docker on Windows, use the following syntax with double quotes:

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:2017-latest

Nota

Il processo di esecuzione delle edizioni di produzione nei contenitori è leggermente diverso.The process for running production editions in containers is slightly different. Per altre informazioni, vedere Run production container images (Eseguire immagini del contenitore di produzione).For more information, see Run production container images.

Se si esegue Docker in Linux o macOS, usare la sintassi seguente con virgolette singole:If you are running Docker on Linux/macOS, use the following syntax with single quotes:

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:2019-GA-ubuntu-16.04

Se si esegue Docker in Windows, usare la sintassi seguente con virgolette doppie:If you are running Docker on Windows, use the following syntax with double quotes:

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:2019-GA-ubuntu-16.04

Passaggi successiviNext steps

Per altre impostazioni di SQL Server non elencate, vedere Configurare SQL Server in Linux con lo strumento mssql-conf.For other SQL Server settings not listed here, see Configure SQL Server on Linux with the mssql-conf tool.

Per altre informazioni su come installare ed eseguire SQL Server in Linux, vedere Installare SQL Server in Linux.For more information on how to install and run SQL Server on Linux, see Install SQL Server on Linux.