• Articolo

SERVERPROPERTY (Transact-SQL)

Restituisce informazioni sulle proprietà dell'istanza del server in SQL Server 2008 R2.

Icona di collegamento a un argomentoConvenzioni della sintassi Transact-SQL

Sintassi

SERVERPROPERTY ( propertyname )

Argomenti

  • propertyname
    Espressione contenente le informazioni sulle proprietà da restituire per il server. I possibili valori di propertyname sono i seguenti.

    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.

    NotaNota
    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, come il numero massimo di CPU, supportati dal prodotto installato. Nelle versioni a 64 bit di Motore di database viene aggiunta la dicitura (64 bit) al nome della versione stessa.

    Restituisce:

    'Data Center Edition'

    'Desktop Engine': non disponibile per SQL Server 2005 e versioni successive.

    'Developer Edition'

    'Enterprise Edition'

    'Enterprise Evaluation Edition'

    'Express Edition'

    'Express Edition with Advanced Services'

    'Personal Edition': non disponibile per SQL Server 2005 e versioni successive.

    'Small Business Server Edition'

    'Standard Edition'

    'Web Edition'

    'Windows Embedded SQL'

    'Workgroup Edition'

    Tipo di dati di base: nvarchar(128)

    EditionID

    Numero di identificazione che 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, come il numero massimo di CPU, supportati dal prodotto installato.

    -978676123 = Data Center

    -1253826760 = Desktop

    -2117995310 = Developer

    -1592396055 = Express

    1804890536 = Enterprise

    610778273 = Enterprise Evaluation

    -133711905 = Express with Advanced Services

    -323382091 = Personal

    -1960233010 = Small Business Server

    -1534726760 = Standard

    1293598313 = Web

    -3250176541 = Windows Embedded SQL

    1333529388 = Workgroup

    Tipo di dati di base: bigint

    EngineEdition

    Edizione di 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, Small Business Server, Web e Workgroup.

    3 = Enterprise: valore restituito per le edizioni Enterprise, Enterprise Evaluation, Data Center e Developer.

    4 = Express: valore restituito per le edizioni Express, Express with Advanced Services e Windows Embedded SQL.

    5 = SQL Azure

    Tipo di dati di base: int

    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 il componente full-text è installato o meno nell'istanza corrente di SQL Server.

    1 = Il componente full-text è installato.

    0 = Il componente full-text non è installato.

    NULL = Input non valido o errore.

    Tipo di dati di base: int

    IsIntegratedSecurityOnly

    Indica se nel server è attivata o meno la modalità di sicurezza integrata.

    1 = Sicurezza integrata attivata.

    0 = Sicurezza integrata non attivata.

    NULL = Input non valido o errore.

    Tipo di dati di base: int

    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 vengono mantenute o gestite dal prodotto SQL Server. Viene sempre restituito 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 vengono mantenute o gestite dal prodotto SQL Server. Viene sempre restituito NULL.

    Tipo di dati di base: int

    ProcessID

    ID processo del servizio SQL Server. ProcessID è utile per identificare quale 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".

    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 Opzione filestream access level.

    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 Opzione filestream access level.

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