Langage de programmation - Base de données - SQL Server - Référence des Stored Procedures système

sp_configure	Configure
SQL Server

Syntaxe

sp_configure [ [ @configname = ] 'option_name' [ , [ @configvalue = ] 'value' ] ]

sp_configure [;]

sp_configure [ @configname= ] 'hadoop connectivity', [ @configvalue = ] { 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 } [;]
RECONFIGURE [;]

Paramètres

Nom	Description
[ @configname = ] 'option_name'	Ce paramètre permet d'indiquer le nom d'une option de configuration. Le paramètre option_name est un varchar(35), avec une valeur par défaut de NULL. Le moteur de base de données SQL Server reconnaît toute chaîne de caractères unique faisant partie du nom de configuration. Si ce paramètre n'est pas spécifié, la liste complète des options est renvoyée. Voici quelques options disponibles :
	Option	Description
	access check cache bucket count	Cette option permet d'indiquer le nombre de compartiments de hachage utilisés pour le cache des résultats de la vérification d'accès.
	access check cache quota	Cette option permet d'indiquer le quota de cache de contrôle d'accès, le contrôle de nombre d'entrées et le nombre de compartiments de hachage utilisés pour le cache de résultats de contrôle d'accès.
	Ad Hoc Distributed Queries	Cette option permet d'activer la composante «OpenRowset/OpenDatasource» de requêtes distribuées ad hoc.
	affinity I/O mask	Cette option permet d'indiquer le masque d'affinité (pour répondre aux besoins d'affinité du processeur) et le masque d'entrée/sortie d'affinité.
	affinity mask	Cette option permet d'indiquer l'affinité de processeur avec les processus léger.
	affinity64 I/O mask	Cette option permet de lier les entrées/sorties de disque SQL Server à un sous-ensemble spécifié de processeurs, de la même manière que l'option de masque d'entrée/sortie d'affinité. Utilisez le masque d'entrée/sortie d'affinité pour lier les 32 premiers processeurs et utilisez le affinity64 I/O mask pour lier les processeurs restants sur l'ordinateur. Si vous reconfigurez l'affinity64 I/O mask, vous devez redémarrer l'instance de SQL Server. Cette option n'est visible que sur la version 64 bits de SQL Server.
	affinity64 mask	Cette option permet d'indiquer que le masque affinity64 lie les processeurs à des processus légers spécifiques, de la même manière que l'option de masque d'affinité. Utilisez le masque d'affinité pour lier les 32 premiers processeurs et utilisez le masque d'affinity64 pour lier les processeurs restants sur l'ordinateur. Cette option n'est visible que sur la version 64 bits de SQL Server.
	Agent XPs	Cette option permet d'activer les STORED PROCERDURE étendues de l'Agent SQL Server sur ce serveur. Lorsque cette option n'est pas activée, le noeud de l'Agent SQL Server n'est pas disponible dans l'Object Explorer ou Explorateur d'objets du SQL Server Management Studio.
	allow polybase export	Cette option permet d'autoriser un INSERT dans une table externe Hadoop.
	allow updates	Cette option est toujours présente dans la STORED PROCERDURE de sp_configure, bien que sa fonctionnalité ne soit pas disponible dans SQL Server. Le réglage n'a aucun effet. Les mises à jour directes des tables système ne sont pas prises en charge.
	backup checksum default	Cette option permet d'activer ou désactiver la somme de contrôle de sauvegarde pendant la sauvegarde et la restauration.
	backup compression default	Cette option permet de déterminer si l'instance de serveur crée des sauvegardes compressées par défaut.
	blocked process threshold (s)	Cette option permet d'indiquer le seuil, en secondes, auquel les rapports de processus bloqués sont générés.
	c2 audit mode	Cette option permet de configurer le serveur pour enregistrer à la fois les tentatives échouées et réussies d'accès aux instructions et aux objets.
	clr enabled	Cette option permet d'activer le CLR.
	contained database authentication	Cette option permet d'activer les bases de données autonomes sur l'instance du moteur de base de données SQL Server.
	cost threshold for parallelism	Cette option permet d'indiquer le seuil auquel SQL Server crée et exécute des plans parallèles pour les requêtes.
	cross db ownership chaining	Cette option permet d'effectuer un chaînage de propriété de base de données croisée pour configurer le chaînage de propriété de base de données croisée pour une instance de Microsoft SQL Server.
	cursor threshold	Cette option permet d'indiquer le nombre de lignes dans l'ensemble de curseurs auquel les ensembles de clefs de curseur sont générés de manière désynchronisée.
	Database Mail XPs	Cette option permet d'activer la messagerie de base de données sur ce serveur.
	default full-text language	Cette option permet d'indiquer une valeur de langue par défaut pour les index de texte intégral.
	default language	Cette option permet d'indiquer la langue par défaut pour toutes les connexions nouvellement créées.
	default trace enabled	Cette option permet d'activée par défaut pour activer ou désactiver les fichiers journaux de trace par défaut.
	disallow results from triggers	Cette option permet d'indiquer une interdiction des résultats des déclencheurs pour contrôler si les déclencheurs renvoient des ensembles de résultats. Les déclencheurs renvoyant des ensembles de résultats peuvent provoquer un comportement inattendu dans les applications n'étant pas conçues pour fonctionner avec eux.
	EKM provider enabled	Cette option permet de contrôler la prise en charge des périphériques Extensible Key Management dans SQL Server. Par défaut, cette option est désactivée.
	filestream access level	Cette option permet de modifier le niveau d'accès FILESTREAM pour cette instance de SQL Server.
	fill factor (%)	Cette option permet de fournir l'affiner d'entreposage et les performances des données d'index.
	ft crawl bandwidth (max)	Cette option permet d'indiquer la taille à laquelle le bassin de tampons mémoire volumineux peut augmenter.
	ft crawl bandwidth (min)	Cette option permet d'indiquer la taille à laquelle le bassin de tampons mémoire volumineux peut diminuer.
	ft notify bandwidth (max)	Cette option permet d'indiquer la taille à laquelle le bassin de petits tampons mémoire peut augmenter
	ft notify bandwidth (min)	Cette option permet d'indiquer la taille à laquelle le bassin de petits tampons mémoire peut diminuer
	index create memory (KB)	Cette option permet de contrôler la quantité maximale de mémoire initialement allouée aux opérations de tri lors de la création d'index.
	in-doubt xact resolution	Cette option permet de contrôler le résultat par défaut des transactions que le Microsoft Distributed Transaction Coordinator (MS DTC) ne parvient pas à résoudre. L'incapacité à résoudre les transactions peut être liée au temps d'arrêt de MS DTC ou à un résultat de transaction inconnu au moment de la récupération.
	lightweight pooling	Cette option permet de fournir un moyen de réduire la surcharge système associée à la commutation de contexte excessive parfois observée dans les environnements de multitraitement symétrique (SMP).
	locks	Cette option permet de fournir le nombre maximal de verrous disponibles, limitant ainsi la quantité de mémoire que le moteur de base de données SQL Server utilise pour eux. Le paramètre par défaut est 0, ce qui permet au moteur de base de données d'allouer et de désallouer des structures de verrouillage de manière dynamique, en fonction de l'évolution des exigences système.
	max degree of parallelism	Cette option permet de configurer le serveur de degré maximal de parallélisme (MAXDOP) dans SQL Server.
	max full-text crawl range	Cette option permet d'indiquer le nombre de partitions que SQL Server doit utiliser lors d'une analyse complète de l'index.
	max server memory (MB)	Cette option permet de reconfigurer la quantité de mémoire (en mégaoctets) pour un processus SQL Server utilisé par une instance de SQL Server.
	max text repl size (B)	Cette option permet d'indiquer la taille maximale (en octets) des données text, ntext, varchar(max), nvarchar(max), varbinary(max), xml et image pouvant être ajoutées à une colonne répliquée ou une colonne capturée dans une seule instruction INSERT, UPDATE, WRITETEXT ou UPDATETEXT.
	max worker threads	Cette option permet de configurer le nombre de processus léger de travail disponibles à l'échelle de SQL Server pour traiter les demandes de requête, la connexion, la déconnexion et les demandes d'application similaires.
	media retention	Cette option permet d'indiquer la durée de conservation de chaque ensemble de sauvegarde. L'option permet de protéger les sauvegardes contre l'écrasement jusqu'à ce que le nombre de jours spécifié se soit écoulé.
	min memory per query (KB)	Cette option permet d'indiquer la quantité minimale de mémoire (en kilo-octets) étant allouée pour l'exécution d'une requête.
	min server memory (MB)	Cette option permet de reconfigurer la quantité de mémoire (en mégaoctets) pour un processus SQL Server utilisé par une instance de SQL Server.
	nested triggers	Cette option permet de contrôler si un déclencheur AFTER peut être mis en cascade.
	network packet size (B)	Cette option permet d'indiquer la taille d'un paquet (en octets) utilisée sur l'ensemble du réseau.
	Ole Automation Procedures	Cette option permet d'indiquer si les objets OLE Automation peuvent être instanciés dans les lots Transact-SQL.
	open objects	Cette option permet d'indiquer le nombre d'objets de base de données ouverts est géré dynamiquement et limité par la mémoire disponible. L'option open objects est disponible dans sp_configure pour une compatibilité descendante avec les scripts existants.
	optimize for ad hoc workloads	Cette option permet d'améliorer l'efficacité du cache de plan pour les charges de travail qui contiennent de nombreux lots ad hoc à usage unique.
	PH timeout (s)	Cette option permet d'indiquer le temps, en secondes, pendant lequel le gestionnaire de protocole de texte intégral doit attendre pour se connecter à une base de données avant d'expirer.
	precompute rank	Cette option permet de modifier le comportement des composantes de filtre.
	priority boost	Cette option permet d'indiquer si SQL Server doit s'exécuter avec une priorité de planification Windows Server 2008 ou Windows Server 2008 R2 supérieure à celle des autres processus sur le même ordinateur.
	query governor cost limit	Cette option permet d'indiquer une limite supérieure du consommation estimé autorisé pour l'exécution d'une requête donnée.
	query wait (s)	Cette option permet d'indiquer le temps, en secondes (de 0 à 2147483647), pendant lequel une requête attend des ressources avant d'expirer.
	recovery interval (min)	Cette option permet de définir une limite supérieure de la durée de récupération d'une base de données.
	remote access	Cette option permet d'indiquer l'accès à distance. Cette option de configuration est une fonction de communication obscure de SQL Server à SQL Server étant obsolète et que vous ne devriez pas utiliser.
	remote admin connections	Cette option permet d'indiquer la connexion de l'accès à distance. Cette option permet d'indiquer une fonction de communication obscure de SQL Server à SQL Server étant obsolète et vous ne devriez probablement pas l'utiliser.
	remote login timeout (s)	Cette option permet d'indiquer le délai de connexion à distance spécifie le nombre de secondes à attendre avant de revenir d'une tentative infructueuse de connexion à un serveur à distance.
	remote proc trans	Cette option permet de protéger les actions d'une procédure de serveur à serveur via une transaction Microsoft Distributed Transaction Coordinator (MS DTC).
	remote query timeout (s)	Cette option permet d'indiquer le délai d'expiration de la requête à distance spécifie combien de temps, en secondes, une opération à distance peut prendre avant que SQL Server n'expire. La valeur par défaut de cette option est 0, ce qui désactive le délai d'attente.
	Replication XPs	Cette option permet d'indiquer l'état de la réplication. Cette option est à usage interne uniquement.
	scan for startup procs	Cette option permet de rechercher l'exécution automatique des STORED PROCEDURE au démarrage de SQL Server.
	server trigger recursion	Cette option permet d'indiquer s'il faut autoriser les déclencheurs au niveau du serveur à se déclencher de manière récursive.
set working set size	Cette option est toujours présente dans la STORED PROCEDURE sp_configure, mais sa fonctionnalité n'est pas disponible dans SQL Server. (Le réglage n'a aucun effet.)
show advanced options	Cette options permet d'afficher les options avancées de la STORED PROCEDURE système sp_configure. Lorsque vous définissez show advanced options sur 1, vous pouvez répertorier les options avancées à l'aide de sp_configure. La valeur par défaut est 0.
SMO and DMO XPs	Cette options permet d'activer la STORED PROCEDURE étendues SQL Server Management Object (SMO) sur ce serveur.
transform noise words	Cette option permet de supprimer un message d'erreur si des mots parasites, c'est-à-dire des mots vides, provoquent le renvoi de zéro ligne par une opération booléenne sur une requête de texte intégral.
two digit year cutoff	Cette option permet de configurer l'option de configuration du serveur de coupure de l'année à deux chiffres dans SQL Server à l'aide de SQL Server Management Studio ou de Transact-SQL.
user connections	Cette option permet d'indiquer le nombre maximal de connexions utilisateur simultanées autorisées sur une instance de SQL Server.
user options	Cette option permet d'indiquer les valeurs par défaut globales pour tous les utilisateurs.
xp_cmdshell	Cette option permet aux administrateurs système de contrôler si la STORED PROCEDURE étendue xp_cmdshell peut être exécutée sur un système.
...	...
[ @configvalue = ] 'value'	Ce paramètre permet d'indiquer le nouveau paramètre de configuration. Le paramètre value est un entier, avec une valeur par défaut NULL. La valeur maximale dépend de l'option individuelle.

Description

Cette Stored Procedure permet d'afficher ou de modifier les paramètres de configuration globale du serveur actuel.

Remarques

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 les paramètres affectant uniquement la session utilisateur en cours, utilisez l'instruction SET.
Unités d'allocation de Mégadonnées (Big Data) de SQL Server : Certaines opérations, notamment la configuration des paramètres du serveur (au niveau de l'instance) ou l'ajout manuel d'une base de données à un groupe de disponibilité, nécessitent une connexion à l'instance SQL Server. Des opérations telles que sp_configure, RESTORE DATABASE ou toute commande DDL dans une base de données appartenant à un groupe de disponibilité nécessitent une connexion à l'instance SQL Server. Par défaut, un unité d'allocation de Mégadonnées (Big Data) n'inclut pas de point de terminaison permettant une connexion à l'instance. Vous devez exposer ce point de terminaison manuellement.
Mise à jour de la valeur de la configuration d'exécution : Lorsque vous spécifiez une nouvelle valeur pour une option, l'ensemble de résultats affiche cette valeur dans la colonne config_value. Cette valeur diffère initialement de la valeur de la colonne run_value, affichant la valeur de configuration en cours d'exécution. Pour mettre à jour la valeur de configuration en cours dans la colonne run_value, l'administrateur système doit exécuter RECONFIGURE ou RECONFIGURE WITH OVERRIDE. RECONFIGURE et RECONFIGURE WITH OVERRIDE fonctionnent avec toutes les options de configuration. Cependant, l'instruction de base RECONFIGURE rejette toute valeur d'option se trouvant en dehors d'une intervalle raisonnable ou pouvant provoquer des conflits entre les 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 du masque d'entrée/sortie d'affinité. RECONFIGURE WITH OVERRIDE, en revanche, accepte toute valeur d'option avec le type de données correct et force la reconfiguration avec la valeur spécifiée.
Une valeur d'option inappropriée peut affecter négativement la configuration de l'instance de serveur. Utilisez RECONFIGURE WITH OVERRIDE avec précaution.
L'instruction RECONFIGURE met à jour certaines options de manière dynamique ; d'autres options nécessitent un arrêt et un redémarrage du serveur. Par exemple, les options min server memory et max server memory sont mises à jour dynamiquement dans le moteur de base de données ; par conséquent, vous pouvez les modifier sans redémarrer le serveur. En revanche, la reconfiguration de la valeur d'exécution de l'option de facteur de remplissage nécessite le redémarrage du moteur de base de données.
Après avoir exécuté RECONFIGURE sur une option de configuration, vous pouvez voir si l'option a été mise à jour dynamiquement en exécutant sp_configure'option_name'. Les valeurs des colonnes run_value et config_value doivent correspondre pour une option mise à jour dynamiquement. Vous pouvez également vérifier quelles options sont dynamiques en consultant la colonne is_dynamic de la vue catalogue sys.configurations. La modification est également écrite dans le journal de bord des erreurs SQL Server. 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ées a utilisé par défaut la mémoire dynamique plutôt que d'utiliser un paramètre n'étant pas valide.
Options avancées : 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. Par défaut, ces options ne sont pas disponibles pour l'affichage et la modification. Pour les rendre disponibles, définissez l'option de configuration Show Advanced Options sur 1.
La STORED PROCEDURE sp_configure limite la sortie des informations à certains champs bien précise. Toutefois, il est possible d'avoir tous les champs à l'aide de la requête SQL suivante :
select * from sys.configurations;

Exemples

L'exemple suivant permet d'activer le CLR :



EXEC sp_configure 'clr enabled', 1

RECONFIGURE

L'exemple suivant permet d'activer les paramètres avancés et les paramètres fibres :



EXEC sp_configure 'show advanced', 1;

RECONFIGURE

GO

 

EXEC sp_configure 'lightweight pooling';

GO

Dernière mise à jour : Mardi, le 17 Août 2021

Section courante

A propos

Section administrative du site

sp_configure

Syntaxe

Paramètres

Description

Remarques

Exemples