Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Aplica-se a:
SQL ServerBanco de Dados SQL do AzureInstância Gerenciada de SQL do AzureAzure Synapse AnalyticsAnalytics Platform System (PDW)Ponto de extremidade de análise de SQL no Microsoft FabricDepósito no Microsoft FabricBanco de dados SQL no Microsoft Fabric
Retorna informações de propriedade sobre a instância de servidor.
Convenções de sintaxe de Transact-SQL
Note
O Microsoft Entra ID era conhecido como Azure Active Directory (Azure AD).
Syntax
SERVERPROPERTY ( 'propertyname' )
Important
Os números de versão do Mecanismo de Banco de Dados para o SQL Server e o Banco de Dados SQL do Azure e o Microsoft Fabric não são comparáveis uns com os outros 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.
Arguments
propertyname
Uma expressão que contém as informações de propriedade que serão retornadas para o servidor.
propertyname pode ser um dos seguintes valores. O uso de um nome de propriedade inválido ou sem suporte nessa versão do Mecanismo de Banco de Dados retorna NULL.
| Property | 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 não é vá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 não é vá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 que a MachineName propriedade.Nota: Se a instância do SQL Server estiver em um cluster de failover e você quiser obter o nome da instância clusterizado de failover, use a MachineName propriedade.NULL = A entrada não é vá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. Use a tabela Edição a seguir para identificar possíveis valores. Tipo de dados base: nvarchar(128) |
EditionID |
Representa a ID da edição do produto instalada 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. Use a tabela Edição a seguir para identificar possíveis valores. 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, Standard Developer, Web e Business Intelligence.) 3 = Enterprise (para edições Enterprise, Enterprise Developer, Developer e Evaluation.) 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 ou Microsoft Fabric 12 = Banco de dados SQL do Microsoft Fabric no Microsoft Fabric. 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 está habilitado para acesso Transact-SQL 2 = FILESTREAM está habilitado para acesso via streaming Transact-SQL e Win32 local 3 = FILESTREAM está habilitado para Transact-SQL e acesso de streaming local e remoto do Win32. 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 está habilitado para acesso Transact-SQL 2 = FILESTREAM está habilitado para acesso via streaming Transact-SQL e Win32 local 3 = FILESTREAM está habilitado para Transact-SQL e acesso de streaming local e remoto do Win32. Tipo de dados base: int |
FilestreamShareName |
O nome do compartilhamento usado por FILESTREAM. NULL = A entrada não é válida, um erro ou não é aplicável. Tipo de dados base: nvarchar(128) |
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. NULL = A entrada não é válida, um erro ou não é aplicável. Tipo de dados base: int |
InstanceDefaultBackupPath |
Nome do caminho padrão para os arquivos de backup da instância. Aplica-se a: SQL Server 2019 (15.x) e versões posteriores. Tipo de dados base: nvarchar(128) |
InstanceDefaultDataPath |
Nome do caminho padrão para os arquivos de dados da instância. Aplica-se a: SQL Server. Tipo de dados base: nvarchar(128) |
InstanceDefaultLogPath |
Nome do caminho padrão para os arquivos de log da instância. Aplica-se a: SQL Server. Tipo de dados base: nvarchar(128) |
InstanceName |
Nome da instância à qual o usuário está conectado. Retornará NULL se o nome da instância for a instância padrão, se a entrada não for válida ou se houver erro.NULL = A entrada não é vá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 não é válida, um erro ou não é aplicável. Tipo de dados base: int |
IsExternalAuthenticationOnly |
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. Aplica-se a: Banco de Dados SQL do Azure e Instância Gerenciada de SQL do Azure. Tipo de dados base: int |
IsExternalGovernanceEnabled |
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. Aplica-se a: SQL Server 2022 (16.x) e versões posteriores. 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 não é válida, um erro ou não é aplicável. 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. NULL = A entrada não é válida, um erro ou não é aplicável. 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 ou desabilitar o recurso de grupo de disponibilidade Always On. Nota: A IsHadrEnabled propriedade pertence somente aos grupos de disponibilidade Always On. 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.Aplica-se a: SQL Server. Tipo de dados base: int |
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 não é válida, um erro ou não é aplicável. Tipo de dados base: int |
IsLocalDB |
O servidor é uma instância do SQL Server Express LocalDB. NULL = A entrada não é válida, um erro ou não é aplicável. Aplica-se a: SQL Server. Tipo de dados base: int |
IsPolyBaseInstalled |
Retorna se a instância do servidor tem o recurso PolyBase instalado. 0 = o PolyBase não está instalado. 1 = o PolyBase está instalado. Aplica-se a: SQL Server 2016 (13.x) e versões posteriores. 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 não é válida, um erro ou não é aplicável. Tipo de dados base: int |
IsTempDbMetadataMemoryOptimized |
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.Aplica-se a: SQL Server 2019 (15.x) e versões posteriores. Tipo de dados base: int |
IsXTPSupported |
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 não é válida, um erro ou não é aplicável. Aplica-se a: SQL Server 2014 (12.x) e versões posteriores e Banco de Dados SQL do Azure. Tipo de dados base: int |
LCID |
LCID (Identificador de localidade do Windows) da ordenação. Tipo de dados base: int |
LicenseType |
Unused. 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 não é válida, um erro ou não é aplicável. Tipo de dados base: nvarchar(128) |
NumLicenses |
Unused. 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 |
Retorna \ no Windows e / no LinuxAplica-se a: SQL Server 2017 (14.x) e versões posteriores. 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 não é válida, um erro ou não é aplicável. Tipo de dados base: int |
ProductBuild |
O número de build. Aplica-se a: SQL Server 2014 (12.x) e versões posteriores. Tipo de dados base: nvarchar(128) |
ProductBuildType |
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. Aplica-se a: SQL Server. 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 da Visualização da Tecnologia da Comunidade. Tipo de dados base: nvarchar(128) |
ProductMajorVersion |
A versão principal. Aplica-se a: SQL Server. Tipo de dados base: nvarchar(128) |
ProductMinorVersion |
A versão secundária. Aplica-se a: SQL Server. Tipo de dados base: nvarchar(128) |
ProductUpdateLevel |
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. Aplica-se a: SQL Server e Instância Gerenciada de SQL do Azure. Tipo de dados base: nvarchar(128) |
ProductUpdateReference |
Artigo da Base de Dados de Conhecimento desta versão. Aplica-se a: SQL Server. Tipo de dados base: nvarchar(128) |
ProductUpdateType |
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 estão disponíveis, independentemente da cadência de versão do SQL Server (política de atualização always-up-to-date ). Aplica-se a: Instância Gerenciada de SQL do Azure. 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 Windows e da instância associadas a uma instância especificada. NULL = A entrada não é vá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 do 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 |
A tabela a seguir lista os valores possíveis para EditionID e Edition.
| EditionID | Edition |
|---|---|
1804890536 |
Enterprise |
1872460670 |
Enterprise Edition: Licenciamento baseado em núcleo |
610778273 |
Avaliação da empresa |
284895786 |
Business Intelligence |
-2117995310 |
Desenvolvedor 1 ou Desenvolvedor Enterprise 2 |
-2509700633 |
Desenvolvedor Standard 2 |
-1592396055 |
Expresso |
-133711905 |
Expresso com Serviços Avançados |
-1534726760 |
Standard |
1293598313 |
Web 1 |
1674378470 |
Banco de Dados SQL ou Azure Synapse Analytics |
-1461570097 |
Desenvolvedor do SQL do Azure no Edge 3 |
1994083197 |
SQL do Azure no Edge 4 |
1Aplica-se a: SQL Server 2022 (16.x) e versões anteriores.
2Aplica-se a: SQL Server 2025 (17.x) e versões posteriores.
3 Indica a edição somente de desenvolvimento para o SQL do Azure no Edge.
4 Indica a edição paga para o SQL do Azure no Edge.
Tipos de retorno
sql_variant
Remarks
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:
EXECUTE sp_dropserver 'current_server_name';
GO
EXECUTE 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 retornou em letras 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 Windows contiver caracteres minúsculos, essa alteração de comportamento poderá causar diferenças entre a ServerName propriedade da SERVERPROPERTY função e @@SERVERNAME (maiúsculas versus minúsculas), 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 |
| 1 – 8 | server01\INST1 |
Retorna a propriedade ServerName como está, sem alterar para maiúscula |
| 9 – 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.
Permissions
Todos os usuários podem consultar as propriedades do servidor.
Examples
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