SERVERPROPERTY (Transact-SQL)

Retorna informações de propriedade sobre a instância de servidor.

Ícone de vínculo de tópicoConvenções de sintaxe Transact-SQL

Sintaxe

SERVERPROPERTY ( propertyname )

Argumentos

  • propertyname
    É uma expressão que contém as informações de propriedade a serem retornadas para o servidor. propertyname pode ser um dos valores a seguir.

    Propriedade

    Valores retornados

    BuildClrVersion

    Versão do tempo de execução de linguagem comum (CLR) Microsoft.NET Framework que foi usado durante construção da instância de SQL Server.

    Tipo de dados base: nvarchar(128)

    Agrupamento

    Nome do agrupamento padrão para o servidor.

    NULL = A entrada não é válida ou um erro.

    Tipo de dados base: nvarchar(128)

    CollationID

    ID do agrupamento SQL Server.

    Tipo de dados base: int

    ComparisonStyle

    Estilo de comparação do agrupamento do Windows.

    Tipo de dados base: int

    ComputerNamePhysicalNetBIOS

    O nome de NetBIOS do computador local no qual a instância de SQL Server está sendo executada no momento.

    Para uma instância clusterizada de SQL Server em um cluster de failover, este valor muda à medida que a instância de SQL Server efetua failover para os outros nós no cluster de failover.

    Em uma instância autônoma do SQL Server, esse valor permanece constante e retorna o mesmo valor da propriedade MachineName.

    ObservaçãoObservação
    Se a instância do SQL Server estiver em um cluster de failover e você desejar obter o nome da instância clusterizada de failover, use a propriedade MachineName.

    NULL = A entrada não é válida ou um erro.

    Tipo de dados base: nvarchar(128)

    Edição

    Edição de produto instalada da instância de SQL Server. Use o valor dessa propriedade para determinar os recursos e os limites, como o número máximo de CPUs que são suportadas pelo produto instalado. Versões de 64 bits da anexação do Mecanismo de Banco de Dados (64 bits) para a versão.

    Retorna:

    'Desktop Engine' (Não disponível para SQL Server.)

    'Developer Edition'

    'Enterprise Edition'

    'Enterprise Evaluation Edition'

    'Edição pessoal' (Não disponível para SQL Server.)

    'Standard Edition'

    'Express Edition'

    'Express Edition com Advanced Services'

    'Workgroup Edition'

    'Windows Embedded SQL'

    Tipo de dados base: nvarchar(128)

    EditionID

    É um número de identificação que representa a edição de produto instalada da instância de SQL Server. Use o valor desta propriedade para determinar os recursos e limites, como número máximo de CPUs, que são suportados pelo produto instalado.

    -1253826760 = Área de trabalho

    -1592396055 = Express

    -1534726760 = Standard

    1333529388 = Grupo de Trabalho

    1804890536 = Enterprise

    -323382091 = Pessoal

    -2117995310 = Desenvolvedor

    610778273 = Avaliação do Enterprise

    1044790755 = Windows Embedded SQL

    4161255391 = Express com Advanced Services

    Tipo de dados base: int

    EngineEdition

    Edição Mecanismo de Banco de Dados da instância do SQL Server instalada no servidor.

    1 = Personal ou Desktop Engine (Não disponível para SQL Server.)

    2 = Standard (Isto é retornado para Standard e Workgroup.)

    3 = Enterprise (Isto é retornado para Enterprise, Enterprise Evaluation e Developer.)

    4 = Express (Isto é retornado para Express, Express com Advanced Services e Windows Embedded SQL.)

    Tipo de dados base: int

    InstanceName

    Nome da instância à qual o usuário está conectado.

    Retorna NULL se o nome de instância for a instância padrão, se a entrada não for válida, ou erro.

    Tipo de dados base: nvarchar(128)

    IsClustered

    A instância de servidor é configurada em um cluster de failover.

    1 = Clusterizado.

    0 = Não clusterizado.

    NULL = A entrada não é válida ou um erro.

    Tipo de dados base: int

    IsFullTextInstalled

    O componente de texto completo é instalado com a instância atual do SQL Server.

    1 = Texto completo é instalado.

    0 = Texto completo não é instalado.

    NULL = A entrada não é válida ou um erro.

    Tipo de dados base: int

    IsIntegratedSecurityOnly

    O servidor está em modo de segurança integrado.

    1 = Segurança integrada.

    0 = Segurança não integrada.

    NULL = A entrada não é válida ou um erro.

    Tipo de dados base: int

    IsSingleUser

    O servidor está em modo de usuário único.

    1 = único usuário.

    0 = Não único usuário

    NULL = A entrada não é válida ou um erro.

    Tipo de dados base: int

    LCID

    Identificador de localidade do Windows (LCID) do agrupamento.

    Tipo de dados base: int

    LicenseType

    Modo desta instância de SQL Server.

    PER_SEAT = Por modo Seat

    PER_PROCESSOR = Modo Per-processor

    DISABLED = Licenciamento desabilitado.

    Tipo de dados base: nvarchar(128)

    MachineName

    Nome do computador do Windows no qual a instância de servidor está sendo executada.

    Para uma instância clusterizada, uma instância de SQL Server sendo executada em um servidor virtual no Microsoft Cluster Service, retorna o nome do servidor virtual.

    NULL = A entrada não é válida ou um erro.

    Tipo de dados base: nvarchar(128)

    NumLicenses

    Número de licenças de cliente registrado para esta instância de SQL Server se em modo Seat.

    Número de processadores licenciados para esta instância de SQL Server se em modo per-processor.

    Retorna NULL quando o servidor não for nenhum destes.

    Tipo de dados base: int

    ProcessID

    ID do processo do serviço SQL Server. ProcessID é útil para identificar qual Sqlservr.exe pertence a esta instância.

    NULL = A entrada não é válida ou um erro.

    Tipo de dados base: int

    ProductVersion

    Versão da instância de SQL Server, no formato de 'major.minor.build'.

    Tipo de dados base: nvarchar(128)

    ProductLevel

    Nível da versão da instância de SQL Server.

    Retorna uma destas opções:

    'RTM' = Versão original

    'SPn' = Versão service pack

    'CTP', = Versão Community Technology Preview

    Tipo de dados base: nvarchar(128)

    ResourceLastUpdateDateTime

    Retorna a data e a hora da última atualização do banco de dados de Recursos.

    Tipo de dados base: datetime

    ResourceVersion

    Retorna o banco de dados de recursos de versão.

    Tipo de dados base: nvarchar(128)

    ServerName

    O servidor de Windows e as informações de instância associados a uma instância especificada de SQL Server.

    NULL = A entrada não é válida ou um erro.

    Tipo de dados base: nvarchar(128)

    SqlCharSet

    O ID do conjunto de caracteres de SQL do ID agrupamento.

    Tipo de dados base: tinyint

    SqlCharSetName

    O nome do conjunto de caracteres SQL do agrupamento.

    Tipo de dados base: nvarchar(128)

    SqlSortOrder

    O ID da ordem de classificação de SQL do agrupamento

    Tipo de dados base: tinyint

    SqlSortOrderName

    O nome da ordem de classificação SQL do agrupamento.

    Tipo de dados base: nvarchar(128)

    FilestreamShareName

    O nome do compartilhamento usado por FILESTREAM.

    FilestreamConfiguredLevel

    O nível de acesso de FILESTREAM configurado. Para obter mais informações, consulte nível de acesso de fluxo de arquivos.

    FilestreamEffectiveLevel

    O nível de acesso de FILESTREAM efetivo. Esse valor poderá ser diferente de FilestreamConfiguredLevel se o nível foi alterado e se a reinicialização de uma instância ou de um computador estiver pendente. Para obter mais informações, consulte nível de acesso de fluxo de arquivos.

Tipos de retorno

sql_variant

Comentários

Propriedade ServerName

A propriedade do ServerName da função SERVERPROPERTY e @@SERVERNAME retorna informações semelhantes. A propriedade do ServerName fornece o servidor de Windows e o nome de instância que juntos compõem a instância exclusiva do servidor. @@SERVERNAME fornece o nome do servidor local configurado no momento.

A propriedade ServerName e @@SERVERNAME retornarão as mesmas informações se o nome do servidor padrão no momento da instalação não tiver sido alterado. O nome de servidor local pode ser configurado executando o seguinte:

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

Se o nome do servidor local não foi alterado em relação ao nome di servidor padrão no momento da instalação, @@SERVERNAME retornará um novo nome.

Propriedades da versão

A função SERVERPROPERTY retorna propriedades individuais relacionadas às informações da versão enquanto a função @@VERSION combina a saída em uma cadeia de caracteres. Se seu aplicativo exigir cadeias de caracteres de propriedade individuais, você poderá usar a função SERVERPROPERTY para retorná-las, em vez de analisar os resultados de @@VERSION.

Exemplos

O exemplo a seguir usa a função SERVERPROPERTY em uma instrução SELECT para retornar informações sobre o servidor atual. Essa situação é útil quando existem diversas instâncias de SQL Server instaladas no servidor Windows e o cliente deve abrir outra conexão à mesma instância usada pela conexão atual.

SELECT CONVERT(sysname, SERVERPROPERTY('servername'));
GO

O exemplo a seguir usa a função SERVERPROPERTY em uma instrução SELECT para retornar informações de versão sobre o produto.

SELECT
SERVERPROPERTY('ProductVersion') AS ProductVersion,
SERVERPROPERTY('ProductLevel') AS ProductLevel,
SERVERPROPERTY('Edition') AS Edition,
SERVERPROPERTY('EngineEdition') AS EngineEdition;
GO

Consulte também

Referência