Compartilhar via


SERVERPROPERTY (Transact-SQL)

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

Ícone de vínculo de tópico Convenções da sintaxe Transact-SQL

Sintaxe

SERVERPROPERTY ( propertyname )

Argumentos

  • propertyname
    É uma expressão que contém as informações de propriedade que serão retornadas para o servidor. propertyname pode ser 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 Computar limites de capacidade por edição do SQL Server. Versões de 64 bits do Mecanismo de Banco de Dados anexam (64 bits) à versão.

    Retorna:

    'Enterprise Edition'

    ‘Enterprise Edition: licenciamento baseado em núcleo’

    'Enterprise Evaluation Edition'

    ‘Business Intelligence Edition’

    'Developer Edition'

    'Express Edition'

    'Express Edition com Advanced Services'

    'Standard Edition'

    'Web Edition'

    Tipo de dados base: nvarchar(128)

    EditionID

    EditionID representa a edição instalada do produto da instância do SQL Server. Use o valor dessa propriedade para determinar os recursos e os limites, como Computar limites de capacidade por edição do SQL Server.

    1804890536 = Enterprise

    1872460670 = Enterprise Edition: licenciamento baseado em núcleo

    610778273= Enterprise Evaluation

    284895786 = Business Intelligence

    -2117995310 = Developer

    -1592396055 = Express

    -133711905= Express com Advanced Services

    -1534726760 = Standard

    1293598313 = Web

    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, Web e Business Intelligence.)

    3 = Enterprise (This is returned for Evaluation, Developer e Enterprise editions.)

    4 = Express (Retornada para Express, Express with Tools e Express com Advanced Services)

    5 = SQL Azure

    Tipo de dados base: int

    HadrManagerStatus

    Indica se o gerenciador do Grupos de Disponibilidade AlwaysOn foi iniciado.

    0 = não iniciado, comunicação pendente.

    1 = iniciado e em execução.

    2 = não iniciado e com falha.

    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

    Os componentes de indexação de texto completo e semântica são instalados na instância atual do SQL Server.

    1 = Componentes de indexação de texto completo e semântica são instalados.

    0 = Componentes de indexação de texto completo e semântica não são instalados.

    NULL = Entrada inválida ou um erro.

    Tipo de dados base: int

    IsHadrEnabled

    Grupos de Disponibilidade AlwaysOn é habilitado nessa instância do servidor.

    0 = O Grupos de Disponibilidade AlwaysOn está desabilitado.

    1 = O recurso Grupos de Disponibilidade AlwaysOn está habilitado.

    Tipo de dados base: int

    Para que réplicas de disponibilidade sejam criadas e executadas em uma instância do SQL Server, Grupos de Disponibilidade AlwaysOn deve estar habilitado na instância do servidor. Para obter mais informações, consulte Habilitar e desabilitar Grupos de Disponibilidade AlwaysOn (SQL Server).

    ObservaçãoObservação

    A propriedade IsHadrEnabled pertence somente ao Grupos de Disponibilidade AlwaysOn. Outros recursos de alta disponibilidade ou de recuperação de desastre, como espelhamento de banco de dados ou envio de logs, não são afetados por essa propriedade de servidor.

    IsIntegratedSecurityOnly

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

    1 = Segurança integrada (Autenticação do Windows)

    0 = Segurança não integrada. (Autenticação do Windows e Autenticação do SQL Server.)

    NULL = Entrada inválida ou um erro.

    Tipo de dados base: int

    IsLocalDB

    O servidor é uma instância do SQL Server Express LocalDB.

    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 do processo do serviço SQL Server. ProcessID é útil para identificar qual Sqlservr.exe pertence a essa 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.revision'.

    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 FILESTREAM configurado. Para obter mais informações, consulte o nível de acesso de fluxo de arquivos.

    FilestreamEffectiveLevel

    O nível de acesso ao FILESTREAM efetivo. Esse valor poderá ser diferente de FilestreamConfiguredLevel se o nível tiver sido alterado e se a reinicialização de uma instância ou de um computador estiver pendente. Para obter mais informações, consulte o 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 similares. 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 2012