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

CETTE RUBRIQUE S’APPLIQUE À :ouiSQL Server (à partir de la version 2008)nonAzure SQL DatabasenonAzure SQL Data Warehouse ouiParallel Data Warehouse THIS TOPIC APPLIES TO:yesSQL Server (starting with 2008)noAzure SQL DatabasenoAzure SQL Data Warehouse yesParallel Data Warehouse

Affiche ou modifie des options de configuration générales pour le serveur actif.Displays or changes global configuration settings for the current server.

Note

Pour plus d’options de configuration au niveau de la base de données, consultez ALTER DATABASE SCOPED CONFIGURATION ( Transact-SQL ) .For database-level configuration options, see ALTER DATABASE SCOPED CONFIGURATION (Transact-SQL). Pour configurer Soft-NUMA, consultez Soft-NUMA ( SQL Server ) .To configure Soft-NUMA, see Soft-NUMA (SQL Server).

Icône de lien de rubrique Conventions de la syntaxe Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SyntaxeSyntax

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

ArgumentsArguments

[ @configname= ] 'nom_option'[ @configname= ] 'option_name'
Nom d'une option de configuration.Is the name of a configuration option. option_name est varchar(35), avec NULL comme valeur par défaut.option_name is varchar(35), with a default of NULL. Moteur de base de données SQL ServerSQL Server Database Engine reconnaît toute chaîne unique qui fait partie du nom de configuration.The Moteur de base de données SQL ServerSQL Server Database Engine recognizes any unique string that is part of the configuration name. Si ce dernier n'est pas spécifié, la liste complète des options est renvoyée.If not specified, the complete list of options is returned.

Pour plus d’informations sur les options de configuration disponibles et leurs paramètres, consultez les Options de Configuration de serveur ( SQL Server ) .For information about the available configuration options and their settings, see Server Configuration Options (SQL Server).

[ @configvalue= ] 'valeur'[ @configvalue= ] 'value'
Nouveau paramètre de configuration.Is the new configuration setting. value est de type int, avec NULL comme valeur par défaut.value is int, with a default of NULL. La valeur maximale dépend de l'option individuelle.The maximum value depends on the individual option.

Pour obtenir la valeur maximale de chaque option, consultez la maximale colonne de la sys.configurations affichage catalogue.To see the maximum value for each option, see the maximum column of the sys.configurations catalog view.

Valeurs des codes de retourReturn Code Values

0 (réussite) ou 1 (échec)0 (success) or 1 (failure)

Jeux de résultatsResult Sets

Lorsqu’elle est exécutée sans paramètres, sp_configure renvoie un jeu de résultats avec cinq colonnes et trie les options par ordre alphabétique en ordre croissant, comme indiqué dans le tableau suivant.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.

Les valeurs de config_value et run_value ne sont pas automatiquement équivalentes.The values for config_value and run_value are not automatically equivalent. Après la mise à jour d’un paramètre de configuration à l’aide de sp_configure, l’administrateur système doit mettre à jour la valeur de configuration en cours d’exécution à l’aide de RECONFIGURE ou 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. Pour plus d'informations, consultez la section Notes.For more information, see the Remarks section.

Nom de colonneColumn name Type de donnéesData type DescriptionDescription
nomname nvarchar(35)nvarchar(35) Nom de l'option de configuration.Name of the configuration option.
minimumminimum intint Valeur minimale de l'option de configuration.Minimum value of the configuration option.
maximummaximum intint Valeur maximale de l'option de configuration.Maximum value of the configuration option.
config_valueconfig_value intint Valeur à laquelle l’option de configuration a été définie à l’aide de sp_configure (valeur dans sysconfigures.Value).Value to which the configuration option was set using sp_configure (value in sys.configurations.value). Pour plus d’informations sur ces options, consultez les Options de Configuration de serveur ( SQL Server ) et 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 Valeur de l’option de configuration en cours d’exécution (valeur dans sys.configurations.value_in_use).Currently running value of the configuration option (value in sys.configurations.value_in_use).

Pour plus d’informations, consultez sys.configurations ( Transact-SQL ) .For more information, see sys.configurations (Transact-SQL).

NotesRemarks

Utilisez sp_configure pour afficher ou modifier les paramètres au niveau du serveur.Use sp_configure to display or change server-level settings. Pour modifier les paramètres au niveau de la base de données, utilisez ALTER DATABASE.To change database-level settings, use ALTER DATABASE. Pour modifier uniquement les paramètres qui ont une incidence sur la session de l'utilisateur actuel, utilisez l'instruction SET.To change settings that affect only the current user session, use the SET statement.

Mise à jour de la valeur de configuration en cours d'exécutionUpdating the Running Configuration Value

Lorsque vous spécifiez un nouveau valeur pour un option, le jeu de résultats affiche cette valeur dans la config_value colonne.When you specify a new value for an option, the result set shows this value in the config_value column. Cette valeur est initialement diffère de la valeur dans la run_value colonne, qui affiche la valeur de configuration en cours d’exécution.This value initially differs from the value in the run_value column, which shows the currently running configuration value. Pour mettre à jour la valeur de configuration en cours d’exécution dans le run_value colonne, l’administrateur système doit exécuter RECONFIGURE ou 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.

Ces deux instructions fonctionnent avec toutes les options de configuration.Both RECONFIGURE and RECONFIGURE WITH OVERRIDE work with every configuration option. Cependant, l'instruction de base RECONFIGURE rejette toute valeur d'option se trouvant en dehors d'une plage appropriée ou pouvant être à l'origine de conflits parmi les options.However, the basic RECONFIGURE statement rejects any option value that is outside a reasonable range or that may cause conflicts among options. Par exemple, RECONFIGURE génère une erreur si le l’intervalle de récupération valeur est supérieure à 60 minutes ou si le masque d’affinité valeur chevauche le masque d’affinité d’e/s valeur.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. Par contre, RECONFIGURE WITH OVERRIDE accepte toutes les valeurs d'option présentant le bon type de données et force la reconfiguration avec la valeur spécifiée.RECONFIGURE WITH OVERRIDE, in contrast, accepts any option value with the correct data type and forces reconfiguration with the specified value.

Attention

Une valeur d'option inappropriée peut avoir des répercussions négatives sur la configuration de l'instance de serveur.An inappropriate option value can adversely affect the configuration of the server instance. Utilisez RECONFIGURE WITH OVERRIDE avec prudence.Use RECONFIGURE WITH OVERRIDE cautiously.

Certaines options peuvent être mises à jour de façon dynamique par l'instruction RECONFIGURE, alors que d'autres nécessitent un arrêt et un redémarrage du serveur.The RECONFIGURE statement updates some options dynamically; other options require a server stop and restart. Par exemple, le options min server memory et mémoire maximum du serveur options mémoire du serveur sont mises à jour dynamiquement le Moteur de base de donnéesDatabase Engine; par conséquent, vous pouvez les modifier sans redémarrer le serveur.For example, the min server memory and max server memory server memory options are updated dynamically in the Moteur de base de donnéesDatabase Engine; therefore, you can change them without restarting the server. En revanche, reconfigurer la valeur en cours d’exécution de la facteur de remplissage option nécessite le redémarrage de le Moteur de base de donnéesDatabase Engine.By contrast, reconfiguring the running value of the fill factor option requires restarting the Moteur de base de donnéesDatabase Engine.

Après l’exécution de RECONFIGURE sur une option de configuration, vous pouvez voir si l’option a été mis à jour dynamiquement en exécutant 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'. Les valeurs dans le run_value et config_value colonnes doivent correspondre pour une option de mise à jour dynamiquement.The values in the run_value and config_value columns should match for a dynamically updated option. Vous pouvez également vérifier quelles sont les options dynamiques en examinant le is_dynamic colonne de la sys.configurations affichage catalogue.You can also check to see which options are dynamic by looking at the is_dynamic column of the sys.configurations catalog view.

Note

Si un valeur est trop élevée pour une option, le run_value colonne reflète le fait que la Moteur de base de donnéesDatabase Engine a pas réussi à la mémoire dynamique au lieu d’utiliser un paramètre qui n’est pas valide.If a specified value is too high for an option, the run_value column reflects the fact that the Moteur de base de donnéesDatabase Engine has defaulted to dynamic memory rather than use a setting that is not valid.

Pour plus d’informations, consultez RECONFIGURE ( Transact-SQL ) .For more information, see RECONFIGURE (Transact-SQL).

Options avancéesAdvanced Options

Certaines options de configuration, tel que masque d’affinité et l’intervalle de récupération, sont désignés comme des options avancées.Some configuration options, such as affinity mask and recovery interval, are designated as advanced options. Par défaut, ces options ne sont ni affichables ni modifiables.By default, these options are not available for viewing and changing. Pour les rendre disponibles, vous devez définir le ShowAdvancedOptions option de configuration à 1.To make them available, set the ShowAdvancedOptions configuration option to 1.

Pour plus d’informations sur les options de configuration et leurs paramètres, consultez les Options de Configuration de serveur ( SQL Server ) .For more information about the configuration options and their settings, see Server Configuration Options (SQL Server).

PermissionsPermissions

Les autorisations d’exécution de sp_configure , sans paramètre ou avec le premier paramètre uniquement, sont accordées par défaut à tous les utilisateurs.Execute permissions on sp_configure with no parameters or with only the first parameter are granted to all users by default. Pour exécuter sp_configure avec les deux paramètres pour modifier une option de configuration ou d’exécuter l’instruction RECONFIGURE, vous devez avoir l’autorisation ALTER SETTINGS au niveau du serveur.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'autorisation ALTER SETTINGS est implicitement détenue par les rôles serveur fixes sysadmin et serveradmin .The ALTER SETTINGS permission is implicitly held by the sysadmin and serveradmin fixed server roles.

ExemplesExamples

A.A. Affichage des options de configuration avancéesListing the advanced configuration options

L'exemple suivant montre comment définir et afficher toutes les options de configuration.The following example shows how to set and list all configuration options. Pour afficher les options de configuration avancées, il faut tout d'abord donner à l'argument show advanced option la valeur 1.Advanced configuration options are displayed by first setting show advanced option to 1. Une fois cette option modifiée, l'exécution de sp_configure sans paramètre renvoie l'ensemble des options de configuration.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';  

Voici le message : « L'option de configuration 'show advanced options' est passée de 0 à 1.Here is the message: "Configuration option 'show advanced options' changed from 0 to 1. Pour installer, exécutez l'instruction RECONFIGURE. »Run the RECONFIGURE statement to install."

Exécutez RECONFIGURE et affichez toutes les options de configuration :Run RECONFIGURE and show all configuration options:

RECONFIGURE;  
EXEC sp_configure;  

B.B. Modification d'une option de configurationChanging a configuration option

L'exemple suivant définit la valeur de l'option système recovery interval à 3 minutes.The following example sets the system recovery interval to 3 minutes.

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

Exemples : Parallel Data WarehouseParallel Data WarehouseExamples: Parallel Data WarehouseParallel Data Warehouse

C.C. Liste de tous les paramètres de configuration disponiblesList all available configuration settings

L'exemple suivant montre comment afficher toutes les options de configuration.The following example shows how to list all configuration options.

EXEC sp_configure;  

Le résultat renvoie le nom de l'option suivi des valeurs minimales et maximales de cette option.The result returns the option name followed by the minimum and maximum values for the option. Le config_value est la valeur qui SQL Data WarehouseSQL Data Warehouse utilisera lors de la reconfiguration terminée.The config_value is the value that SQL Data WarehouseSQL Data Warehouse will use when reconfiguration is complete. run_value est la valeur en cours d’utilisation.The run_value is the value that is currently being used. Les valeurs config_value et run_value sont généralement identiques, sauf si la valeur est en cours de modification.The config_value and run_value are usually the same unless the value is in the process of being changed.

D.D. Liste des paramètres de configuration pour un nom de configurationList the configuration settings for one configuration name

EXEC sp_configure @configname='hadoop connectivity';  

E.E. Définir la connectivité HadoopSet Hadoop connectivity

Définition de la connectivité Hadoop requiert quelques étapes supplémentaires en plus des sp_configure.Setting Hadoop connectivity requires a few more steps in addition to running sp_configure. Pour connaître la procédure complète, consultez CREATE EXTERNAL DATA SOURCE ( Transact-SQL ) .For the full procedure, see CREATE EXTERNAL DATA SOURCE (Transact-SQL).

Voir aussiSee Also

RECONFIGURE (Transact-SQL) RECONFIGURE (Transact-SQL)
Instructions SET (Transact-SQL) SET Statements (Transact-SQL)
Options de configuration de serveur (SQL Server) Server Configuration Options (SQL Server)
ALTER DATABASE (Transact-SQL) ALTER DATABASE (Transact-SQL)
Procédures stockées système (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)