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. Para configurar o Soft-NUMA, consulte Soft-NUMA (SQL Server).

Convenções de sintaxe de Transact-SQL

Sintaxe

Sintaxe para SQL Server.

sp_configure
    [ [ @configname = ] 'configname' ]
    [ , [ @configvalue = ] configvalue ]
[ ; ]

Sintaxe do Parallel Data Warehouse.

sp_configure
[ ; ]

Argumentos

@configname [ = ] 'nome da configuração'

O nome de uma opção de configuração. @configname é 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 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 [ = ] valor de configuração

A nova definição de configuração. @configvalue é int, com um padrão de NULL.

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

Valores do código de retorno

0 (sucesso) ou 1 (falha).

Conjunto 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 definição de configuração usando sp_configureo , você também deve atualizar o valor de configuração atual, usando ou RECONFIGURE WITH OVERRIDERECONFIGURE . 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.
run_value	int	Valor atualmente em execução da opção de configuração (valor em sys.configurations.value_in_use). Para obter mais informações, consulte sys.configurations.

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.

Clusters de Big Data do SQL Server

Determinadas operações, incluindo a definição de configurações de servidor (nível de instância) ou a adição manual de 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.

Atualizar o valor de configuração atual

Quando você especifica um novo @configvalue para um @configname, o conjunto de resultados mostra esse valor na config_value coluna. Inicialmente, esse valor difere do valor na run_value coluna, que mostra o valor de configuração em execução no momento. Para atualizar o valor de configuração atual na run_value coluna, o administrador do sistema deve executar ou RECONFIGURE RECONFIGURE WITH OVERRIDE.

Ambos RECONFIGURE e RECONFIGURE WITH OVERRIDE funcionam com todas as opções de configuração. No entanto, a instrução básica RECONFIGURE rejeita qualquer valor de opção que esteja fora de um intervalo razoável ou que possa causar conflitos entre as 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 sobrepuser ao valor da máscara de E/S de afinidade. RECONFIGURE WITH OVERRIDE, por outro lado, 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 RECONFIGURE instrução atualiza algumas opções dinamicamente; outras opções exigem uma parada e reinicialização do servidor. 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 Dados. Portanto, você pode alterá-los 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 uma opção de configuração, você pode ver se a opção foi atualizada dinamicamente executando sp_configure '<configname>'. Os valores nas colunas e config_value devem corresponder a run_value uma opção atualizada dinamicamente. Você também pode verificar quais opções são dinâmicas observando a is_dynamic coluna da exibição do sys.configurations catálogo.

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

Se um @configvalue especificado for muito alto para uma opção, a coluna refletirá run_value o fato de que o Mecanismo de Banco de Dados usa 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 RECONFIGURAR.

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 de configuração show advanced options 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 voltar para 0 quando terminar 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 executar a RECONFIGURE instrução, você deve receber a permissão no nível do ALTER SETTINGS servidor. A permissão ALTER SETTINGS é implicitamente mantida pelas funções de servidor fixas sysadmin e serveradmin.

Exemplos

R. Liste as opções de configuração avançada

O exemplo a seguir mostra como configurar e listar todas as opções de configuração. Você pode exibir opções de configuração avançadas definindo show advanced options primeiro como 1. Depois que essa opção for alterada, você poderá exibir todas as opções de configuração executando sp_configure sem parâmetros.

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

Este é o conjunto de resultados.

Configuration option 'show advanced options' changed from 0 to 1. Run the `RECONFIGURE` statement to install.

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

RECONFIGURE;
EXEC sp_configure;

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

O exemplo a seguir define a opção de configuração do sistema recovery interval como 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 é o valor que o config_value Azure Synapse Analytics usa quando a reconfiguração é concluída. O run_value é o valor que está sendo usado no momento. Os config_value e run_value geralmente são os mesmos, a menos que o valor esteja em processo de alteração.

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 de executar sp_configureo . Para obter o procedimento completo, consulte CREATE EXTERNAL DATA SOURCE (CRIAR FONTE DE DADOS EXTERNA).

sp_configure [ @configname = ] 'hadoop connectivity',
             [ @configvalue = ] { 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 }
[ ; ]
RECONFIGURE;
[ ; ]

Conteúdo relacionado

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