• Artigo

RECONFIGURE (Transact-SQL)

Atualiza o valor configurado atualmente (a coluna config_value do conjunto de resultados sp_configure) de uma opção de configuração alterada com o procedimento armazenado do sistema sp_configure. Como algumas opções de configuração requerem uma parada e um reinício do servidor para atualizar o valor atualmente em execução, RECONFIGURE nem sempre atualiza o valor atualmente em execução (a coluna run_value do conjunto de resultados sp_configure) para um valor de configuração alterado.

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

Sintaxe

RECONFIGURE [ WITH OVERRIDE ]

Argumentos

  • RECONFIGURE
    Especifica que se a definição da configuração não requerer uma parada e um reinício do servidor, o valor atualmente em execução deverá ser atualizado. RECONFIGURE também verifica se os valores da nova configuração não são válidos (por exemplo, um valor de ordem de classificação que não exista em syscharsets) ou não recomendados. Com as opções de configuração que não requeiram uma parada e um reinício do servidor, o valor atualmente em execução e os valores atualmente configurados para a opção de configuração devem ser o mesmo valor depois que RECONFIGURE for especificado.

  • WITH OVERRIDE
    Desabilita a verificação do valor da configuração (para valores que não são válidos ou não recomendados) para a opção de configuração avançada recoveryinterval.

    Qualquer opção de configuração pode ser reconfigurada usando a opção WITH OVERRIDE. Além disso, RECONFIGURE WITH OVERRIDE força a reconfiguração com o valor especificado. Por exemplo, a opção de configuração minservermemory poderia ser configurada com um valor maior que o especificado na opção de configuração maxservermemory. Entretanto, isso é considerado um erro fatal. Portanto, a especificação de RECONFIGURE WITH OVERRIDE não desabilitaria a verificação do valor da configuração.

Comentários

sp_configure não aceita novos valores de opção de configuração fora dos intervalos válidos documentados para cada opção de configuração.

RECONFIGURE não é permitido em uma transação explícita ou implícita. Ao reconfigurar várias opções ao mesmo tempo, se alguma das operações de reconfiguração falhar, nenhuma delas entrará em vigor.

Permissões

O padrão das permissões de RECONFIGURE é concedida aos possuidores da permissão ALTER SETTINGS. As funções de servidor fixas sysadmin e serveradmin contêm esta permissão implicitamente.

Exemplos

O exemplo a seguir define o limite superior para a opção de configuração recovery interval como 90 minutos e usa RECONFIGURE WITH OVERRIDE para instalá-la. Por padrão, os intervalos de recuperação maiores que 60 minutos não são recomendados e nem permitidos. Entretanto, como a opção WITH OVERRIDE está especificada, o SQL Server não verifica se o valor especificado (90) é válido para a opção de configuração recovery interval.

EXEC sp_configure 'recovery interval', 90
RECONFIGURE WITH OVERRIDE
GO