SERVERPROPERTY (Transact-SQL)

S’applique à :SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)Point de terminaison d’analytique SQL dans Microsoft Fabric Entrepôt dans Microsoft Fabric Base de données SQL dans Microsoft Fabric

Retourne des informations de propriété relatives à l'instance du serveur.

Conventions de la syntaxe Transact-SQL

Note

Microsoft Entra ID s'appelait Azure Active Directory (Azure AD) jusqu'à une date récente.

Syntax

SERVERPROPERTY ( 'propertyname' )

Important

Les numéros de version du moteur de base de données pour SQL Server et Azure SQL Database et Microsoft Fabric 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 être l’une des valeurs suivantes. L’utilisation d’un nom de propriété non valide ou non pris en charge sur cette version du moteur de base de données retourne NULL.

Property	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 = L’entrée n’est pas valide, une erreur ou non applicable. Type de données de base : nvarchar(128)
`Collation`	Nom du classement par défaut pour le serveur. NULL = L’entrée n’est pas valide ou une 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 `MachineName` propriété. Note: Si l’instance de SQL Server se trouve dans un cluster de basculement et que vous souhaitez obtenir le nom de l’instance en cluster de basculement, utilisez la `MachineName` propriété. NULL = L’entrée n’est pas valide, une erreur ou non applicable. 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. Utilisez le tableau d’édition suivant pour identifier les valeurs possibles. Type de données de base : nvarchar(128)
`EditionID`	Représente l’ID de l’édition de produit installée de l’instance 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. Utilisez le tableau d’édition suivant pour identifier les valeurs possibles. 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, Développeur Standard, Web et Business Intelligence.) 3 = Entreprise (éditions Entreprise, Développeur, Développeur et Évaluation.) 4 = Express (pour Express, Express with Tools et Express with Advanced Services) 5 = Base de données SQL 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 ou Microsoft Fabric 12 = Base de données SQL Microsoft Fabric dans Microsoft Fabric. 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 Transact-SQL et l’accès en streaming Win32 local et distant. 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 Transact-SQL et l’accès en streaming Win32 local et distant. Type de données de base : int
`FilestreamShareName`	Nom du partage utilisé par FILESTREAM. NULL = L’entrée n’est pas valide, une erreur ou non applicable. Type de données de base : nvarchar(128)
`HadrManagerStatus`	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 = L’entrée n’est pas valide, une erreur ou non applicable. Type de données de base : int
`InstanceDefaultBackupPath`	Nom du chemin par défaut jusqu’aux fichiers de sauvegarde d’instance. S’applique à : SQL Server 2019 (15.x) et versions ultérieures. Type de données de base : nvarchar(128)
`InstanceDefaultDataPath`	Nom du chemin par défaut jusqu’aux fichiers de données d’instance. S’applique à : SQL Server. Type de données de base : nvarchar(128)
`InstanceDefaultLogPath`	Nom du chemin par défaut jusqu’aux fichiers journaux d’instance. S’applique à : SQL Server. Type de données de base : nvarchar(128)
`InstanceName`	Nom de l'instance à laquelle l'utilisateur est connecté. Retourne `NULL` si le nom de l’instance est l’instance par défaut, si l’entrée n’est pas valide ou si l’erreur est générée. NULL = L’entrée n’est pas valide, une erreur ou non applicable. 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 = L’entrée n’est pas valide, une erreur ou non applicable. Type de données de base : int
`IsExternalAuthenticationOnly`	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. S’applique à : Azure SQL Database et Azure SQL Managed Instance. Type de données de base : int
`IsExternalGovernanceEnabled`	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. S’applique à : SQL Server 2022 (16.x) et versions ultérieures. 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 = L’entrée n’est pas valide, une erreur ou non applicable. Type de données de base : int
`IsHadrEnabled`	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 = L’entrée n’est pas valide, une erreur ou non applicable. 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 ou désactiver la fonctionnalité de groupe de disponibilité Always On. Note: La `IsHadrEnabled` propriété 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. S’applique à : SQL Server. Type de données de base : int
`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 = L’entrée n’est pas valide, une erreur ou non applicable. Type de données de base : int
`IsLocalDB`	Le serveur est une instance de SQL Server Express LocalDB. NULL = L’entrée n’est pas valide, une erreur ou non applicable. S’applique à : SQL Server. Type de données de base : int
`IsPolyBaseInstalled`	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. S’applique à : SQL Server 2016 (13.x) et versions ultérieures. 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 = L’entrée n’est pas valide, une erreur ou non applicable. Type de données de base : int
`IsTempDbMetadataMemoryOptimized`	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. S’applique à : SQL Server 2019 (15.x) et versions ultérieures. Type de données de base : int
`IsXTPSupported`	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 = L’entrée n’est pas valide, une erreur ou non applicable. S’applique à : SQL Server 2014 (12.x) et versions ultérieures et Azure SQL Database. 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`	Unused. 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 = L’entrée n’est pas valide, une erreur ou non applicable. Type de données de base : nvarchar(128)
`NumLicenses`	Unused. Les informations de licence ne sont pas conservées ou ne sont pas gérées par le produit SQL Server. Retourne toujours `NULL`. Type de données de base : int
`PathSeparator`	Retourne `\` sur Windows et `/` sur Linux S’applique à : SQL Server 2017 (14.x) et versions ultérieures. Type 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 = L’entrée n’est pas valide, une erreur ou non applicable. Type de données de base : int
`ProductBuild`	Numéro de build. S’applique à : SQL Server 2014 (12.x) et ultérieur. Type de données de base : nvarchar(128)
`ProductBuildType`	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. S’applique à : SQL Server. 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 Community Technology Preview. Type de données de base : nvarchar(128)
`ProductMajorVersion`	Version principale. S’applique à : SQL Server. Type de données de base : nvarchar(128)
`ProductMinorVersion`	Version mineure. S’applique à : SQL Server. Type de données de base : nvarchar(128)
`ProductUpdateLevel`	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. S’applique à : SQL Server et Azure SQL Managed Instance. Type de données de base : nvarchar(128)
`ProductUpdateReference`	Article de la Base de connaissances pour cette version. S’applique à : SQL Server. Type de données de base : nvarchar(128)
`ProductUpdateType`	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 = De nouvelles fonctionnalités sont apportées à Azure SQL Managed Instance dès qu’elles sont disponibles, indépendamment de la cadence de publication de SQL Server (Always-up-to-date de mise à jour). S’applique à : Azure SQL Managed Instance. 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`	Les informations sur le serveur Windows et l’instance associées à une instance spécifiée. NULL = L’entrée n’est pas valide ou une 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 à partir 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

Le tableau suivant répertorie les valeurs possibles pour EditionID et Edition.

EditionID	Édition
`1804890536`	Entreprise
`1872460670`	Édition Entreprise : Licences basées sur les cœurs
`610778273`	Évaluation d’entreprise
`284895786`	Informatique décisionnelle
`-2117995310`	Développeur ¹ ou Développeur Entreprise ²
`-2509700633`	Développeur ^{Standard 2}
`-1592396055`	Express
`-133711905`	Service Express avec Services Avancés
`-1534726760`	Norme
`1293598313`	Web ¹
`1674378470`	SQL Database ou Azure Synapse Analytics
`-1461570097`	Azure SQL Edge Developer ³
`1994083197`	Azure SQL ^{Edge 4}

¹S’applique à : SQL Server 2022 (16.x) et versions antérieures.
²S’applique à : SQL Server 2025 (17.x) et versions ultérieures.
³ Indique l’édition de développement uniquement pour Azure SQL Edge.
⁴ Indique l’édition payante pour Azure SQL Edge.

Types de retour

sql_variant

Remarks

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 :

EXECUTE sp_dropserver 'current_server_name';
GO

EXECUTE 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 principales précédentes, elle a retourné 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 minuscules, ce changement de comportement peut entraîner des différences entre la ServerName propriété de la SERVERPROPERTY fonction et @@SERVERNAME (majuscules et minuscules), même s’il n’y a 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.

Permissions

Tous les utilisateurs peuvent interroger les propriétés du serveur.

Examples

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

Rétroaction

Cette page vous a-t-elle été utile ?

Last updated on 2025-11-18