ALTER SERVER CONFIGURATION (Transact-SQL)

Artigo
11/24/2015

Modifica as definições da configuração global para o servidor atual no SQL Server 2012.

Ícone de vínculo de tópico Convenções de sintaxe Transact-SQL

Sintaxe

ALTER SERVER CONFIGURATION
SET <optionspec> 

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

<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 }

Argumentos

<process_affinity> ::=

PROCESS AFFINITY
Permite que threads de hardware sejam associados a CPUs.
CPU = { AUTO | <CPU_range_spec> }
Distribui threads de trabalho do SQL Server para cada CPU dentro do intervalo especificado. CPUs fora do intervalo especificado não terão threads atribuídos.
- AUTO
  Especifica que nenhum thread está atribuído a uma CPU. O sistema operacional pode mover threads livremente entre CPUs com base na carga de trabalho do servidor. Essa é a configuração padrão e recomendada.
- <CPU_range_spec> ::=
  Especifica a CPU ou o intervalo de CPUs ao qual atribuir threads.
- { CPU_ID | CPU_ID TO CPU_ID } [ ,...n ]
  É a lista de uma ou mais CPUs. As IDs de CPUs começam com 0 e são valores integer.
NUMANODE = <NUMA_node_range_spec>
Atribui threads a todas as CPUs que pertencem ao nó NUMA especificado ou ao intervalo de nós.
- <NUMA_node_range_spec> ::=
  Especifica o nó NUMA ou o intervalo de nós NUMA.
- { NUMA_node_ID | NUMA_node_ID TO NUMA_node_ID } [ ,...n ]
  É a lista de um ou mais nós NUMA. As IDs de nós NUMA começam com 0 e são valores integer.

<diagnostic_log> ::=

DIAGNOSTICS LOG
Inicia ou interrompe o log de dados de diagnóstico capturados pelo procedimento sp_server_diagnostics e define os parâmetros de configuração do log SQLDIAG, como a contagem de substituições de arquivos, o tamanho do arquivo do log e o local do arquivo. Para obter mais informações, consulte Exibir e ler o log de diagnóstico da instância do cluster de failover.
ON
Inicia o log de dados de diagnóstico do SQL Server no local especificado na opção de arquivo PATH. Este é o padrão.
DESATIVADO
Interrompe o log de dados diagnóstico.
PATH = { 'os_file_path' | DEFAULT }
Caminho que indica o local dos logs de diagnóstico. A localização padrão é <\MSSQL\Log> dentro da pasta de instalação da instância de cluster de failover do SQL Server.
MAX_SIZE = { 'log_max_size' MB | DEFAULT }
Tamanho máximo em megabytes que o log de diagnóstico pode atingir. O padrão é 100 MB.
MAX_FILES = { 'max_file_count' | DEFAULT }
Número máximo de arquivos de log de diagnóstico que podem ser armazenados no computador antes de serem reciclados para novos logs de diagnóstico.

<failover_cluster_property> ::=

FAILOVER CLUSTER PROPERTY
Modifica as propriedades do cluster de failover privado de recursos do SQL Server.
VERBOSE LOGGING = { 'logging_detail' | DEFAULT }
Define o nível do log do clustering de failover do SQL Server. Pode ser ativado para fornecer detalhes adicionais nos logs de erros para solução de problemas.
- 0 – O log está desativado (padrão)
- 1 – Apenas erros
- 2 – Erros e avisos
SQLDUMPEREDUMPFLAGS
Determina o tipo de arquivos de despejo gerados pelo utilitário SQLDumper do SQL Server. A configuração padrão é 0. Para obter mais informações, consulte artigo de conhecimento de utilitário do SQL Server Dumper.
SQLDUMPERDUMPPATH = { 'os_file_path' | DEFAULT }
O local onde o utilitário SQLDumper armazena os arquivos de despejo. Para obter mais informações, consulte o artigo da Base de Dados de Conhecimento do utilitário do SQL Server Dumper.
SQLDUMPERDUMPTIMEOUT = { 'dump_time-out' | DEFAULT }
O valor do tempo limite em milissegundos para o utilitário SQLDumper gerar um despejo no caso de uma falha do SQL Server. O valor padrão é 0, o que indica que não há nenhum tempo limite para a conclusão do despejo. Para obter mais informações, consulte o artigo da Base de Dados de Conhecimento do utilitário do SQL Server Dumper.
FAILURECONDITIONLEVEL = { 'failure_condition_level' | DEFAULT }
As condições sob as quais a instância do cluster de failover do SQL Server deve apresentar uma falha ou reiniciar. O valor padrão é 3, o que indica que o recurso do SQL Server apresentará failover ou reiniciará em erros críticos do servidor. Para obter mais informações sobre esse e outros níveis de condições de falha, consulte Definir as configurações da propriedade FailureConditionLevel.
HEALTHCHECKTIMEOUT = { 'health_check_time-out' | DEFAULT }
O valor do tempo limite de quanto tempo a DLL de recursos do Mecanismo de Banco de Dados do SQL Server deve aguardar por informações de integridade do servidor antes de considerar a instância do SQL Server como sem resposta. O valor de tempo limite é expresso em milissegundos. O padrão é 60000 milissegundos (60 segundos).

<hadr_cluster_context> ::=

HADR CLUSTER CONTEXT = { 'remote_windows_cluster' | LOCAL }
Alterna o contexto do cluster HADR da instância de servidor para o cluster especificado do Windows Server Failover Clustering (WSFC). O contexto do cluster HADR determina qual cluster WSFC (Windows Server Failover Clustering) gerencia os metadados das réplicas de disponibilidade hospedadas pela instância de servidor. Use a opção SET HADR CLUSTER CONTEXT somente durante uma migração entre clusters de Grupos de Disponibilidade AlwaysOn para uma instância do SQL Server 2012 SP1 em um novo cluster WSFC.

Só é possível alternar o contexto do cluster HADR do cluster WSFC local para um cluster remoto e, depois, do cluster remoto para o cluster local. O contexto do cluster HADR pode ser alternado para um cluster remoto somente quando a instância do SQL Server não está hospedando réplicas de disponibilidade.

Um contexto do cluster HADR remoto pode ser alternado novamente para o cluster local a qualquer momento. Entretanto, o contexto não poderá ser alternado novamente enquanto a instância de servidor estiver hospedando réplicas de disponibilidade.

Para identificar o cluster de destino, especifique um dos seguintes valores:
- windows_cluster
  O CON (nome do objeto de cluster) de um cluster WSFC. Você pode especificar o nome curto ou o nome de domínio completo. Para localizar o endereço IP de destino de um nome curto, ALTER SERVER CONFIGURATION usa a resolução DNS. Em algumas situações, um nome curto pode causar confusão, e DNS pode retornar o endereço IP errado. Portanto, é recomendável especificar o nome de domínio completo.
- LOCAL
  O cluster WSFC local.
Para obter mais informações, consulte Alterar o contexto do cluster HADR da instância de servidor (SQL Server).

Comentários gerais

Essa instrução não requer uma reinicialização do SQL Server. No caso de uma instância de cluster de failover do SQL Server, uma reinicialização do recurso de cluster do SQL Server não é necessária.

Limitações e restrições

Essa instrução não oferece suporte a gatilhos DDL.

Permissões

Requer as permissões ALTER SETTINGS para a opção de afinidade de processo. As permissões ALTER SETTINGS e VIEW SERVER STATE para o log diagnóstico e opções de propriedades do cluster de failover, além da permissão CONTROL SERVER para a opção de contexto do cluster HADR.

A DLL de recursos do SQL Server Mecanismo de Banco de Dados é executada na conta Sistema Local. Portanto, a conta Sistema Local conta deve ter acesso de leitura e gravação para o caminho especificado na opção de Log de Diagnóstico.

Exemplos

Categoria	Elementos de sintaxe em destaque
Configurando a afinidade do processo	CPU • NUMANODE • AUTO
Configurando as opções do log de diagnóstico	ON • OFF • PATH • MAX_SIZE
Configurando as propriedades do cluster de failover	HealthCheckTimeout
Como alterar o contexto do cluster de uma réplica de disponibilidade	'windows_cluster'

Configurando a afinidade do processo

Os exemplos desta seção mostram como definir a afinidade do processo para CPUs e nós NUMA. Os exemplos presumem que o servidor contém 256 CPUs que são organizadas em quatro grupos de 16 nós NUMA cada um. Não são atribuídos threads a nenhum nó NUMA ou CPU.

Grupo 0: Nós NUMA 0 a 3, CPUs 0 a 63
Grupo 1: Nós NUMA 4 a 7, CPUs 64 a 127
Grupo 2: Nós NUMA 8 a 12, CPUs 128 a 191
Grupo 3: Nós NUMA 13 a 16, CPUs 192 a 255

A. Configurando a afinidade para todas as CPUs nos grupos 0 e 2

O exemplo a seguir define afinidade para todas as CPUs nos grupos 0 e 2.

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

B. Configurar afinidade para todas as CPUs nos nós NUMA 0 e 7

O exemplo a seguir define a afinidade de CPU para nós 0 e 7.

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

C. Definir afinidade para as CPUs 60 a 200

O exemplo a seguir define a afinidade para as CPUs 60 a 200.

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

D. Definir afinidade para CPU 0 em um sistema que tem duas CPUs

O exemplo a seguir define a afinidade para CPU=0 em um computador que tem duas CPUs. Antes de a instrução seguinte ser executada, a máscara de bits de afinidade interna é 00.

ALTER SERVER CONFIGURATION SET PROCESS AFFINITY CPU=0;

E. Configurando a afinidade como AUTO

O exemplo a seguir define a afinidade como AUTO.

ALTER SERVER CONFIGURATION
SET PROCESS AFFINITY CPU=AUTO;

Configurando as opções do log de diagnóstico

Os exemplos desta seção mostram como definir os valores para a opção de log de diagnóstico.

A. Iniciando o log de diagnóstico

O exemplo a seguir inicia o log de dados de diagnóstico.

ALTER SERVER CONFIGURATION SET DIAGNOSTICS LOG ON;

B. Interrompendo o log de diagnóstico

O exemplo a seguir interrompe o log de dados de diagnóstico.

ALTER SERVER CONFIGURATION SET DIAGNOSTICS LOG OFF;

C. Especificando o local dos logs de diagnóstico.

O exemplo a seguir define o local dos logs de diagnósticos como o caminho do arquivo especificado.

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

D. Especificando o tamanho máximo de cada log diagnóstico

O exemplo a seguir define o tamanho máximo de cada log de diagnóstico como 10 megabytes.

ALTER SERVER CONFIGURATION 
SET DIAGNOSTICS LOG MAX_SIZE = 10 MB;

Configurando as propriedades do cluster de failover

O exemplo a seguir ilustra a configuração dos valores das propriedades dos recursos do cluster de failover do SQL Server.

A. Especificando o valor da propriedade HealthCheckTimeout.

O exemplo a seguir define a opção HealthCheckTimeout como 15.000 milissegundos (15 segundos).

ALTER SERVER CONFIGURATION 
SET FAILOVER CLUSTER PROPERTY HealthCheckTimeout = 15000;

Como alterar o contexto do cluster de uma réplica de disponibilidade

O exemplo a seguir altera o contexto do cluster HADR da instância do SQL Server. Para especificar o cluster WSFC de destino, clus01, o exemplo especifica o nome de objeto completo do cluster, clus01.xyz.com.

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

Consulte também

Compartilhar via