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

S’APPLIQUE À : ouiSQL Server ouiAzure SQL Database (Managed Instance uniquement) nonAzure Synapse Analytics (SQL DW) ouiParallel Data Warehouse APPLIES TO: yesSQL Server yesAzure SQL Database (Managed Instance only) noAzure Synapse Analytics (SQL DW) 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.

Notes

Pour les 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 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 = ] 'option_name' est le nom d’une option de configuration.[ @configname = ] 'option_name' 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 (options)de configuration du serveur SQL Server.For information about the available configuration options and their settings, see Server Configuration Options (SQL Server).

[ @configvalue = ] 'value' est le nouveau paramètre de configuration.[ @configvalue = ] 'value' 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 afficher la valeur maximale de chaque option, consultez la colonne maximum de l’affichage catalogue sys. configurations .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

En cas d’exécution sans paramètre, sp_configure retourne un jeu de résultats avec cinq colonnes et trie les options par ordre alphabétique dans l’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 équivalentes automatiquement.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 en utilisant 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 sys. configurations. 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 options (de configuration) du 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 en cours d’exécution de l’option de configuration (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.

Clusters Big Data SQL ServerSQL Server Big Data Clusters

Pour certaines opérations, comme notamment la configuration des paramètres de serveur (au niveau de l’instance) ou l’ajout manuel d’une base de données à un groupe de disponibilité, une connexion à l’instance SQL Server peut s’avérer nécessaire.Certain operations, including configuring server (instance level) settings, or manually adding a database to an availability group, require a connection to the SQL Server Instance. Les opérations comme sp_configure, RESTORE DATABASE ou n’importe quelle commande DDL dans une base de données appartenant à un groupe de disponibilité nécessitent une connexion à l’instance SQL Server.Operations like sp_configure, RESTORE DATABASE, or any DDL command in a database belonging to an availability group require a connection to the SQL Server instance. Par défaut, un cluster Big Data ne comporte pas de point de terminaison permettant une connexion à l’instance.By default, a big data cluster does not include an endpoint that enables a connection to the instance. Vous devez exposer ce point de terminaison manuellement.You must expose this endpoint manually.

Pour obtenir des instructions, consultez Se connecter aux bases de données sur le réplica principal.For instructions, see Connect to databases on the primary replica.

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

Lorsque vous spécifiez une nouvelle valeur pour une option, le jeu de résultats affiche cette valeur dans la colonne config_value .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érente de la valeur de la colonne run_value , 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 la colonne run_value , 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 la valeur de l' intervalle de récupération est supérieure à 60 minutes ou si la valeur du masque d’affinité chevauche la valeur 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. 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, les options min Server Memory et Max Server Memory Server sont mises à jour dynamiquement dans 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, la reconfiguration de la valeur d’exécution de l’option facteur de remplissage nécessite le redémarrage de l' 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é mise à jour de manière dynamique 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 des colonnes run_value et config_value doivent correspondre pour une option 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 options sont dynamiques en examinant la colonne is_dynamic de l’affichage catalogue 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 modification est également écrite dans le journal des erreurs SQL Server.The change is also written to the SQL Server error log.

Notes

Si une valeur spécifiée est trop élevée pour une option, la colonne run_value reflète le fait que le Moteur de base de donnéesDatabase Engine a utilisé par défaut la mémoire dynamique au lieu d’utiliser un paramètre non 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, telles que le masque d’affinité et l' intervalle de récupération, sont désignées comme 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, affectez la valeur 1 à l’option de configuration ShowAdvandedOptions .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 options (de)configuration du serveur SQL Server.For more information about the configuration options and their settings, see Server Configuration Options (SQL Server).

AutorisationsPermissions

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 afin de modifier une option de configuration ou d’exécuter l’instruction RECONFIGURE, vous devez disposer de 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 que SQL Data WarehouseSQL Data Warehouse utilisera une fois 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

La définition de la connectivité Hadoop nécessite quelques étapes supplémentaires en plus de l’exécution de sp_configure.Setting Hadoop connectivity requires a few more steps in addition to running sp_configure. Pour obtenir 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)