使用 mssql-conf 工具在 Linux 上設定 SQL Server

適用於：SQL Server - Linux

mssql-conf 是一個設定指令碼，會使用適用於 Red Hat Enterprise Linux、SUSE Linux Enterprise Server 和 Ubuntu 的 SQL Server 進行安裝。 它會修改儲存組態值的 mssql.conf 檔案 。

mssql-conf 是搭配 Linux 上的 SQL Server 安裝的組態腳本。 您可以使用此公用程式來設定下列參數：

參數	描述
代理	啟用 SQL Server Agent
使用 Microsoft Entra 識別碼進行驗證	使用 Microsoft Entra ID 進行驗證的設定（先前稱為 Azure Active Directory）。
使用 Windows 進行驗證	Windows Server Active Directory 驗證的設定。
整理	為 Linux 上的 SQL Server 設定新的定序。
自訂密碼原則	密碼政策會強制執行密碼的複雜性、到期和變更。
客戶意見反應	選擇 SQL Server 是否要將意見反應傳送給 Microsoft。
Database Mail 設定檔	為 Linux 上的 SQL Server 設定預設 Database Mail 設定檔。
預設數據目錄	將新 SQL Server 資料庫資料檔案 (.mdf) 的預設目錄變更。
默認記錄檔目錄	更改新 SQL Server 資料庫日誌 (.ldf) 檔案的預設目錄。
預設 master 資料庫檔案目錄	在現有 SQL 安裝上變更 master 資料庫檔案的預設目錄。
預設 master 資料庫檔名	變更 master 資料庫檔案的名稱。
預設轉存目錄	變更新記憶體傾印和其他疑難排解檔案的預設資料夾。
默認錯誤記錄檔目錄	變更新 SQL Server 錯誤記錄檔、預設分析程式追蹤、系統健康會話 XE，以及 Hekaton 會話 XE 檔案的預設目錄。
默認備份目錄	更改新備份檔案的預設目錄。
轉儲類型	選擇要收集的記憶體傾印檔案類型。
版本	設定 SQL Server 的版本。
高可用性	啟用可用性群組。
本地稽核目錄	設定目錄來新增本機稽核檔案。
地區設定	設定要針對 SQL Server 使用的地區設定。
記憶體限制	設定 SQL Server 的記憶體限制。
Microsoft分散式交易協調器	設定和疑難排解 Linux 上的 MSDTC。
機器學習服務 EULA	接受適用於 mlservices 套件的 R 和 Python EULA。 僅適用於 SQL Server 2019 (15.x)。
網路設定	適用於 SQL Server 的其他網路設定。
輸出網路存取	啟用 機器學習服務 R、Python 和 Java 延伸模組的輸出網路存取。
SQL Server 連接器	設定 SQL Server 連接器的記錄層級。
TCP 埠	變更 SQL Server 接聽連線所在的連接埠。
TLS	設定傳輸層級安全性。
追蹤旗標	設定服務即將使用的追蹤旗標。

提示

這其中一些設定也可以使用環境變數來設定。 如需詳細資訊，請參閱 在Linux上使用環境變數設定SQL Server 設定。

使用提示

• 對於 Always On 可用性群組和共用磁碟叢集，一律會在每個節點上進行相同的設定變更。

• 針對共用磁碟叢集案例，請勿嘗試重新開啟 mssql-server 服務來套用變更。 SQL Server 正以應用程式形式執行中。 相反地，讓資源離線，然後重新上線。

• 這些範例會藉由指定完整路徑來執行 mssql-conf ： /opt/mssql/bin/mssql-conf。 如果您選擇改為巡覽至該路徑，請在目前目錄的內容中執行 mssql-conf ： ./mssql-conf。

• 如果您想要修改容器內的 mssql.conf 檔案，請在其中容器以所需設定執行的主機上建立 mssql.conf 檔案，然後重新部署您的容器。 例如，mssql.conf 檔案的下列新增內容會啟用 SQL Server Agent。

  [sqlagent]
  enabled = true
  

  您可以使用下列命令來部署容器：

  docker run -e "ACCEPT_EULA=Y" -e "MSSQL_SA_PASSWORD=<password>" \
  -p 5433:1433 --name sql1 \
  -v /container/sql1:/var/opt/mssql \
  -d mcr.microsoft.com/mssql/server:2019-latest
  

  警告

  您的密碼應遵循 SQL Server 預設 密碼原則。 依預設，密碼長度必須至少有 8 個字元，並包含下列四種字元組合中其中三種組合的字元：大寫字母、小寫字母、以 10 為底數的數字以及符號。 密碼長度最多可達 128 個字元。 盡可能使用長且複雜的密碼。

  如需詳細資訊，請參閱 建立 SQL Server 容器要使用的組態檔。

啟用 SQL Server Agent

此 sqlagent.enabled 設定會啟用 SQL Server Agent。 預設會停用 SQL Server Agent。 如果 sqlagent.enabled 配置檔中 mssql.conf 不存在，則 SQL Server 會在內部假設 SQL Server Agent 已停用。

若要變更此設定，請執行下列步驟：

1. 啟用 SQL Server Agent：

   sudo /opt/mssql/bin/mssql-conf set sqlagent.enabled true
   

2. 重新啟動 SQL Server 服務：

   sudo systemctl restart mssql-server
   

為 Linux 上的 SQL Server 設定預設 Database Mail 設定檔

sqlagent.databasemailprofile 可讓您針對電子郵件警示設定預設的 DB Mail 設定檔。

sudo /opt/mssql/bin/mssql-conf set sqlagent.databasemailprofile <profile_name>

SQL Agent 錯誤記錄檔

sqlagent.errorlogfile 和 sqlagent.errorlogginglevel 設定可讓您分別設定 SQL Agent 記錄檔路徑和記錄層級。

sudo /opt/mssql/bin/mssql-conf set sqlagent.errorlogfile <path>

SQL Agent 記錄層級是以位元遮罩值表示，其對應值為：

• 1 = 錯誤
• 2 = 警告
• 4 = 資訊

如果您想要擷取所有層級，請使用 7 作為值。

sudo /opt/mssql/bin/mssql-conf set sqlagent.errorlogginglevel <level>

設定 Microsoft Entra 帳戶驗證

從 SQL Server 2022 (16.x) 開始，您可以設定 SQL Server 的 Microsoft Entra ID。 若要設定 Microsoft Entra ID，您必須在安裝 SQL Server 之後，安裝適用於 SQL Server 的 Azure 延伸模組。 如需如何設定 Microsoft Entra ID 的資訊，請參閱 教學課程：設定 SQL Server 的 Microsoft Entra 驗證。

變更預設的 Microsoft Entra ID 憑證路徑

根據預設，Microsoft Entra 憑證檔案會儲存在 /var/opt/mssql/aadsecrets/ 中。 如果您使用憑證存放區或加密磁碟機，則可以變更此路徑。 若要變更路徑，您可以使用下列命令：

sudo /opt/mssql/bin/mssql-conf set network.aadcertificatefilepath /path/to/new/location.pfx

在上一個範例中，/path/to/new/location.pfx 是您偏好的路徑，包括 憑證名稱。

Microsoft Entra 驗證的憑證 (由適用於 SQL Server 的 Azure 延伸項目下載) 會儲存在此位置。 您無法將其變更為 /var/opt/mssql/secrets。

注意

安裝 SQL Server 之後，您隨時都可以變更預設的 Microsoft Entra ID 憑證路徑，但必須在啟用 Microsoft Entra ID「之前」變更。

Microsoft Entra ID 組態選項

Microsoft Entra 驗證會針對在 Linux 上執行的 SQL Server 執行個體使用下列選項。

警告

Microsoft Entra ID 參數是由適用於 SQL Server 的 Azure 延伸模組所設定，不應手動重新設定。 此處所列資訊僅供參考之用。

SQL Server 2022 （16.x） CU 19 引進了一個選項，可設定 Microsoft Entra 驗證端點的 IPv6 記錄限制。 如果在Linux上啟用IPv6，且無法連線Microsoft Entra 驗證端點的 IPv6 位址，您可以設定 network.ipv6dnsrecordslimit 選項，讓 Microsoft Entra 驗證能夠運作。 將此選項設定為介於 0 和 5 之間的任何值，保證至少嘗試使用一個 IPv4 位址到達 Microsoft Entra 端點。

值 0 表示不會嘗試任何 IPv6 端點位址。 的值 5 表示嘗試五個AAAA位址。

注意

此 network.ipv6dnsrecordslimit 設定是在伺服器層級設定，而且可能會影響其他使用 IPv6 的服務。

選項	描述
network.aadauthenticationendpoint	Microsoft Entra 驗證的端點
network.aadcertificatefilepath	用來向 Microsoft Entra ID 進行驗證的憑證檔案路徑
network.aadclientcertblacklist	Microsoft Entra ID 用戶端憑證封鎖清單
network.aadclientid	Microsoft Entra 用戶端 GUID
network.aadfederationmetadataendpoint	Microsoft Entra 同盟中繼資料的端點
network.aadgraphapiendpoint	Azure AD 圖形 API 的端點
network.aadgraphendpoint	Azure AD Graph 端點
network.aadissuerurl	Microsoft Entra 簽發者 URL
network.aadmsgraphendpoint	Microsoft Entra MS 圖表化端點
network.aadonbehalfofauthority	Microsoft Entra ID 代表授權單位
network.aadprimarytenant	Microsoft Entra 主要租用戶 GUID
network.aadsendx5c	Microsoft Entra ID 傳送 X5C
network.aadserveradminname	將設為系統管理員的 Microsoft Entra 帳戶名稱
network.aadserveradminsid	將設為系統管理員的 Microsoft Entra 帳戶 SID
network.aadserveradmintype	將設為系統管理員的 Microsoft Entra 帳戶類型
network.aadserviceprincipalname	Microsoft Entra 服務主體名稱
network.aadserviceprincipalnamenoslash	不使用正斜線的 Microsoft Entra 服務主體名稱
network.aadstsurl	Microsoft Entra STS 網址

設定 Windows Active Directory 驗證

setup-ad-keytab 選項可用來建立金鑰表，但必須建立使用者和服務主體名稱 (SPN) 才能使用此選項。 Active Directory 公用程式 adutil 可用來建立使用者、SPN 和 keytab。

如需使用 setup-ad-keytab 的選項，請執行下列命令：

sudo /opt/mssql/bin/mssql-conf setup-ad-keytab --help

validate-ad-config 選項會驗證 Active Directory 驗證的組態。

變更 SQL Server 定序

set-collation 選項會將定序值變更為任何支援的定序。 若要進行這項變更，必須停止 SQL Server 服務。

1. 請先備份您伺服器上的 任何用戶資料庫 。

2. 然後使用 sp_detach_db 預存程式來中斷使用者資料庫連結。

3. 執行 set-collation 選項並遵循提示：

   sudo /opt/mssql/bin/mssql-conf set-collation
   

4. mssql-conf 公用程式會嘗試變更為指定的定序值，然後重新啟動服務。 如果發生任何錯誤，則會將定序復原為先前的值。

5. 還原您的使用者資料庫備份。

如需支援的定序列表，請執行 sys.fn_helpcollations 函式： SELECT Name from sys.fn_helpcollations()。

<a id=“custom-password-policy>

自訂密碼原則

從 Linux 上的 SQL Server 2025 （17.x） 預覽開始，您可以在 檔案中 mssql.conf 設定下列組態參數，以強制執行自定義密碼原則。

組態選項	描述
passwordpolicy.passwordminimumlength	定義密碼所需的最小字元數。 密碼長度最多可達 128 個字元。
passwordpolicy.passwordhistorylength	決定必須記住的先前密碼數目。
passwordpolicy.passwordminimumage	指定用戶必須等候的最小持續時間，才能再次變更其密碼。
passwordpolicy.passwordmaximumage	設定密碼在必須變更之前可以使用的最大持續時間。

注意

目前， passwordminimumlength 可以設定為少於八個字元。 您的密碼應遵循 SQL Server 預設 密碼原則。 依預設，密碼長度必須至少有 8 個字元，並包含下列四種字元組合中其中三種組合的字元：大寫字母、小寫字母、以 10 為底數的數字以及符號。 密碼長度最多可達 128 個字元。 盡可能使用長且複雜的密碼。

如需詳細資訊，請參閱 在Linux上的SQL Server 中設定 SQL 登入的自訂密碼原則。

設定客戶意見反應

telemetry.customerfeedback 設定會變更 SQL Server 是否要將意見反應傳送給 Microsoft。 預設會針對所有版本將此值設為 true。 若要變更此值，請執行下列命令：

重要

您不能針對免費的 SQL Server 版本 (Express 和 Developer) 關閉客戶意見反應。

1. 以 root 身分使用 命令執行 settelemetry.customerfeedback 腳本。 下列範例藉由指定 false 來關閉客戶意見反應。

   sudo /opt/mssql/bin/mssql-conf set telemetry.customerfeedback false
   

2. 重新啟動 SQL Server 服務：

   sudo systemctl restart mssql-server
   

如需詳細資訊，請參閱 設定Linux上SQL Server的使用方式和診斷數據收集 和 SQL Server 隱私權補充。

變更預設資料或記錄目錄位置

filelocation.defaultdatadir 和 filelocation.defaultlogdir 設定會變更建立新資料庫和記錄檔的位置。 根據預設，此位置為 /var/opt/mssql/data。 若要變更這些設定，請使用下列步驟：

1. 為新的資料庫資料和記錄檔建立目標目錄。 下列範例會建立新的 /tmp/data 目錄：

   sudo mkdir /tmp/data
   

2. 將目錄的擁有者和群組變更為 mssql 使用者：

   sudo chown mssql /tmp/data
   sudo chgrp mssql /tmp/data
   

3. 使用 mssql-conf 以 命令變更預設資料目錄 set ：

   sudo /opt/mssql/bin/mssql-conf set filelocation.defaultdatadir /tmp/data
   

4. 重新啟動 SQL Server 服務：

   sudo systemctl restart mssql-server
   

5. 現在，新建資料庫的所有資料庫檔案都將儲存於這個新位置。 如果您想要變更新資料庫的記錄 (.ldf) 檔案位置，您可以使用下列 set 命令：

   sudo /opt/mssql/bin/mssql-conf set filelocation.defaultlogdir /tmp/log
   

6. 此命令也會假設 /tmp/log 目錄存在，而且它位於使用者和群組 mssql 之下。

變更預設 master 資料庫檔案目錄位置

filelocation.masterdatafile 和 filelocation.masterlogfile 設定會變更 SQL Server 資料庫引擎尋找 master 資料庫檔案的位置。 根據預設，此位置為 /var/opt/mssql/data。

若要變更這些設定，請使用下列步驟：

1. 為新的錯誤記錄檔建立目標目錄。 下列範例會建立新的 /tmp/masterdatabasedir 目錄：

   sudo mkdir /tmp/masterdatabasedir
   

2. 將目錄的擁有者和群組變更為 mssql 使用者：

   sudo chown mssql /tmp/masterdatabasedir
   sudo chgrp mssql /tmp/masterdatabasedir
   

3. 使用命令 mssql-conf 來變更主要資料和記錄檔的預設資料庫目錄：

   sudo /opt/mssql/bin/mssql-conf set filelocation.masterdatafile /tmp/masterdatabasedir/master.mdf
   sudo /opt/mssql/bin/mssql-conf set filelocation.masterlogfile /tmp/masterdatabasedir/mastlog.ldf
   

   注意

   除了移動主要資料和記錄檔，這也會移動所有其他系統資料庫的預設位置。

4. 停止 SQL Server 服務：

   sudo systemctl stop mssql-server
   

5. 移動 master.mdf 和 mastlog.ldf 檔案：

   sudo mv /var/opt/mssql/data/master.mdf /tmp/masterdatabasedir/master.mdf
   sudo mv /var/opt/mssql/data/mastlog.ldf /tmp/masterdatabasedir/mastlog.ldf
   

6. 啟動 SQL Server 服務：

   sudo systemctl start mssql-server
   

   注意

   如果 SQL Server 在指定目錄中找不到 master.mdf 和 mastlog.ldf 檔案，則會在指定目錄中自動建立系統資料庫的範本化複本，而 SQL Server 會成功啟動。 不過，新資料庫中不會更新sa使用者資料庫、伺服器登入、伺服器憑證、加密密鑰、SQL 代理程式作業或舊master密碼等元數據。 您將必須停止 SQL Server，並將舊的 master.mdf 和 mastlog.ldf 移到新的指定位置，然後啟動 SQL Server 以繼續使用現有的中繼資料。

變更 master 資料庫檔案的名稱

filelocation.masterdatafile 和 filelocation.masterlogfile 設定會變更 SQL Server 資料庫引擎尋找 master 資料庫檔案的位置。 您也可以使用此動作來變更 master 資料庫和記錄檔的名稱。

若要變更這些設定，請使用下列步驟：

1. 停止 SQL Server 服務：

   sudo systemctl stop mssql-server
   

2. 使用 mssql-conf，使用 master 命令來變更資料和記錄檔的預期master資料庫名稱set：

   sudo /opt/mssql/bin/mssql-conf set filelocation.masterdatafile /var/opt/mssql/data/masternew.mdf
   sudo /opt/mssql/bin/mssql-conf set filelocation.mastlogfile /var/opt/mssql/data/mastlognew.ldf
   

   重要

   當 SQL Server 成功啟動之後，您就只能變更 master 資料庫和記錄檔的名稱。 初始執行之前，SQL Server 預期會將檔案命名為 master.mdf 和 mastlog.ldf。

3. 變更 master 資料庫資料和記錄檔的名稱：

   sudo mv /var/opt/mssql/data/master.mdf /var/opt/mssql/data/masternew.mdf
   sudo mv /var/opt/mssql/data/mastlog.ldf /var/opt/mssql/data/mastlognew.ldf
   

4. 啟動 SQL Server 服務：

   sudo systemctl start mssql-server
   

變更預設的傾印目錄位置

filelocation.defaultdumpdir 設定會變更在發生當機時產生記憶體和 SQL 傾印的預設位置。 根據預設，這些檔案會在 /var/opt/mssql/log 中產生。

若要設定這個新位置，請使用下列命令：

1. 為新轉儲檔案建立目標目錄。 下列範例會建立新的 /tmp/dump 目錄：

   sudo mkdir /tmp/dump
   

2. 將目錄的擁有者和群組變更為 mssql 使用者：

   sudo chown mssql /tmp/dump
   sudo chgrp mssql /tmp/dump
   

3. 使用 mssql-conf 以 命令變更預設資料目錄 set ：

   sudo /opt/mssql/bin/mssql-conf set filelocation.defaultdumpdir /tmp/dump
   

4. 重新啟動 SQL Server 服務：

   sudo systemctl restart mssql-server
   

變更預設錯誤記錄檔目錄位置

filelocation.errorlogfile 設定會更改新錯誤記錄檔、預設分析工具追蹤、系統健康工作階段 XE 以及 Hekaton 工作階段 XE 檔案的建立位置。 根據預設，此位置為 /var/opt/mssql/log。 設定 SQL Server 錯誤記錄檔的目錄會成為其他記錄的預設記錄目錄。

變更這些設定：

1. 為新的錯誤記錄檔建立目標目錄。 下列範例會建立新的 /tmp/logs 目錄：

   sudo mkdir /tmp/logs
   

2. 將目錄的擁有者和群組變更為 mssql 使用者：

   sudo chown mssql /tmp/logs
   sudo chgrp mssql /tmp/logs
   

3. 使用 mssql-conf 以 命令變更預設錯誤記錄檔檔名稱 set ：

   sudo /opt/mssql/bin/mssql-conf set filelocation.errorlogfile /tmp/logs/errorlog
   

4. 重新啟動 SQL Server 服務：

   sudo systemctl restart mssql-server
   

errorlog.numerrorlogs 設定允許您指定在重置日誌之前所保存的錯誤日誌數量。

變更預設的備份資料夾位置

filelocation.defaultbackupdir 設定會變更產生備份檔案的預設位置。 根據預設，這些檔案會在 /var/opt/mssql/data 中產生。

若要設定這個新位置，請使用下列命令：

1. 為新的備份檔案建立目標目錄。 下列範例會建立新的 /tmp/backup 目錄：

   sudo mkdir /tmp/backup
   

2. 將目錄的擁有者和群組變更為 mssql 使用者：

   sudo chown mssql /tmp/backup
   sudo chgrp mssql /tmp/backup
   

3. 使用 mssql-conf 命令來變更預設的備份目錄：set

   sudo /opt/mssql/bin/mssql-conf set filelocation.defaultbackupdir /tmp/backup
   

4. 重新啟動 SQL Server 服務：

   sudo systemctl restart mssql-server
   

指定核心傾倒設定

如果其中一個 SQL Server 程序中發生例外狀況或損毀，SQL Server 就會建立記憶體傾印。 擷取記憶體轉儲可能需要很長的時間，並占用大量空間。 若要儲存資源並避免重複的記憶體傾印，您可以使用 coredump.disablecoredump 選項停用自動傾印擷取。

sudo /opt/mssql/bin/mssql-conf set coredump.disablecoredump <true or false>

停用自動核心傾印時 (將 coredump.disablecoredump 設定為 true)，使用者仍然可以手動產生記憶體傾印。

有兩個選項可控制 SQL Server 所收集的記憶體傾印類型：coredump.coredumptype 和 coredump.captureminiandfull。 這些都與核心轉儲捕捉的兩個階段有關。

第一個階段的擷取是由 coredump.coredumptype 設定所控制，它會決定例外狀況期間所產生的傾印檔案類型。 第二個階段會在 coredump.captureminiandfull 設定時啟用。 如果將 coredump.captureminiandfull 設定為 true，則會產生 coredump.coredumptype 所指定的傾印檔案，同時也會產生第二個迷你傾印。 將 coredump.captureminiandfull 設定為 false，會停用第二次擷取嘗試。

1. 決定是否要使用 coredump.captureminiandfull 設定來擷取迷你和完整轉儲。

   sudo /opt/mssql/bin/mssql-conf set coredump.captureminiandfull <true or false>
   

   預設： false

2. 使用 coredump.coredumptype 設定來指定傾印檔案的類型。

   sudo /opt/mssql/bin/mssql-conf set coredump.coredumptype <dump_type>
   

   預設： miniplus

   下表列出可能的 coredump.coredumptype 值。

   類型	描述
   mini	Mini 是最小的傾印檔案類型。 它會使用 Linux 系統資訊來判斷程序中的執行緒和模組。 傾印僅包含主機系統環境執行緒堆疊和模組。 其中不包含間接記憶體參考或全域變數。
   miniplus	MiniPlus 類似於 mini，但它包含額外的記憶體。 它瞭解 SQLPAL 的內部運作及主機環境，並將下列記憶體區域新增至轉儲： - 各種全域變數 - 所有高於 64 TB 的記憶體 - 在 /proc/$pid/maps 中找到的所有具名區域 - 來自執行緒和堆疊空間的非直接記憶體 - 執行緒資訊，包括相關聯的執行緒環境區塊 (TEB) 及處理序環境區塊 (PEB) - 模組資訊 - VMM 和 VAD 樹
   filtered	Filtered 會使用減法設計，除非特別排除，否則會納入程序中的所有記憶體。 此設計瞭解 SQLPAL 和主機環境的內部，但會從轉儲中排除某些區域。
   full	Full 是一種完整的進程轉儲，其中包括位於 /proc/$pid/maps 的所有區域。 這不是由 coredump.captureminiandfull 設定所控制。

版本

您可以使用 set-edition 選項來變更 SQL Server 版本。 若要變更 SQL Server 版本，必須先停止 SQL Server 服務。 如需 Linux 版本上可用 SQL Server 的詳細資訊，請參閱 SQL Server 版本。

高可用性

hadr.hadrenabled 選項會在您的 SQL Server 執行個體上啟用可用性群組。 下列命令藉由將 hadr.hadrenabled 設定為 1 來啟用可用性群組。 您必須重新啟動 SQL Server，才能使設定生效。

sudo /opt/mssql/bin/mssql-conf set hadr.hadrenabled  1
sudo systemctl restart mssql-server

如需如何搭配可用性群組使用此操作的詳細資訊，請參閱下列兩篇文章。

• 設定 SQL Server Always On 可用性群組以在 Linux 上取得高可用性
• 在 Linux 上設定 SQL Server 可用性集群以進行讀取擴展

設定本機稽核目錄

telemetry.userrequestedlocalauditdirectory 設定會啟用本機稽核，並讓您能夠設定建立本機稽核記錄的目錄。

1. 為新的本機稽核記錄建立目標目錄。 下列範例會建立新的 /tmp/audit 目錄：

   sudo mkdir /tmp/audit
   

2. 將目錄的擁有者和群組變更為 mssql 使用者：

   sudo chown mssql /tmp/audit
   sudo chgrp mssql /tmp/audit
   

3. 以 root 身分執行 mssql-conf 腳本，使用 set 命令來為 telemetry.userrequestedlocalauditdirectory：

   sudo /opt/mssql/bin/mssql-conf set telemetry.userrequestedlocalauditdirectory /tmp/audit
   

4. 重新啟動 SQL Server 服務：

   sudo systemctl restart mssql-server
   

如需詳細資訊，請參閱 設定Linux上SQL Server的使用方式和診斷數據收集。

變更 SQL Server 地區設定

language.lcid 設定會將 SQL Server 地區設定變更為任何支援的語言識別碼 (LCID)。

1. 下列範例會將地區設定變更為 [法文 (1036)]：

   sudo /opt/mssql/bin/mssql-conf set language.lcid 1036
   

2. 重新啟動 SQL Server 服務以套用變更：

   sudo systemctl restart mssql-server
   

設定記憶體限制

memory.memorylimitmb 設定會控制 SQL Server 可用的實體記憶體數量 (以 MB 為單位)。 實體記憶體的預設值為 80%，可避免記憶體不足 (OOM) 的狀況。

重要

此 memory.memorylimitmb 設定會限制 SQL Server 進程可用的 物理記憶體 數量。 最大伺服器記憶體 （MB） 設定可用來調整 SQL Server 緩衝池可用的記憶體數量，但永遠不能超過 SQL Server 可用的物理記憶體數量。 如需 最大伺服器記憶體 （MB） 伺服器組態選項的詳細資訊，請參閱 伺服器記憶體組態選項。

1. 以 root 身分使用 命令執行 setmemory.memorylimitmb 腳本。 下列範例會將 SQL Server 可用的記憶體變更為 3.25 GB (3,328 MB)。

   sudo /opt/mssql/bin/mssql-conf set memory.memorylimitmb 3328
   

2. 重新啟動 SQL Server 服務以套用變更：

   sudo systemctl restart mssql-server
   

其他記憶體設定

下列選項可用來進行記憶體設定。

選項	描述
memory.disablememorypressure	SQL Server 可解除記憶體壓力。 值可以是 true 或 false (預設)。 停用記憶體壓力會禁止 SQL Server 用來將其實體記憶體使用量限制為 memory.memorylimitmb 的訊號，進而導致使用量最終超過該限制。
memory.memory_optimized	啟用或停用 SQL Server 的記憶體最佳化功能：持續性記憶體檔案啟用、記憶體保護。 值可以是 true 或 false。
memory.enablecontainersharedmemory	僅適用於 SQL Server 容器。 使用此設定可啟用 SQL Server 容器內的共用記憶體。 如需詳細資訊，請參閱在容器中啟用 VDI 備份和還原。 值可以是 true 或 false (預設)。

設定 MSDTC

network.rpcport 和 distributedtransaction.servertcpport 設定可用來設定 Microsoft 分散式交易協調器 (MSDTC)。 若要變更這些設定，請執行下列命令：

1. 以 root 身分執行 mssql-conf 腳本，使用 set 命令來為 network.rpcport：

   sudo /opt/mssql/bin/mssql-conf set network.rpcport <rcp_port>
   

2. 然後將 distributedtransaction.servertcpport 設置為：

   sudo /opt/mssql/bin/mssql-conf set distributedtransaction.servertcpport <servertcpport_port>
   

除了設定這些值，您還必須為連接埠 135 設定路由及更新防火牆。 如需如何執行這項作的詳細資訊，請參閱如何在Linux上設定Microsoft分散式交易協調器 （MSDTC）。

mssql-conf 有多個其他設定可用來監視和排除 MSDTC 故障。 下表簡短描述這些設定。 如需其使用方式的詳細資訊，請參閱 Windows 支援文章： 在 Windows 10 計算機上啟用 MS DTC 的診斷追蹤。

選項	描述
distributedtransaction.allowonlysecurerpccalls	設定僅允許安全的 RPC 呼叫以用於分散式交易
distributedtransaction.fallbacktounsecurerpcifnecessary	設定僅允許安全通訊的 RPC 呼叫以執行分散式交易
distributedtransaction.maxlogsize	DTC 交易記錄檔大小 (以 MB 為單位)。 預設值為 64 MB
distributedtransaction.memorybuffersize	儲存追蹤的循環緩衝區大小。 此大小以 MB 為單位，預設值為 10 MB
distributedtransaction.servertcpport	MSDTC rpc 伺服器連接埠
distributedtransaction.trace_cm	連線管理員中的追蹤
distributedtransaction.trace_contact	追蹤連絡人集區和連絡人
distributedtransaction.trace_gateway	追蹤閘道來源
distributedtransaction.trace_log	日誌追蹤
distributedtransaction.trace_misc	無法歸類到其他類別的痕跡
distributedtransaction.trace_proxy	MSDTC Proxy 中所產生的追蹤
distributedtransaction.trace_svc	追蹤服務及 .exe 檔案的啟動過程
distributedtransaction.trace_trace	追蹤基礎結構本身
distributedtransaction.trace_util	追蹤從多個位置呼叫的公用程式常式
distributedtransaction.trace_xa	XA 交易管理器 (XATM) 追蹤來源
distributedtransaction.tracefilepath	應在其中儲存追蹤檔案的資料夾
distributedtransaction.turnoffrpcsecurity	啟用或停用分散式交易的 RPC 安全性

接受 Machine Learning Services EULA

將 機器學習 R 或 Python 套件 新增至 Database Engine 需要您接受 R 和 Python 開放原始碼發行版的授權條款。 下表列舉與 mlservices EULA 相關的所有可用命令或選項。 根據您安裝的內容而定，會針對 R 和 Python 使用相同的 EULA 參數。

# For all packages: database engine and mlservices
# Setup prompts for mlservices EULAs, which you need to accept
sudo /opt/mssql/bin/mssql-conf setup

# Add R or Python to an existing installation
sudo /opt/mssql/bin/mssql-conf setup accept-eula-ml

# Alternative valid syntax
# Adds the EULA section to the INI and sets acceptulam to yes
sudo /opt/mssql/bin/mssql-conf set EULA accepteulaml Y

# Rescind EULA acceptance and removes the setting
sudo /opt/mssql/bin/mssql-conf unset EULA accepteulaml

您也可以將 EULA 接受直接新增至 mssql.conf 檔案：

[EULA]
accepteula = Y
accepteulaml = Y

啟用輸出網路存取

預設會停用 SQL Server 機器學習服務 功能中 R、Python 和 Java 延伸模組的輸出網路存取。 若要啟用輸出要求，請使用 outboundnetworkaccess 設定 Boolean 屬性。

設定屬性之後，重新啟動 SQL Server Launchpad 服務，以從 INI 檔案讀取更新後的值。 每當修改擴充性相關設定時，系統會顯示重新啟動訊息提醒您。

# Adds the extensibility section and property.
# Sets "outboundnetworkaccess" to true.
# This setting is required if you want to access data or operations off the server.
sudo /opt/mssql/bin/mssql-conf set extensibility outboundnetworkaccess 1

# Turns off network access but preserves the setting
sudo /opt/mssql/bin/mssql-conf set extensibility outboundnetworkaccess 0

# Removes the setting and rescinds network access
sudo /opt/mssql/bin/mssql-conf unset extensibility.outboundnetworkaccess

您也可以直接新增 outboundnetworkaccess 至 mssql.conf 檔案：

[extensibility]
outboundnetworkaccess = 1

變更 Azure Key Vault 的 SQL Server 連接器的記錄層級

在 SQL Server 2022 (16.x) CU 14 和更新版本中，Linux 上的 SQL Server 支援使用 Azure Key Vault 的 TDE 可延伸金鑰管理。 您可以為下列其中一個值設定記錄層級：

層級	描述
0 (預設值)	資訊
1	錯誤
2	無記錄

若要變更 SQL Server 連接器的記錄層級，請使用下列範例：

sudo /opt/mssql/bin/mssql-conf set sqlconnector.logginglevel 1

如需詳細資訊，請參閱 搭配 SQL 加密功能使用 SQL Server 連接器。

變更 TCP 通訊埠

network.tcpport 設定會變更 SQL Server 用來接聽連線的 TCP 連接埠。 此連接埠預設為 1433。 若要變更此連接埠，請執行下列命令：

1. 以 root 身分執行 mssql-conf 腳本，使用 set 命令來為 network.tcpport：

   sudo /opt/mssql/bin/mssql-conf set network.tcpport <new_tcp_port>
   

2. 重新啟動 SQL Server 服務：

   sudo systemctl restart mssql-server
   

3. 目前在連線到 SQL Server 時，您必須在主機名稱或 IP 位址之後，以逗號 (,) 指定自訂連接埠。 例如，若要與 sqlcmd 連線，您可以使用下列命令：

   sqlcmd -S localhost,<new_tcp_port> -U test -P test
   

指定 TLS 設定

下列選項會針對在 Linux 上執行的 SQL Server 執行個體設定 TLS。

選項	描述
network.forceencryption	如果是 1，SQL Server 會強制加密所有連線。 根據預設，這個選項是 0。
network.tlscert	SQL Server 針對 TLS 使用的憑證檔案絕對路徑。 範例：/etc/ssl/certs/mssql.pem 憑證檔案必須可由 mssql 帳戶存取。 Microsoft 建議使用 chown mssql:mssql <file>; chmod 400 <file> 來限制檔案的存取。
network.tlskey	SQL Server 針對 TLS 使用的私密金鑰檔案絕對路徑。 範例：/etc/ssl/private/mssql.key 憑證檔案必須可由 mssql 帳戶存取。 Microsoft 建議使用 chown mssql:mssql <file>; chmod 400 <file> 來限制檔案的存取。
network.tlsprotocols	SQL Server 所允許的 TLS 通訊協定清單 (以逗號分隔)。 SQL Server 始終會嘗試協商允許的最強通訊協定。 如果用戶端不支援任何允許的通訊協定，SQL Server 就會拒絕連線嘗試。 若要取得相容性，預設允許所有支援的通訊協定 (1.2、1.1、1.0)。 如果您的用戶端支援 TLS 1.2，則 Microsoft 建議只允許 TLS 1.2。
network.tlsciphers	指定 SQL Server 針對 TLS 允許哪些加密。 此字串必須根據 OpenSSL 的加密清單格式進行格式化。 一般來說，您應該不需要變更此選項。 預設允許下列 Cipher： ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-AES128-SHA256:ECDHE-ECDSA-AES256-SHA384:ECDHE-RSA-AES128-SHA256:ECDHE-RSA-AES256-SHA384:ECDHE-ECDSA-AES256-SHA:ECDHE-ECDSA-AES128-SHA:ECDHE-RSA-AES256-SHA:ECDHE-RSA-AES128-SHA:AES256-GCM-SHA384:AES128-GCM-SHA256:AES256-SHA256:AES128-SHA256:AES256-SHA:AES128-SHA
network.kerberoskeytabfile	Kerberos keytab 檔案的路徑

如需使用 TLS 設定的範例，請參閱 加密 Linux 上 SQL Server 的連線。

網路設定

請參閱 教學課程：搭配 Linux 上的 SQL Server 使用 Active Directory 驗證 ，以取得在 Linux 上使用 Active Directory 驗證與 SQL Server 的完整資訊。

下列選項是使用 mssql-conf 設定的其他網路設定。

選項	描述
network.disablesssd	停用對 SSSD 的 Active Directory 帳戶資訊的查詢，並預設改用 LDAP 呼叫。 值可以是 true 或 false。
network.enablekdcfromkrb5conf	允許從 krb5.conf 查閱 KDC 資訊。 值可以是 true 或 false。
network.forcesecureldap	強制使用 LDAPS 來連絡網域控制站。 值可以是 true 或 false。
network.ipaddress	連入連線的 IP 位址。
network.kerberoscredupdatefrequency	針對需要更新的 Kerberos 認證進行檢查之間的時間 (以秒為單位)。 值為整數。
network.privilegedadaccount	用於 Active Directory 驗證的具特殊權限 Active Directory 使用者。 值為 <username>。 如需詳細資訊，請參閱 教學課程：在Linux上搭配SQL Server使用 Active Directory 驗證
network.ipv6dnsrecordslimit	將可設定的限制設定為 DNS 要求所傳回的 AAAA 記錄數目。 值是和0之間的5正整數。 此選項保證 WinHTTP 要求具有至少一個 IPv4 位址的預設重試次數 （6） 嘗試。
uncmapping	將 UNC 路徑映射到本機路徑。 例如： sudo /opt/mssql/bin/mssql-conf set uncmapping //servername/sharename /tmp/folder 。
ldaphostcanon	設定 OpenLDAP 是否應該在繫結步驟期間規範主機名稱。 值可以是 true 或 false。

啟用或停用追蹤旗標

traceflag 選項會啟用或停用啟動 SQL Server 服務的追蹤旗標。 若要啟用/停用追蹤旗標，請使用下列命令：

1. 使用下列命令啟用追蹤旗標。 例如，針對追蹤標誌 1234：

   sudo /opt/mssql/bin/mssql-conf traceflag 1234 on
   

2. 您可以分別指定多個追蹤旗標來加以啟用：

   sudo /opt/mssql/bin/mssql-conf traceflag 2345 3456 on
   

3. 同樣地，您可以藉由指定追蹤旗標並新增 off 參數來停用一或多個已啟用的追蹤旗標：

   sudo /opt/mssql/bin/mssql-conf traceflag 1234 2345 3456 off
   

4. 重新啟動 SQL Server 服務以套用變更：

   sudo systemctl restart mssql-server
   

移除設定

若要取消設定 mssql-conf set 所做的任何設定，請使用 選項和設定的名稱來呼叫 unset。 這會清除設定，有效地使其返回預設值。

1. 下列範例會清除 network.tcpport 選項。

   sudo /opt/mssql/bin/mssql-conf unset network.tcpport
   

2. 重新啟動 SQL Server 服務。

   sudo systemctl restart mssql-server
   

檢視目前設定

若要檢視任何已設定的設定，請執行下列命令以輸出 mssql.conf 檔案的內容：

sudo cat /var/opt/mssql/mssql.conf

此檔案中未顯示的任何設定都會使用其預設值。 下一節提供範例 mssql.conf 檔案。

檢視各種選項

若要檢視可使用 mssql-conf 公用程式設定的各種選項，請執行 help 命令：

sudo /opt/mssql/bin/mssql-conf --help

結果會為您提供各種設定選項，以及每個設定的簡短描述。

mssql.conf 格式

下列 /var/opt/mssql/mssql.conf 檔案提供每項設定的範例。 您可以視需要使用此格式，手動對 mssql.conf 檔案進行變更。 如果您手動變更檔案，則必須先重新啟動 SQL Server 之後才能套用變更。 若要將 mssql.conf 檔案與 Docker 一起使用，您必須讓 Docker 持久化您的資料。 首先，將完整的 mssql.conf 檔案新增至您的主機目錄，然後執行該容器。 有一個範例在設定 SQL Server 在 Linux 上的使用和診斷數據收集中。

[EULA]
accepteula = Y
accepteulaml = Y

[coredump]
captureminiandfull = true
coredumptype = full

[distributedtransaction]
servertcpport = 51999

[filelocation]
defaultbackupdir = /var/opt/mssql/data/
defaultdatadir = /var/opt/mssql/data/
defaultdumpdir = /var/opt/mssql/data/
defaultlogdir = /var/opt/mssql/data/

[hadr]
hadrenabled = 0

[language]
lcid = 1033

[memory]
memorylimitmb = 4096

[network]
forceencryption = 0
ipaddress = 10.192.0.0
kerberoskeytabfile = /var/opt/mssql/secrets/mssql.keytab
rpcport = 13500
tcpport = 1401
tlscert = /etc/ssl/certs/mssql.pem
tlsciphers = ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-ECDSA-AES256-GCM-SHA384:ECDHE-RSA-AES128-GCM-SHA256:ECDHE-RSA-AES256-GCM-SHA384:ECDHE-ECDSA-AES128-SHA256:ECDHE-ECDSA-AES256-SHA384:ECDHE-RSA-AES128-SHA256:ECDHE-RSA-AES256-SHA384:ECDHE-ECDSA-AES256-SHA:ECDHE-ECDSA-AES128-SHA:ECDHE-RSA-AES256-SHA:ECDHE-RSA-AES128-SHA:AES256-GCM-SHA384:AES128-GCM-SHA256:AES256-SHA256:AES128-SHA256:AES256-SHA:AES128-SHA
tlskey = /etc/ssl/private/mssql.key
tlsprotocols = 1.2,1.1,1.0

[sqlagent]
databasemailprofile = default
errorlogfile = /var/opt/mssql/log/sqlagentlog.log
errorlogginglevel = 7

[telemetry]
customerfeedback = true
userrequestedlocalauditdirectory = /tmp/audit

[traceflag]
traceflag0 = 1204
traceflag1 = 2345
traceflag = 3456

相關內容

• 在 Linux 上使用環境變數設置 SQL Server
• 選擇在Linux上管理 SQL Server 的正確工具
• 設定和自定義 SQL Server Linux 容器

參與編輯 SQL 文件

您知道您可以自行編輯 SQL 內容嗎？ 這樣做不僅可以協助改善我們的文件，還能被列為該頁面的貢獻者。

如需詳細資訊，請參閱 編輯Microsoft Learn 檔。