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ırmak için 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 ayarlar. SQL Server görüntüsü için gerekli ayar.
MSSQL_SA_PASSWORD Parolayı sa yapılandırır.

SA_PASSWORD ortam değişkeni kullanım dışıdır. Bunun yerine MSSQL_SA_PASSWORD kullanın.
MSSQL_DB Kapsayıcı başlangıcında oluşturulacak veritabanının adını ayarlar.
MSSQL_USER ayarlanırsa MSSQL_DB , kapsayıcı başlangıcında oluşturulacak kullanıcı olmayansa bir adı ayarlar. Kullanıcıya MSSQL_DB veritabanında erişim hakları verilir. Bu değişken kullanılıyorsa, MSSQL_PASSWORD ayrıca ayarlanmalıdır. MSSQL_DB ayarlı değilse, bu değişken yoksayılır.
MSSQL_PASSWORD adı içinde MSSQL_USERolan kullanıcının parolasını ayarlar. Bu değişken kullanılıyorsa, MSSQL_USER ayrıca ayarlanmalıdır. Ayarlanmamışsa MSSQL_DB, bu değişken yoksayılır.
MSSQL_PID SQL Server sürümünü veya ürün anahtarını ayarlar. 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 ayar, 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 dinleyeceği TCP bağlantı noktasını yapılandırır (varsayılan: 1433).
MSSQL_IP_ADDRESS IP adresini ayarlar. Şu anda IP adresi IPv4 stilinde olmalıdır (0.0.0.0).
MSSQL_BACKUP_DIR Varsayılan yedekleme dizini konumunu ayarlar.
MSSQL_DATA_DIR Yeni SQL Server veritabanı veri dosyalarının (.mdf) oluşturulduğu dizini değiştirir.
MSSQL_LOG_DIR Yeni SQL Server veritabanı günlüğü (.ldf) dosyalarının oluşturulduğu dizini değiştirir.
MSSQL_DUMP_DIR SQL Server bellek dökümlerini ve diğer sorun giderme dosyalarını varsayılan olarak depoladığı dizini değiştirir.
MSSQL_ENABLE_HADR Kullanılabilirlik gruplarını etkinleştirir. Örneğin, 1 özelliği etkinleştirir ve 0 devre dışı bırakır.
MSSQL_AGENT_ENABLED SQL Server Agent etkinleştirir. Örneğin, true aracıyı etkinleştirir ve false devre dışı bırakır. Varsayılan olarak ajan 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 SQL Server Standard Developer sürümü
Standard SQL Server Standard sürümü
EnterpriseDeveloper 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.

  • 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

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.