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

APPLIES TO: yesSQL Server (starting with 2008) yesAzure SQL Database (Managed Instance only) noAzure SQL Data Warehouse yesParallel Data Warehouse

Visualizza o modifica le impostazioni di configurazione globali per il server corrente.Displays or changes global configuration settings for the current server.

Nota

Per le opzioni di configurazione a livello di database, vedere ALTER DATABASE ambito di configurazione (Transact-SQL).For database-level configuration options, see ALTER DATABASE SCOPED CONFIGURATION (Transact-SQL). Per configurare Soft-NUMA, vedere Soft-NUMA (di SQL Server).To configure Soft-NUMA, see Soft-NUMA (SQL Server).

Icona di collegamento a un argomentoConvenzioni della sintassi Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SintassiSyntax

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

ArgomentiArguments

[ @configname = ] 'option_name' È il nome di un'opzione di configurazione.[ @configname = ] 'option_name' Is the name of a configuration option. option_name è varchar(35) e il valore predefinito è NULL.option_name is varchar(35), with a default of NULL. Motore di database di SQL ServerSQL Server Database Engine riconosce qualsiasi stringa univoca che faccia parte del nome della configurazione.The Motore di database di SQL ServerSQL Server Database Engine recognizes any unique string that is part of the configuration name. Se non si specifica alcun nome di opzione, viene restituito l'elenco completo delle opzioni.If not specified, the complete list of options is returned.

Per informazioni sulle opzioni di configurazione disponibili e le relative impostazioni, vedere opzioni di configurazione (di SQL Server).For information about the available configuration options and their settings, see Server Configuration Options (SQL Server).

[ @configvalue = ] 'value' È la nuova impostazione di configurazione.[ @configvalue = ] 'value' Is the new configuration setting. value è inte il valore predefinito è NULL.value is int, with a default of NULL. Il valore massimo dipende dalla singola opzione.The maximum value depends on the individual option.

Per visualizzare il valore massimo per ogni opzione, vedere la massima colonna di sys.configurations visualizzazione catalogo.To see the maximum value for each option, see the maximum column of the sys.configurations catalog view.

Valori restituitiReturn Code Values

0 (esito positivo) o 1 (esito negativo)0 (success) or 1 (failure)

Set di risultatiResult Sets

Se eseguita senza parametri, sp_configure restituisce un set di risultati con cinque colonne e Ordina le opzioni in ordine alfabetico in ordine crescente, come illustrato nella tabella seguente.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.

I valori per config_value e run_value non sono automaticamente equivalenti.The values for config_value and run_value are not automatically equivalent. Dopo aver aggiornato un'impostazione di configurazione usando sp_configure, l'amministratore di sistema è necessario aggiornare il valore di configurazione utilizzando l'istruzione RECONFIGURE o RECONFIGURE WITH 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. Per altre informazioni, vedere la sezione Osservazioni.For more information, see the Remarks section.

Nome colonnaColumn name Tipo di datiData type DescrizioneDescription
namename nvarchar(35)nvarchar(35) Nome dell'opzione di configurazione.Name of the configuration option.
minimumminimum intint Valore minimo dell'opzione di configurazione.Minimum value of the configuration option.
maximummaximum intint Valore massimo dell'opzione di configurazione.Maximum value of the configuration option.
config_valueconfig_value intint Valore a cui è stata impostata l'opzione di configurazione usando sp_configure (valore nelle Configurations).Value to which the configuration option was set using sp_configure (value in sys.configurations.value). Per ulteriori informazioni su queste opzioni, vedere opzioni di configurazione (di 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 Valore dell'opzione di configurazione (valore in value_in_use).Currently running value of the configuration option (value in sys.configurations.value_in_use).

Per ulteriori informazioni, vedere sys.configurations (Transact-SQL).For more information, see sys.configurations (Transact-SQL).

NoteRemarks

Uso sp_configure per visualizzare o modificare le impostazioni a livello di server.Use sp_configure to display or change server-level settings. Per modificare le impostazioni a livello di database, utilizzare ALTER DATABASE.To change database-level settings, use ALTER DATABASE. Per modificare le impostazioni che interessano solo la sessione utente corrente, utilizzare l'istruzione SET.To change settings that affect only the current user session, use the SET statement.

Aggiornamento del valore di configurazione correnteUpdating the Running Configuration Value

Quando si specifica un nuovo valore per un' opzione, il set di risultati Mostra questo valore di config_value colonna.When you specify a new value for an option, the result set shows this value in the config_value column. Questo valore inizialmente è diverso dal valore di run_value colonna che mostra il valore di configurazione attualmente in esecuzione.This value initially differs from the value in the run_value column, which shows the currently running configuration value. Per aggiornare il valore di configurazione nel run_value colonna, l'amministratore di sistema deve eseguire RECONFIGURE o RECONFIGURE WITH OVERRIDE.To update the running configuration value in the run_value column, the system administrator must run either RECONFIGURE or RECONFIGURE WITH OVERRIDE.

Sia RECONFIGURE che RECONFIGURE WITH OVERRIDE funzionano con tutte le opzioni di configurazione.Both RECONFIGURE and RECONFIGURE WITH OVERRIDE work with every configuration option. L'istruzione RECONFIGURE, tuttavia, non accetta i valori di opzione che non rientrano in un intervallo ragionevole o che possono causare conflitti tra le opzioni.However, the basic RECONFIGURE statement rejects any option value that is outside a reasonable range or that may cause conflicts among options. Ad esempio RECONFIGURE genera un errore se il intervallo di recupero valore è maggiore di 60 minuti o se il maschera di affinità valore si sovrappone con il maschera di affinità i/ovalore.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, invece, accetta qualsiasi valore di opzione con il tipo di dati corretto e impone la riconfigurazione utilizzando il valore specificato.RECONFIGURE WITH OVERRIDE, in contrast, accepts any option value with the correct data type and forces reconfiguration with the specified value.

Attenzione

Un valore non corretto può compromettere la configurazione dell'istanza del server.An inappropriate option value can adversely affect the configuration of the server instance. Utilizzare RECONFIGURE WITH OVERRIDE con cautela.Use RECONFIGURE WITH OVERRIDE cautiously.

L'istruzione RECONFIGURE aggiorna alcune opzioni in modo dinamico. Per altre è necessario arrestare e riavviare il server.The RECONFIGURE statement updates some options dynamically; other options require a server stop and restart. Ad esempio, il memoria server min e massima di memoria del server opzioni memoria server vengono aggiornate dinamicamente la Motore di databaseDatabase Engine; pertanto, possono essere modificate senza riavviare il server.For example, the min server memory and max server memory server memory options are updated dynamically in the Motore di databaseDatabase Engine; therefore, you can change them without restarting the server. Riconfigurazione, al contrario, il valore di il fattore di riempimento opzione richiede il riavvio di Motore di databaseDatabase Engine.By contrast, reconfiguring the running value of the fill factor option requires restarting the Motore di databaseDatabase Engine.

Dopo aver eseguito RECONFIGURE per un'opzione di configurazione, è possibile visualizzare se l'opzione è stata aggiornata in modo dinamico eseguendo sp_configure'nome_opzione'.After running RECONFIGURE on a configuration option, you can see whether the option has been updated dynamically by executing sp_configure'option_name'. I valori di run_value e config_value colonne devono corrispondere a un'opzione aggiornato in modo dinamico.The values in the run_value and config_value columns should match for a dynamically updated option. È possibile anche verificare quali opzioni sono dinamiche osservando la is_dynamic della colonna della Sys. Configurations vista del catalogo.You can also check to see which options are dynamic by looking at the is_dynamic column of the sys.configurations catalog view.

Nota

Se un oggetto specificato valore troppo elevato per un'opzione, il run_value colonna riflette il fatto che il Motore di databaseDatabase Engine ha impostato come predefinito per la memoria dinamica, anziché usare un'impostazione che non è valida.If a specified value is too high for an option, the run_value column reflects the fact that the Motore di databaseDatabase Engine has defaulted to dynamic memory rather than use a setting that is not valid.

Per ulteriori informazioni, vedere RICONFIGURARE (Transact-SQL).For more information, see RECONFIGURE (Transact-SQL).

Opzioni avanzateAdvanced Options

Configurazione di alcune opzioni, ad esempio maschera di affinità e intervallo di recupero, sono designati come opzioni avanzate.Some configuration options, such as affinity mask and recovery interval, are designated as advanced options. Per impostazione predefinita non è possibile visualizzarle e modificarle.By default, these options are not available for viewing and changing. Per renderli disponibili, impostare il ShowAdvancedOptions l'opzione di configurazione a 1.To make them available, set the ShowAdvancedOptions configuration option to 1.

Per ulteriori informazioni sulle opzioni di configurazione e le relative impostazioni, vedere opzioni di configurazione (di SQL Server).For more information about the configuration options and their settings, see Server Configuration Options (SQL Server).

PermissionsPermissions

Le autorizzazioni di esecuzione per sp_configure senza alcun parametro o solo con il primo parametro vengono assegnate per impostazione predefinita a tutti gli utenti.Execute permissions on sp_configure with no parameters or with only the first parameter are granted to all users by default. Per eseguire sp_configure con entrambi i parametri per modificare un'opzione di configurazione o per eseguire l'istruzione RECONFIGURE, è necessario essere concessa l'autorizzazione a livello di server 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. L'autorizzazione ALTER SETTINGS è assegnata implicitamente ai ruoli predefiniti del server sysadmin e serveradmin .The ALTER SETTINGS permission is implicitly held by the sysadmin and serveradmin fixed server roles.

EsempiExamples

A.A. Visualizzazione dell'elenco delle opzioni di configurazione avanzateListing the advanced configuration options

Nell'esempio seguente viene illustrato come impostare ed elencare tutte le opzioni di configurazione.The following example shows how to set and list all configuration options. Le opzioni di configurazione avanzate vengono visualizzate se innanzitutto si imposta show advanced option su 1.Advanced configuration options are displayed by first setting show advanced option to 1. In seguito alla modifica di questa opzione, se si esegue sp_configure senza parametri, verranno visualizzate tutte le opzioni di configurazione.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';  

Ecco il messaggio: "Opzione di configurazione 'show advanced options' modificato da 0 a 1.Here is the message: "Configuration option 'show advanced options' changed from 0 to 1. Per eseguire l'installazione, utilizzare RECONFIGURE".Run the RECONFIGURE statement to install."

Eseguire RECONFIGURE e visualizzare tutte le opzioni di configurazione:Run RECONFIGURE and show all configuration options:

RECONFIGURE;  
EXEC sp_configure;  

B.B. Modifica di un'opzione di configurazioneChanging a configuration option

Nell'esempio seguente viene impostato il valore di recovery interval del sistema su 3 minuti.The following example sets the system recovery interval to 3 minutes.

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

Esempi: Parallel Data WarehouseParallel Data WarehouseExamples: Parallel Data WarehouseParallel Data Warehouse

C.C. Elencare tutte le impostazioni di configurazione disponibiliList all available configuration settings

L'esempio seguente mostra come impostare ed elencare tutte le opzioni di configurazione.The following example shows how to list all configuration options.

EXEC sp_configure;  

Il risultato restituisce il nome dell'opzione seguito dai valori minimi e massimo per l'opzione.The result returns the option name followed by the minimum and maximum values for the option. Il config_value è il valore che SQL Data WarehouseSQL Data Warehouse utilizzerà per la riconfigurazione è completa.The config_value is the value that SQL Data WarehouseSQL Data Warehouse will use when reconfiguration is complete. config_value è il valore in uso.The run_value is the value that is currently being used. The config_value e run_value sono in genere uguali, a meno che il valore non sia in corso di modifica.The config_value and run_value are usually the same unless the value is in the process of being changed.

D.D. Elencare le impostazioni di configurazione per un nome di configurazioneList the configuration settings for one configuration name

EXEC sp_configure @configname='hadoop connectivity';  

E.E. Impostare la connettività HadoopSet Hadoop connectivity

L'impostazione Hadoop connectivity richiede alcuni passaggi aggiuntivi oltre a eseguire sp_configure.Setting Hadoop connectivity requires a few more steps in addition to running sp_configure. Per istruzioni complete, vedere Crea origine dati esterna (Transact-SQL).For the full procedure, see CREATE EXTERNAL DATA SOURCE (Transact-SQL).

Vedere ancheSee Also

RECONFIGURE (Transact-SQL) RECONFIGURE (Transact-SQL)
Istruzioni SET (Transact-SQL) SET Statements (Transact-SQL)
Opzioni di configurazione del server (SQL Server) Server Configuration Options (SQL Server)
ALTER DATABASE (Transact-SQL) ALTER DATABASE (Transact-SQL)
Stored procedure di 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)