Aracılığıyla paylaş


Linux'ta ortam değişkenleriyle SQL Server ayarlarını yapılandırma

Şunlar için geçerlidir:Linux üzerinde SQL Server

Linux üzerinde SQL Server'ı yapılandırmak için birkaç farklı ortam değişkeni kullanabilirsiniz. Bu değişkenler iki senaryoda kullanılır:

Bahşiş

Bu kurulum senaryolarından sonra SQL Server'ı yapılandırmanız gerekiyorsa bkz. Mssql-conf aracıyla Linux üzerinde SQL Server'ı yapılandırma.

Ortam değişkenleri

Ortam değişkeni Açıklama
ACCEPT_EULA ACCEPT_EULA End-User Lisans Sözleşmesi'ni kabulünüzü onaylamak için değişkeni herhangi bir değere ayarlayın. SQL Server görüntüsü için gerekli ayar.
MSSQL_SA_PASSWORD sa parolasını yapılandırın.

SA_PASSWORD ortam değişkeni kullanım dışıdır. Bunun yerine MSSQL_SA_PASSWORD kullanın.
MSSQL_PID SQL Server sürümünü veya ürün anahtarını ayarlayın. Olası değerler aşağıdaki SQL Server sürümleri tablosunda listelenmiştir. Bir ürün anahtarı belirtirseniz, bu anahtarın #####-#####-#####-#####-#####biçiminde olması gerekir; burada # bir sayı veya harftir.
MSSQL_LCID SQL Server için kullanılacak dil kimliğini ayarlar. Örneğin, 1036 Fransızcadır.
MSSQL_COLLATION SQL Server için varsayılan harmanlamayı ayarlar. Bu, dil kimliğinin (LCID) harmanlamayla varsayılan eşlemesini geçersiz kılar.
MSSQL_MEMORY_LIMIT_MB SQL Server'ın kullanabileceği en yüksek bellek miktarını (MB cinsinden) ayarlar. Varsayılan olarak, toplam fiziksel belleğin 80% olur.
MSSQL_TCP_PORT SQL Server'ın dinlediğini TCP bağlantı noktasını yapılandırın (varsayılan 1433).
MSSQL_IP_ADDRESS IP adresini ayarlayın. Şu anda IP adresi IPv4 stilinde olmalıdır (0.0.0.0).
MSSQL_BACKUP_DIR Varsayılan yedekleme dizini konumunu ayarlayın.
MSSQL_DATA_DIR Yeni SQL Server veritabanı veri dosyalarının (.mdf) oluşturulduğu dizini değiştirin.
MSSQL_LOG_DIR Yeni SQL Server veritabanı günlüğü (.ldf) dosyalarının oluşturulduğu dizini değiştirin.
MSSQL_DUMP_DIR SQL Server'ın varsayılan olarak bellek dökümlerini ve diğer sorun giderme dosyalarını depoladığı dizini değiştirin.
MSSQL_ENABLE_HADR Kullanılabilirlik Grubunu etkinleştirin. Örneğin, '1' etkinleştirilir ve '0' devre dışı bırakılır
MSSQL_AGENT_ENABLED SQL Server Aracısı'nı etkinleştirin. Örneğin, 'true' etkinleştirilir ve 'false' devre dışı bırakılır. Varsayılan olarak aracı devre dışıdır.
MSSQL_MASTER_DATA_FILE master veritabanı veri dosyasının konumunu ayarlar. SQL Server ilk çalıştırılıncaya kadar master.mdf olarak adlandırılmalıdır.
MSSQL_MASTER_LOG_FILE master veritabanı günlük dosyasının konumunu ayarlar. SQL Server ilk çalıştırılıncaya kadar mastlog.ldf olarak adlandırılmalıdır.
MSSQL_ERROR_LOG_FILE errorlog dosyalarının konumunu ayarlar. Örneğin, /var/opt/mssql/log/errorlog.

SQL Server sürümleri

MSSQL_PID Edition
Evaluation SQL Server Değerlendirme sürümü
Developer SQL Server Developer sürümü
Express SQL Server Express sürümü
Web SQL Server Web sürümü
Standard SQL Server Standard sürümü
Enterprise Bu eski seçenek, Enterprise edition Server + İstemci Erişim Lisansı (CAL) tabanlı lisanslamayı temsil eder ve SQL Server örneği başına en fazla 20 çekirdekle sınırlıdır. Enterprise yeni sözleşmelerde kullanılamaz. Enterprise sürümünü dağıtmak istediğinizde EnterpriseCore seçmeniz gerekir.
EnterpriseCore SQL Server Enterprise Core sürümü. EnterpriseCore, çekirdek sınırı olmayan çekirdek tabanlı sunucu lisanslama modelini temsil eder. Daha fazla bilgi için bkz . SQL Server sürümüne göre işlem kapasitesi sınırları.
A product key Bir ürün anahtarı belirtirseniz, bu anahtarın #####-#####-#####-#####-#####biçiminde olması gerekir; burada # bir sayı veya harftir.

Bu sürümler hakkında daha fazla bilgi için bkz. SQL Server sürümleri.

MSSQL_PID Edition
Evaluation SQL Server Değerlendirme sürümü
Express SQL Server Express sürümü
StandardDeveloper

(Kapsayıcılar için kullanın DeveloperStandard)
SQL Server Standard Developer sürümü
Standard SQL Server Standard sürümü
EnterpriseDeveloper

(Kapsayıcılar için kullanın Developer)
SQL Server Enterprise Developer sürümü
Enterprise Bu eski seçenek, Enterprise edition Server + İstemci Erişim Lisansı (CAL) tabanlı lisanslamayı temsil eder ve SQL Server örneği başına en fazla 20 çekirdekle sınırlıdır. Enterprise yeni sözleşmelerde kullanılamaz. Enterprise sürümünü dağıtmak istediğinizde EnterpriseCore seçmeniz gerekir.
EnterpriseCore SQL Server Enterprise Core sürümü. EnterpriseCore, çekirdek sınırı olmayan çekirdek tabanlı sunucu lisanslama modelini temsil eder. Daha fazla bilgi için bkz . SQL Server sürümüne göre işlem kapasitesi sınırları.
A product key Bir ürün anahtarı belirtirseniz, bu anahtarın #####-#####-#####-#####-#####biçiminde olması gerekir; burada # bir sayı veya harftir.

Bu sürümler hakkında daha fazla bilgi için bkz. SQL Server sürümleri.

İlk kurulumla kullanma

Bu örnek, yapılandırılmış ortam değişkenleriyle mssql-conf setup çalıştırır. Aşağıdaki ortam değişkenleri belirtilir:

  • ACCEPT_EULA son kullanıcı lisans sözleşmesini kabul eder.

  • MSSQL_PID, üretim dışı kullanım için ücretsiz olarak lisanslı SQL Server Developer Edition'ı belirtir.

  • MSSQL_SA_PASSWORD güçlü bir parola ayarlar. Parolanız,SQL Server varsayılan parola ilkesine uygun olmalıdır. Varsayılan olarak, parola en az sekiz karakter uzunluğunda olmalı ve şu dört kümeden üçünün karakterlerini içermelidir: büyük harfler, küçük harfler, 10 tabanındaki basamaklar ve simgeler. Parolalar en çok 128 karakter uzunluğunda olabilir. Mümkün olduğunca uzun ve karmaşık parolalar kullanın.

  • MSSQL_TCP_PORT, SQL Server'ın dinlediğini TCP bağlantı noktasını 1234 olarak ayarlar.

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

Docker ile kullanma

Bu örnek docker komutu, yeni bir SQL Server kapsayıcısı oluşturmak için aşağıdaki ortam değişkenlerini kullanır:

  • ACCEPT_EULA son kullanıcı lisans sözleşmesini kabul eder.

  • MSSQL_PID, üretim dışı kullanım için ücretsiz olarak lisanslı SQL Server Developer Edition'ı belirtir.

    SQL Server 2025 (17.x) veya daha sonraki bir sürüm için bir kapsayıcı dağıttığınızda, Standart Geliştirici sürümü için MSSQL_PID=DeveloperStandard ve Enterprise Developer sürümü için MSSQL_PID=Developer kullanın.

  • MSSQL_SA_PASSWORD güçlü bir parola ayarlar. Parolanız,SQL Server varsayılan parola ilkesine uygun olmalıdır. Varsayılan olarak, parola en az sekiz karakter uzunluğunda olmalı ve şu dört kümeden üçünün karakterlerini içermelidir: büyük harfler, küçük harfler, 10 tabanındaki basamaklar ve simgeler. Parolalar en çok 128 karakter uzunluğunda olabilir. Mümkün olduğunca uzun ve karmaşık parolalar kullanın.

  • MSSQL_TCP_PORT, SQL Server'ın dinlediğini TCP bağlantı noktasını 1234 olarak ayarlar. Bu, 1433 numaralı bağlantı noktasını (varsayılan) bir konak bağlantı noktasına eşlemek yerine özel TCP bağlantı noktasının bu örnekteki -p 1234:1234 komutuyla eşlenmesi gerektiği anlamına gelir.

Docker'ı Linux üzerinde çalıştırıyorsanız, tek tırnak işaretiyle aşağıdaki söz dizimini kullanın:

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

Docker'ı Windows'ta çalıştırıyorsanız, çift tırnak işaretiyle aşağıdaki söz dizimini kullanın:

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

Not

Kapsayıcılarda üretim sürümlerini çalıştırma işlemi biraz farklıdır. Daha fazla bilgi için bkz. Üretim kapsayıcısı görüntülerini çalıştırma.

Docker'ı Linux üzerinde çalıştırıyorsanız, tek tırnak işaretiyle aşağıdaki söz dizimini kullanın:

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

Docker'ı Windows'ta çalıştırıyorsanız, çift tırnak işaretiyle aşağıdaki söz dizimini kullanın:

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

Docker'ı Linux üzerinde çalıştırıyorsanız, tek tırnak işaretiyle aşağıdaki söz dizimini kullanın:

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

Docker'ı Windows'ta çalıştırıyorsanız, çift tırnak işaretiyle aşağıdaki söz dizimini kullanın:

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

Docker'ı Linux üzerinde çalıştırıyorsanız, tek tırnak işaretiyle aşağıdaki söz dizimini kullanın:

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

Docker'ı Windows'ta çalıştırıyorsanız, çift tırnak işaretiyle aşağıdaki söz dizimini kullanın:

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

SQL Server 2025 (17.x) veya daha sonraki bir sürüm için bir kapsayıcı dağıttığınızda, Standart Geliştirici sürümü için MSSQL_PID=DeveloperStandard ve Enterprise Developer sürümü için MSSQL_PID=Developer kullanın.

Dikkat

Parolanız,SQL Server varsayılan parola ilkesine uygun olmalıdır. Varsayılan olarak, parola en az sekiz karakter uzunluğunda olmalı ve şu dört kümeden üçünün karakterlerini içermelidir: büyük harfler, küçük harfler, 10 tabanındaki basamaklar ve simgeler. Parolalar en çok 128 karakter uzunluğunda olabilir. Mümkün olduğunca uzun ve karmaşık parolalar kullanın.

SQL belgelerine katkıda bulunma

SQL içeriğini kendiniz düzenleyebildiğinizi biliyor muydunuz? Bunu yaparsanız, belgelerimizin geliştirilmesine yardımcı olmakla kalmaz, aynı zamanda sayfaya katkıda bulunan olarak da kabul edilirsiniz.

Daha fazla bilgi için Bkz. Microsoft Learn belgelerini düzenleme.