Linux 上の SQL Server の設定を環境変数で構成するConfigure SQL Server settings with environment variables on Linux

このトピックに適用されますはいSQL Server (Linux の場合のみ)ありませんAzure SQL DatabaseありませんAzure SQL Data Warehouseありません。並列データ ウェアハウス THIS TOPIC APPLIES TO: yesSQL Server (Linux only)noAzure SQL DatabasenoAzure SQL Data WarehousenoParallel Data Warehouse

いくつかの別の環境変数を使用して、Linux 上の SQL Server 2017 を構成することができます。You can use several different environment variables to configure SQL Server 2017 on Linux. これらの変数は、2 つのシナリオで使用されます。These variables are used in two scenarios:

ヒント

これらのシナリオのセットアップ後に SQL Server を構成する必要がある場合は、次を参照してください。 mssql-conf ツールを使用して Linux 上の SQL Server を構成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 DescriptionDescription
ACCEPT_EULAACCEPT_EULA 任意の値 (たとえば、' Y') を設定すると SQL Server のライセンス契約に同意します。Accept the SQL Server license agreement when set to any value (for example, 'Y').
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:
EvaluationEvaluation
DeveloperDeveloper
ExpressExpress
WebWeb
StandardStandard
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 に使用する言語 ID を設定します。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. 照合順序には、言語 id (LCID) の既定のマッピングが上書きされます。This overrides the default mapping of language id (LCID) to collation.
MSSQL_MEMORY_LIMIT_MBMSSQL_MEMORY_LIMIT_MB SQL Server が使用できる最大メモリサイズ (MB) を設定します。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 SQL Server がリッスンする TCP ポート (既定は 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 新しい SQL Server データベースのデータ ファイル (.mdf) が作成されるディレクトリを変更します。Change the directory where the new SQL Server database data files (.mdf) are created.
MSSQL_LOG_DIRMSSQL_LOG_DIR 新しい SQL Server データベースのログ (.ldf) ファイルが作成されるディレクトリを変更します。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.
MSSQL_MASTER_LOG_FILEMSSQL_MASTER_LOG_FILE Master データベース ログ ファイルの場所を設定します。Sets the location of the master database log file.
MSSQL_ERROR_LOG_FILEMSSQL_ERROR_LOG_FILE エラー ログ ファイルの場所を設定します。Sets the location of the errorlog files.

例: 初回セットアップExample: 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 非運用環境で利用できる、フリーライセンスの Developer Edition の SQL Server を指定します。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 SQL Server がリッスンする TCP ポートを 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

例: DockerExample: Docker

この例の docker コマンドでは、次の環境変数を使用して、新しい SQL Server 2017 コンテナーを作成します。This example docker command uses the following environment variables to create a new SQL Server 2017 container:

  • ACCEPT_EULA使用許諾契約書を受け入れます。ACCEPT_EULA accepts the end user license agreement.
  • MSSSQL_PID 非運用環境で利用できる、フリーライセンスの Developer Edition の SQL Server を指定します。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 SQL Server がリッスンする TCP ポートを 1234 として設定します。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.

Linux/macOS で Docker を実行している場合は、単一引用符で、次の構文を使用します。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

Windows で Docker を実行している場合は、二重引用符で、次の構文を使用します。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

注意

コンテナーで実稼働のエディションを実行するためのプロセスは若干異なります。The process for running production editions in containers is slightly different. 詳細については、次を参照してください。実稼働のコンテナー イメージを実行For more information, see Run production container images.

次の手順Next steps

記載されていない、その他の SQL Server の設定は、次を参照してください。 mssql-conf ツールを使用して Linux 上の SQL Server を構成For other SQL Server settings not listed here, see Configure SQL Server on Linux with the mssql-conf tool.

Linux 上に SQL Server をインストールして実行する方法の詳細については、次を参照してください。 Linux 上に SQL Server をインストールFor more information on how to install and run SQL Server on Linux, see Install SQL Server on Linux.