sp_configure (Transact-SQL)

Exibe ou altera parâmetros de configurações globais do servidor atual.

Convenções de sintaxe Transact-SQL

Sintaxe

sp_configure [ [ @configname = ] 'option_name' 
    [ , [ @configvalue = ] 'value' ] ] 

Argumentos

• [ [ @configname= ] 'option_name'
  É o nome de uma opção de configuração. option_name é varchar(35), com um padrão de NULL. O Mecanismo de banco de dados do SQL Server reconhece qualquer cadeia de caracteres única que faça parte do nome de configuração. Se não for especificado, a lista completa de opções será retornada.

  Para obter mais informações sobre as opções de configuração disponíveis e seus parâmetros, consulte Definindo opções de configuração do servidor.

• [ [ @configvalue= ] 'value'
  É o novo parâmetro de uma configuração. value é int, com um padrão de NULL. O valor máximo depende da opção individual.

  Para exibir o valor máximo de cada opção, consulte a coluna maximum da exibição do catálogo sys.configurations.

Valores de código de retorno

0 (êxito) ou 1 (falha)

Conjuntos de resultados

Quando executado sem parâmetros, sp_configure retorna um conjunto de resultados com cinco colunas e ordena as opções alfabeticamente em ordem crescente, como mostrado na tabela seguinte.

Os valores de config_value e run_value não são automaticamente equivalentes. Após atualizar um parâmetro de configuração usando sp_configure, o administrador de sistema deve atualizar o valor de configuração usando RECONFIGURE ou RECONFIGURE WITH OVERRIDE. Para obter mais informações, consulte a seção Comentários.

Nome da coluna	Tipo de dados	Descrição
name	nvarchar(35)	O nome da opção de configuração.
minimum	int	Valor mínimo da opção de configuração.
maximum	int	Valor máximo da opção de configuração.
config_value	int	Valor para qual a opção de configuração foi configurada usando sp_configure (valor em sys.configurations.value). Para obter mais informações sobre essas opções, consulte Definindo opções de configuração do servidor e sys.configurations (Transact-SQL).
run_value	int	Valor atual em uso da opção de configuração (valor em sys.configurations.value_in_use). Para obter mais informações, consulte sys.configurations (Transact-SQL).

Comentários

Use sp_configure para exibir ou alterar configurações de nível de servidor. Para alterar configurações de nível de banco de dados, use ALTER DATABASE. Para alterar configurações que afetam somente a sessão do usuário atual, use a instrução SET.

Atualizando o valor de configuração de execução

Quando você especificar um value novo para um option, o conjunto de resultados mostra este valor na coluna config_value. Este valor difere inicialmente do valor na coluna run_value que mostra o valor de configuração atualmente em execução. Para atualizar o valor de configuração em execução na coluna run_value, o administrador de sistema deve executar RECONFIGURE ou RECONFIGURE WITH OVERRIDE.

RECONFIGURE e RECONFIGURE WITH OVERRIDE trabalham com todas opções de configuração. Porém, a instrução básica RECONFIGURE rejeita qualquer valor de opção que está fora de um intervalo razoável, pois caso contrário isso pode causar conflitos entre opções. Por exemplo, RECONFIGURE irá gerar um erro se o valor recovery interval for maior que 60 minutos ou se o valor affinity mask se sobrepor com o valor affinity I/O mask. RECONFIGURE WITH OVERRIDE, ao contrário, aceita qualquer valor de opção com o tipo de dados correto e força a reconfiguração com o valor especificado.

Cuidado
Um valor de opção inadequado pode afetar negativamente a configuração da instância do servidor. Use RECONFIGURE WITH OVERRIDE com cuidado.

A instrução RECONFIGURE atualiza algumas opções dinamicamente, outras opções requerem a parada do servidor e reinicialização. Por exemplo, as opções de memória do servidor min server memory e max server memory são dinamicamente atualizadas no Mecanismo de Banco de Dados, portanto, você pode alterá-las sem reinicializar o servidor. Ao contrário, reconfigurar o valor de execução da opção fill factor requer a reinicialização do Mecanismo de Banco de Dados.

Após executar RECONFIGURE em uma opção de configuração, será possível consultar se a opção foi dinamicamente atualizada executando sp_configure'option_name'. Os valores nas colunas run_value e config_value devem corresponder com uma opção dinamicamente atualizada. Você também pode verificar quais opções são dinâmicas consultando a coluna is_dynamic da exibição do catálogo sys.configurations.

Observação
Se um value especificado for muito alto para uma opção, a coluna run_value refletirá o fato que o Mecanismo de Banco de Dados definiu para o padrão de memória dinâmica ao invés de utilizar um parâmetro que não é válido.

Para obter mais informações, consulte RECONFIGURE (Transact-SQL).

Opções avançadas

Algumas opções de configuração, como affinity mask e recovery interval, são designadas como opções avançadas. Por padrão, essas opções não estão disponíveis para exibição e alteração. Para torná-las disponíveis, defina a opção de configuração ExibirOpções Avançadas como 1.

Para obter mais informações sobre as opções de configuração e seus parâmetros, consulte Definindo opções de configuração do servidor.

Permissões

Permissões de execução sem parâmetros ou com somente o primeiro parâmetro em sp_configure são concedidas a todos os usuários por padrão. Para executar sp_configure com ambos os parâmetros para alterar uma opção de configuração ou executar a instrução RECONFIGURE, você deve possuir a permissão ALTER SETTINGS de nível de servidor. A permissão de ALTER SETTINGS é implicitamente mantida pelas funções de servidor fixas sysadmin e serveradmin.

Exemplos

A. Listando as opções de configuração avançada

O exemplo a seguir mostra como configurar e listar todas as opções de configuração. Opções de configuração avançada são exibidas pelo primeiro parâmetro show advanced option como 1. Depois que essa opção for alterada, a execução de sp_configure sem parâmetros exibe todas as opções de configuração.

USE master;
GO
EXEC sp_configure 'show advanced option', '1';

Aqui está a mensagem: "Opção de configuração 'show advanced options' alterada de 0 para 1. Execute a instrução RECONFIGURE para instalar”.

Execute RECONFIGURE e exiba todas as opções de configuração:

RECONFIGURE;
EXEC sp_configure;

B. Alterando uma opção de configuração

O exemplo a seguir define o recovery interval de sistema para 3 minutos.

USE master;
GO
EXEC sp_configure 'recovery interval', '3';
RECONFIGURE WITH OVERRIDE;

Consulte também

Referência

RECONFIGURE (Transact-SQL)

SET (Transact-SQL)

ALTER DATABASE (Transact-SQL)

Procedimentos armazenados do sistema (Transact-SQL)

sys.configurations (Transact-SQL)

Conceitos

Definindo opções de configuração do servidor