Partilhar via

sp_configure (Transact-SQL)

Aplica-se a:SQL ServerAzure SQL Managed InstanceAnalytics Platform System (PDW)

Exibe ou altera as definições de configuração global para o servidor atual.

Observação

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

Transact-SQL convenções de sintaxe

Sintaxe

Sintaxe para SQL Server.

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

Sintaxe para o Analytics Platform System (PDW).

sp_configure
[ ; ]

Arguments

@configname [ = ] 'configname'

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.

@configvalue [ = ] configvalue

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 para cada opção, consulte a maximum coluna da sys.configurations exibição de catálogo.

Valores de código de retorno

0 (sucesso) ou 1 (fracasso).

Conjunto de resultados

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.

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_configure, você também deve atualizar o valor de configuração em execução, usando um ou RECONFIGURERECONFIGURE WITH OVERRIDE. Para obter mais informações, consulte a seção Observações .

Nome da coluna Tipo de dados Description
name Nvarchar(35) 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 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.

Observações

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 de usuário atual, use a SET instrução.

Algumas opções de configuração do servidor só estão disponíveis através da ALTER SERVER CONFIGURATION.

Atualizar o valor de configuração em execução

Quando você especifica um novo @configvalue para um @configname, o conjunto de resultados mostra esse valor na config_value coluna. Esse valor inicialmente 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 em execução na coluna, o run_value administrador do sistema deve executar um RECONFIGURE ou RECONFIGURE WITH OVERRIDE.

Ambos RECONFIGURE e RECONFIGURE WITH OVERRIDE trabalhar 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 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.

Atenção

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 min server memory e max server memory server memory 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 em uma opção de configuração, você pode ver se a opção foi atualizada dinamicamente executando sp_configure '<configname>'. Os valores nas run_value colunas e config_value devem corresponder para uma opção atualizada dinamicamente. Você também pode verificar quais opções são dinâmicas observando a is_dynamic coluna da sys.configurations exibição de 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 assume 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.

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 visualização e alteração. Para disponibilizá-los, defina a opção de configuração show advanced options como 1.

Atenção

Quando a opção mostrar opções avançadas estiver 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 visualizar as 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.

Permissions

As permissões de execução em sp_configure sem parâmetros ou apenas com o primeiro parâmetro 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 ALTER SETTINGS permissão é mantida implicitamente pelas funções de servidor fixas sysadmin e serveradmin .

Examples

A. Listar as opções de configuração avançadas

O exemplo a seguir mostra como definir 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

EXECUTE sp_configure 'show advanced options', '1';

Aqui está o conjunto de resultados.

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

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

RECONFIGURE;

EXECUTE 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

EXECUTE sp_configure 'recovery interval', '3';

RECONFIGURE WITH OVERRIDE;

Exemplos: Analytics Platform System (PDW)

C. Listar todas as definições de configuração disponíveis

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

EXECUTE 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 usa quando a reconfiguração é concluída. O run_value é o valor que está sendo usado atualmente. Os config_value e run_value são geralmente os mesmos, a menos que o valor esteja em processo de alteração.

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

EXECUTE sp_configure @configname = 'hadoop connectivity';

E. Definir conectividade Hadoop

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

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

Conteúdo relacionado

  • Last updated on