Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Aplica-se a:
SQL ServerBase de Dados SQL do AzureInstância Gerida do Azure SQLAzure Synapse AnalyticsSistema de Plataforma de Análise (PDW)Ponto de Extremidade de Análise SQL no Microsoft FabricArmazém no Microsoft FabricBase de Dados SQL no Microsoft Fabric
Retorna informações de propriedade sobre a instância do servidor.
Transact-SQL convenções de sintaxe
Note
O Microsoft Entra ID era conhecido anteriormente como Azure Ative Directory (Azure AD).
Syntax
SERVERPROPERTY ( 'propertyname' )
Important
Os números de versão do Mecanismo de Banco de Dados do SQL Server e do Banco de Dados SQL do Azure e do Microsoft Fabric não são comparáveis entre si e representam números de compilação internos para esses produtos separados. O Motor de Base de Dados da Base de Dados SQL do Azure baseia-se na mesma base de código que o Motor de Base de Dados do SQL Server. O mais importante, o Motor de Base de Dados na Base de Dados SQL do Azure possui sempre os bits do Motor de Base de Dados SQL mais recentes. Por exemplo, a versão 12 da Base 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 a serem 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 Microsoft .NET Framework Common Language Runtime (CLR) 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 de base: nvarchar(128) |
Collation |
Nome do agrupamento padrão para o servidor. NULL = A entrada não é válida ou é um erro. Tipo de dados de base: nvarchar(128) |
CollationID |
ID do agrupamento do SQL Server. Tipo de dados de base: int |
ComparisonStyle |
Estilo de comparação do Windows do agrupamento. Tipo de dados de base: int |
ComputerNamePhysicalNetBIOS |
Nome NetBIOS do computador local no qual a instância do SQL Server está sendo executada no momento. Para uma instância clusterizada do SQL Server em um cluster de failover, esse valor muda à medida que a instância do SQL Server realiza failover para 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.Observação: Se a instância do SQL Server estiver em um cluster de failover e você quiser obter o nome da instância clusterizada de failover, use a MachineName propriedade.NULL = A entrada não é válida, um erro ou não é aplicável. Tipo de dados de base: nvarchar(128) |
Edition |
Instalada a edição do produto da instância do SQL Server. Use o valor dessa propriedade para determinar os recursos e os limites, como Limites de capacidade de computação por edição do SQL Server. As versões de 64 bits do Mecanismo de Banco de Dados acrescentam (64 bits) à versão. Use a tabela Edition a seguir para identificar valores possíveis. Tipo de dados de 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 Limites de capacidade de computação por edição do SQL Server. Use a tabela Edition a seguir para identificar valores possíveis. Tipo de dados de 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 versões posteriores.) 2 = Standard (para desenvolvedor padrão, desenvolvedor padrão, Web e business intelligence.) 3 = Enterprise (para as edições Enterprise, Enterprise Developer, Developer e Evaluation.) 4 = Express (Para Express, Express com Ferramentas e Express com Advanced Services) 5 = Banco de dados SQL 6 = Azure Synapse Analytics 8 = Instância Gerenciada SQL do Azure 9 = Azure SQL Edge (Para todas as edições do Azure SQL Edge) 11 = pool SQL sem servidor do Azure Synapse ou Microsoft Fabric 12 = Base de dados SQL Microsoft Fabric no Microsoft Fabric. Tipo de dados de base: int |
FilestreamConfiguredLevel |
O nível configurado de acesso FILESTREAM. Para obter mais informações, consulte nível de acesso de fluxo de arquivos. 0 = FILESTREAM está desativado 1 = FILESTREAM está ativado para acesso Transact-SQL 2 = FILESTREAM está habilitado para acesso de streaming Win32 Transact-SQL e local 3 = FILESTREAM está habilitado para acesso de streaming Win32 Transact-SQL e local e remoto. Tipo de dados de base: int |
FilestreamEffectiveLevel |
O nível efetivo de acesso FILESTREAM. Esse valor pode ser diferente do FilestreamConfiguredLevel se o nível tiver sido alterado e uma reinicialização da instância ou do computador estiver pendente. Para obter mais informações, consulte nível de acesso de fluxo de arquivos. 0 = FILESTREAM está desativado 1 = FILESTREAM está ativado para acesso Transact-SQL 2 = FILESTREAM está habilitado para acesso de streaming Win32 Transact-SQL e local 3 = FILESTREAM está habilitado para acesso de streaming Win32 Transact-SQL e local e remoto. Tipo de dados de 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 de base: nvarchar(128) |
HadrManagerStatus |
Indica se o gerenciador de grupos de disponibilidade Always On foi iniciado. 0 = Não iniciado, pendente de comunicação. 1 = Iniciado e em execução. 2 = Não iniciado e falhou. NULL = A entrada não é válida, um erro ou não é aplicável. Tipo de dados de 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 de 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 de 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 de base: nvarchar(128) |
InstanceName |
Nome da instância à qual o usuário está conectado. Retorna 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 de base: nvarchar(128) |
IsAdvancedAnalyticsInstalled |
Devolve 1 se a funcionalidade Advanced Analytics tiver sido instalada durante a configuração; 0 se o Advanced Analytics não tiver sido instalado. Tipo de dados de base: int |
IsBigDataCluster |
Introduzido no SQL Server 2019 (15.x) começando com 4. Retorna 1 se a instância for SQL Server Big Data Cluster; 0 se não. Tipo de dados de base: int |
IsClustered |
A instância do servidor é configurada em um cluster de failover. 1 = Agrupado. 0 = Não agrupado. NULL = A entrada não é válida, um erro ou não é aplicável. Tipo de dados de base: int |
IsExternalAuthenticationOnly |
Retorna se a autenticação somente Microsoft Entra, está habilitada. 1 = A autenticação somente Microsoft Entra-está habilitada. 0 = A autenticação somente Microsoft Entra-está desabilitada. Aplica-se a: Banco de Dados SQL do Azure e Instância Gerenciada SQL do Azure. Tipo de dados de base: int |
IsExternalGovernanceEnabled |
Retorna se as políticas de acesso do Microsoft Purview estão habilitadas. 1 = A governação externa está ativada. 0 = A governação externa está desativada. Aplica-se a: SQL Server 2022 (16.x) e versões posteriores. Tipo de dados de base: int |
IsFullTextInstalled |
Os componentes de indexação semântica e de texto completo são instalados na instância atual do SQL Server. 1 = Os componentes de indexação semântica e de texto completo estão instalados. 0 = Os componentes de indexação semântica e de texto completo não estão instalados. NULL = A entrada não é válida, um erro ou não é aplicável. Tipo de dados de base: int |
IsHadrEnabled |
Os grupos de disponibilidade Always On estão habilitados nesta instância do servidor. 0 = O recurso Grupos de disponibilidade Always On está desativado. 1 = O recurso de grupos de disponibilidade Always On está habilitado. NULL = A entrada não é válida, um erro ou não é aplicável. Para que as réplicas de disponibilidade sejam criadas e executadas em uma instância do SQL Server, os grupos de disponibilidade Always On devem ser habilitados na instância do servidor. Para obter mais informações, consulte Habilitar ou desabilitar o recurso de grupo de disponibilidade Always On. Observação: A IsHadrEnabled propriedade pertence apenas a grupos de disponibilidade Always On. Outros recursos de alta disponibilidade ou recuperação de desastres, 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 de base: int |
IsIntegratedSecurityOnly |
O servidor está no 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 de base: int |
IsLocalDB |
Server é 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 de 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 de base: int |
IsServerSuspendedForSnapshotBackup |
O servidor está em modo de suspensão e requer descongelamento no nível do servidor. 1 = Suspenso. 0 = Não suspenso. Tipo de dados de base: int |
IsSingleUser |
O servidor está no modo de usuário único. 1 = Utilizador único. 0 = Não utilizador único NULL = A entrada não é válida, um erro ou não é aplicável. Tipo de dados de base: int |
IsTempDbMetadataMemoryOptimized |
Retorna 1 se tempdb tiver sido habilitado para usar tabelas com otimização de memória para metadados; 0 se tempdb estiver usando tabelas regulares baseadas em disco para metadados. Para obter mais informações, consulte Banco de dados tempdb.Aplica-se a: SQL Server 2019 (15.x) e versões posteriores. Tipo de dados de base: int |
IsXTPSupported |
O servidor suporta In-Memory OLTP. 1 = O servidor suporta In-Memory OLTP. 0 = O servidor não suporta In-Memory OLTP. 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 de base: int |
LCID |
LCID (identificador de localidade do Windows) do agrupamento. Tipo de dados de 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 de base: nvarchar(128) |
MachineName |
Nome do computador Windows no qual a instância do 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, ela retorna o nome do servidor virtual. NULL = A entrada não é válida, um erro ou não é aplicável. Tipo de dados de 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 de base: int |
PathSeparator |
Devoluções \ 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 de base: int |
ProductBuild |
O número da compilação. Aplica-se a: SQL Server 2014 (12.x) e versões posteriores. Tipo de dados de base: nvarchar(128) |
ProductBuildType |
Tipo de compilação da compilação atual. Devolve um dos seguintes valores: OD = Liberação sob demanda de um cliente específico. GDR = Versão de Distribuição Geral lançada através do Windows Update. NULL = Não aplicável. Aplica-se a: SQL Server. Tipo de dados de base: nvarchar(128) |
ProductLevel |
Nível da versão da instância do SQL Server. Devolve um dos seguintes valores: 'RTM' = Versão original 'SPn' = Versão do Service Pack 'CTPn', = versão Community Technology Preview. Tipo de dados de base: nvarchar(128) |
ProductMajorVersion |
A versão principal. Aplica-se a: SQL Server. Tipo de dados de base: nvarchar(128) |
ProductMinorVersion |
A versão secundária. Aplica-se a: SQL Server. Tipo de dados de base: nvarchar(128) |
ProductUpdateLevel |
Nível de atualização da compilação atual. indica uma atualização cumulativa. Devolve um dos seguintes valores: n = Atualização cumulativa NULL = Não aplicável. Aplica-se a: SQL Server e Instância Gerenciada SQL do Azure. Tipo de dados de base: nvarchar(128) |
ProductUpdateReference |
Artigo da Base de Dados de Conhecimento para essa versão. Aplica-se a: SQL Server. Tipo de dados de base: nvarchar(128) |
ProductUpdateType |
Atualize a cadência da instância a seguir. Corresponde à política de atualização da Instância Gerenciada SQL do Azure . Devolve um dos seguintes valores: = As atualizações são implantadas por meio de atualizações cumulativas (CUs) para a versão principal correspondente do SQL Server (SQL Server 2022 política de atualização). Contínuo = Novos recursos são trazidos para a Instância Gerenciada SQL do Azure assim que estiverem disponíveis, independentemente da cadência de lançamento do SQL Server (política de atualização de dataup-tosempre ). Aplica-se a: Instância Gerenciada SQL do Azure. Tipo de dados de base: nvarchar(128) |
ProductVersion |
Versão da instância do SQL Server, na forma de major.minor.build.revision. Tipo de dados de base: nvarchar(128) |
ResourceLastUpdateDateTime |
Retorna a data e a hora em que o banco de dados de Recursos foi atualizado pela última vez. Tipo de dados base: datetime |
ResourceVersion |
Retorna a versão Banco de dados de recursos. Tipo de dados de 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 de base: nvarchar(128) |
SqlCharSet |
A ID do conjunto de caracteres SQL da ID de agrupamento. Tipo de dados base: tinyint |
SqlCharSetName |
O nome do conjunto de caracteres SQL do agrupamento. Tipo de dados de base: nvarchar(128) |
SqlSortOrder |
A 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 de base: nvarchar(128) |
SuspendedDatabaseCount |
O número de bancos de dados suspensos no servidor. Tipo de dados de 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 Empresarial |
284895786 |
Inteligência de Negócios |
-2117995310 |
Desenvolvedor 1 ou Developer Enterprise 2 |
-2509700633 |
Padrão do desenvolvedor 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 |
Azure SQL Edge Developer 3 |
1994083197 |
Azure SQL 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 Azure SQL Edge.
4 Indica a edição paga para o Azure SQL Edge.
Tipos de devolução
sql_variant
Remarks
Propriedade ServerName
A ServerName propriedade da função e SERVERPROPERTY retornar informações semelhantes. A ServerName propriedade fornece o servidor 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 ServerName propriedade e @@SERVERNAME retornam as mesmas informações se o nome do servidor padrão, no momento da instalação, não tiver sido alterado. O nome do 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 do nome do servidor padrão no momento da instalação, @@SERVERNAME retornará o novo nome.
A ServerName propriedade da função retorna o nome do SERVERPROPERTY servidor Windows à medida que é salvo. Nas versões principais anteriores, ele retornava em maiúsculas. Esse comportamento mudou de volta para maiúsculas entre o SQL Server 2019 (15.x) 9 e 12, mas a partir do SQL Server 2019 (15.x) 13, o nome do servidor retorna conforme é salvo.
Se o nome do servidor Windows contiver caracteres minúsculos, essa alteração de comportamento poderá causar diferenças entre a propriedade da função e ServerName (maiúsculas SERVERPROPERTY versus minúsculas), mesmo que não haja alteração de nome para o servidor.
Considere que você tem um servidor nomeado como server01, com uma instância do SQL Server chamada INST1. A tabela a seguir resume a mudança de comportamento entre diferentes compilações do SQL Server 2019 (15.x):
| Versão do SQL Server 2019 (15.x) | SERVERPROPERTY('ServerName') | Informações adicionais |
|---|---|---|
| RTM | SERVER01\INST1 |
Devolve a propriedade em maiúsculas ServerName |
| 1 – 8 | server01\INST1 |
Retorna a propriedade como está, sem alterar para maiúsculas ServerName |
| 9 – 12 | SERVER01\INST1 |
Devolve a propriedade em maiúsculas ServerName |
| 13 e versões posteriores | server01\INST1 |
Devolve a propriedade as-is, sem alterar para maiúsculas ServerName |
Propriedades da versão
A SERVERPROPERTY função retorna propriedades individuais que se relacionam com as informações de versão, enquanto a função @@VERSION combina a saída em uma cadeia de caracteres. Se seu aplicativo requer cadeias de caracteres de propriedade individuais, você pode usar a SERVERPROPERTY função para retorná-las em vez de analisar os resultados @@VERSION .
Permissions
Todos os usuários podem consultar as propriedades do servidor.
Examples
O exemplo a seguir usa a SERVERPROPERTY função em uma SELECT instrução para retornar informações sobre a instância atual do SQL Server.
SELECT SERVERPROPERTY('MachineName') AS ComputerName,
SERVERPROPERTY('ServerName') AS InstanceName,
SERVERPROPERTY('Edition') AS Edition,
SERVERPROPERTY('ProductVersion') AS ProductVersion,
SERVERPROPERTY('ProductLevel') AS ProductLevel;
GO