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 de Analytique Platform System (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_configure
de , 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 1
sur , 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 obtenu.
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 Analytique 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)