SERVERPROPERTY (Transact-SQL)
S’applique à : 
SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)
Retourne des informations de propriété relatives à l'instance du serveur.
Conventions de la syntaxe Transact-SQL
Remarque
Microsoft Entra ID était précédemment connu sous le nom d’Azure Active Directory (Azure AD).
Syntaxe
SERVERPROPERTY ( 'propertyname' )
Important
Les numéros de version Moteur de base de données pour SQL Server et Azure SQL Database ne sont pas comparables entre eux et représentent des numéros de build internes pour ces produits distincts. La Moteur de base de données pour Azure SQL Database est basée sur la même base de code que le Moteur de base de données SQL Server. Plus important encore, le Moteur de base de données dans Azure SQL Database dispose toujours des dernières versions de SQL Moteur de base de données bits. Par exemple, la version 12 d’Azure SQL Database est plus récente que la version 16 de SQL Server.
Arguments
propertyname
Expression contenant les informations de propriétés à retourner pour le serveur. propertyname peut avoir l’une des valeurs suivantes. L’utilisation d’un nom de propriété (propertyname) non valide ou non pris en charge sur cette version du moteur de base de données retourne NULL.
| Propriété | Valeurs retournées |
|---|---|
BuildClrVersion |
Version du CLR (Common Language Runtime) Microsoft .NET Framework qui a été utilisée lors de la génération de l’instance de SQL Server. NULL = Entrée non valide, non applicable ou erreur. Type de données de base : nvarchar(128) |
Collation |
Nom du classement par défaut pour le serveur. NULL = Entrée non valide ou erreur. Type de données de base : nvarchar(128) |
CollationID |
ID du classement SQL Server. Type de données de base : int |
ComparisonStyle |
Style de comparaison Windows du classement. Type de données de base : int |
ComputerNamePhysicalNetBIOS |
Nom NetBIOS de l'ordinateur local sur lequel l'instance de SQL Server est en cours d'exécution. Pour une instance cluster de SQL Server sur un cluster de basculement, cette valeur change étant donné que l'instance de SQL Server bascule sur d'autres nœuds du cluster de basculement. Sur une instance autonome de SQL Server, cette valeur reste constante et retourne la même valeur que la propriété MachineName. Remarque : Si l’instance de SQL Server se trouve dans un cluster de basculement et si vous voulez obtenir le nom de l’instance en cluster de basculement, utilisez la propriété MachineName. NULL = Entrée non valide, non applicable ou erreur. Type de données de base : nvarchar(128) |
Edition |
Édition du produit installée de l'instance de SQL Server. Utilisez la valeur de cette propriété pour déterminer les fonctionnalités et les limites, telles que les limites de capacité de calcul des éditions SQL Server. Les versions 64 bits du Moteur de base de données ajoutent la mention (64 bits) à la version. Retourne les informations suivantes : « Enterprise Edition » « Enterprise Edition : Licence par cœur » « Enterprise Evaluation Edition » « Business Intelligence Edition » « Developer Edition » « Express Edition » « Express Edition with Advanced Services » « Standard Edition » « Web Edition » « SQL Azure » indique SQL Database ou Azure Synapse Analytics « Développeur Azure SQL Edge » fait référence à l’édition Développement uniquement pour Azure SQL Edge « Azure SQL Edge » fait référence à l’édition payante d’Azure SQL Edge Type de données de base : nvarchar(128) |
EditionID |
EditionID représente l'édition de produit installée de l'instance de SQL Server. Utilisez la valeur de cette propriété pour déterminer des fonctionnalités et des limites, telles que les limites de capacité de calcul des éditions SQL Server. 1804890536 = Enterprise 1872460670 = Enterprise Edition: Licence par cœur 610778273 = Évaluation Enterprise 284895786 = Business Intelligence -2117995310 = Developer -1592396055 = Express -133711905 = Express avec services avancés -1534726760 = Standard 1293598313 = Web 1674378470 = SQL Database or Azure Synapse Analytics -1461570097 = Azure SQL Edge Developer 1994083197 = Azure SQL Edge Type de données de base : bigint |
EngineEdition |
Édition du Moteur de base de données de l'instance de SQL Server installée sur le serveur. 1 = Personal ou Desktop Engine (non disponible dans SQL Server 2005 (9.x) et versions ultérieures) 2 = Standard (pour Standard, Web et Business Intelligence) 3 = Enterprise (pour Evaluation, Developer et Enterprise) 4 = Express (pour Express, Express with Tools et Express with Advanced Services) 5 = SQL Database 6 = Azure Synapse Analytics 8 = Azure SQL Managed Instance 9 = Azure SQL Edge (pour toutes les éditions d’Azure SQL Edge) 11 = pool SQL serverless Azure Synapse Type de données de base : int |
FilestreamConfiguredLevel |
Niveau configuré d'accès de FILESTREAM. Pour plus d’informations, consultez Niveau d’accès filestream. 0 = FILESTREAM est désactivé 1 = FILESTREAM est activé pour l’accès Transact-SQL 2 = FILESTREAM est activé pour l’accès Transact-SQL et l'accès local Win32 en diffusion continue 3 = FILESTREAM est activé pour l'accès Transact-SQL et l'accès local et distant Win32 en diffusion continue Type de données de base : int |
FilestreamEffectiveLevel |
Niveau effectif d'accès de FILESTREAM. Cette valeur peut être différente de FilestreamConfiguredLevel si le niveau a changé ou si un redémarrage de l'instance ou de l'ordinateur est en attente. Pour plus d’informations, consultez Niveau d’accès filestream. 0 = FILESTREAM est désactivé 1 = FILESTREAM est activé pour l’accès Transact-SQL 2 = FILESTREAM est activé pour l’accès Transact-SQL et l'accès local Win32 en diffusion continue 3 = FILESTREAM est activé pour l'accès Transact-SQL et l'accès local et distant Win32 en diffusion continue Type de données de base : int |
FilestreamShareName |
Nom du partage utilisé par FILESTREAM. NULL = Entrée non valide, non applicable ou erreur. Type de données de base : nvarchar(128) |
HadrManagerStatus |
S’applique à : SQL Server 2012 (11.x) et versions ultérieures. Indique si le gestionnaire Groupes de disponibilité Always On a démarré. 0 = Non démarré, en attente de communication 1 = Démarré et en cours d'exécution 2 = Non démarré et en état d'échec NULL = Entrée non valide, non applicable ou erreur. Type de données de base : int |
InstanceDefaultBackupPath |
S’applique à : SQL Server 2019 (15.x) et versions ultérieures. Nom du chemin par défaut jusqu’aux fichiers de sauvegarde d’instance. |
InstanceDefaultDataPath |
S’applique à : SQL Server 2012 (11.x) jusqu’à la version actuelle dans les mises à jour depuis fin 2015. Nom du chemin par défaut jusqu’aux fichiers de données d’instance. Type de données de base : nvarchar(128) |
InstanceDefaultLogPath |
S’applique à : SQL Server 2012 (11.x) jusqu’à la version actuelle dans les mises à jour depuis fin 2015. Nom du chemin par défaut jusqu’aux fichiers journaux d’instance. Type de données de base : nvarchar(128) |
InstanceName |
Nom de l'instance à laquelle l'utilisateur est connecté. Retourne la valeur NULL si le nom de l'instance est celui de l'instance par défaut et en cas d'entrée incorrecte ou d'erreur. NULL = Entrée non valide, non applicable ou erreur. Type de données de base : nvarchar(128) |
IsAdvancedAnalyticsInstalled |
Retourne 1 si la fonctionnalité Analyse avancée a été installée pendant l’installation ; 0 si la fonctionnalité Analyse avancée n’a pas été installée. Type de données de base : int |
IsBigDataCluster |
Introduite dans SQL Server 2019 (15.x) à partir de la mise à jour cumulative 4 (CU 4). Retourne 1 si l’instance est un cluster Big Data SQL Server ; 0 dans le cas contraire. Type de données de base : int |
IsClustered |
L'instance de serveur est configurée dans un cluster de basculement. 1 = Ordonné en clusters 0 = Non cluster NULL = Entrée non valide, non applicable ou erreur. Type de données de base : int |
IsExternalAuthenticationOnly |
S’applique à : Azure SQL Database et Azure SQL Managed Instance. Indique si l’authentification par Microsoft Entra uniquement est activée. 1 = L’authentification par Microsoft Entra uniquement est activée. 0 = L’authentification par Microsoft Entra uniquement est désactivée. Type de données de base : int |
IsExternalGovernanceEnabled |
S’applique à :SQL Server 2022 (16.x) et versions plus récentes. Retourne si les stratégies d’accès Microsoft Purview sont activées. 1 = La gouvernance externe est activée. 0 = La gouvernance externe est désactivée. Type de données de base : int |
IsFullTextInstalled |
Les composants d'indexation sémantique et de texte intégral sont installés sur l'instance actuelle de SQL Server. 1 = Les composants d'indexation sémantique et de texte intégral sont installés. 0 = Les composants d'indexation sémantique et de texte intégral ne sont pas installés. NULL = Entrée non valide, non applicable ou erreur. Type de données de base : int |
IsHadrEnabled |
S’applique à : SQL Server 2012 (11.x) et versions ultérieures. Groupes de disponibilité Always On est activé sur cette instance de serveur. 0 = La fonctionnalité Groupes de disponibilité Always On est désactivée. 1 = La fonctionnalité Groupes de disponibilité Always On est activée. NULL = Entrée non valide, non applicable ou erreur. Type de données de base : int Pour les réplicas de disponibilité à créer et exécuter sur une instance de SQL Server, le service Groupes de disponibilité Always On doit être activé sur l'instance de serveur. Pour plus d’informations, consultez Activer et désactiver les groupes de disponibilité Always On (SQL Server). Remarque : La propriété IsHadrEnabled se rapporte uniquement aux Groupes de disponibilité Always On. D'autres fonctionnalités haute disponibilité ou de récupération d'urgence, telles que la mise en miroir de bases de données ou la copie des journaux de transaction, ne sont pas affectées par cette propriété du serveur. |
IsIntegratedSecurityOnly |
Le serveur fonctionne en mode de sécurité intégrée. 1 = Sécurité intégrée (authentification Windows) 0 = Sécurité non intégrée. (Authentification Windows et authentification SQL Server.) NULL = Entrée non valide, non applicable ou erreur. Type de données de base : int |
IsLocalDB |
S’applique à : SQL Server 2012 (11.x) et versions ultérieures. Le serveur est une instance de SQL Server Express LocalDB. NULL = Entrée non valide, non applicable ou erreur. Type de données de base : int |
IsPolyBaseInstalled |
S'applique à: SQL Server 2016 (13.x). Indique si la fonctionnalité PolyBase est installée sur l’instance de serveur. 0 = PolyBase n’est pas installée. 1 = Polybase est installée. Type de données de base : int |
IsServerSuspendedForSnapshotBackup |
Le serveur est en mode suspension et nécessite une libération au niveau du serveur. 1 = Suspendu 0 = Non suspendu Type de données de base : int |
IsSingleUser |
Le serveur est en mode mono-utilisateur. 1 = Utilisateur unique 0 = Utilisateur non unique NULL = Entrée non valide, non applicable ou erreur. Type de données de base : int |
IsTempDbMetadataMemoryOptimized |
S’applique à : SQL Server 2019 (15.x) et versions ultérieures. Retourne 1 si tempdb a été activée pour utiliser des tables à mémoire optimisée pour les métadonnées ; 0 si tempdb utilise des tables basées sur des disques régulières pour les métadonnées. Pour plus d'informations, consultez tempdb Database.Type de données de base : int |
IsXTPSupported |
S’applique à : SQL Server (SQL Server 2014 (12.x) et versions ultérieures), SQL Database. Le serveur prend en charge OLTP en mémoire. 1 = Le serveur prend en charge OLTP en mémoire. 0 = Le serveur ne prend pas en charge OLTP en mémoire. NULL = Entrée non valide, non applicable ou erreur. Type de données de base : int |
LCID |
Identificateur des paramètres régionaux (LCID) Windows du classement. Type de données de base : int |
LicenseType |
Inutilisé. Les informations de licence ne sont pas conservées ou ne sont pas gérées par le produit SQL Server. Retourne toujours DISABLED. Type de données de base : nvarchar(128) |
MachineName |
Nom de l'ordinateur Windows sur lequel s'exécute l'instance du serveur. Dans le cas d'une instance en cluster, instance de SQL Server s'exécutant sur un serveur virtuel sous Microsoft Cluster Service, le nom du serveur virtuel est retourné. NULL = Entrée non valide, non applicable ou erreur. Type de données de base : nvarchar(128) |
NumLicenses |
Inutilisé. Les informations de licence ne sont pas conservées ou ne sont pas gérées par le produit SQL Server. Retourne toujours la valeur Null. Type de données de base : int |
PathSeparator |
S’applique à : SQL Server 2017 (14.x) et versions ultérieures. Retourne \ sur Windows et / sur LinuxType de données de base : nvarchar |
ProcessID |
ID de processus du service SQL Server. ProcessID permet d'identifier le fichier sqlservr.exe qui appartient à cette instance. NULL = Entrée non valide, non applicable ou erreur. Type de données de base : int |
ProductBuild |
S’applique à : SQL Server 2014 (12.x) à compter d’octobre 2015. Numéro de build. Type de données de base : nvarchar(128) |
ProductBuildType |
S’applique à : SQL Server 2012 (11.x) jusqu’à la version actuelle dans les mises à jour depuis fin 2015. Type de build de la build actuelle. Renvoie l'une des valeurs suivantes : OD = Version à la demande pour un client spécifique. GDR = Correctif logiciel grand public publié par le biais de Windows Update. NULL = non applicable. Type de données de base : nvarchar(128) |
ProductLevel |
Niveau de la version de l'instance de SQL Server. Renvoie l'une des valeurs suivantes : « 'RTM » = Version d'origine 'SPn' = version du Service Pack 'CTPn', = version CTP (Community Technology Preview) Type de données de base : nvarchar(128) |
ProductMajorVersion |
S’applique à : SQL Server 2012 (11.x) jusqu’à la version actuelle dans les mises à jour depuis fin 2015. Version principale. Type de données de base : nvarchar(128) |
ProductMinorVersion |
S’applique à : SQL Server 2012 (11.x) jusqu’à la version actuelle dans les mises à jour depuis fin 2015. Version mineure. Type de données de base : nvarchar(128) |
ProductUpdateLevel |
S’applique à : SQL Server 2012 (11.x) via la version actuelle dans les mises à jour depuis la fin de 2015 et Azure SQL Managed Instance. Niveau de mise à jour de la build actuelle. CU indique une mise à jour cumulative. Renvoie l'une des valeurs suivantes : CUn = mise à jour cumulative NULL = non applicable. Type de données de base : nvarchar(128) |
ProductUpdateReference |
S’applique à : SQL Server 2012 (11.x) jusqu’à la version actuelle dans les mises à jour depuis fin 2015. Article de la Base de connaissances pour cette version. Type de données de base : nvarchar(128) |
ProductUpdateType |
S’applique à : Azure SQL Managed Instance Fréquence de mise à jour suivante pour l’instance. Correspond à la stratégie de mise à jour d’Azure SQL Managed Instance. Renvoie l'une des valeurs suivantes : CU = Les mises à jour sont déployées via des mises à jour cumulatives (CU) pour la version principale de SQL Server correspondante (stratégie de mise à jour de SQL Server 2022). Continu = Les nouvelles fonctionnalités sont apportées à Azure SQL Managed Instance dès qu’elles sont disponibles, indépendamment de la fréquence de publication de SQL Server (stratégie de mise à jour toujours actualisée). Type de données de base : nvarchar(128) |
ProductVersion |
Version de l’instance de SQL Server, sous la forme de major.minor.build.revision. Type de données de base : nvarchar(128) |
ResourceLastUpdateDateTime |
Retourne la date et l'heure de la dernière mise à jour de la base de données des ressources. Type de données de base : datetime |
ResourceVersion |
Retourne la base de données des ressources de versions. Type de données de base : nvarchar(128) |
ServerName |
Informations relatives à l'instance et au serveur Windows, associées à une instance spécifique de SQL Server. NULL = Entrée non valide ou erreur. Type de données de base : nvarchar(128) |
SqlCharSet |
ID du jeu de caractères SQL provenant de l'ID de classement Type de données de base : tinyint |
SqlCharSetName |
Nom du jeu de caractères SQL provenant du classement Type de données de base : nvarchar(128) |
SqlSortOrder |
ID d'ordre de tri SQL provenant du classement Type de données de base : tinyint |
SqlSortOrderName |
Nom de l'ordre de tri SQL provenant du classement. Type de données de base : nvarchar(128) |
SuspendedDatabaseCount |
Nombre de bases de données suspendues sur le serveur. Type de données de base : int |
Types de retour
sql_variant
Notes
ServerName, propriété
La propriété ServerName de la fonction SERVERPROPERTY et @@SERVERNAME retournent des informations similaires. La propriété ServerName fournit le serveur et le nom de l'instance Windows qui constituent ensemble l'instance de serveur unique. @@SERVERNAME fournit le nom du serveur local configuré actuellement.
La propriété ServerName et @@SERVERNAME retournent les mêmes informations si le nom de serveur par défaut n'a pas été changé lors de l'installation. Le nom de serveur local peut être configuré en exécutant la commande suivante :
EXEC sp_dropserver 'current_server_name';
GO
EXEC sp_addserver 'new_server_name', 'local';
GO
Si le nom par défaut du serveur local a été modifié lors de l'installation, @@SERVERNAME retourne le nouveau nom.
La propriété ServerName de la fonction SERVERPROPERTY retourne le nom du serveur Windows tel qu’il est enregistré. Dans les versions majeures précédentes, elle retournait des majuscules. Ce comportement est revenu en majuscules entre SQL Server 2019 (15.x) CU 9 et CU 12, mais à partir de SQL Server 2019 (15.x) CU 13, le nom du serveur revient au fur et à mesure qu’il est enregistré.
Si le nom du serveur Windows contient des caractères en minuscules, ce changement de comportement peut entraîner des différences entre la propriété ServerName de la fonction SERVERPROPERTY et @@SERVERNAME (en majuscules ou minuscules), même s’il n’existe aucune modification de nom pour le serveur.
Pensez que vous avez un serveur nommé server01, avec une instance SQL Server nommée INST1. La table suivante récapitule le changement de comportement entre différentes builds de SQL Server 2019 (15.x) :
| Publication de SQL Server 2019 (15.x) | SERVERPROPERTY('ServerName') | Informations supplémentaires |
|---|---|---|
| RTM | SERVER01\INST1 |
Renvoie la propriété ServerName en majuscules |
| CU 1 – CU 8 | server01\INST1 |
Retourne la propriété ServerName telle qu’elle, sans changer en majuscules |
| CU 9 – CU 12 | SERVER01\INST1 |
Renvoie la propriété ServerName en majuscules |
| CU 13 et versions ultérieures | server01\INST1 |
Retourne la propriété ServerName telle qu’elle, sans changer en majuscules |
Propriétés de version
La fonction SERVERPROPERTY retourne des propriétés individuelles qui sont en rapport avec les informations de version, alors que la fonction @@VERSION combine la sortie en une seule chaîne. Si votre application requiert des chaînes de propriété individuelles, vous pouvez utiliser la fonction SERVERPROPERTY pour les retourner au lieu d’analyser les résultats de @@VERSION.
Autorisations
Tous les utilisateurs peuvent interroger les propriétés du serveur.
Exemples
L’exemple suivant utilise la fonction SERVERPROPERTY dans une instruction SELECT pour retourner des informations sur l’instance actuelle de SQL Server.
SELECT
SERVERPROPERTY('MachineName') AS ComputerName,
SERVERPROPERTY('ServerName') AS InstanceName,
SERVERPROPERTY('Edition') AS Edition,
SERVERPROPERTY('ProductVersion') AS ProductVersion,
SERVERPROPERTY('ProductLevel') AS ProductLevel;
GO
Contenu connexe
Pour obtenir la liste des fonctionnalités prises en charge par les éditions de SQL Server sur Windows, consultez :