SERVERPROPERTY (Transact-SQL)
Restituisce informazioni sulle proprietà dell'istanza del server.
.gif "Icona di collegamento a un argomento")
Convenzioni della sintassi Transact-SQL
Sintassi
SERVERPROPERTY ( propertyname )
Argomenti
propertyname
Espressione che contiene le informazioni sulle proprietà da restituire per il server. I possibili valori di propertyname vengono indicati di seguito.Proprietà
Valori restituiti
BuildClrVersion
Versione di Microsoft .NET Framework Common Language Runtime (CLR) utilizzata durante la compilazione dell'istanza di SQL Server.
Tipo di dati di base: nvarchar(128)
Collation
Nome delle regole di confronto predefinite per il server.
NULL = Input non valido o errore.
Tipo di dati di base: nvarchar(128)
CollationID
ID delle regole di confronto SQL Server.
Tipo di dati di base: int
ComparisonStyle
Stile di confronto di Windows per le regole di confronto.
Tipo di dati di base: int
ComputerNamePhysicalNetBIOS
Nome NetBIOS del computer locale in cui è in esecuzione l'istanza di SQL Server.
Per un'istanza cluster di SQL Server in un cluster di failover, questo valore cambia in caso di failover dell'istanza di SQL Server su altri nodi del cluster di failover.
In un'istanza autonoma di SQL Server questo valore rimane costante e restituisce lo stesso valore della proprietà MachineName.
[!NOTA]
Se l'istanza di SQL Server è inclusa in un cluster di failover e si desidera ottenere il nome dell'istanza del cluster di failover, utilizzare la proprietà MachineName.
NULL = Input non valido o errore.
Tipo di dati di base: nvarchar(128)
Edition
Edizione del prodotto installata per l'istanza di SQL Server. Utilizzare il valore di questa proprietà per determinare le funzionalità e i limiti, ad esempio Limiti della capacità di calcolo per edizione di SQL Server. Nelle versioni a 64 bit del Motore di database viene aggiunta la dicitura (64 bit) al nome della versione stessa.
Restituisce:
'Enterprise Edition'
‘Enterprise Edition: Core-based Licensing’
'Enterprise Evaluation Edition'
'Business Intelligence Edition'
'Developer Edition'
'Express Edition'
'Express Edition with Advanced Services'
'Standard Edition'
'Web Edition'
Tipo di dati di base: nvarchar(128)
EditionID
Rappresenta l'edizione del prodotto installata per l'istanza di SQL Server. Utilizzare il valore di questa proprietà per determinare le funzionalità e i limiti, ad esempio Limiti della capacità di calcolo per edizione di SQL Server.
1804890536 = Enterprise
1872460670 = Enterprise Edition: Core-based Licensing
610778273 = Enterprise Evaluation
284895786 = Business Intelligence
-2117995310 = Developer
-1592396055 = Express
-133711905= Express with Advanced Services
-1534726760 = Standard
1293598313 = Web
Tipo di dati di base: bigint
EngineEdition
Edizione del Motore di database dell'istanza di SQL Server installata nel server.
1 = Personal o Desktop Engine: non disponibile in SQL Server 2005 e versioni successive.
2 = Standard: valore restituito per le edizioni Standard, Web e Business Intelligence.
3 = Enterprise: valore restituito per le edizioni Evaluation, Developer ed entrambe le edizioni Enterprise .
4 = Express: valore restituito per le edizioni Express, Express with Tools ed Express with Advanced Services.
5 = SQL Azure
Tipo di dati di base: int
HadrManagerStatus
Indica se Gestione Gruppi di disponibilità AlwaysOn è stata avviata.
0 = non avviata, comunicazione in sospeso.
1 = Avviata e in esecuzione.
2 = Non avviata e non riuscita.
InstanceName
Nome dell'istanza a cui è connesso l'utente.
Restituisce NULL se il nome dell'istanza corrisponde all'istanza predefinita oppure in caso di input non valido o di errore.
Tipo di dati di base: nvarchar(128)
IsClustered
L'istanza del server è configurata in un cluster di failover.
1 = Cluster.
0 = Non cluster.
NULL = Input non valido o errore.
Tipo di dati di base: int
IsFullTextInstalled
Indica se i componenti di indicizzazione full-text e semantica sono installati nell'istanza corrente di SQL Server.
1 = i componenti di indicizzazione full-text e semantica sono installati.
0 = i componenti di indicizzazione full-text e semantica non sono installati.
NULL = Input non valido o errore.
Tipo di dati di base: int
IsHadrEnabled
Gruppi di disponibilità AlwaysOn è abilitato in questa istanza del server.
0 = la funzionalità Gruppi di disponibilità AlwaysOn è disabilitata.
1 = la funzionalità Gruppi di disponibilità AlwaysOn è abilitata.
Tipo di dati di base: int
Affinché sia possibile creare ed eseguire repliche di disponibilità in un'istanza di SQL Server, Gruppi di disponibilità AlwaysOn deve essere abilitato nell'istanza del server. Per ulteriori informazioni, vedere Abilitare e disabilitare la funzionalità Gruppi di disponibilità AlwaysOn (SQL Server).
[!NOTA]
La proprietà IsHadrEnabled è relativa solo a Gruppi di disponibilità AlwaysOn. Altre funzionalità a disponibilità elevata o di ripristino di emergenza, quali il mirroring del database o il log shipping, non sono interessate da questa proprietà server.
IsIntegratedSecurityOnly
Indica se il server è in modalità di sicurezza integrata.
1 = Sicurezza integrata (autenticazione di Windows)
0 = Sicurezza integrata non attivata. Sia l'autenticazione di Windows sia l'autenticazione di SQL Server.
NULL =Input non valido o errore.
Tipo di dati di base: int
IsLocalDB
Il server è un'istanza del database locale di SQL Server Express.
IsSingleUser
Indica se nel server è attivata o meno la modalità utente singolo.
1 = Modalità utente singolo attivata.
0 = Modalità utente singolo non attivata.
NULL = Input non valido o errore.
Tipo di dati di base: int
LCID
Identificatore delle impostazioni locali (LCID) di Windows per le regole di confronto.
Tipo di dati di base: int
LicenseType
Non utilizzato. Le informazioni sulla licenza non sono mantenute o non sono gestite dal prodotto SQL Server. Restituisce sempre DISABLED.
Tipo di dati di base: nvarchar(128)
MachineName
Nome del computer Windows in cui è in esecuzione l'istanza del server.
Nel caso di un'istanza cluster, un'istanza di SQL Server eseguita in un server virtuale con Microsoft Cluster Services restituisce il nome del server virtuale.
NULL = Input non valido o errore.
Tipo di dati di base: nvarchar(128)
NumLicenses
Non utilizzato. Le informazioni sulla licenza non sono mantenute o non sono gestite dal prodotto SQL Server. Restituisce sempre NULL.
Tipo di dati di base: int
ProcessID
ID di processo del servizio SQL Server. ProcessID è utile per identificare quale istanza di Sqlservr.exe appartiene all'istanza.
NULL = Input non valido o errore.
Tipo di dati di base: int
ProductVersion
Versione dell'istanza di SQL Server nel formato "major.minor.build.revision".
Tipo di dati di base: nvarchar(128)
ProductLevel
Livello della versione dell'istanza di SQL Server.
Restituisce una delle operazioni seguenti:
'RTM' = Versione originale
'SPn' = Versione Service Pack
'CTP' = versione Community Technology Preview
Tipo di dati di base: nvarchar(128)
ResourceLastUpdateDateTime
Restituisce la data e l'ora dell'ultimo aggiornamento del database Resource.
Tipo di dati di base: datetime
ResourceVersion
Restituisce la versione del database Resource.
Tipo di dati di base: nvarchar(128)
ServerName
Informazioni relative sia al server Windows che all'istanza associate all'istanza specificata di SQL Server.
NULL = Input non valido o errore.
Tipo di dati di base: nvarchar(128)
SqlCharSet
ID del set di caratteri SQL dall'ID delle regole di confronto.
Tipo di dati di base: tinyint
SqlCharSetName
Nome del set di caratteri SQL dalle regole di confronto.
Tipo di dati di base: nvarchar(128)
SqlSortOrder
ID del tipo di ordinamento SQL dalle regole di confronto.
Tipo di dati di base: tinyint
SqlSortOrderName
Nome del tipo di ordinamento SQL dalle regole di confronto.
Tipo di dati di base: nvarchar(128)
FilestreamShareName
Nome della condivisione utilizzata da FILESTREAM.
FilestreamConfiguredLevel
Livello di accesso di FILESTREAM configurato. Per ulteriori informazioni, vedere Livello di accesso FILESTREAM.
FilestreamEffectiveLevel
Livello di accesso di FILESTREAM effettivo. Questo valore può essere diverso da quello di FilestreamConfiguredLevel se il livello è stato modificato e vi è un'operazione di riavvio dell'istanza o del computer in sospeso. Per ulteriori informazioni, vedere Livello di accesso FILESTREAM.
Tipi restituiti
sql_variant
Osservazioni
Proprietà ServerName
La proprietà ServerName della funzione SERVERPROPERTY e @@SERVERNAME restituiscono informazioni simili. La proprietà ServerName restituisce il nome del server Windows e il nome dell'istanza che insieme compongono il nome univoco dell'istanza del server. @@SERVERNAME restituisce il nome del server locale attualmente configurato.
La proprietà ServerName e @@SERVERNAME restituiscono le stesse informazioni se il nome di server impostato come predefinito al momento dell'installazione non è stato modificato. Per configurare il nome del server locale eseguire l'istruzione seguente:
EXEC sp_dropserver 'current_server_name';
GO
EXEC sp_addserver 'new_server_name', 'local';
GO
Se il nome del server locale è stato modificato rispetto al nome del server impostato come predefinito al momento dell'installazione, @@SERVERNAME restituisce il nuovo nome.
Proprietà della versione
La funzione SERVERPROPERTY restituisce singole proprietà correlate alle informazioni sulla versione, mentre la funzione @@VERSION combina l'output in una stringa. Se l'applicazione richiede stringhe delle proprietà singole, è possibile utilizzare la funzione SERVERPROPERTY per restituirle anziché analizzare i risultati di @@VERSION.
Esempi
Nell'esempio seguente viene utilizzata la funzione SERVERPROPERTY in un'istruzione SELECT per restituire informazioni sul server corrente. Ciò risulta utile quando in un server Windows sono installate più istanze di SQL Server e il client deve aprire un'altra connessione alla stessa istanza utilizzata dalla connessione corrente.
SELECT CONVERT(sysname, SERVERPROPERTY('servername'));
GO
Nell'esempio seguente viene utilizzata la funzione SERVERPROPERTY in un'istruzione SELECT per restituire informazioni sulla versione relative al prodotto.
SELECT
SERVERPROPERTY('ProductVersion') AS ProductVersion,
SERVERPROPERTY('ProductLevel') AS ProductLevel,
SERVERPROPERTY('Edition') AS Edition,
SERVERPROPERTY('EngineEdition') AS EngineEdition;
GO