Partilhar via


SERVERPROPERTY (Transact-SQL)

Aplica-se a: SQL Server Banco de Dados SQL do Azure Instância Gerenciada de SQL do Azure Azure Synapse Analytics Analytics Platform System (PDW)

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

Convenções de sintaxe de Transact-SQL

Observação

O Microsoft Entra ID era conhecido anteriormente como Azure Active Directory (Azure AD).

Sintaxe

SERVERPROPERTY ( 'propertyname' )

Importante

Os números de versão Mecanismo de Banco de Dados a SQL Server e Banco de Dados SQL do Azure não são comparáveis entre si e representam números de build internos para esses produtos separados. O Mecanismo de Banco de Dados para Banco de Dados SQL do Azure é baseado na mesma base de código que o Mecanismo de Banco de Dados do SQL Server. O mais importante é que o Mecanismo de Banco de Dados em Banco de Dados SQL do Azure sempre tem os bits de Mecanismo de Banco de Dados do SQL mais recentes. Por exemplo, a versão 12 do Banco de Dados SQL do Azure é mais recente do que a versão 16 do SQL Server.

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 abaixo. O uso de um propertyname inválido ou sem suporte nessa versão do Mecanismo de Banco de Dados retornará NULL.

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

NULL = A entrada é inválida, um erro ou não aplicável.

Tipo de dados base: nvarchar(128)
Collation Nome da ordenação padrão para o servidor.

NULL = A entrada é inválida ou um erro.

Tipo de dados base: nvarchar(128)
CollationID ID da ordenação do SQL Server.

Tipo de dados base: int
ComparisonStyle Estilo de comparação da ordenação 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 da propriedade MachineName.

Observaçã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 é inválida, um erro ou não aplicável.

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 Calcular 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'

'SQL do Azure' indica o Banco de Dados SQL ou o Azure Synapse Analytics

'Desenvolvedor do SQL do Azure no Edge' indica a edição somente de desenvolvimento do SQL do Azure no Edge

'SQL do Azure no Edge' indica a edição paga do SQL do Azure no Edge

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 recursos e limites, como Calcular 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 = Padrão

1293598313 = Web

1674378470 = Banco de Dados SQL ou Azure Synapse Analytics

-1461570097 = Desenvolvedor do SQL do Azure no Edge

1994083197 = SQL do Azure no Edge

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 (9.x) e em versões posteriores.)

2 = Standard (Para Standard, Web e Business Intelligence).

3 = Enterprise (Para edições Evaluation, Enterprise e Developer).

4 = Express (Para Express, Express with Tools e Express with Advanced Services)

5 = Banco de Dados SQL

6 = Azure Synapse Analytics

8 = Instância Gerenciada do Azure SQL

9 = SQL do Azure no Edge (Para todas as edições do SQL do Azure no Edge)

11 = pool de SQL sem servidor do Azure Synapse

Tipo de dados base: int
FilestreamConfiguredLevel O nível de acesso ao FILESTREAM configurado. Para obter mais informações, consulte Nível de acesso de fluxo de arquivos.

0 = FILESTREAM está desabilitado

1 = FILESTREAM is enabled for Transact-SQL access

2 = FILESTREAM está habilitado para acesso via streaming Transact-SQL e Win32 local

3 = FILESTREAM está habilitado para Transact-SQL e acesso via streaming Win32 local e remoto

Tipo de dados base: int
FilestreamEffectiveLevel O nível de acesso ao 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.

0 = FILESTREAM está desabilitado

1 = FILESTREAM is enabled for Transact-SQL access

2 = FILESTREAM está habilitado para acesso via streaming Transact-SQL e Win32 local

3 = FILESTREAM está habilitado para Transact-SQL e acesso via streaming Win32 local e remoto

Tipo de dados base: int
FilestreamShareName O nome do compartilhamento usado por FILESTREAM.

NULL = A entrada é inválida, um erro ou não aplicável.

Tipo de dados base: nvarchar(128)
HadrManagerStatus Aplica-se a: SQL Server 2012 (11.x) e posterior.

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.

NULL = A entrada é inválida, um erro ou não aplicável.

Tipo de dados base: int
InstanceDefaultBackupPath Aplica-se a: SQL Server 2019 (15.x) e posterior.

Nome do caminho padrão para os arquivos de backup da instância.
InstanceDefaultDataPath Aplica-se a: do SQL Server 2012 (11.x) até a versão atual em atualizações a partir do final de 2015.

Nome do caminho padrão para os arquivos de dados da instância.

Tipo de dados base: nvarchar(128)
InstanceDefaultLogPath Aplica-se a: do SQL Server 2012 (11.x) até a versão atual em atualizações a partir do final de 2015.

Nome do caminho padrão para os arquivos de log da instância.

Tipo de dados base: nvarchar(128)
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.

NULL = A entrada é inválida, um erro ou não aplicável.

Tipo de dados base: nvarchar(128)
IsAdvancedAnalyticsInstalled Retorna 1 se a funcionalidade Advanced Analytics foi instalada durante a instalação; 0 se o Advanced Analytics não foi instalado.

Tipo de dados base: int
IsBigDataCluster Introduzido no SQL Server 2019 (15.x) a partir da CU 4.

Retorna 1 se a instância é o Cluster de Big Data do SQL Server; caso contrário, 0.

Tipo de dados base: int
IsClustered A instância de servidor é configurada em um cluster de failover.

1 = Clusterizado.

0 = Não clusterizado.

NULL = A entrada é inválida, um erro ou não aplicável.

Tipo de dados base: int
IsExternalAuthenticationOnly Aplica-se a: Banco de Dados SQL do Azure e Instância Gerenciada de SQL do Azure.

Retorna se a autenticação somente do Microsoft Entra está habilitada.

1 = Autenticação somente do Microsoft Entra está habilitada.

0 = Autenticação somente do Microsoft Entra está desabilitada.

Tipo de dados base: int
IsExternalGovernanceEnabled Aplica-se a: SQL Server 2022 (16.x) e versões posteriores.

Retorna se as políticas de acesso do Microsoft Purview estão habilitadas.

1 = A governança externa está habilitada.

0 = A governança externa está desabilitada.

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 = A entrada é inválida, um erro ou não aplicável.

Tipo de dados base: int
IsHadrEnabled Aplica-se a: SQL Server 2012 (11.x) e posterior.

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.

NULL = A entrada é inválida, um erro ou não aplicável.

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, confira Habilitar e desabilitar Grupos de Disponibilidade Always On (SQL Server).

Observaçã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 = A entrada é inválida, um erro ou não aplicável.

Tipo de dados base: int
IsLocalDB Aplica-se a: SQL Server 2012 (11.x) e posterior.

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

NULL = A entrada é inválida, um erro ou não aplicável.

Tipo de dados base: int
IsPolyBaseInstalled Aplica-se a: SQL Server 2016 (13.x).

Retorna se a instância do servidor tem o recurso PolyBase instalado.

0 = o PolyBase não está instalado.

1 = o PolyBase está instalado.

Tipo de dados base: int
IsServerSuspendedForSnapshotBackup O servidor está no modo de suspensão e requer o descongelamento no nível do servidor.

1 = Suspenso.

0 = Não suspenso

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 = A entrada é inválida, um erro ou não aplicável.

Tipo de dados base: int
IsTempDbMetadataMemoryOptimized Aplica-se a: SQL Server 2019 (15.x) e posterior.

Retorna tempdb se o tempdb foi habilitado para usar tabelas com otimização de memória para metadados; 0 se o tempdb estiver usando tabelas regulares baseadas em disco para metadados. Para obter mais informações, confira tempdb Database.

Tipo de dados base: int
IsXTPSupported Aplica-se ao: SQL Server (SQL Server 2014 (12.x) e posterior), Banco de Dados SQL.

Servidor dá suporte a OLTP na memória.

1= O servidor dá suporte a OLTP na memória.

0 = O servidor não dá suporte a OLTP na memória.

NULL = A entrada é inválida, um erro ou não aplicável.

Tipo de dados base: int
LCID LCID (Identificador de localidade do Windows) da ordenação.

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 = A entrada é inválida, um erro ou não aplicável.

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
PathSeparator Aplica-se a: SQL Server 2017 (14.x) e posterior.

Retorna \ no Windows e / no Linux

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

NULL = A entrada é inválida, um erro ou não aplicável.

Tipo de dados base: int
ProductBuild Aplica-se a: SQL Server 2014 (12.x) a partir de outubro de 2015.

O número de build.

Tipo de dados base: nvarchar(128)
ProductBuildType Aplica-se a: do SQL Server 2012 (11.x) até a versão atual em atualizações a partir do final de 2015.

Tipo de build do build atual.

Retorna um dos seguintes valores:

OD = versão Sob Demanda por meio de um cliente específico.

GDR = versão de distribuição geral lançada pelo Windows Update.

NULL = não aplicável.

Tipo de dados base: nvarchar(128)
ProductLevel Nível da versão da instância do SQL Server.

Retorna um dos seguintes valores:

'RTM' = Versão original

'SPn' = versão Service pack

'CTPn', = versão Community Technology Preview

Tipo de dados base: nvarchar(128)
ProductMajorVersion Aplica-se a: do SQL Server 2012 (11.x) até a versão atual em atualizações a partir do final de 2015.

A versão principal.

Tipo de dados base: nvarchar(128)
ProductMinorVersion Aplica-se a: do SQL Server 2012 (11.x) até a versão atual em atualizações a partir do final de 2015.

A versão secundária.

Tipo de dados base: nvarchar(128)
ProductUpdateLevel Aplica-se a: SQL Server 2012 (11.x) até a versão atual em atualizações a partir do final de 2015 e Instância Gerenciada de SQL do Azure.

Atualize o nível do build atual. CU indica uma atualização cumulativa.

Retorna um dos seguintes valores:

CUn = Atualização Cumulativa

NULL = não aplicável.

Tipo de dados base: nvarchar(128)
ProductUpdateReference Aplica-se a: do SQL Server 2012 (11.x) até a versão atual em atualizações a partir do final de 2015.

Artigo da Base de Dados de Conhecimento desta versão.

Tipo de dados base: nvarchar(128)
ProductUpdateType Aplica-se a: Instância Gerenciada de SQL do Azure

Atualize a cadência que a instância segue. Corresponde à política de atualização da Instância Gerenciada de SQL do Azure.

Retorna um dos seguintes valores:

CU = As atualizações são implantadas por meio de atualizações cumulativas (CUs) para a versão principal correspondente do SQL Server (política de atualização do SQL Server 2022).

Contínuo = Novos recursos são trazidos para a Instância Gerenciada de SQL do Azure assim que se tornam disponíveis, independentemente da cadência de versão do SQL Server (Política de atualização sempre atualizada).

Tipo de dados base: nvarchar(128)
ProductVersion Versão da instância do SQL Server, no formato major.minor.build.revision.

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 = A entrada é inválida ou um erro.

Tipo de dados base: nvarchar(128)
SqlCharSet A ID do conjunto de caracteres SQL da ID da ordenação.

Tipo de dados base: tinyint
SqlCharSetName O nome do conjunto de caracteres SQL da ordenação.

Tipo de dados base: nvarchar(128)
SqlSortOrder A ID da ordem de classificação SQL da ordenação

Tipo de dados base: tinyint
SqlSortOrderName O nome da ordem de classificação SQL da ordenação.

Tipo de dados base: nvarchar(128)
SuspendedDatabaseCount O número de bancos de dados suspensos no servidor.

Tipo de dados base: int

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 tiver sido alterado em relação ao nome de servidor padrão no momento da instalação, @@SERVERNAME retornará o novo nome.

A propriedade ServerName da função SERVERPROPERTY retorna o nome do servidor Windows conforme ele é salvo. Nas versões principais anteriores, ele retornava maiúsculas. Esse comportamento foi alterado novamente para maiúsculas entre o SQL Server 2019 (15.x) CU9 e CU12, mas, a partir do SQL Server 2019 (15.x) CU13, o nome do servidor retornará conforme ele foi salvo.

Se o nome do servidor do Windows contiver caracteres minúsculos, essa alteração de comportamento poderá causar diferenças entre a propriedade ServerName da função SERVERPROPERTY e @@SERVERNAME (maiúscula versus minúscula), mesmo que não haja nenhuma alteração de nome para o servidor.

Considere que você tem um servidor nomeado como server01, com uma instância de SQL Server nomeadaINST1. A tabela a seguir resume a alteração do comportamento entre diferentes builds de SQL Server 2019 (15.x):

Lançamento do SQL Server 2019 (15.x) SERVERPROPERTY('ServerName') Informações adicionais
RTM SERVER01\INST1 Retorna a propriedade ServerName em letras maiúsculas
CU 1 – CU 8 server01\INST1 Retorna a propriedade ServerName como está, sem alterar para maiúscula
CU 9 – CU 12 SERVER01\INST1 Retorna a propriedade ServerName em letras maiúsculas
CU 13 e versões posteriores server01\INST1 Retorna a propriedade ServerName como está, sem alterar para maiúscula

Propriedades de 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. Caso o aplicativo exija cadeias de caracteres de propriedade individuais, use a função SERVERPROPERTY para retorná-las, em vez de analisar os resultados de @@VERSION.

Permissões

Todos os usuários podem consultar as propriedades do servidor.

Exemplos

O exemplo a seguir usa a função SERVERPROPERTY em uma instrução SELECT para retornar informações sobre a instância atual de SQL Server.

SELECT
 SERVERPROPERTY('MachineName') AS ComputerName,
 SERVERPROPERTY('ServerName') AS InstanceName,
 SERVERPROPERTY('Edition') AS Edition,
 SERVERPROPERTY('ProductVersion') AS ProductVersion,
 SERVERPROPERTY('ProductLevel') AS ProductLevel;
GO

Para obter uma lista dos recursos compatíveis com as edições do SQL Server no Windows, consulte: