Partilhar via

  • Artigo

SERVERPROPERTY (Transact-SQL)

Retorna informações de propriedade sobre a instância de servidor no SQL Server 2008 R2.

Í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 ter um dos valores a seguir.

    Propriedade

    Valores retornados

    BuildClrVersion

    Versão do Microsoft .NET Framework Common Language Runtime (CLR) que foi usado durante a criação da instância do SQL Server.

    Tipo de dados base: nvarchar(128)

    Collation

    Nome do agrupamento padrão para o servidor.

    NULL = Entrada inválida ou um erro.

    Tipo de dados base: nvarchar(128)

    CollationID

    ID do agrupamento do SQL Server.

    Tipo de dados base: int

    ComparisonStyle

    Estilo de comparação do agrupamento do Windows.

    Tipo de dados base: int

    ComputerNamePhysicalNetBIOS

    O nome NetBIOS do computador local no qual a instância do SQL Server está em execução 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 que a 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 = Entrada inválida ou um erro.

    Tipo de dados base: nvarchar(128)

    Edition

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

    Retorna:

    'Data Center Edition'

    'Desktop Engine' (Não disponível no SQL Server 2005 e em versões posteriores.)

    'Developer Edition'

    'Enterprise Edition'

    'Enterprise Evaluation Edition'

    'Express Edition'

    'Express Edition com Advanced Services'

    'Personal Edition' (Não disponível no SQL Server 2005 e em versões posteriores.)

    'Small Business Server Edition'

    'Standard Edition'

    'Web Edition'

    'Windows Embedded SQL'

    'Workgroup Edition'

    Tipo de dados base: nvarchar(128)

    EditionID

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

    -978676123 = Data Center

    -1253826760 = Área de trabalho

    -2117995310 = Developer

    -1592396055 = Express

    1804890536 = Enterprise

    610778273= Enterprise Evaluation

    -133711905= Express com Advanced Services

    -323382091 = Personal

    -1960233010 = Small Business Server

    -1534726760 = Standard

    1293598313 = Web

    -3250176541 = Windows Embedded SQL

    1333529388 = Grupo de Trabalho

    Tipo de dados base: bigint

    EngineEdition

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

    1 = Personal ou Desktop Engine (Não disponível no SQL Server 2005 e em versões posteriores.)

    2 = Standard (Retornada para Standard, Small Business Server, Web e Workgroup.)

    3 = Enterprise (Retornada para Enterprise, Enterprise Evaluation, Data Center e Developer.)

    4 = Express (Retornada para Express, Express com Advanced Services e Windows Embedded SQL.)

    5 = SQL Azure

    Tipo de dados base: int

    InstanceName

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

    Retornará 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 = Entrada invá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 = Entrada invá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 = Entrada inválida ou um erro.

    Tipo de dados base: int

    IsSingleUser

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

    1 = Usuário único.

    0 = Usuário não único

    NULL = Entrada inválida ou um erro.

    Tipo de dados base: int

    LCID

    Identificador de localidade do Windows (LCID) do agrupamento.

    Tipo de dados base: int

    LicenseType

    Não utilizado. As informações de licença não são preservadas ou mantidas pelo produto SQL Server. Sempre retorna DISABLED.

    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 do SQL Server em execução em um servidor virtual no Microsoft Cluster Service, retorna o nome do servidor virtual.

    NULL = Entrada inválida ou um erro.

    Tipo de dados base: nvarchar(128)

    NumLicenses

    Não utilizado. As informações de licença não são preservadas ou mantidas pelo produto SQL Server. Sempre retorna NULL.

    Tipo de dados base: int

    ProcessID

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

    NULL = Entrada inválida ou um erro.

    Tipo de dados base: int

    ProductVersion

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

    Tipo de dados base: nvarchar(128)

    ProductLevel

    Nível da versão da instância do 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 do Recurso.

    Tipo de dados base: datetime

    ResourceVersion

    Retorna o banco de dados do Recurso da versão.

    Tipo de dados base: nvarchar(128)

    ServerName

    As informações do servidor e da instância do Windows associadas a uma instância especificada do SQL Server.

    NULL = Entrada inválida ou um erro.

    Tipo de dados base: nvarchar(128)

    SqlCharSet

    A ID do conjunto de caracteres SQL da ID do 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 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 ao fluxo de arquivos configurado. Para obter mais informações, consulte Opção de nível de acesso de fluxo de arquivos.

    FilestreamEffectiveLevel

    O nível de acesso ao fluxo de arquivos 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 Opção de nível de acesso de fluxo de arquivos.

Tipos de retorno

sql_variant

Comentários

Propriedade ServerName

A propriedade ServerName da função SERVERPROPERTY e @@SERVERNAME retornam informações semelhantes. A propriedade ServerName fornece o servidor do Windows e o nome da 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

Edições e componentes do SQL Server 2008 R2