SERVERPROPERTY (Transact-SQL)

Devuelve información de la propiedad acerca de la instancia del servidor en SQL Server 2008 R2.

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 del Motor de base de datos anexan (64 bits) a la versión.

    Devuelve:

    'Data Center Edition'

    'Desktop Engine' (no está disponible en SQL Server 2005 y versiones posteriores.)

    'Developer Edition'

    'Enterprise Edition'

    'Enterprise Evaluation Edition'

    'Express Edition'

    'Express Edition with Advanced Services'

    'Personal Edition' (no está disponible en SQL Server 2005 y versiones posteriores).

    'Small Business Server Edition'

    'Standard Edition'

    'Web Edition'

    'Windows Embedded SQL'

    'Workgroup Edition'

    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 características y los límites, como el número máximo de CPU admitidas por el producto instalado.

    -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

    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, Small Business Server, Web y Workgroup).

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

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

    5 = SQL Azure

    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 completo se ha instalado con la instancia actual de SQL Server.

    1 = El componente de texto completo está instalado.

    0 = El componente de texto completo 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

    No se usa. El producto SQL Server no conserva ni mantiene la información de 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 SQL Server no conserva ni mantiene la información de licencia. Siempre devuelve NULL.

    Tipo de datos base: int

    ProcessID

    Process ID de SQL Server service. 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 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 Opción Nivel de acceso de secuencia de archivos.

    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 Opción 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