SERVERPROPERTY (Transact-SQL)

S’applique à : ouiSQL Server (toutes les versions prises en charge) OuiAzure SQL Database OuiAzure SQL Managed Instance ouiAzure Synapse Analytics OuiParallel Data Warehouse

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

Icône du lien de rubrique Conventions de la syntaxe Transact-SQL

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. Il s’agit de 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. La version 12 de Azure SQL Database est plus récente que la version 15 de SQL Server.

Notes

Pour afficher la syntaxe Transact-SQL pour SQL Server 2014 et versions antérieures, consultez Versions antérieures de la documentation.

Arguments

propertyname
Expression contenant les informations de propriétés à retourner pour le serveur. propertyname peut avoir l’une des valeurs suivantes.

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)
Classement 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)
Édition Édition du 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. 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 Microsoft 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 = Enterprise Evaluation

284895786 = Business Intelligence

-2117995310 = Developer

-1592396055 = Express

-133711905 = Express with Advanced Services

-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 (valeur retournée pour Standard, Web et Business Intelligence)

3 = Enterprise (valeur retournée pour les éditions Evaluation, Developer et Enterprise.)

4 = Express (valeur retournée pour Express, Express with Tools et Express with Advanced Services)

5 = SQL Database

6 = Microsoft Azure Synapse Analytics

8 = Azure SQL Managed Instance

9 = Azure SQL Edge (ceci est retourné 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.

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.

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) à compter de la mise à jour cumulative 4 (CU4).

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 une valeur indiquant si l’authentification Azure AD uniquement est activée.

1 = L’authentification Azure AD uniquement est activée.

0 = L’authentification Azure AD uniquement 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é AlwaysOn (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
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 la base de données 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 standard 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
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) depuis 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.

Retourne 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.

Retourne l'une des valeurs suivantes :

« 'RTM » = Version d'origine

'SP n' = version du Service Pack

'CTP n', = 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.

Retourne l'une des valeurs suivantes :

CU n = 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)

Types de retour

sql_variant

Notes

Propriété ServerName

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 actuellement configuré.

La propriété ServerName et @@SERVERNAME retournent les mêmes informations si le nom de serveur par défaut au moment de l’installation n’a pas été changé. 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.

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  

Voir aussi

Éditions et composants de SQL Server 2016