sys.dm_os_cluster_properties(Transact-SQL)

适用于:SQL Server

返回一行,其中包含本文中标识的SQL Server群集资源属性的当前设置。 如果在SQL Server的独立实例上运行此视图,则不返回任何数据。

可以使用这些属性设置影响故障检测、故障响应时间和日志记录的值,以监视SQL Server故障转移群集实例的运行状况。

列名称 数据类型 可为 Null Description
VerboseLogging bigint 是 SQL Server 故障转移群集的日志记录级别。 启用详细日志记录,在错误日志中提供额外的详细信息,以便进行故障排除。 以下值之一:

- 0:日志记录已关闭(默认值)
- 1:仅错误
- 2:错误和警告

有关详细信息,请参阅 ALTER SERVER CONFIGURATION。
SqlDumperDumpFlags bigint 是 SQLDumper 转储标志确定 SQL Server 生成的转储文件的类型。 默认设置为 0。
SqlDumperDumpPath nvarchar(260) 否 SQLDumper 实用工具生成转储文件的位置。
SqlDumperDumpTimeOut bigint 是 SQLDumper 实用工具在SQL Server失败时生成转储的超时值(以毫秒为单位)。 默认值为 0。
FailureConditionLevel bigint 是 设置 SQL Server 故障转移群集应失败或重启的条件。 默认值为 3。 有关详细说明或更改属性设置,请参阅 “配置 FailureConditionLevel 属性设置”。
HealthCheckTimeout bigint 是 SQL Server 数据库引擎资源 DLL 在将SQL Server实例视为无响应之前,应等待服务器运行状况信息的超时值。 超时值以毫秒为单位表示。 默认值为 60000 (60,000)。

有关详细信息或更改此属性设置,请参阅 “配置 HealthCheckTimeout 属性设置”。
ClusterConnectionOptions nvarchar(4000) 是 有关这些选项的详细信息,请参阅 “群集连接选项” 部分。

群集连接选项

Key 支持的值 Description
Encrypt Mandatory、Strict、Optional 指定如何强制加密可用性组。 如果服务器不支持加密,连接将失败。 如果将加密设置为 Mandatory“是”, TrustServerCertificate 则必须设置为“是”。 如果将加密 Strict设置为, TrustServerCertificate 则忽略。

注意:此键值对是必需的。
HostNameInCertificate 副本名称或 AG 侦听器名称 指定用于加密的证书中的副本名称或可用性组侦听器名称。 此值必须与证书的 使用者可选名称 中的值匹配。 如果证书中列出了服务器名称,则可以省略 HostNameInCertificate 密钥值对。 如果证书中未列出服务器名称,则必须使用服务器名称指定 HostNameInCertificate 密钥值对。

注意:此键值对是可选的。
TrustServerCertificate Yes、No 将 yes 设置为指定驱动程序不验证服务器的 TLS/SSL 证书。 如果 no,驱动程序将验证证书。 有关详细信息,请查看 TDS 8.0。

注意:此键值对是可选的。
ServerCertificate 证书的路径 如果不想使用 HostNameInCertificate,可以将路径传递给证书。 群集服务帐户必须具有从给定位置读取证书的权限。

注意:此键值对是可选的。
CLUSTER_CONNECTION_OPTIONS 空字符串 ('') 清除现有配置并还原为默认加密设置 Encrypt=Mandatory 和 TrustServerCertificate=Yes。

有关详细信息,请参阅 CREATE AVAILABILITY GROUP 和 ALTER AVAILABILITY GROUP。

Permissions

SQL Server 2019(15.x)和早期版本需要对SQL Server故障转移群集实例具有 VIEW SERVER STATE 权限。

SQL Server 2022 (16.x) 及更高版本需要 VIEW SERVER PERFORMANCE STATE 对服务器具有权限。

Examples

以下示例使用 sys.dm_os_cluster_properties 返回SQL Server故障转移群集资源的属性设置。

SELECT VerboseLogging,
       SqlDumperDumpFlags,
       SqlDumperDumpPath,
       SqlDumperDumpTimeOut,
       FailureConditionLevel,
       HealthCheckTimeout
FROM sys.dm_os_cluster_properties;

结果集如下。

VerboseLogging SqlDumperDumpFlags SqlDumperDumpPath SqlDumperDumpTimeOut FailureConditionLevel HealthCheckTimeout
0 0 Null 0 3 60000