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.
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).
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.
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 | Valor atualmente em execução da opção de configuração (valor em sys.configurations.value_in_use). Para mais informações, confira sys.configurations (Transact-SQL). |
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.
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 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.
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 adotou como padrão a 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 configuração de 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. Recomenda-se usar esse estado apenas temporariamente e voltar para 0 quando terminar a tarefa que exigia a visualizaçã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
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)
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de