sp_configure (Transact-SQL)

S’applique à : SQL Server Base de données Azure SQL Azure Synapse Analytics Analytics Platform System (PDW)

Affiche ou modifie des options de configuration générales pour le serveur actif.

Remarque

Pour connaître les options de configuration au niveau de la base de données, consultez ALTER DATABASE SCOPED CONFIGURATION. Pour configurer Soft-NUMA, consultez Soft-NUMA (SQL Server).

Conventions de la syntaxe Transact-SQL

Syntaxe

Syntaxe de SQL Server.

sp_configure
    [ [ @configname = ] 'configname' ]
    [ , [ @configvalue = ] configvalue ]
[ ; ]

Syntaxe pour le système de plateforme Analytics (PDW).

sp_configure
[ ; ]

Arguments

[ @configname = ] 'configname'

Nom d’une option de configuration. @configname est varchar(35), avec la valeur par défaut NULL. SQL Server Moteur de base de données 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 les options de configuration du serveur.

[ @configvalue = ] configvalue

Nouveau paramètre de configuration. @configvalue est int, avec la valeur par défaut NULL.

La valeur maximale dépend de l'option individuelle. Pour afficher la valeur maximale de chaque option, consultez la maximum colonne de l’affichage sys.configurations catalogue.

Valeurs des codes de retour

0 (réussite) or 1 (échec).

Jeu de résultats

En cas d’exécution sans paramètre, sp_configure retourne un jeu de résultats avec cinq colonnes et commande les options par ordre alphabétique dans l’ordre croissant, comme indiqué dans le tableau suivant.

Les valeurs pour config_value et run_value ne sont pas automatiquement équivalentes. Après avoir mis à jour un paramètre de configuration à l’aide sp_configurede , vous devez également mettre à jour la valeur de configuration en cours d’exécution, à l’aide de l’une ou de l’autre RECONFIGURE .RECONFIGURE WITH OVERRIDE Pour plus d’informations, consultez la section Remarques.

Nom de la colonne	Type de données	Description
name	nvarchar(35)	Nom de l'option de configuration.
minimum	int	Valeur minimale de l'option de configuration.
maximum	int	Valeur maximale de l'option de configuration.
config_value	int	Valeur à laquelle l’option de configuration a été définie à l’aide sp_configure de (valeur dans sys.configurations.value). Pour plus d’informations sur ces options, consultez les options de configuration du serveur et sys.configurations.
run_value	int	Valeur en cours d’exécution de l’option de configuration (valeur dans sys.configurations.value_in_use). Pour plus d’informations, consultez sys.configurations.

Notes

Permet sp_configure d’afficher ou de 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 qui affectent uniquement la session utilisateur active, utilisez l’instruction SET .

Certaines options de configuration de serveur sont disponibles uniquement via ALTER SERVER CONFIGURATION.

Clusters Big Data SQL Server

Certaines opérations, notamment la configuration des paramètres de serveur (niveau d’instance) ou l’ajout manuel d’une base de données à un groupe de disponibilité, nécessitent une connexion à l’instance SQL Server. 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. Par défaut, un cluster Big Data ne comporte pas de point de terminaison permettant une connexion à l’instance. Vous devez exposer ce point de terminaison manuellement.

Pour obtenir des instructions, consultez Se connecter aux bases de données sur le réplica principal.

Mettre à jour la valeur de configuration en cours d’exécution

Lorsque vous spécifiez une nouvelle @configvalue pour un @configname, le jeu de résultats affiche cette valeur dans la config_value colonne. Cette valeur diffère initialement de la valeur de 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 la run_value colonne, l’administrateur système doit s’exécuter soit RECONFIGURE .RECONFIGURE WITH OVERRIDE

Les deux RECONFIGURE et RECONFIGURE WITH OVERRIDE fonctionnent avec chaque option de configuration. Toutefois, l’instruction de base RECONFIGURE rejette toute valeur d’option qui se trouve en dehors d’une plage raisonnable ou qui peut entraîner 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é se chevauche avec la valeur de masque d’affinité d’E/S. RECONFIGURE WITH OVERRIDE, en revanche, accepte n’importe quelle valeur d’option avec le type de données correct et force la reconfiguration avec la valeur spécifiée.

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.

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 server 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, reconfigurer la valeur en cours d’exécution de l’option de facteur de remplissage nécessite le redémarrage du Moteur de base de données.

Après l’exécution RECONFIGURE sur une option de configuration, vous pouvez voir si l’option a été mise à jour dynamiquement en exécutant sp_configure '<configname>'. Les valeurs dans les colonnes et config_value les run_value valeurs doivent correspondre à une option mise à jour dynamique. Vous pouvez également vérifier quelles options sont dynamiques en examinant la is_dynamic colonne de l’affichage sys.configurations catalogue.

La modification est également écrite dans le journal des erreurs SQL Server.

Si un @configvalue spécifié est trop élevé pour une option, la run_value colonne reflète le fait que le Moteur de base de données est défini par défaut sur la mémoire dynamique, plutôt que d’utiliser un paramètre qui n’est pas valide.

Pour plus d’informations, consultez RECONFIGURE.

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 d’options avancées sur 1.

Attention

Lorsque l’option afficher les options avancées est définie 1sur , ce paramètre s’applique à tous les utilisateurs. Il est recommandé d’utiliser cet état temporairement et de revenir au 0 moment où la tâche a besoin d’afficher les options avancées.

Pour plus d’informations sur les options de configuration et leurs paramètres, consultez les options de configuration du serveur.

autorisations

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 pour exécuter l’instruction RECONFIGURE , vous devez disposer de l’autorisation au ALTER SETTINGS niveau du serveur. L’autorisation ALTER SETTINGS est implicitement détenue par les rôles serveur fixes sysadmin et serveradmin.

Exemples

R. Répertorier les options de configuration avancées

L'exemple suivant montre comment définir et afficher toutes les options de configuration. Vous pouvez afficher les options de configuration avancées en définissant show advanced options d’abord sur 1. Une fois cette option modifiée, vous pouvez afficher toutes les options de configuration en s’exécutant sp_configure sans paramètres.

USE master;
GO
EXEC sp_configure 'show advanced options', '1';

Voici le jeu de résultats.

Configuration option 'show advanced options' changed from 0 to 1. Run the `RECONFIGURE` statement to install.

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

RECONFIGURE;
EXEC sp_configure;

B. Modifier une option de configuration

L’exemple suivant définit l’option de configuration système recovery interval sur 3 minutes.

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

Exemples : Analytics Platform System (PDW)

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. Il config_value s’agit de la valeur utilisée par Azure Synapse Analytics lors de la reconfiguration. Il run_value s’agit de la valeur actuellement utilisée. Les config_value valeurs sont run_value 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

La définition de la connectivité Hadoop nécessite quelques étapes supplémentaires en plus de l’exécution sp_configure. Pour obtenir la procédure complète, consultez CREATE EXTERNAL DATA SOURCE.

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

Contenu connexe

• ALTER SERVER CONFIGURATION (Transact-SQL)
• RECONFIGURE (Transact-SQL)
• Instructions SET (Transact-SQL)
• Options de configuration de serveur
• ALTER DATABASE (Transact-SQL)
• Procédures stockées système (Transact-SQL)
• sys.configurations (Transact-SQL)
• ALTER DATABASE SCOPED CONFIGURATION (Transact-SQL)
• Soft-NUMA (SQL Server)