合 使用 mssql-conf 工具配置 Linux 上的 SQL Server

简介

mssql-conf 是随 SQL Server 2019 (15.x) for Red Hat Enterprise Linux、SUSE Linux Enterprise Server 和 Ubuntu 安装的配置脚本。 可以使用此实用工具设置以下参数：

提示

还可以使用环境变量配置其中某些设置。 有关详细信息，请参阅使用环境变量配置 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 代理。

  [sqlagent] enabled = true

  1 2	[sqlagent] enabled = true

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

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

  1 2 3 4

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

  有关详细信息，请参阅创建 SQL Server 容器要使用的 config 文件。

启用 SQL Server 代理

sqlagent.enabled 设置可启用 SQL Server 代理。 默认情况下，SQL Server 代理处于禁用状态。 如果 mssql.conf 设置文件中不存在 sqlagent.enabled，则 SQL Server 在内部假定已禁用 SQL Server 代理。

若要更改此设置，请使用以下步骤：

1. 启用 SQL Server 代理：

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

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

2. 重启 SQL Server 服务：

   sudo systemctl restart mssql-server

   1	sudo systemctl restart mssql-server

为 Linux 上的 SQL Server 设置默认数据库邮件配置文件

通过 sqlagent.databasemailprofile，可为电子邮件警报设置默认的 DB 邮件配置文件。

SQL 代理错误日志

通过 sqlagent.errorlogfile 和 sqlagent.errorlogginglevel 设置，可分别设置 SQL 代理日志文件路径和日志记录级别。

SQL 代理日志记录级别是位掩码值，等于：

• 1 = 错误
• 2 = 警告
• 4 = 信息

如果要捕获所有级别，请使用 7 作为值。

配置 Azure Active Directory 身份验证

从 SQL Server 2022 (16.x) 开始，可以为 SQL Server 配置 Azure Active Directory (Azure AD)。 若要配置 Azure AD，必须在安装 SQL Server 之后安装用于 SQL Server 的 Azure 扩展。 有关如何配置 Azure AD 的信息，请参阅教程：设置适用于 SQL Server 的 Azure Active Directory 身份验证。

更改默认 Azure AD 证书路径

默认情况下，Azure AD 证书文件存储在 /var/opt/mssql/aadsecrets/ 中。 如果使用证书存储或加密驱动器，则可以更改此路径。 若要更改路径，可以使用以下命令：

在前面的示例中，/path/to/new/location.pfx 是首选路径，包括证书名称。

用于 SQL Server 的 Azure 扩展下载的 Azure AD 身份验证的证书存储在此位置。 你无法将其更改为 /var/opt/mssql/secrets。

备注

安装 SQL Server 后，虽然可以随时更改默认的 Azure AD 证书路径，但必须在启用 Azure AD 之前更改。

Azure AD 配置选项

Azure AD 身份验证将以下选项用于 Linux 上运行的 SQL Server 实例。

警告

Azure AD 参数由用于 SQL Server 的 Azure 扩展配置，不应手动重新配置。 此处列出的选项仅供参考。

配置 Windows Active Directory 身份验证

setup-ad-keytab 选项可用于创建密钥表，但必须创建了用户和服务主体名称 (SPN) 才能使用此选项。 Active Directory 实用工具 adutil 可用于创建用户、SPN 和密钥表。

有关使用 setup-ad-keytab 的选项，请运行以下命令：

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

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

4. mssql-conf 实用工具会尝试更改为指定的排序规则值并重新启动该服务。 如果出现任何错误，它会将排序规则回滚到前一个值。

5. 还原用户数据库备份。

若要获取支持的排序规则的列表，请运行 sys.fn_helpcollations 函数：SELECT Name from sys.fn_helpcollations()。

配置客户反馈

使用 telemetry.customerfeedback 设置可更改 SQL Server 是否向 Microsoft 发送反馈。 默认情况下，对于所有版本，此值设置为 true。 若要更改该值，请运行以下命令：

重要

无法关闭 SQL Server、Express 和 Developer 免费版本的客户反馈。

1. 使用 telemetry.customerfeedback 的 set 命令以 root 身份运行 mssql-conf 脚本。 以下示例通过指定 false 来关闭客户反馈。

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

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

2. 重启 SQL Server 服务：

   sudo systemctl restart mssql-server

   1	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

   1	sudo mkdir /tmp/data

2. 将目录的所有者和组更改为 mssql 用户：

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

   1 2	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

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

4. 重启 SQL Server 服务：

   sudo systemctl restart mssql-server

   1	sudo systemctl restart mssql-server

5. 现在，为新数据库创建的所有数据库文件都将存储在此新位置。 如果要更改新数据库的日志文件 (.ldf) 位置，可以使用下面的 set 命令：

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

   1	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

   1	sudo mkdir /tmp/masterdatabasedir

2. 将目录的所有者和组更改为 mssql 用户：

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

   1 2	sudo chown mssql /tmp/masterdatabasedir sudo chgrp mssql /tmp/masterdatabasedir

3. 使用 mssql-conf 通过 set 命令更改主数据和日志文件的默认 master 数据库目录：

   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

   1 2	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

   1	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

   1 2	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

   1	sudo systemctl start mssql-server

   备注

   如果 SQL Server 在指定目录中找不到 master.mdf 和 mastlog.ldf 文件，将在指定目录中自动创建系统数据库的模板化副本，并且 SQL Server 将成功启动。 但是，诸如用户数据库、服务器登录名、服务器证书、加密密钥、SQL 代理作业或旧 SA 登录密码等元数据将不会在新 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

   1	sudo systemctl stop mssql-server

2. 使用 mssql-conf 通过 set 命令更改 master 数据和日志文件的预期 master 数据库名称：

   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

   1 2	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

   1 2	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

   1	sudo systemctl start mssql-server

更改默认转储目录位置

使用 filelocation.defaultdumpdir 设置可更改每当系统崩溃时生成内存和 SQL 转储的默认位置。 默认情况下，这些文件在 /var/opt/mssql/log 中生成。

若要设置新位置，请使用以下命令：

1. 为新的转储文件创建目标目录。 以下示例创建新的 /tmp/dump 目录：

   sudo mkdir /tmp/dump

   1	sudo mkdir /tmp/dump

2. 将目录的所有者和组更改为 mssql 用户：

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

   1 2	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

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

4. 重启 SQL Server 服务：

   本人提供Oracle(OCP、OCM)、MySQL(OCP)、PostgreSQL(PGCA、PGCE、PGCM)等数据库的培训和考证业务，私聊QQ646634621或微信dbaup66，谢谢！
   后续精彩内容已被站长无情隐藏，请输入验证码解锁本文！

   验证码：

   获取验证码： 请先关注本站微信公众号，然后回复“验证码”，获取验证码。在微信里搜索“AiDBA”或者“dbaup6”或者微信扫描右侧二维码都可以关注本站微信公众号。

   相关文章

   • 在 Linux 上使用环境变量配置 SQL Server 设置
   • linux安装SQL Server时设置默认语言与排序规则Chinese_PRC_CI_AS
   • Linux下MSSQL的安装
   • MSSQL中的幽灵数据删除进程、虚影清除进程（ghost cleanup）
   • SSMS配置错误，导致 SELECT 失败，因为下列 SET 选项的设置不正确: 'QUOTED_IDENTIFIER, ANSI_PADDING'。请确保 SET 选项正确无误，可以用于 计算列上的索引视图和/或索引和/或筛选的索引和/或查询通知和/或 XML 数据类型方法和/或空间索引操作。。
   • MSSQL删除tempdb的数据文件
   • MSSQL中的等待事件SQLTRACE_FILE_BUFFER说明
   • MSSQL的数据库快照
   • MSSQL 2014新功能之延迟事务持续性(Delayed Transaction Durability)--延迟提交
   • MSSQL中的实时查询统计
   • MSSQL中查询索引的创建时间和删除时间
   • MSSQL中查询依赖关系
   • MSSQL的ldf日志文件丢失, 如何仅用mdf文件恢复数据库呢
   • MSSQL移动数据库文件（分离和附加）
   • Windows的资源监视器中进程对磁盘的响应时间多少毫秒即为延迟比较厉害影响磁盘性能IO
   • MSSQL扩展事件之system_health会话
   • MSSQL的创建索引占用的内存
   • MSSQL 2014新功能之缓存池扩展BPE (Buffer Pool Extension)
   • MSSQL中的锁和阻塞
   • MSSQL中的数据库兼容性级别
   打赏赞(1)分享