Настройка параметров SQL Server с помощью переменных среды в LinuxConfigure SQL Server settings with environment variables on Linux

Область применения:  ДаSQL Server (только в Linux) НетБаза данных SQL Azure НетХранилище данных SQL AzureНетParallel Data Warehouse APPLIES TO: yesSQL Server (Linux only) noAzure SQL Database noAzure SQL Data Warehouse noParallel Data Warehouse

Для настройки SQL Server 2017 на Linux можно использовать несколько различных переменных среды.You can use several different environment variables to configure SQL Server 2017 on Linux. Эти переменные используются в двух сценариях:These variables are used in two scenarios:

Для настройки предварительной версии SQL Server 2019 на Linux можно использовать несколько различных переменных среды.You can use several different environment variables to configure SQL Server 2019 preview on Linux. Эти переменные используются в двух сценариях:These variables are used in two scenarios:

Совет

Если требуется выполнить настройку SQL Server после начальной настройки, ознакомьтесь с разделом Настройка SQL Server на Linux с помощью средства mssql-conf.If you need to configure SQL Server after these setup scenarios, see Configure SQL Server on Linux with the mssql-conf tool.

Переменные средыEnvironment variables

Переменная средыEnvironment variable ОписаниеDescription
ACCEPT_EULAACCEPT_EULA Присвойте переменной ACCEPT_EULA любое значение, чтобы подтвердить свое согласие с лицензионным соглашением.Set the ACCEPT_EULA variable to any value to confirm your acceptance of the End-User Licensing Agreement. Обязательный параметр для образа SQL Server.Required setting for the SQL Server image.
MSSQL_SA_PASSWORDMSSQL_SA_PASSWORD Настройте пароль пользователя SA.Configure the SA user password.
MSSQL_PIDMSSQL_PID Укажите выпуск SQL Server или ключ продукта.Set the SQL Server edition or product key. Возможные значения.Possible values include:
Ознакомительная версияEvaluation
РазработчикDeveloper
ExpressExpress
WebWeb
Standard EditionStandard
EnterpriseEnterprise
Ключ продуктаA product key

Если указывается ключ продукта, он должен соответствовать формату #####-#####-#####-#####-#####, где каждый знак "#" представляет собой букву или цифру.If specifying a product key, it must be in the form of #####-#####-#####-#####-#####, where '#' is a number or a letter.
MSSQL_LCIDMSSQL_LCID Задайте идентификатор языка для SQL Server.Sets the language ID to use for SQL Server. Например, значение 1036 соответствует французскому языку.For example 1036 is French.
MSSQL_COLLATIONMSSQL_COLLATION Задает параметры сортировки по умолчанию для SQL Server.Sets the default collation for SQL Server. Переопределяет заданное по умолчанию сопоставление идентификатора языка (LCID) и параметров сортировки.This overrides the default mapping of language id (LCID) to collation.
MSSQL_MEMORY_LIMIT_MBMSSQL_MEMORY_LIMIT_MB Задает максимальный объем памяти (в МБ), который может использовать SQL Server.Sets the maximum amount of memory (in MB) that SQL Server can use. По умолчанию используется 80 % от общего объема физической памяти.By default it is 80% of the total physical memory.
MSSQL_TCP_PORTMSSQL_TCP_PORT Настройте порт TCP, который будет прослушивать SQL Server (по умолчанию 1433).Configure the TCP port that SQL Server listens on (default 1433).
MSSQL_IP_ADDRESSMSSQL_IP_ADDRESS Укажите IP-адрес.Set the IP address. На данный момент необходимо задавать IP-адрес в стиле IPv4 (0.0.0.0).Currently, the IP address must be IPv4 style (0.0.0.0).
MSSQL_BACKUP_DIRMSSQL_BACKUP_DIR Задайте каталог резервного копирования по умолчанию.Set the Default backup directory location.
MSSQL_DATA_DIRMSSQL_DATA_DIR Измените каталог, в котором создаются новые файлы данных (MDF) базы данных SQL Server.Change the directory where the new SQL Server database data files (.mdf) are created.
MSSQL_LOG_DIRMSSQL_LOG_DIR Измените каталог, в котором создаются новые файлы журнала (LDF) базы данных SQL Server.Change the directory where the new SQL Server database log (.ldf) files are created.
MSSQL_DUMP_DIRMSSQL_DUMP_DIR Измените каталог, в котором по умолчанию будут размещаться дампы памяти SQL Server, а также другие файлы для устранения неполадок.Change the directory where SQL Server will deposit the memory dumps and other troubleshooting files by default.
MSSQL_ENABLE_HADRMSSQL_ENABLE_HADR Включение группы доступности.Enable Availability Group. Например, значение "1" включает группу, а "0" отключает ее.For example, '1' is enabled, and '0' is disabled
MSSQL_AGENT_ENABLEDMSSQL_AGENT_ENABLED Включение агента SQL Server.Enable SQL Server Agent. Например, значение "true" включает агент, а "false" отключает его.For example, 'true' is enabled and 'false' is disabled. По умолчанию агент отключен.By default, agent is disabled.
MSSQL_MASTER_DATA_FILEMSSQL_MASTER_DATA_FILE Задает местонахождение файла базы данных master.Sets the location of the master database data file. До первого запуска SQL Server этот файл должен иметь имя master.mdf.Must be named master.mdf until first run of SQL Server.
MSSQL_MASTER_LOG_FILEMSSQL_MASTER_LOG_FILE Задает местонахождение файла журнала базы данных master.Sets the location of the master database log file. До первого запуска SQL Server этот файл должен иметь имя mastlog.ldf.Must be named mastlog.ldf until first run of SQL Server.
MSSQL_ERROR_LOG_FILEMSSQL_ERROR_LOG_FILE Задает местонахождение файлов журнала ошибок.Sets the location of the errorlog files.
Переменная средыEnvironment variable ОписаниеDescription
ACCEPT_EULAACCEPT_EULA Присвойте переменной ACCEPT_EULA любое значение, чтобы подтвердить свое согласие с лицензионным соглашением.Set the ACCEPT_EULA variable to any value to confirm your acceptance of the End-User Licensing Agreement. Обязательный параметр для образа SQL Server.Required setting for the SQL Server image.
MSSQL_SA_PASSWORDMSSQL_SA_PASSWORD Настройте пароль пользователя SA.Configure the SA user password.
MSSQL_PIDMSSQL_PID Укажите выпуск SQL Server или ключ продукта.Set the SQL Server edition or product key. Возможные значения.Possible values include:
Ознакомительная версияEvaluation
РазработчикDeveloper
ExpressExpress
WebWeb
Standard EditionStandard
EnterpriseEnterprise
Ключ продуктаA product key

Если указывается ключ продукта, он должен соответствовать формату #####-#####-#####-#####-#####, где каждый знак "#" представляет собой букву или цифру.If specifying a product key, it must be in the form of #####-#####-#####-#####-#####, where '#' is a number or a letter.
MSSQL_LCIDMSSQL_LCID Задайте идентификатор языка для SQL Server.Sets the language ID to use for SQL Server. Например, значение 1036 соответствует французскому языку.For example 1036 is French.
MSSQL_COLLATIONMSSQL_COLLATION Задает параметры сортировки по умолчанию для SQL Server.Sets the default collation for SQL Server. Переопределяет заданное по умолчанию сопоставление идентификатора языка (LCID) и параметров сортировки.This overrides the default mapping of language id (LCID) to collation.
MSSQL_MEMORY_LIMIT_MBMSSQL_MEMORY_LIMIT_MB Задает максимальный объем памяти (в МБ), который может использовать SQL Server.Sets the maximum amount of memory (in MB) that SQL Server can use. По умолчанию используется 80 % от общего объема физической памяти.By default it is 80% of the total physical memory.
MSSQL_TCP_PORTMSSQL_TCP_PORT Настройте порт TCP, который будет прослушивать SQL Server (по умолчанию 1433).Configure the TCP port that SQL Server listens on (default 1433).
MSSQL_IP_ADDRESSMSSQL_IP_ADDRESS Укажите IP-адрес.Set the IP address. На данный момент необходимо задавать IP-адрес в стиле IPv4 (0.0.0.0).Currently, the IP address must be IPv4 style (0.0.0.0).
MSSQL_BACKUP_DIRMSSQL_BACKUP_DIR Задайте каталог резервного копирования по умолчанию.Set the Default backup directory location.
MSSQL_DATA_DIRMSSQL_DATA_DIR Измените каталог, в котором создаются новые файлы данных (MDF) базы данных SQL Server.Change the directory where the new SQL Server database data files (.mdf) are created.
MSSQL_LOG_DIRMSSQL_LOG_DIR Измените каталог, в котором создаются новые файлы журнала (LDF) базы данных SQL Server.Change the directory where the new SQL Server database log (.ldf) files are created.
MSSQL_DUMP_DIRMSSQL_DUMP_DIR Измените каталог, в котором по умолчанию будут размещаться дампы памяти SQL Server, а также другие файлы для устранения неполадок.Change the directory where SQL Server will deposit the memory dumps and other troubleshooting files by default.
MSSQL_ENABLE_HADRMSSQL_ENABLE_HADR Включение группы доступности.Enable Availability Group. Например, значение "1" включает группу, а "0" отключает ее.For example, '1' is enabled, and '0' is disabled
MSSQL_AGENT_ENABLEDMSSQL_AGENT_ENABLED Включение агента SQL Server.Enable SQL Server Agent. Например, значение "true" включает агент, а "false" отключает его.For example, 'true' is enabled and 'false' is disabled. По умолчанию агент отключен.By default, agent is disabled.
MSSQL_MASTER_DATA_FILEMSSQL_MASTER_DATA_FILE Задает местонахождение файла базы данных master.Sets the location of the master database data file. До первого запуска SQL Server этот файл должен иметь имя master.mdf.Must be named master.mdf until first run of SQL Server.
MSSQL_MASTER_LOG_FILEMSSQL_MASTER_LOG_FILE Задает местонахождение файла журнала базы данных master.Sets the location of the master database log file. До первого запуска SQL Server этот файл должен иметь имя mastlog.ldf.Must be named mastlog.ldf until first run of SQL Server.
MSSQL_ERROR_LOG_FILEMSSQL_ERROR_LOG_FILE Задает местонахождение файлов журнала ошибок.Sets the location of the errorlog files.

Использование с начальной настройкойUse with initial setup

В этом примере mssql-conf setup запускается с настроенными переменными среды.This example runs mssql-conf setup with configured environment variables. Заданы следующие переменные среды:The following environment variables are specified:

  • ACCEPT_EULA — принимает условия лицензионного соглашения.ACCEPT_EULA accepts the end user license agreement.
  • MSSSQL_PID — задает выпуск SQL Server Developer Edition с бесплатной лицензией для нерабочего использования.MSSSQL_PID specifies the freely licensed Developer Edition of SQL Server for non-production use.
  • MSSQL_SA_PASSWORD — задает надежный пароль.MSSQL_SA_PASSWORD sets a strong password.
  • MSSQL_TCP_PORT — задает порт TCP 1234, который будет прослушивать SQL Server.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

Использование с DockerUse with Docker

В этом примере в команде docker используются следующие переменные среды для создания нового контейнера SQL Server:This example docker command uses the following environment variables to create a new SQL Server container:

  • ACCEPT_EULA — принимает условия лицензионного соглашения.ACCEPT_EULA accepts the end user license agreement.
  • MSSSQL_PID — задает выпуск SQL Server Developer Edition с бесплатной лицензией для нерабочего использования.MSSSQL_PID specifies the freely licensed Developer Edition of SQL Server for non-production use.
  • MSSQL_SA_PASSWORD — задает надежный пароль.MSSQL_SA_PASSWORD sets a strong password.
  • MSSQL_TCP_PORT — задает порт TCP 1234, который будет прослушивать SQL Server.MSSQL_TCP_PORT sets the TCP port that SQL Server listens on to 1234. Это означает, что вместо сопоставления порта 1433 (по умолчанию) с портом узла в этом примере необходимо выполнить сопоставление пользовательского порта TCP с помощью команды -p 1234:1234.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.

Если вы работаете с Docker в Linux/macOS, используйте следующий синтаксис с одинарными кавычками: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

Если вы работаете с Docker в Windows, используйте следующий синтаксис с двойными кавычками: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

Примечание

Процесс запуска контейнера с производственными выпусками немного отличается.The process for running production editions in containers is slightly different. Дополнительные сведения см. в разделе Запуск образов контейнеров с производственными выпусками.For more information, see Run production container images.

Если вы работаете с Docker в Linux/macOS, используйте следующий синтаксис с одинарными кавычками: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-CTP3.2-ubuntu

Если вы работаете с Docker в Windows, используйте следующий синтаксис с двойными кавычками: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-CTP3.2-ubuntu

Следующие шагиNext steps

Другие параметры SQL Server, не представленные здесь, описываются в статье Настройка SQL Server на Linux с помощью средства mssql-conf.For other SQL Server settings not listed here, see Configure SQL Server on Linux with the mssql-conf tool.

Дополнительные сведения об установке и запуске SQL Server на Linux см. в статье Установка SQL Server на Linux.For more information on how to install and run SQL Server on Linux, see Install SQL Server on Linux.