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

QUESTO ARGOMENTO SI APPLICA A: SìSQL Server (solo Linux)nonDatabase SQL di AzurenonAzure SQL Data Warehousenon Parallel Data Warehouse THIS TOPIC APPLIES TO: yesSQL Server (Linux only)noAzure SQL DatabasenoAzure SQL Data WarehousenoParallel Data Warehouse

È possibile utilizzare diverse variabili di ambiente diverso per configurare SQL Server 2017 su Linux.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:

Suggerimento

Se è necessario configurare SQL Server dopo 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 DescriptionDescription
ACCEPT_EULAACCEPT_EULA Accettare il contratto di licenza di SQL Server quando è impostato su qualsiasi valore (ad esempio, "Y").Accept the SQL Server license agreement when set to any value (for example, 'Y').
MSSQL_SA_PASSWORDMSSQL_SA_PASSWORD Configurare la password dell'utente dell'amministratore di sistema.Configure the SA user password.
MSSQL_PIDMSSQL_PID Impostare la chiave di edizione o del prodotto 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, 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 di lingua da usare per SQL Server.Sets the language ID to use for SQL Server. Ad esempio 1036 è il francese.For example 1036 is French.
MSSQL_COLLATIONMSSQL_COLLATION Imposta le regole di confronto predefinite per SQL Server.Sets the default collation for SQL Server. Questa impostazione sostituisce il mapping predefinito degli id di 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 è possibile usare SQL Server.Sets the maximum amount of memory (in MB) that SQL Server can use. Per impostazione predefinita è l'80% della memoria fisica totale.By default it is 80% of the total physical memory.
MSSQL_TCP_PORTMSSQL_TCP_PORT Configurare la porta TCP in ascolto il Server SQL (valore predefinito 1433).Configure the TCP port that SQL Server listens on (default 1433).
MSSQL_IP_ADDRESSMSSQL_IP_ADDRESS Impostare l'indirizzo IP.Set the IP address. Attualmente, l'indirizzo IP deve essere IPv4 stile (0.0.0.0).Currently, the IP address must be IPv4 style (0.0.0.0).
MSSQL_BACKUP_DIRMSSQL_BACKUP_DIR Impostare il percorso di directory di backup predefinito.Set the Default backup directory location.
MSSQL_DATA_DIRMSSQL_DATA_DIR Passare alla directory in cui vengono creati i nuovi file di dati di SQL Server database (mdf).Change the directory where the new SQL Server database data files (.mdf) are created.
MSSQL_LOG_DIRMSSQL_LOG_DIR Passare alla directory in cui vengono creati i nuovi file di log (ldf) del database di SQL Server.Change the directory where the new SQL Server database log (.ldf) files are created.
MSSQL_DUMP_DIRMSSQL_DUMP_DIR Passare alla directory in cui SQL Server verrà depositare i dump di memoria e altri file sulla 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 Abilitare il gruppo di disponibilità.Enable Availability Group. Ad esempio, '1' è abilitata, e '0' è disabilitatoFor example, '1' is enabled, and '0' is disabled
MSSQL_AGENT_ENABLEDMSSQL_AGENT_ENABLED Abilitare SQL Server Agent.Enable SQL Server Agent. Ad esempio, è abilitato 'true' e 'false' è disabilitata.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 database master.Sets the location of the master database data file.
MSSQL_MASTER_LOG_FILEMSSQL_MASTER_LOG_FILE Imposta il percorso del file di log database master.Sets the location of the master database log file.
MSSQL_ERROR_LOG_FILEMSSQL_ERROR_LOG_FILE Imposta il percorso dei file di log degli errori.Sets the location of the errorlog files.

Esempio: configurazione inizialeExample: initial setup

Questo esempio viene eseguito mssql-conf setup con configurato le variabili di ambiente.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 accetta il contratto di licenza utente finale.ACCEPT_EULA accepts the end user license agreement.
  • MSSSQL_PID specifica con licenza gratuita per gli sviluppatori edizione di SQL Server per l'uso non di produzione.MSSSQL_PID specifies the freely licensed Developer Edition of SQL Server for non-production use.
  • MSSQL_SA_PASSWORD imposta una password complessa.MSSQL_SA_PASSWORD sets a strong password.
  • MSSQL_TCP_PORT imposta la porta TCP che SQL Server è in ascolto al 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

Esempio: DockerExample: Docker

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

  • ACCEPT_EULA accetta il contratto di licenza utente finale.ACCEPT_EULA accepts the end user license agreement.
  • MSSSQL_PID specifica con licenza gratuita per gli sviluppatori edizione di SQL Server per l'uso non di produzione.MSSSQL_PID specifies the freely licensed Developer Edition of SQL Server for non-production use.
  • MSSQL_SA_PASSWORD imposta una password complessa.MSSQL_SA_PASSWORD sets a strong password.
  • MSSQL_TCP_PORT imposta la porta TCP che SQL Server è in ascolto al 1234.MSSQL_TCP_PORT sets the TCP port that SQL Server listens on to 1234. Ciò significa che invece di mapping la porta 1433 (valore predefinito) a una porta dell'host, la porta TCP personalizzata deve essere mappata con il -p 1234:1234 comando 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 su Linux/macOS, usare la sintassi seguente con le 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 microsoft/mssql-server-linux:2017-latest

Se si esegue Docker in Windows, usare la sintassi seguente con le 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 microsoft/mssql-server-linux: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.

Passaggi successiviNext steps

Per altre impostazioni di SQL Server non elencate qui, 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.