sp_configure (Transact-SQL)sp_configure (Transact-SQL)

APLICA-SE A: simSQL Server simBanco de Dados SQL do Azure (somente a Instância Gerenciada) nãoAzure Synapse Analytics (SQL DW) simParallel Data Warehouse APPLIES TO: yesSQL Server yesAzure SQL Database (Managed Instance only) noAzure Synapse Analytics (SQL DW) yesParallel Data Warehouse

Exibe ou altera parâmetros de configuração global para o servidor atual.Displays or changes global configuration settings for the current server.

Observação

Para obter opções de configuração no nível do banco de dados, consulte ALTER DATABASE scopeed Configuration (Transact-SQL).For database-level configuration options, see ALTER DATABASE SCOPED CONFIGURATION (Transact-SQL). Para configurar o soft-NUMA, consulte Soft- (numa)SQL Server.To configure Soft-NUMA, see Soft-NUMA (SQL Server).

Ícone de link do tópico Convenções de sintaxe Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SintaxeSyntax

-- 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  
[;]  

ArgumentosArguments

[ @configname = ] 'option_name' é o nome de uma opção de configuração.[ @configname = ] 'option_name' Is the name of a configuration option. option_name é varchar(35) , com um padrão de NULL.option_name is varchar(35), with a default of NULL. O Mecanismo de Banco de Dados do SQL ServerSQL Server Database Engine reconhece qualquer cadeia de caracteres única que faça parte do nome de configuração.The Mecanismo de Banco de Dados do SQL ServerSQL Server Database Engine recognizes any unique string that is part of the configuration name. Se não for especificado, a lista completa de opções será retornada.If not specified, the complete list of options is returned.

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.For information about the available configuration options and their settings, see Server Configuration Options (SQL Server).

[ @configvalue = ] 'value' é a nova definição de configuração.[ @configvalue = ] 'value' Is the new configuration setting. value é int, com um padrão NULL.value is int, with a default of NULL. O valor máximo depende da opção individual.The maximum value depends on the individual option.

Para ver o valor máximo de cada opção, consulte a coluna máximo da exibição do catálogo Sys. Configurations .To see the maximum value for each option, see the maximum column of the sys.configurations catalog view.

Valores do código de retornoReturn Code Values

0 (êxito) ou 1 (falha)0 (success) or 1 (failure)

Conjuntos de resultadosResult Sets

Quando executado sem parâmetros, sp_configure retorna um conjunto de resultados com cinco colunas e ordena as opções alfabeticamente em ordem crescente, conforme mostrado na tabela a seguir.When executed with no parameters, sp_configure returns a result set with five columns and orders the options alphabetically in ascending order, as shown in the following table.

Os valores para config_value e run_value não são equivalentes automaticamente.The values for config_value and run_value are not automatically equivalent. Depois de atualizar um parâmetro de configuração usando sp_configure, o administrador do sistema deve atualizar o valor de configuração em execução usando RECONFIGURE ou RECONFIGURE com override.After updating a configuration setting by using sp_configure, the system administrator must update the running configuration value by using either RECONFIGURE or RECONFIGURE WITH OVERRIDE. Para obter mais informações, consulte a seção Comentários.For more information, see the Remarks section.

Nome da colunaColumn name Tipo de dadosData type DescriçãoDescription
namename nvarchar(35)nvarchar(35) O nome da opção de configuração.Name of the configuration option.
minimumminimum intint Valor mínimo da opção de configuração.Minimum value of the configuration option.
maximummaximum intint Valor máximo da opção de configuração.Maximum value of the configuration option.
config_valueconfig_value intint Valor para o qual a opção de configuração foi definida usando sp_configure (valor em Sys. Configurations. Value).Value to which the configuration option was set using sp_configure (value in 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).For more information about these options, see Server Configuration Options (SQL Server) and sys.configurations (Transact-SQL).
run_valuerun_value intint Valor em execução no momento da opção de configuração (valor em Sys. Configurations. value_in_use).Currently running value of the configuration option (value in sys.configurations.value_in_use).

Para obter mais informações, consulte Sys. (Configurations)Transact-SQL.For more information, see sys.configurations (Transact-SQL).

ComentáriosRemarks

Use sp_configure para exibir ou alterar as configurações de nível de servidor.Use sp_configure to display or change server-level settings. Para alterar configurações de nível de banco de dados, use ALTER DATABASE.To change database-level settings, use ALTER DATABASE. Para alterar configurações que afetam somente a sessão do usuário atual, use a instrução SET.To change settings that affect only the current user session, use the SET statement.

Clusters de Big Data do SQL ServerSQL Server Big Data Clusters

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.Certain operations, including configuring server (instance level) settings, or manually adding a database to an availability group, require a connection to the SQL Server Instance. 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.Operations like sp_configure, RESTORE DATABASE, or any DDL command in a database belonging to an availability group require a connection to the SQL Server instance. Por padrão, um cluster Big Data não inclui um ponto de extremidade que habilita uma conexão com a instância.By default, a big data cluster does not include an endpoint that enables a connection to the instance. Você deve expor esse ponto de extremidade manualmente.You must expose this endpoint manually.

Para instruções, confira Conectar-se a bancos de dados na réplica primária.For instructions, see Connect to databases on the primary replica.

Atualizando o valor de configuração de execuçãoUpdating the Running Configuration Value

Quando você especifica um novo valor para uma opção, o conjunto de resultados mostra esse valor na coluna config_value .When you specify a new value for an option, the result set shows this value in the config_value column. Esse valor é, inicialmente, diferente do valor na coluna run_value , que mostra o valor de configuração em execução no momento.This value initially differs from the value in the run_value column, which shows the currently running configuration value. Para atualizar o valor de configuração em execução na coluna run_value , o administrador do sistema deve executar a reconfiguração ou reconfigurar com override.To update the running configuration value in the run_value column, the system administrator must run either RECONFIGURE or RECONFIGURE WITH OVERRIDE.

RECONFIGURE e RECONFIGURE WITH OVERRIDE trabalham com todas opções de configuração.Both RECONFIGURE and RECONFIGURE WITH OVERRIDE work with every configuration option. 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.However, the basic RECONFIGURE statement rejects any option value that is outside a reasonable range or that may cause conflicts among options. 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 sobrepor ao valor de máscara de e/s de afinidade .For example, RECONFIGURE generates an error if the recovery interval value is larger than 60 minutes or if the affinity mask value overlaps with the affinity I/O mask value. 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.RECONFIGURE WITH OVERRIDE, in contrast, accepts any option value with the correct data type and forces reconfiguration with the specified value.

Cuidado

Um valor de opção inadequado pode afetar negativamente a configuração da instância do servidor.An inappropriate option value can adversely affect the configuration of the server instance. Use RECONFIGURE WITH OVERRIDE com cuidado.Use RECONFIGURE WITH OVERRIDE cautiously.

A instrução RECONFIGURE atualiza algumas opções dinamicamente, outras opções requerem a parada do servidor e reinicialização.The RECONFIGURE statement updates some options dynamically; other options require a server stop and restart. Por exemplo, as opções de memória mínima do servidor e memória máxima do servidor são atualizadas dinamicamente no Mecanismo de Banco de DadosDatabase Engine; Portanto, você pode alterá-los sem reiniciar o servidor.For example, the min server memory and max server memory server memory options are updated dynamically in the Mecanismo de Banco de DadosDatabase Engine; therefore, you can change them without restarting the server. Por outro lado, a reconfiguração do valor em execução da opção fator de preenchimento requer a reinicialização do Mecanismo de Banco de DadosDatabase Engine.By contrast, reconfiguring the running value of the fill factor option requires restarting the Mecanismo de Banco de DadosDatabase Engine.

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' .After running RECONFIGURE on a configuration option, you can see whether the option has been updated dynamically by executing sp_configure'option_name'. Os valores nas colunas run_value e config_value devem corresponder a uma opção atualizada dinamicamente.The values in the run_value and config_value columns should match for a dynamically updated option. 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 .You can also check to see which options are dynamic by looking at the is_dynamic column of the sys.configurations catalog view.

A alteração também é gravada no log de erros do SQL Server.The change is also written to the SQL Server error log.

Observação

Se um valor especificado for muito alto para uma opção, a coluna run_value refletirá o fato de que a Mecanismo de Banco de DadosDatabase Engine tem como padrão a memória dinâmica em vez de usar uma configuração que não é válida.If a specified value is too high for an option, the run_value column reflects the fact that the Mecanismo de Banco de DadosDatabase Engine has defaulted to dynamic memory rather than use a setting that is not valid.

Para obter mais informações, consulte reconfigure (Transact-)SQL.For more information, see RECONFIGURE (Transact-SQL).

Opções AvançadasAdvanced Options

Algumas opções de configuração, como a máscara de afinidade e o intervalo de recuperação, são designadas como opções avançadas.Some configuration options, such as affinity mask and recovery interval, are designated as advanced options. Por padrão, essas opções não estão disponíveis para exibição e alteração.By default, these options are not available for viewing and changing. Para torná-los disponíveis, defina a opção de configuração de Imadvancedoptions como 1.To make them available, set the ShowAdvancedOptions configuration option to 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.For more information about the configuration options and their settings, see Server Configuration Options (SQL Server).

PermissõesPermissions

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.Execute permissions on sp_configure with no parameters or with only the first parameter are granted to all users by default. 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.To execute sp_configure with both parameters to change a configuration option or to run the RECONFIGURE statement, you must be granted the ALTER SETTINGS server-level permission. A permissão ALTER SETTINGS é implicitamente mantida pelas funções de servidor fixas sysadmin e serveradmin .The ALTER SETTINGS permission is implicitly held by the sysadmin and serveradmin fixed server roles.

ExemplosExamples

A.A. Listando as opções de configuração avançadaListing the advanced configuration options

O exemplo a seguir mostra como configurar e listar todas as opções de configuração.The following example shows how to set and list all configuration options. Opções de configuração avançada são exibidas pelo primeiro parâmetro show advanced option como 1.Advanced configuration options are displayed by first setting show advanced option to 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.After this option has been changed, executing sp_configure with no parameters displays all configuration options.

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.Here is the message: "Configuration option 'show advanced options' changed from 0 to 1. Execute a instrução RECONFIGURE para instalar”.Run the RECONFIGURE statement to install."

Execute RECONFIGURE e exiba todas as opções de configuração:Run RECONFIGURE and show all configuration options:

RECONFIGURE;  
EXEC sp_configure;  

B.B. Alterando uma opção de configuraçãoChanging a configuration option

O exemplo a seguir define o recovery interval de sistema para 3 minutos.The following example sets the system recovery interval to 3 minutes.

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

Exemplos: Parallel Data WarehouseParallel Data WarehouseExamples: Parallel Data WarehouseParallel Data Warehouse

C.C. Listar todas as configurações disponíveisList all available configuration settings

O exemplo a seguir mostra como listar todas as opções de configuração.The following example shows how to list all configuration options.

EXEC sp_configure;  

O resultado retorna o nome da opção seguido pelos valores mínimo e máximo da opção.The result returns the option name followed by the minimum and maximum values for the option. O config_value é o valor que SQL Data WarehouseSQL Data Warehouse será usado quando a reconfiguração for concluída.The config_value is the value that SQL Data WarehouseSQL Data Warehouse will use when reconfiguration is complete. O run_value é o valor que está sendo usado.The run_value is the value that is currently being used. Normalmente, config_value e run_value são os mesmos, a menos que o valor esteja sendo alterado.The config_value and run_value are usually the same unless the value is in the process of being changed.

D.D. Listar as definições de configuração de um nome de configuraçãoList the configuration settings for one configuration name

EXEC sp_configure @configname='hadoop connectivity';  

E.E. Definir a conectividade do HadoopSet Hadoop connectivity

A configuração da conectividade do Hadoop requer mais algumas etapas, além da execução de sp_configure.Setting Hadoop connectivity requires a few more steps in addition to running sp_configure. Para obter o procedimento completo, consulte criar fonte (de dados externa Transact)-SQL.For the full procedure, see CREATE EXTERNAL DATA SOURCE (Transact-SQL).

Consulte tambémSee Also

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