Udostępnij za pomocą


Konfigurowanie ustawień programu SQL Server ze zmiennymi środowiskowymi w systemie Linux

Dotyczy:SQL Server — Linux

Do skonfigurowania programu SQL Server w systemie Linux można użyć kilku różnych zmiennych środowiskowych. Te zmienne są używane w dwóch scenariuszach:

  • Aby skonfigurować konfigurację początkową za pomocą polecenia mssql-conf setup.
  • Aby skonfigurować nowy obraz kontenera SQL Server Linux.

Napiwek

Jeśli musisz skonfigurować program SQL Server po tych scenariuszach konfiguracji, zobacz Konfigurowanie programu SQL Server w systemie Linux przy użyciu narzędzia mssql-conf.

Zmienne środowiskowe

Zmienna środowiskowa Opis
ACCEPT_EULA Ustaw zmienną na dowolną ACCEPT_EULA wartość, aby potwierdzić akceptację umowy licencyjnejEnd-User. Wymagane ustawienie dla obrazu programu SQL Server.
MSSQL_SA_PASSWORD Skonfiguruj hasło sa.

Zmienna środowiskowa SA_PASSWORD jest przestarzała. Zamiast tego użyj MSSQL_SA_PASSWORD.
MSSQL_PID Ustaw wersję programu SQL Server lub klucz produktu. Możliwe wartości są wymienione w poniższej tabeli edycji programu SQL Server . Jeśli określisz klucz produktu, musi on mieć postać #####-#####-#####-#####-#####, gdzie # jest liczbą lub literą.
MSSQL_LCID Ustawia identyfikator języka, który ma być używany dla programu SQL Server. Na przykład 1036 to francuski.
MSSQL_COLLATION Ustawia sortowanie domyślne dla programu SQL Server. Spowoduje to zastąpienie domyślnego mapowania identyfikatora języka (LCID) dla porządkowania.
MSSQL_MEMORY_LIMIT_MB Ustawia maksymalną ilość pamięci (w MB), która może być używana przez program SQL Server. Domyślnie jest to 80% całkowitej pamięci fizycznej.
MSSQL_TCP_PORT Skonfiguruj port TCP, na który nasłuchuje program SQL Server (domyślnie 1433).
MSSQL_IP_ADDRESS Ustaw adres IP. Obecnie adres IP musi mieć styl IPv4 (0.0.0.0.0).
MSSQL_BACKUP_DIR Ustaw domyślną lokalizację katalogu kopii zapasowej.
MSSQL_DATA_DIR Zmień katalog, w którym są tworzone nowe pliki danych bazy danych programu SQL Server (.mdf).
MSSQL_LOG_DIR Zmień katalog, w którym są tworzone nowe pliki dziennika bazy danych programu SQL Server (.ldf).
MSSQL_DUMP_DIR Zmień katalog, w którym program SQL Server domyślnie deponuje zrzuty pamięci i inne pliki rozwiązywania problemów.
MSSQL_ENABLE_HADR Włącz grupę dostępności. Na przykład "1" oznacza włączone, a "0" oznacza wyłączone.
MSSQL_AGENT_ENABLED Włącz agenta programu SQL Server. Na przykład wartość "true" jest włączona, a wartość "false" jest wyłączona. Domyślnie agent jest wyłączony.
MSSQL_MASTER_DATA_FILE Ustawia lokalizację pliku danych bazy danych master. Musi mieć nazwę master.mdf do pierwszego uruchomienia programu SQL Server.
MSSQL_MASTER_LOG_FILE Ustawia lokalizację pliku dziennika bazy danych master. Musi mieć nazwę mastlog.ldf do pierwszego uruchomienia programu SQL Server.
MSSQL_ERROR_LOG_FILE Ustawia lokalizację plików errorlog. Na przykład /var/opt/mssql/log/errorlog.

Wersje programu SQL Server

MSSQL_PID Edition
Evaluation Wersja ewaluowa programu SQL Server
Developer SQL Server Developer Edition
Express Sql Server Express edition
Web SQL Server edycja Web
Standard SQL Server Edycja Standardowa
Enterprise Ta starsza opcja reprezentuje licencjonowanie oparte na licencji serwerów enterprise i licencji dostępu klienta (CAL) i jest ograniczona do maksymalnie 20 rdzeni na wystąpienie programu SQL Server. Enterprise nie jest dostępne dla nowych umów. Należy wybrać EnterpriseCore, gdy chcesz wdrożyć wersję Enterprise.
EnterpriseCore SQL Server Enterprise Core edition. EnterpriseCore reprezentuje model licencjonowania serwera opartego na rdzeniach bez limitów rdzeni. Aby uzyskać więcej informacji, zobacz Limity pojemności obliczeniowej według wersji programu SQL Server.
A product key Jeśli określisz klucz produktu, musi on mieć postać #####-#####-#####-#####-#####, gdzie # jest liczbą lub literą.

Aby uzyskać więcej informacji na temat tych edycji, zobacz Wersje programu SQL Server.

MSSQL_PID Edition
Evaluation Wersja ewaluowa programu SQL Server
Express Sql Server Express edition
StandardDeveloper SQL Server Developer Edition
Standard SQL Server Standard Edition
EnterpriseDeveloper SQL Server Developer Edition
Enterprise Ta starsza opcja reprezentuje licencjonowanie oparte na licencji serwerów enterprise i licencji dostępu klienta (CAL) i jest ograniczona do maksymalnie 20 rdzeni na wystąpienie programu SQL Server. Enterprise nie jest dostępne dla nowych umów. Należy wybrać EnterpriseCore, gdy chcesz wdrożyć wersję Enterprise.
EnterpriseCore SQL Server Enterprise Core edition. EnterpriseCore reprezentuje model licencjonowania serwera opartego na rdzeniach bez limitów rdzeni. Aby uzyskać więcej informacji, zobacz Limity pojemności obliczeniowej według wersji programu SQL Server.
A product key Jeśli określisz klucz produktu, musi on mieć postać #####-#####-#####-#####-#####, gdzie # jest liczbą lub literą.

Aby uzyskać więcej informacji na temat tych edycji, zobacz Wersje programu SQL Server.

Używanie z początkową konfiguracją

W tym przykładzie uruchamia się mssql-conf setup ze skonfigurowanymi zmiennymi środowiskowymi. Określono następujące zmienne środowiskowe:

  • ACCEPT_EULA akceptuje umowę licencyjną użytkownika końcowego.

  • MSSQL_PID określa wolno licencjonowaną wersję Developer Edition programu SQL Server do użytku nieprodukcyjnego.

  • MSSQL_SA_PASSWORD ustawia silne hasło. Hasło powinno być zgodne z domyślnymi zasadami haseł programu SQL Server. Domyślnie hasło musi mieć długość co najmniej ośmiu znaków i zawierać znaki z trzech z następujących czterech zestawów: wielkie litery, małe litery, cyfry podstawowe-10 i symbole. Hasła mogą mieć długość maksymalnie 128 znaków. Używaj haseł, które są tak długie i złożone, jak to możliwe.

  • MSSQL_TCP_PORT ustawia port TCP, na którym nasłuchuje program SQL Server, na 1234.

sudo ACCEPT_EULA='Y' MSSQL_PID='Developer' MSSQL_SA_PASSWORD='<password>' MSSQL_TCP_PORT=1234 /opt/mssql/bin/mssql-conf setup

Używanie z platformą Docker

W tym przykładzie docker polecenie używa następujących zmiennych środowiskowych do utworzenia nowego kontenera programu SQL Server:

  • ACCEPT_EULA akceptuje umowę licencyjną użytkownika końcowego.

  • MSSQL_PID określa wolno licencjonowaną wersję Developer Edition programu SQL Server do użytku nieprodukcyjnego.

    W przypadku wdrażania kontenera dla programu SQL Server 2025 (17.x) lub nowszej wersji należy użyć MSSQL_PID=DeveloperStandard dla edycji Standard Developer oraz MSSQL_PID=Developer dla edycji Enterprise Developer.

  • MSSQL_SA_PASSWORD ustawia silne hasło. Hasło powinno być zgodne z domyślnymi zasadami haseł programu SQL Server. Domyślnie hasło musi mieć długość co najmniej ośmiu znaków i zawierać znaki z trzech z następujących czterech zestawów: wielkie litery, małe litery, cyfry podstawowe-10 i symbole. Hasła mogą mieć długość maksymalnie 128 znaków. Używaj haseł, które są tak długie i złożone, jak to możliwe.

  • MSSQL_TCP_PORT ustawia port TCP, na którym nasłuchuje program SQL Server, na 1234. Oznacza to, że w tym przykładzie, zamiast mapować port 1433 (wartość domyślna) na port hosta, należy mapować niestandardowy port TCP za pomocą polecenia -p 1234:1234.

Jeśli używasz platformy Docker w systemie Linux, użyj następującej składni z pojedynczymi cudzysłowami:

docker run -e ACCEPT_EULA=Y -e MSSQL_PID='Developer' -e MSSQL_SA_PASSWORD='<password>' -e MSSQL_TCP_PORT=1234 -p 1234:1234 -d mcr.microsoft.com/mssql/server:2017-latest

Jeśli używasz platformy Docker w systemie Windows, użyj następującej składni z podwójnymi cudzysłowami:

docker run -e ACCEPT_EULA=Y -e MSSQL_PID="Developer" -e MSSQL_SA_PASSWORD="<password>" -e MSSQL_TCP_PORT=1234 -p 1234:1234 -d mcr.microsoft.com/mssql/server:2017-latest

Notatka

Proces uruchamiania wersji produkcyjnych w kontenerach jest nieco inny. Aby uzyskać więcej informacji, zobacz Obrazy kontenerów produkcyjnych.

Jeśli używasz platformy Docker w systemie Linux, użyj następującej składni z pojedynczymi cudzysłowami:

docker run -e ACCEPT_EULA=Y -e MSSQL_PID='Developer' -e MSSQL_SA_PASSWORD='<password>' -e MSSQL_TCP_PORT=1234 -p 1234:1234 -d mcr.microsoft.com/mssql/server:2019-latest

Jeśli używasz platformy Docker w systemie Windows, użyj następującej składni z podwójnymi cudzysłowami:

docker run -e ACCEPT_EULA=Y -e MSSQL_PID="Developer" -e MSSQL_SA_PASSWORD="<password>" -e MSSQL_TCP_PORT=1234 -p 1234:1234 -d mcr.microsoft.com/mssql/server:2019-latest

Jeśli używasz platformy Docker w systemie Linux, użyj następującej składni z pojedynczymi cudzysłowami:

docker run -e ACCEPT_EULA=Y -e MSSQL_PID='Developer' -e MSSQL_SA_PASSWORD='<password>' -e MSSQL_TCP_PORT=1234 -p 1234:1234 -d mcr.microsoft.com/mssql/server:2022-latest

Jeśli używasz platformy Docker w systemie Windows, użyj następującej składni z podwójnymi cudzysłowami:

docker run -e ACCEPT_EULA=Y -e MSSQL_PID="Developer" -e MSSQL_SA_PASSWORD="<password>" -e MSSQL_TCP_PORT=1234 -p 1234:1234 -d mcr.microsoft.com/mssql/server:2022-latest

Jeśli używasz platformy Docker w systemie Linux, użyj następującej składni z pojedynczymi cudzysłowami:

docker run -e ACCEPT_EULA=Y -e MSSQL_PID='Developer' -e MSSQL_SA_PASSWORD='<password>' -e MSSQL_TCP_PORT=1234 -p 1234:1234 -d mcr.microsoft.com/mssql/server:2025-latest

Jeśli używasz platformy Docker w systemie Windows, użyj następującej składni z podwójnymi cudzysłowami:

docker run -e ACCEPT_EULA=Y -e MSSQL_PID="Developer" -e MSSQL_SA_PASSWORD="<password>" -e MSSQL_TCP_PORT=1234 -p 1234:1234 -d mcr.microsoft.com/mssql/server:2025-latest

W przypadku wdrażania kontenera dla SQL Server 2025 (17.x) lub nowszej wersji należy użyć MSSQL_PID=DeveloperStandard dla edycji Standard Developer oraz MSSQL_PID=Developer dla edycji Enterprise Developer.

Ostrożność

Hasło powinno być zgodne z domyślnymi zasadami haseł programu SQL Server. Domyślnie hasło musi mieć długość co najmniej ośmiu znaków i zawierać znaki z trzech z następujących czterech zestawów: wielkie litery, małe litery, cyfry podstawowe-10 i symbole. Hasła mogą mieć długość maksymalnie 128 znaków. Używaj haseł, które są tak długie i złożone, jak to możliwe.

Współtworzenie dokumentacji SQL

Czy wiesz, że możesz samodzielnie edytować zawartość SQL? Jeśli to zrobisz, nie tylko pomożesz ulepszyć naszą dokumentację, ale także zostaniesz uznany za współautora strony.

Aby uzyskać więcej informacji, zobacz Edytowanie dokumentacji środowiska Microsoft Learn.