sp_configure (Transact-SQL)

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

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

Convenções de sintaxe de 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 do SQL Server reconhece qualquer cadeia de caracteres exclusiva que faça parte do nome de 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 definição de 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 de config_value e run_value não são automaticamente equivalentes. Depois de atualizar uma definição de 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.

Comentários

Use sp_configure para exibir ou alterar 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 de usuário atual, use a SET instrução.

Algumas opções de configuração do servidor só estão disponíveis por meio do 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. Esse valor inicialmente 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 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 gerará 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 sobrepor 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.

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 min server memory e max server memory server memory são atualizadas dinamicamente no Mecanismo de Banco de Dados, portanto, você pode alterá-las sem reiniciar o servidor. Por outro lado, a reconfiguração do valor de 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 observando a coluna is_dynamic da exibição de catálogo sys.configurations .

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

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 configuração de Opções Avançadas como 1.

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

R. 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 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

A configuração da conectividade do Hadoop requer mais algumas etapas, além da execução do sp_configure. Para obter o procedimento completo, consulte CREATE EXTERNAL DATA SOURCE (Transact-SQL).

Confira 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)