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 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 LinuxTipo 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
Conteúdo relacionado
Para obter uma lista dos recursos compatíveis com as edições do SQL Server no Windows, consulte: