sp_configure (Transact-SQL)

Aplica-se a: SQL Server Instância Gerenciada de SQL do Azure Azure Synapse Analytics Analytics Platform System (PDW)

Exibe ou altera parâmetros de configuração global para o servidor atual.

Observação

Para obter opções de configuração no nível do banco de dados, consulte ALTER DATABASE SCOPED CONFIGURATION (Transact-SQL). Para configurar o Soft-NUMA, consulte Soft-NUMA (SQL Server).

Topic link iconConvenções de sintaxe do Transact-SQL

Sintaxe

-- Syntax for SQL Server  
  
sp_configure [ [ @configname = ] 'option_name'   
    [ , [ @configvalue = ] 'value' ] ]  
-- Syntax for Parallel Data Warehouse  
  
-- List all of the configuration options  
sp_configure  
[;]  
  
-- Configure Hadoop connectivity  
sp_configure [ @configname= ] 'hadoop connectivity',  
             [ @configvalue = ] { 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 }  
[;]  
RECONFIGURE  
[;]  

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 SQL Server reconhece qualquer cadeia de caracteres exclusiva que faça parte do nome da configuração. Se não for especificado, a lista completa de opções será retornada.

Para obter informações sobre as opções de configuração disponíveis e suas configurações, consulte Opções de Configuração do Servidor (SQL Server).

[ @configvalue = ] 'value' É a nova configuração. value é int, com um padrão NULL. O valor máximo depende da opção individual.

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

Valores do 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 em ordem alfabética em ordem crescente, conforme mostrado na tabela a seguir.

Os valores para config_value e run_value não são automaticamente equivalentes. Depois de atualizar uma configuração usando sp_configure, o administrador do sistema deve atualizar o valor de configuração em execuçã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 o qual a opção de configuração foi definida usando sp_configure (valor em sys.configurations.value). Para obter mais informações sobre essas opções, consulte Opções de Configuração do Servidor (SQL Server) e sys.configurations (Transact-SQL).
run_value int Atualmente executando o valor 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 as configurações no nível do servidor. Para alterar as configurações no nível do banco de dados, use ALTER DATABASE. Para alterar as configurações que afetam apenas a sessão do usuário atual, use a SET instrução.

Algumas opções de configuração do servidor só estão disponíveis por meio de ALTER SERVER CONFIGURATION (Transact-SQL).

Clusters de Big Data do SQL Server

Determinadas operações, incluindo a definir configurações de servidor (nível de instância) ou adicionar manualmente um banco de dados a um grupo de disponibilidade, exigem uma conexão com a Instância do SQL Server. Operações como sp_configure, RESTORE DATABASE ou qualquer comando DDL em um banco de dados que pertence a um grupo de disponibilidade exigem uma conexão com a instância do SQL Server. Por padrão, um cluster Big Data não inclui um ponto de extremidade que habilita uma conexão com a instância. Você deve expor esse ponto de extremidade manualmente.

Para instruções, confira Conectar-se a bancos de dados na réplica primária.

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

Quando você especifica um novo valor para uma opção, o conjunto de resultados mostra esse valor na coluna config_value . Inicialmente, esse valor difere do valor na coluna run_value , que mostra o valor de configuração em execução no momento. Para atualizar o valor de configuração em execução na coluna run_value , o administrador do sistema deve executar RECONFIGURE ou RECONFIGURAR 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 gera um erro se o valor do intervalo de recuperação for maior que 60 minutos ou se o valor da máscara de afinidade se sobrepõe ao valor da máscara de E/S de afinidade . 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 mínima do servidor e memória máxima do servidor de memória do servidor são atualizadas dinamicamente no Mecanismo de Banco de Dados; portanto, você pode alterá-los sem reiniciar o servidor. Por outro lado, reconfigurar o valor em execução da opção de fator de preenchimento requer a reinicialização do Mecanismo de Banco de Dados.

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

A alteração também é gravada no log de erros SQL Server.

Observação

Se um valor especificado for muito alto para uma opção, a coluna run_value refletirá o fato de que o Mecanismo de Banco de Dados tem o padrão de memória dinâmica em vez de usar uma configuração que não é válida.

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

Opções avançadas

Algumas opções de configuração, como máscara de afinidade e intervalo de recuperação, 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 disponibilizá-los, defina a opção mostrar opções avançadas como 1.

Cuidado

Quando a opção Mostrar Opções Avançadas é definida como 1, essa configuração se aplica a todos os usuários. É recomendável usar esse estado apenas temporariamente e alternar de volta para 0 quando terminar com a tarefa que exigia a exibição das opções avançadas.

Para obter mais informações sobre as opções de configuração e suas configurações, consulte Opções de Configuração do Servidor (SQL Server).

Permissões

Permissões de execução sem parâmetros ou com apenas 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 para executar a instrução RECONFIGURE, você deve receber a permissão de nível de servidor ALTER SETTINGS. A permissão 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 options 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 options', '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;  

Exemplos: PDW (Analytics Platform System)

C. Listar todas as configurações disponíveis

O exemplo a seguir mostra como listar todas as opções de configuração.

EXEC sp_configure;  

O resultado retorna o nome da opção seguido pelos valores mínimo e máximo da opção. O config_value é o valor que o Microsoft Azure Synapse Analytics usará quando a reconfiguração for concluída. O run_value é o valor que está sendo usado. Normalmente, config_value e run_value são os mesmos, a menos que o valor esteja sendo alterado.

D. Listar as definições de configuração de um nome de configuração

EXEC sp_configure @configname='hadoop connectivity';  

E. Definir a conectividade do Hadoop

Definir a conectividade do Hadoop requer mais algumas etapas, além de executar sp_configure. Para o procedimento completo, consulte CREATE EXTERNAL DATA SOURCE (Transact-SQL).

Consulte Também

ALTER SERVER CONFIGURATION (Transact-SQL)
RECONFIGURE (Transact-SQL)
Instruções SET (Transact-SQL)
Opções de configuração do servidor (SQL Server)
ALTER DATABASE (Transact-SQL)
Procedimentos armazenados do sistema (Transact-SQL)
sys.configurations (Transact-SQL)
ALTER DATABASE SCOPED CONFIGURATION (Transact-SQL)
Soft-NUMA (SQL Server)