Partager via


SERVERPROPERTY (Transact-SQL)

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

Icône Lien de rubriqueConventions de syntaxe 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é 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.

    RemarqueRemarque
    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 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 :

    « Desktop Engine » (indisponible pour SQL Server.)

    « Developer Edition »

    « Enterprise Edition »

    « Enterprise Evaluation Edition »

    « 'Personal Edition » (indisponible pour SQL Server.)

    « Standard Edition »

    « Express Edition »

    « Express Edition with Advanced Services »

    « Workgroup Edition »

    « Windows Embedded SQL »

    Type de données de base : nvarchar(128)

    EditionID

    Numéro d'identification qui représente l'édition 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é.

    -1253826760 = Desktop

    -1592396055 = Express

    -1534726760 = Standard

    1333529388 = Workgroup

    1804890536 = Enterprise

    -323382091 = Personal

    -2117995310 = Developer

    610778273 = Enterprise Evaluation

    1044790755 = Windows Embedded SQL

    4161255391 = Express with Advanced Services

    Type de données de base : int

    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 (indisponible pour SQL Server.)

    2 = Standard (valeur renvoyée pour Standard et Workgroup.)

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

    4 = Express (valeur retournée pour Express, Express with Advanced Services et Windows Embedded SQL.)

    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 utilisateur unique.

    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

    Mode de cette instance de SQL Server.

    PER_SEAT = Mode Par siège

    PER_PROCESSOR = Mode Par processeur

    DISABLED = Licences désactivées.

    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 cluster, une instance de SQL Server fonctionnant sur un serveur virtuel sous Microsoft Cluster Server, elle retourne le nom du serveur virtuel.

    NULL = Entrée non valide ou erreur

    Type de données de base : nvarchar(128)

    NumLicenses

    Nombre de licences client enregistrées pour cette instance de SQL Server, en cas de mode Par siège.

    Nombre de licences ordinateur pour cette instance de SQL Server, en cas de mode Par ordinateur.

    Retourne la valeur NULL si le mode du serveur n'est aucun des modes ci-dessus.

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