SERVERPROPERTY (Transact-SQL)
Retourne des informations de propriété relatives à l'instance du serveur.
.gif "Icône Lien de rubrique")
Conventions de la syntaxe Transact-SQL
Syntaxe
SERVERPROPERTY ( propertyname )
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 construction de l'instance de SQL Server.
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.
.gif "Remarque")
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 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, par exemple Limites de capacité de calcul par l'édition de 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 : contrat de licence selon le nombre de cœurs »
« Enterprise Evaluation Edition »
« Business Intelligence Edition »
« Developer Edition »
« Express Edition »
« Express Edition with Advanced Services »
« Standard Edition »
« Web Edition »
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 les fonctionnalités et les limites, par exemple Limites de capacité de calcul par l'édition de SQL Server.
1804890536 = Enterprise
1872460670 = Enterprise Edition : contrat de licence selon le nombre de cœurs
610778273 = Enterprise Evaluation
284895786 = Business Intelligence
-2117995310 = Developer
-1592396055 = Express
-133711905 = Express with Advanced Services
-1534726760 = Standard
1293598313 = Web
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 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 les deux éditions Enterprise.)
4 = Express (valeur retournée pour Express, Express with Tools et Express with Advanced Services)
5 = SQL Azure
Type de données de base : int
HadrManagerStatus
Indique si le gestionnaire Groupes de disponibilité AlwaysOn 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
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.
Type de données de base : nvarchar(128)
IsClustered
L'instance du serveur est configurée dans un cluster de basculement.
1 = Ordonné en clusters
0 = Non cluster
NULL = Entrée non valide ou erreur.
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 ou erreur.
Type de données de base : int
IsHadrEnabled
Groupes de disponibilité AlwaysOn est activé sur cette instance de serveur.
0 = la fonctionnalité Groupes de disponibilité AlwaysOn est désactivée.
1 = la fonctionnalité Groupes de disponibilité AlwaysOn est activée.
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é AlwaysOn 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 au service Groupes de disponibilité AlwaysOn.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 ou erreur.
Type de données de base : int
IsLocalDB
Le serveur est une instance de SQL Server Express LocalDB.
IsSingleUser
Le serveur est en mode mono-utilisateur.
1 = Utilisateur unique
0 = Utilisateur non unique
NULL = Entrée non valide 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, elle retourne le nom du serveur virtuel.
NULL = Entrée non valide 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 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 ou erreur
Type de données de base : int
ProductVersion
Version de l'instance de SQL Server, sous la forme de 'major.minor.build.revision'.
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
« SPn » = Version Service Pack
« CTP », = Version préliminaire CTP (Community Technology Preview)
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)
FilestreamShareName
Nom du partage utilisé par FILESTREAM.
FilestreamConfiguredLevel
Niveau configuré d'accès de FILESTREAM. Pour plus d'informations, consultez Niveau d'accès filestream.
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.
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 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.
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 dans une chaîne unique. 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.
Exemples
L'exemple suivant utilise la fonction SERVERPROPERTY d'une instruction SELECT pour retourner des informations sur le serveur actif. Ce scénario est utile lorsque plusieurs instances SQL Server sont installées sur un serveur Windows et que le client doit initialiser une autre connexion vers l'instance utilisée par la connexion actuelle.
SELECT CONVERT(sysname, SERVERPROPERTY('servername'));
GO
L'exemple suivant utilise la fonction SERVERPROPERTY dans une instruction SELECT pour retourner des informations sur la version du produit.
SELECT
SERVERPROPERTY('ProductVersion') AS ProductVersion,
SERVERPROPERTY('ProductLevel') AS ProductLevel,
SERVERPROPERTY('Edition') AS Edition,
SERVERPROPERTY('EngineEdition') AS EngineEdition;
GO