ALTER SERVER CONFIGURATION (Transact-SQL)

项目
03/25/2014

修改 SQL Server 中当前服务器的全局配置设置。

适用范围：SQL Server（SQL Server 2008 R2 到当前版本）。

语法

ALTER SERVER CONFIGURATION
SET <optionspec> 
[;]

<optionspec> ::=
{
     <process_affinity>
   | <diagnostic_log>
   | <failover_cluster_property>
   | <hadr_cluster_context>
   | <buffer_pool_extension>
}

<process_affinity> ::= 
   PROCESS AFFINITY 
   {
     CPU = { AUTO | <CPU_range_spec> } 
   | NUMANODE = <NUMA_node_range_spec> 
   }
   <CPU_range_spec> ::= 
      { CPU_ID | CPU_ID  TO CPU_ID } [ ,...n ] 

   <NUMA_node_range_spec> ::= 
      { NUMA_node_ID | NUMA_node_ID TO NUMA_node_ID } [ ,...n ]

<diagnostic_log> ::= 
   DIAGNOSTICS LOG 
   { 
     ON  
   | OFF  
   | PATH = { 'os_file_path' | DEFAULT }  
   | MAX_SIZE = { 'log_max_size' MB | DEFAULT }  
   | MAX_FILES = { 'max_file_count' | DEFAULT }  
   }

<failover_cluster_property> ::= 
   FAILOVER CLUSTER PROPERTY <resource_property>
   <resource_property> ::=
      {
        VerboseLogging = { 'logging_detail' | DEFAULT }  
      | SqlDumperDumpFlags = { 'dump_file_type' | DEFAULT }
      | SqlDumperDumpPath = { 'os_file_path'| DEFAULT }
      | SqlDumperDumpTimeOut = { 'dump_time-out' | DEFAULT }
      | FailureConditionLevel = { 'failure_condition_level' | DEFAULT }
      | HealthCheckTimeout = { 'health_check_time-out' | DEFAULT }
      }

<hadr_cluster_context> ::=
   HADR CLUSTER CONTEXT = { 'remote_windows_cluster' | LOCAL }

<buffer_pool_extension>::=
    BUFFER POOL EXTENSION 
    { ON ( FILENAME = 'os_file_path_and_name' , SIZE = <size_spec> ) 
    | OFF }

    <size_spec> ::=
        { size [ KB | MB | GB ] }

参数

<process_affinity> ::=

PROCESS AFFINITY
使硬件线程与 CPU 相关联。
CPU = { AUTO | <CPU_range_spec> }
将 SQL Server 工作线程分发到指定范围内的各 CPU。超出了指定范围的 CPU 将不会分配有线程。
- AUTO
  指定没有为 CPU 分配线程。操作系统可以基于服务器工作负荷在 CPU 之间自由地移动线程。这是默认值，还是推荐设置。
- <CPU_range_spec> ::=
  指定要将线程指定给的 CPU 或 CPU 范围。
- { CPU_ID | CPU_ID TO CPU_ID } [ ,...n ]
  一个或多个 CPU 的列表。 CPU ID 从 0 开始且为 integer 值。
NUMANODE = <NUMA_node_range_spec>
将线程分配给属于指定 NUMA 节点或节点范围的所有 CPU。
- <NUMA_node_range_spec> ::=
  指定 NUMA 节点或 NUMA 节点范围。
- { NUMA_node_ID | NUMA_node_ID TO NUMA_node_ID } [ ,...n ]
  一个或多个 NUMA 节点的列表。 NUMA 节点 ID 从 0 开始且为 integer 值。

<diagnostic_log> ::=

适用范围：SQL Server 2012 到 SQL Server 2014。

DIAGNOSTICS LOG
启动或停止对 sp_server_diagnostics 过程捕获的诊断数据的日志记录，并设置 SQLDIAG 日志配置参数，如日志文件滚动更新计数、日志文件大小和文件位置。有关详细信息，请参阅查看和读取故障转移群集实例诊断日志。
ON
在 PATH 文件选项指定的位置启动对 SQL Server 诊断数据的日志记录。这是默认设置。
OFF
停止对诊断数据的日志记录。
PATH = { 'os_file_path' | DEFAULT }
指示诊断日志位置的路径。默认位置是 SQL Server 故障转移群集实例的安装文件夹中的 <\MSSQL\Log>。
MAX_SIZE = { 'log_max_size' MB | DEFAULT }
每个诊断日志可以增长到的最大大小 (MB)。默认值为 100 MB。
MAX_FILES = { 'max_file_count' | DEFAULT }
可以存储在计算机上的诊断日志文件的最大数量，超过该数量后这些文件将被新的诊断日志所取代。

<failover_cluster_property> ::=

适用范围：SQL Server 2012 到 SQL Server 2014。

FAILOVER CLUSTER PROPERTY
修改 SQL Server 资源专用的故障转移群集属性。
VERBOSE LOGGING = { 'logging_detail' | DEFAULT }
设置 SQL Server 故障转移群集的日志记录级别。可以通过启用该属性在错误日志中提供更多详细信息以排除故障。
- 0 – 禁用日志记录（默认值）
- 1 - 仅限错误
- 2 – 错误和警告
SQLDUMPEREDUMPFLAGS
确定 SQL Server SQLDumper 实用工具生成的转储文件的类型。默认设置为 0。有关详细信息，请参阅 SQL Server Dumper 实用工具知识库文章。
SQLDUMPERDUMPPATH = { 'os_file_path' | DEFAULT }
SQLDumper 实用工具存储转储文件的位置。有关详细信息，请参阅 SQL Server Dumper 实用工具知识库文章。
SQLDUMPERDUMPTIMEOUT = { 'dump_time-out' | DEFAULT }
超时值（毫秒），一旦 SQL Server 失败，SQLDumper 实用工具即在该超时值后生成转储。默认值为 0，表示完成该转储没有时间限制。有关详细信息，请参阅 SQL Server Dumper 实用工具知识库文章。
FAILURECONDITIONLEVEL = { 'failure_condition_level' | DEFAULT }
SQL Server 故障转移群集实例应在什么状况下进行故障转移或重新启动。默认值是 3，这表示 SQL Server 资源将在出现严重服务器错误时进行故障转移或重新启动。有关此故障条件级别和其他故障条件级别的详细信息，请参阅配置 FailureConditionLevel 属性设置。
HEALTHCHECKTIMEOUT = { 'health_check_time-out' | DEFAULT }
超时值，即 SQL Server 数据库引擎资源 DLL 在认定 SQL Server 实例不响应之前应等待服务器运行状况信息的时间。该超时值用毫秒表示。默认值为 60000 毫秒（60 秒）。

<hadr_cluster_context> ::=

适用范围：SQL Server 2012 到 SQL Server 2014。

HADR CLUSTER CONTEXT = { 'remote_windows_cluster' | LOCAL }
将服务器实例的 HADR 群集上下文切换到指定的 Windows Server 故障转移群集 (WSFC) 群集。 “HADR 群集上下文”用于确定哪些 Windows Server 故障转移群集 (WSFC) 群集管理由服务器实例承载的可用性副本的元数据。仅在 AlwaysOn 可用性组跨群集迁移到新 WSFC 群集上的 SQL Server 2012 SP1 或更高版本实例的过程中，才使用 SET HADR CLUSTER CONTEXT 选项。

您只能将 HADR 群集上下文从本地 WSFC 群集切换到远程群集，然后再从远程群集切换回本地群集。只有在 SQL Server 实例不承载任何可用性副本时，才能将 HADR 群集上下文切换到远程群集。

远程 HADR 群集上下文随时可以切换回本地群集。但是，只要服务器实例承载任何可用性副本，该上下文将无法再进行切换。

若要标识目标群集，请指定下列值之一：
- windows_cluster
  WSFC 群集的群集对象名称 (CON)。您可以指定短名称或者完整的域名称。为了找到短名称的目标 IP 地址，ALTER SERVER CONFIGURATION 使用 DNS 解析。在某些情况下，短名称可能导致混淆，DNS 可能返回错误的 IP 地址。因此，我们建议您指定完整的域名。
- LOCAL
  本地 WSFC 群集。
有关详细信息，请参阅更改服务器实例的 HADR 群集上下文 (SQL Server)。

<buffer_pool_extension>::=

适用范围：SQL Server 2014 到 SQL Server 2014。

ON
启用缓冲池扩展选项。此选项通过使用固态硬盘 (SSD) 等非易失性存储在池中保持清洁的数据页来扩展缓冲池的大小。有关此功能的详细信息，请参阅缓冲池扩展。不是所有 SQL Server 版本都提供缓冲池扩展。有关详细信息，请参阅 SQL Server 2014 各个版本支持的功能。
FILENAME = 'os_file_path_and_name'
定义缓冲池扩展缓存文件的目录路径和名称。文件扩展名必须指定为 .BPE。您必须先关闭 BUFFER POOL EXTENSION，然后才能修改 FILENAME。
SIZE = size [ KB | MB | GB ]
定义缓存大小。默认大小规格是 KB。最小大小为 Max Server Memory 的大小。最大限制为最大服务器内存大小的 32 倍。有关最大服务器内存的详细信息，请参阅 sp_configure (Transact-SQL)。

您必须先关闭 BUFFER POOL EXTENSION，然后才能修改文件的大小。若要指定小于当前大小的大小，必须重新启动 SQL Server 实例以回收内存。否则，指定的大小必须与当前大小相同或大于当前大小。
OFF
禁用缓冲池扩展选项。必须先禁用缓冲池扩展选项，然后才能修改关联的任何参数，如文件大小或名称。禁用此选项会从注册表中删除所有相关配置信息。

备注

因为禁用缓冲池扩展会大大缩小缓冲池大小，所以可能会对服务器性能产生负面影响。

一般备注

此语句不要求重新启动 SQL Server。对于 SQL Server 故障转移群集实例，它不需要重新启动该 SQL Server 群集资源。

限制和局限

此语句不支持 DDL 触发器。

权限

对于进程关联选项需要 ALTER SETTINGS 权限。对于诊断日志和故障转移群集属性选项需要 ALTER SETTINGS 和 VIEW SERVER STATE 权限，对于 HADR 群集上下文选项需要 CONTROL SERVER 权限。

需要对缓冲池扩展选项拥有 ALTER SERVER STATE 权限。

SQL Server 数据库引擎资源 DLL 以本地系统帐户身份运行。因此，本地系统帐户必须对诊断日志选项中的指定路径具有读写访问权限。

示例

类别	作为特征的语法元素
设置进程关联	CPU • NUMANODE • AUTO
设置诊断日志选项	ON • OFF • PATH • MAX_SIZE
设置故障转移群集属性	HealthCheckTimeout
更改可用性副本的群集上下文	'windows_cluster'
设置缓冲池扩展	BUFFER POOL EXTENSION

设置进程关联

本节中的示例显示如何设置与 CPU 和 NUMA 节点的进程关联。该示例假定服务器包含 256 个 CPU，这些 CPU 分为四组，每组各有 16 个 NUMA 节点。线程未分配给任何 NUMA 节点或 CPU。

组 0：NUMA 节点 0 到 3，CPU 0 到 63
组 1：NUMA 节点 4 到 7，CPU 64 到 127
组 2：NUMA 节点 8 到 12，CPU 128 到 191
组 3：NUMA 节点 13 到 16，CPU 192 到 255

A.设置与 0 和 2 组中所有 CPU 的关联

下面的示例设置与 0 和 2 组中所有 CPU 的关联。

ALTER SERVER CONFIGURATION 
SET PROCESS AFFINITY CPU=0 TO 63, 128 TO 191;

B.设置与 NUMA 节点 0 和 7 中所有 CPU 的关联

下面的示例仅设置与节点 0 和 7 的 CPU 关联。

ALTER SERVER CONFIGURATION 
SET PROCESS AFFINITY NUMANODE=0, 7;

C.设置与 CPU 60 到 200 的关联

下面的示例设置与 CPU 60 到 200 的关联。

ALTER SERVER CONFIGURATION 
SET PROCESS AFFINITY CPU=60 TO 200;

D.设置与具有两个 CPU 的系统上的 CPU 0 的关联

下面的示例设置与具有两个 CPU 的计算机上的 CPU=0 的关联。在执行以下语句前，内部关联位掩码为 00。

ALTER SERVER CONFIGURATION SET PROCESS AFFINITY CPU=0;

E.设置与 AUTO 的关联

下面的示例将关联设置为 AUTO。

ALTER SERVER CONFIGURATION
SET PROCESS AFFINITY CPU=AUTO;

设置诊断日志选项

适用范围：SQL Server 2012 到 SQL Server 2014。

本节中的示例说明如何设置诊断日志选项的值。

A.启动诊断日志记录

下面的示例启动诊断数据的日志记录。

ALTER SERVER CONFIGURATION SET DIAGNOSTICS LOG ON;

B.停止诊断日志记录

下面的示例停止诊断数据的日志记录。

ALTER SERVER CONFIGURATION SET DIAGNOSTICS LOG OFF;

C.指定诊断日志的位置

下面的示例将诊断日志的位置设置为指定的文件路径。

ALTER SERVER CONFIGURATION
SET DIAGNOSTICS LOG PATH = 'C:\logs';

D.指定每个诊断日志的最大大小

下面的示例将每个诊断日志的最大大小设置为 10 MB。

ALTER SERVER CONFIGURATION 
SET DIAGNOSTICS LOG MAX_SIZE = 10 MB;

设置故障转移群集属性

适用范围：SQL Server 2012 到 SQL Server 2014。

下面的示例说明如何设置 SQL Server 故障转移群集资源属性的值。

A.指定 HealthCheckTimeout 属性的值

下面的示例将 HealthCheckTimeout 选项设置为 15,000 毫秒（15 秒）。

ALTER SERVER CONFIGURATION 
SET FAILOVER CLUSTER PROPERTY HealthCheckTimeout = 15000;

B.更改可用性副本的群集上下文

下面的示例更改 SQL Server 实例的 HADR 群集上下文。为了指定目标 WSFC 群集 (clus01)，本示例指定完整的群集对象名称 (clus01.xyz.com)。

ALTER SERVER CONFIGURATION SET HADR CLUSTER CONTEXT = 'clus01.xyz.com';

设置缓冲池扩展选项

A.设置缓冲池扩展选项

适用范围：SQL Server 2014 到 SQL Server 2014。

下面的示例启用缓冲池扩展选项并指定文件名和大小。

ALTER SERVER CONFIGURATION 
SET BUFFER POOL EXTENSION ON
    (FILENAME = 'F:\SSDCACHE\Example.BPE', SIZE = 50 GB);

B.修改缓冲池扩展参数

下面的示例修改缓冲池扩展文件的大小。修改任何参数前必须先禁用缓冲池扩展选项。

ALTER SERVER CONFIGURATION 
SET BUFFER POOL EXTENSION OFF;
GO
EXEC sp_configure 'max server memory (MB)', 12000;
GO
RECONFIGURE;
GO
ALTER SERVER CONFIGURATION
SET BUFFER POOL EXTENSION ON
    (FILENAME = 'F:\SSDCACHE\Example.BPE', SIZE = 60 GB);
GO

请参阅

通过

ALTER SERVER CONFIGURATION (Transact-SQL)

语法

参数

一般备注

限制和局限

权限

示例

设置进程关联

A.设置与 0 和 2 组中所有 CPU 的关联

B.设置与 NUMA 节点 0 和 7 中所有 CPU 的关联

C.设置与 CPU 60 到 200 的关联

D.设置与具有两个 CPU 的系统上的 CPU 0 的关联

E.设置与 AUTO 的关联

设置诊断日志选项

A.启动诊断日志记录

B.停止诊断日志记录

C.指定诊断日志的位置

D.指定每个诊断日志的最大大小

设置故障转移群集属性

A.指定 HealthCheckTimeout 属性的值

B.更改可用性副本的群集上下文

设置缓冲池扩展选项

A.设置缓冲池扩展选项

B.修改缓冲池扩展参数

请参阅

任务

参考

概念

其他资源