SERVERPROPERTY (Transact-SQL)

Syntaxe

SERVERPROPERTY ( propertyname )

Arguments

• propertyname
  Expression contenant les informations de propriété devant être retournées pour le serveur. L'argument propertyname peut prendre 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. 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 le nombre maximal de processeurs qui sont pris en charge par le produit installé. Les versions 64 bits du Moteur de base de données ajoutent la mention (64 bits) à la version. Retourne les informations suivantes : « Data Center Edition » « Desktop Engine » (non disponible pour SQL Server 2005 et versions ultérieures) « Developer Edition » « Enterprise Edition » « Enterprise Evaluation Edition » « Express Edition » « Express Edition with Advanced Services » « Personal Edition » (non disponible pour SQL Server 2005 et versions ultérieures) « Small Business Server Edition » « Standard Edition » « Web Edition » « Windows Embedded SQL » « Workgroup Edition » Type de données de base : nvarchar(128)
  EditionID	Numéro d'identification qui représente l'é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 le nombre maximal de processeurs qui sont pris en charge par le produit installé. -978676123 = Data Center -1253826760 = Desktop -2117995310 = Developer -1592396055 = Express 1804890536 = Enterprise 610778273 = Enterprise Evaluation -133711905 = Express with Advanced Services -323382091 = Personal -1960233010 = Small Business Server -1534726760 = Standard 1293598313 = Web -3250176541 = Windows Embedded SQL 1333529388 = Workgroup 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, Small Business Server, Web et Workgroup) 3 = Enterprise (valeur retournée pour Enterprise, Enterprise Evaluation Data Center et Developer) 4 = Express (valeur retournée pour Express, Express with Advanced Services et Windows Embedded SQL.) 5 = SQL Azure Type de données de base : int
  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	Composant de texte intégral installé avec l'instance actuelle de SQL Server. 1 = Texte intégral installé 0 = Texte intégral non installé NULL = Entrée non valide ou erreur. 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. 0 = Sécurité non intégrée. NULL = Entrée non valide ou erreur. 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 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 sur la licence ne sont pas conservées ni gérées par le produit SQL Server. Retourne toujours la valeur 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 sur la licence ne sont pas conservées ni 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 ou erreur Type de données de base : int
  ProductVersion	Version de l'instance de SQL Server, sous la forme de 'major.minor.build'. Type de données de base : nvarchar(128)
  ProductLevel	Niveau de la version de l'instance de SQL Server. Retourne l'une des options 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 Option Niveau d'accès du flux de fichier.
  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 Option Niveau d'accès du flux de fichier.

Types de retour

sql_variant

Notes

Propriété ServerName

EXEC sp_dropserver 'current_server_name';
GO
EXEC sp_addserver 'new_server_name', 'local';
GO

Propriétés 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

Voir aussi

Référence