SERVERPROPERTY (Transact-SQL)

Devuelve información de la propiedad acerca de la instancia del servidor.

Icono de vínculo a temasConvenciones de sintaxis de Transact-SQL

Sintaxis

SERVERPROPERTY ( propertyname )

Argumentos

  • propertyname
    Es una expresión que contiene la información de la propiedad que se va a devolver para el servidor. propertyname puede ser uno de los valores siguientes.

    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.

    NotaNota
    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, como por ejemplo el número máximo de CPU admitidas por el producto instalado. Las versiones de 64 bits de Database Engine (Motor de base de datos) anexan (64 bits) a la versión.

    Devuelve:

    'Desktop Engine' (no está disponible para SQL Server)

    'Developer Edition'

    'Enterprise Edition'

    'Enterprise Evaluation Edition'

    'Personal Edition' (no está disponible para SQL Server)

    'Standard Edition'

    'Express Edition'

    'Express Edition with Advanced Services'

    'Workgroup Edition'

    'Windows Embedded SQL'

    Tipo de datos base: nvarchar(128)

    EditionID

    Número de identificación que representa la edición instalada de la instancia de SQL Server. Utilice el valor de esta propiedad para determinar las funciones y los límites, como el número máximo de CPU admitidas por el producto instalado.

    -1253826760 = Desktop

    -1592396055 = Express

    -1534726760 = Standard

    1333529388 = Workgroup

    1804890536 = Enterprise

    -323382091 = Personal

    -2117995310 = Developer

    610778273 = Enterprise Evaluation

    1044790755 = Windows Embedded SQL

    4161255391 = Express con Advanced Services

    Tipo de datos base: int

    EngineEdition

    Edición de Database Engine (Motor de base de datos) de la instancia de SQL Server instalada en el servidor.

    1 = Personal o Desktop Engine (no está disponible para SQL Server)

    2 = Standard (se devuelve para Standard y Workgroup)

    3 = Enterprise (se devuelve para Enterprise, Enterprise Evaluation y Developer)

    4 = Express (se devuelve para Express, Express con Advanced Services y Windows Embedded SQL)

    Tipo de datos base: int

    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

    El componente de texto se ha instalado con la instancia actual de SQL Server.

    1 = El componente de texto está instalado.

    0 = El componente de texto no está instalado.

    NULL = La entrada no es válida o es un error.

    Tipo de datos base: int

    IsIntegratedSecurityOnly

    El servidor está en modo de seguridad integrada.

    1 = Seguridad integrada.

    0 = Seguridad no integrada.

    NULL = La entrada no es válida o es un error.

    Tipo de datos base: int

    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

    Modo de esta instancia de SQL Server.

    PER_SEAT = Modo por puesto

    PER_PROCESSOR = Modo por procesador

    DISABLED = Licencia deshabilitada

    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

    Número de licencias de cliente registradas para esta instancia de SQL Server en el modo por puesto.

    Número de licencias de procesador para esta instancia de SQL Server en el modo por procesador.

    Devuelve NULL si el servidor no es ninguno de los anteriores.

    Tipo de datos base: int

    ProcessID

    Id. 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'.

    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 orden de SQL a partir de la intercalación.

    Tipo de datos base: tinyint

    SqlSortOrderName

    Nombre de orden 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 filestream access level.

    FilestreamEffectiveLevel

    Nivel efectivo de acceso de FILESTREAM. Este valor puede ser diferente 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 filestream access level.

Tipos de valores devueltos

sql_variant

Notas

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