SERVERPROPERTY (Transact-SQL)
Devuelve información de la propiedad acerca de la instancia del servidor.
.gif "Icono de vínculo a temas")
Convenciones de sintaxis de Transact-SQL
Sintaxis
SERVERPROPERTY ( propertyname )
Argumentos
propertyname
Es una expresión que contiene la información de propiedad que se va a devolver para el servidor. propertyname puede tener uno de los siguientes valores.Propiedad
Valor devuelto
BuildClrVersion
Versión de Common Language Runtime (CLR) de Microsoft .NET Framework utilizada al generar la instancia de SQL Server.
Tipo de datos base: nvarchar(128)
Collation
El nombre de la intercalación predeterminada para el servidor.
NULL = La entrada no es válida o es un error.
Tipo de datos base: nvarchar(128)
CollationID
Id. de la intercalación de SQL Server.
Tipo de datos base: int
ComparisonStyle
El estilo de comparación de Windows de la intercalación.
Tipo de datos base: int
ComputerNamePhysicalNetBIOS
Nombre NetBIOS del equipo local en el que se ejecuta la instancia de SQL Server.
En el caso de una instancia en clúster de SQL Server en un clúster de conmutación por error, este valor cambia conforme la instancia de SQL Server se conmuta por error con otros nodos del clúster de conmutación por error.
En una instancia independiente de SQL Server, este valor permanece constante y devuelve el mismo valor que la propiedad MachineName.
[!NOTA]
Si la instancia de SQL Server se encuentra en un clúster de conmutación por error y desea obtener el nombre de la instancia en clúster de conmutación por error, utilice la propiedad MachineName.
NULL = La entrada no es válida o es un error.
Tipo de datos base: nvarchar(128)
Edition
Edición del producto instalado de la instancia de SQL Server. Utilice el valor de esta propiedad para determinar las características y los límites, por ejemplo Límites de la capacidad de cálculo de cada edición de SQL Server. Las versiones de 64 bits del Motor de base de datos anexan (64 bits) a la versión.
Devuelve:
'Enterprise Edition'
Enterprise Edition: licencia basada en núcleo
'Enterprise Evaluation Edition'
'Business Intelligence Edition'
'Developer Edition'
'Express Edition'
'Express Edition with Advanced Services'
'Standard Edition'
'Web Edition'
Tipo de datos base: nvarchar(128)
EditionID
EditionID representa la edición instalada de la instancia de SQL Server. Use el valor de esta propiedad para determinar las características y los límites, por ejemplo Límites de la capacidad de cálculo de cada edición de SQL Server.
1804890536 = Enterprise
1872460670 = Enterprise Edition: licencia basada en núcleo
610778273= Enterprise Evaluation
284895786 = Business Intelligence
-2117995310 = Developer
-1592396055 = Express
-133711905= Express con Advanced Services
-1534726760 = Standard
1293598313 = Web
Tipo de datos base: bigint
EngineEdition
Edición de Motor de base de datos de la instancia de SQL Server instalada en el servidor.
1 = Personal o Desktop Engine (No está disponible en SQL Server 2005 y versiones posteriores.)
2 = Standard (se devuelve para Standard, Web y Business Intelligence.)
3 = Enterprise (es el valor que se devuelve en las ediciones Evaluation, Developer y las dos ediciones Enterprise)
4 = Express (se devuelve para Express Express with Tools y Express con Advanced Services.)
5 = SQL Azure
Tipo de datos base: int
HadrManagerStatus
Indica si el administrador de Grupos de disponibilidad AlwaysOn ha iniciado.
0 = No iniciado, pendiente de comunicación.
1 = Iniciado y en ejecución.
2 = No iniciado y con error.
InstanceName
Nombre de la instancia a la que está conectado el usuario.
Devuelve NULL si el nombre de la instancia es la instancia predeterminada o si es una entrada no válida o un error.
Tipo de datos base: nvarchar(128)
IsClustered
La instancia del servidor se configura en un clúster de conmutación por error.
1 = Clúster.
0 = No clúster.
NULL = La entrada no es válida o es un error.
Tipo de datos base: int
IsFullTextInstalled
Los componentes de indización de texto completo y semántica están instalados en la instancia actual de SQL Server.
1 = Los componentes de indización de texto completo y semántica están instalados.
0 = Los componentes de indización de texto completo y semántica no están instalados.
NULL = La entrada no es válida o es un error.
Tipo de datos base: int
IsHadrEnabled
Grupos de disponibilidad AlwaysOn está habilitado en esta instancia del servidor.
0 = La característica Grupos de disponibilidad AlwaysOn está deshabilitada.
1 = La característica Grupos de disponibilidad AlwaysOn está habilitada.
Tipo de datos base: int
Para que las réplicas de disponibilidad se creen y ejecuten en una instancia de SQL Server, Grupos de disponibilidad AlwaysOn debe estar habilitado en la instancia del servidor. Para obtener más información, vea Habilitar y deshabilitar grupos de disponibilidad de AlwaysOn (SQL Server).
[!NOTA]
La propiedad IsHadrEnabled pertenece solamente a Grupos de disponibilidad AlwaysOn. Otras características de alta disponibilidad o de recuperación ante desastres, como la creación de reflejo de la base de datos o el trasvase de registros, no se ven afectadas por esta propiedad de servidor.
IsIntegratedSecurityOnly
El servidor está en modo de seguridad integrada.
1= Seguridad integrada (Autenticación de Windows)
0 = Seguridad no integrada. (Tanto la autenticación de Windows como la autenticación de SQL Server).
NULL = La entrada no es válida o es un error.
Tipo de datos base: int
IsLocalDB
El servidor es una instancia de SQL Server Express LocalDB.
IsSingleUser
El servidor está en modo de usuario único.
1 = Usuario único.
0 = Usuario no único.
NULL = La entrada no es válida o es un error.
Tipo de datos base: int
LCID
Identificador de configuración regional (LCID) de Windows de la intercalación.
Tipo de datos base: int
LicenseType
No se usa. El producto de SQL Server no conserva ni mantiene la información sobre la licencia. Siempre devuelve DISABLED.
Tipo de datos base: nvarchar(128)
MachineName
Nombre del equipo con Windows en el que se está ejecutando la instancia del servidor.
Para una instancia en clúster, una instancia de SQL Server que se ejecuta en el Servicio de Cluster Server de Microsoft, devuelve el nombre del servidor virtual.
NULL = La entrada no es válida o es un error.
Tipo de datos base: nvarchar(128)
NumLicenses
No se usa. El producto de SQL Server no conserva ni mantiene la información sobre la licencia. Siempre devuelve NULL.
Tipo de datos base: int
ProcessID
Identificador de proceso del servicio SQL Server. ProcessID es útil para identificar a qué Sqlservr.exe pertenece esta instancia.
NULL = La entrada no es válida o es un error.
Tipo de datos base: int
ProductVersion
Versión de la instancia de SQL Server como 'major.minor.build.revision'.
Tipo de datos base: nvarchar(128)
ProductLevel
Nivel de la versión de la instancia de SQL Server.
Devuelve una de las siguientes opciones:
'RTM' = Versión comercial original
'SPn' = Versión de Service Pack
'CTP' = versión Community Technology Preview
Tipo de datos base: nvarchar(128)
ResourceLastUpdateDateTime
Devuelve la fecha y hora de la última actualización de la base de datos de recursos.
Tipo de datos base: datetime
ResourceVersion
Devuelve la versión de la base de datos de recursos.
Tipo de datos base: nvarchar(128)
ServerName
La información del servidor Windows y de la instancia asociada con una instancia especificada de SQL Server.
NULL = La entrada no es válida o es un error.
Tipo de datos base: nvarchar(128)
SqlCharSet
Id. del juego de caracteres de SQL a partir del Id. de intercalación.
Tipo de datos base: tinyint
SqlCharSetName
Juego de caracteres de SQL a partir de la intercalación.
Tipo de datos base: nvarchar(128)
SqlSortOrder
Id. de criterio de ordenación de SQL a partir de la intercalación.
Tipo de datos base: tinyint
SqlSortOrderName
Nombre de criterio de ordenación de SQL a partir de la intercalación.
Tipo de datos base: nvarchar(128)
FilestreamShareName
Nombre del recurso compartido usado por FILESTREAM.
FilestreamConfiguredLevel
Nivel configurado de acceso de FILESTREAM. Para obtener más información, vea nivel de acceso de secuencia de archivos.
FilestreamEffectiveLevel
Nivel efectivo de acceso de FILESTREAM. Este valor puede ser diferente del de FilestreamConfiguredLevel si el nivel ha cambiado y queda pendiente un reinicio de la instancia o del equipo. Para obtener más información, vea nivel de acceso de secuencia de archivos.
Tipos de valor devueltos
sql_variant
Comentarios
Propiedad ServerName
La propiedad ServerName de la función SERVERPROPERTY y @@SERVERNAME devuelven información similar. La propiedad ServerName proporciona el nombre de la instancia y el servidor Windows que forman la instancia de servidor única. @@SERVERNAME proporciona el nombre del servidor local configurado actualmente.
La propiedad ServerName y @@SERVERNAME devuelven la misma información si no se ha cambiado el nombre del servidor predeterminado en el momento de la instalación. El nombre del servidor local se puede configurar ejecutando lo siguiente:
EXEC sp_dropserver 'current_server_name';
GO
EXEC sp_addserver 'new_server_name', 'local';
GO
Si se ha seleccionado un nombre para el servidor local distinto del predeterminado durante la instalación, @@SERVERNAME devuelve el nombre nuevo.
Propiedades de la versión
La función SERVERPROPERTY devuelve propiedades sueltas relacionadas con la información de la versión, mientras que la función @@VERSION combina la salida en una cadena. Si la aplicación requiere cadenas con las propiedades por separado, puede utilizar la función SERVERPROPERTY para devolverlas en lugar de analizar los resultados de @@VERSION.
Ejemplos
En el siguiente ejemplo se utiliza la función SERVERPROPERTY en una instrucción SELECT para devolver información acerca del servidor actual. Este escenario es útil cuando hay varias instancias de SQL Server instaladas en un servidor Windows y el cliente necesita abrir otra conexión a la misma instancia utilizada en la conexión actual.
SELECT CONVERT(sysname, SERVERPROPERTY('servername'));
GO
En el ejemplo siguiente se utiliza la función SERVERPROPERTY en una instrucción SELECT para devolver información de versión sobre el producto.
SELECT
SERVERPROPERTY('ProductVersion') AS ProductVersion,
SERVERPROPERTY('ProductLevel') AS ProductLevel,
SERVERPROPERTY('Edition') AS Edition,
SERVERPROPERTY('EngineEdition') AS EngineEdition;
GO