SERVERPROPERTY (Transact-SQL)

S’applique à :SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

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

Conventions de la syntaxe Transact-SQL

Remarque

L’ID Microsoft Entra était précédemment appelé 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.

Remarque

Pour afficher la syntaxe Transact-SQL pour SQL Server 2014 (12.x) et versions antérieures, consultez la Documentation sur les versions antérieures.

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.

Retourne si l’authentification Microsoft Entra uniquement est activée.

1 = L’authentification Microsoft Entra-only est activée.

0 = l’authentification Microsoft Entra-only 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 Linux

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 = 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) jusqu’à la version actuelle dans les mises à jour depuis fin 2015.

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)
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

Pour obtenir la liste des fonctionnalités prises en charge par les éditions de SQL Server sur Windows, consultez :