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

SI APPLICA A: sìSQL Server sìDatabase SQL di Azure (solo Istanza gestita) noAzure SQL Data Warehouse sìParallel Data Warehouse APPLIES TO: yesSQL Server 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 (scoped Configuration)Transact-SQL.For database-level configuration options, see ALTER DATABASE SCOPED CONFIGURATION (Transact-SQL). Per configurare Soft-NUMA, vedere SQL Server)Soft- (NUMA.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'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 sulle relative impostazioni, vedere Opzioni (di configurazione)del server SQL Server.For information about the available configuration options and their settings, see Server Configuration Options (SQL Server).

[ @configvalue = ] 'value'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 colonna Maximum della vista del catalogo sys. Configurations.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 alfabeticamente le opzioni 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 l'aggiornamento di un'impostazione di configurazione tramite sp_configure, l'amministratore di sistema deve aggiornare il valore di configurazione in esecuzione utilizzando riconfigure 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 in cui è stata impostata l'opzione di configurazione utilizzando sp_configure (valore in sys. Configurations. value).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 del) server 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 corrente dell'opzione di configurazione (valore in sys. Configurations. 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

Utilizzare 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 nella colonna config_value .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 nella colonna run_value , che mostra il valore di configurazione correntemente 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 in esecuzione nella colonna run_value , 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. Riconfigura, ad esempio, genera un errore se il valore dell' intervallo di recupero è maggiore di 60 minuti o se il valore della maschera di affinità si sovrappone al valore di affinity i/O mask .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, le opzioni memoria minima del server e memoria server max server memory vengono aggiornate dinamicamente nella Motore di databaseDatabase Engine; pertanto, è possibile modificarle 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. Al contrario, per riconfigurare il valore corrente dell'opzione Fill Factor è necessario riavviare Motore di databaseDatabase Engine.By contrast, reconfiguring the running value of the fill factor option requires restarting the Motore di databaseDatabase Engine.

Dopo l'esecuzione di RECONFIGURE in un'opzione di configurazione, è possibile verificare se l'opzione è stata aggiornata dinamicamente eseguendo 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'. I valori nelle colonne run_value e config_value devono corrispondere per un'opzione aggiornata dinamicamente.The values in the run_value and config_value columns should match for a dynamically updated option. È anche possibile verificare quali opzioni sono dinamiche osservando la colonna is_dynamic della vista del catalogo 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.

La modifica viene inoltre scritta nel log degli errori di SQL Server.The change is also written to the SQL Server error log.

Nota

Se un valore specificato è troppo elevato per un'opzione, la colonna run_value riflette il fatto che l' Motore di databaseDatabase Engine oggetto è stato impostato come predefinito nella memoria dinamica anziché utilizzare un'impostazione 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 RECONFIGURE (Transact-SQL).For more information, see RECONFIGURE (Transact-SQL).

Opzioni avanzateAdvanced Options

Alcune opzioni di configurazione, ad esempio affinity mask e Recovery Interval, sono designate 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 renderle disponibili, impostare l'opzione di configurazione ShowAdvancedOptions su 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)del server 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 concedere 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

R.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 ' Mostra opzioni avanzate ' modificata 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. Config_value è il valore che SQL Data WarehouseSQL Data Warehouse verrà utilizzato al termine della riconfigurazione.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

Per impostare la connettività Hadoop sono necessari alcuni passaggi aggiuntivi oltre all'esecuzione di sp_configure.Setting Hadoop connectivity requires a few more steps in addition to running sp_configure. Per la procedura completa, vedere creare un'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)