sp_configure (Transact-SQL)

 

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.

System_CAPS_ICON_note.jpg Remarque


Pour plus d’options de configuration au niveau de la base de données, consultez ALTER DATABASE étendue CONFIGURATION (Transact-SQL). Pour configurer Soft-NUMA, consultez Soft-NUMA (SQL Server).

Topic link icon Conventions de la syntaxe Transact-SQL

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

[ @configname= ] 'option_name'
Nom d'une option de configuration. option_name est varchar(35), avec NULL comme valeur par défaut. Moteur de base de données SQL Server reconnaît toute chaîne unique qui fait partie du nom de configuration. Si ce dernier n'est pas spécifié, la liste complète des options est renvoyée.

Pour plus d’informations sur les options de configuration disponibles et leurs paramètres, consultez Options de Configuration de serveur (SQL Server).

[ @configvalue= ] 'value'
Nouveau paramètre de configuration. value est de type int, avec NULL comme valeur par défaut. La valeur maximale dépend de l'option individuelle.

Pour obtenir la valeur maximale de chaque option, consultez la maximale colonne de la sys.configurations affichage catalogue.

0 (réussite) ou 1 (échec)

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 dans l’ordre croissant, comme indiqué dans le tableau suivant.

Les valeurs de config_value et run_value ne sont pas automatiquement équivalentes. 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. Pour plus d'informations, consultez la section Notes.

Nom de colonneType de donnéesDescription
nomnvarchar(35)Nom de l'option de configuration.
minimumintValeur minimale de l'option de configuration.
maximumintValeur maximale de l'option de configuration.
config_valueintValeur à laquelle l’option de configuration a été définie à l’aide de sp_configure (valeur dans sysconfigures.Value). Pour plus d’informations sur ces options, consultez la page Options de Configuration de serveur (SQL Server) et sys.configurations (Transact-SQL).
run_valueintValeur de l’option de configuration en cours d’exécution (valeur dans sys.configurations.value_in_use).

Pour plus d’informations, consultez sys.configurations (Transact-SQL).

Utilisez sp_configure pour afficher ou modifier les paramètres au niveau du serveur. Pour modifier les paramètres au niveau de la base de données, utilisez ALTER DATABASE. Pour modifier uniquement les paramètres qui ont une incidence sur la session de l'utilisateur actuel, utilisez l'instruction SET.

Lorsque vous spécifiez un nouveau valeur pour un option, le jeu de résultats affiche cette valeur dans la config_value colonne. 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. 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.

Ces deux instructions fonctionnent avec toutes les options de configuration. 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. Par exemple, RECONFIGURE génère une erreur si le l’intervalle de récupération valeur est supérieure à 60 minutes ou si les masque d’affinité valeur chevauche le masque d’affinité d’e/s valeur. 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.

System_CAPS_ICON_caution.jpg Attention


Une valeur d'option inappropriée peut avoir des répercussions négatives sur la configuration de l'instance de serveur. Utilisez RECONFIGURE WITH OVERRIDE avec prudence.

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. Par exemple, le options min server memory et maximale de mémoire du serveur options mémoire du serveur sont mis à jour dynamiquement dans le Moteur de base de données; par conséquent, vous pouvez les modifier sans redémarrer le serveur. Reconfiguration en revanche, 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ées.

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'. Les valeurs dans le run_value et config_value colonnes doivent correspondre à une option mises à jour dynamiquement. Vous pouvez également vérifier quelles sont les options dynamiques en examinant le is_dynamic colonne de la sys.configurations affichage catalogue.

System_CAPS_ICON_note.jpg Remarque


Si la valeur spécifiée valeur est trop élevée pour une option, le run_value colonne reflète le fait que la Moteur de base de données a par défaut la mémoire dynamique au lieu d’utiliser un paramètre qui n’est pas valide.

Pour plus d’informations, consultez RECONFIGURE (Transact-SQL).

Certaines options de configuration, tel que masque d’affinité et l’intervalle de récupération, sont désignées comme des options avancées. Par défaut, ces options ne sont ni affichables ni modifiables. Pour les rendre disponibles, définissez les ShowAdvancedOptions option de configuration sur 1.

Pour plus d’informations sur les options de configuration et leurs paramètres, consultez la page Options de Configuration de serveur (SQL Server).

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. 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. L'autorisation ALTER SETTINGS est implicitement détenue par les rôles serveur fixes sysadmin et serveradmin .

A. Affichage des options de configuration avancées

L'exemple suivant montre comment définir et afficher toutes les options de configuration. Pour afficher les options de configuration avancées, il faut tout d'abord donner à l'argument show advanced option la valeur 1. Une fois cette option modifiée, l'exécution de sp_configure sans paramètre renvoie l'ensemble des options de configuration.

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. Pour installer, exécutez l'instruction RECONFIGURE. »

Exécutez RECONFIGURE et affichez toutes les options de configuration :

RECONFIGURE;  
EXEC sp_configure;  

B. Modification d'une option de configuration

L'exemple suivant définit la valeur de l'option système recovery interval à 3 minutes.

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

C. Liste de tous les paramètres de configuration disponibles

L'exemple suivant montre comment afficher toutes les options de configuration.

EXEC sp_configure;  

Le résultat renvoie le nom de l'option suivi des valeurs minimales et maximales de cette option. Le config_value est la valeur qui SQL Data Warehouse utilisera lors de la configuration est terminée. run_value est la valeur en cours d’utilisation. Les valeurs config_value et run_value sont généralement identiques, sauf si la valeur est en cours de modification.

D. Liste des paramètres de configuration pour un nom de configuration

EXEC sp_configure @configname='hadoop connectivity';  

E. Définir la connectivité Hadoop

Paramètre de connectivité Hadoop nécessite quelques étapes supplémentaires, outre l’exécution de sp_configure. Pour connaître la procédure complète, consultez CREATE EXTERNAL DATA SOURCE (Transact-SQL).

RECONFIGURE (Transact-SQL)
Instructions SET (Transact-SQL)
Options de Configuration de serveur (SQL Server)
MODIFIER la base de données (Transact-SQL)
Procédures système (Transact-SQL)
Sys.configurations (Transact-SQL)
MODIFIER la CONFIGURATION inclus dans l’étendue de base de données (Transact-SQL)
Soft-NUMA (SQL Server)

Ajouts de la communauté

AJOUTER
Afficher: