SERVERPROPERTY (Transact-SQL)

Restituisce informazioni sulle proprietà dell'istanza del server.

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 generazione 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 del Motore di database viene aggiunta la dicitura (64 bit) al nome della versione stessa.

    Restituisce:

    'Desktop Engine' (non disponibile per SQL Server)

    'Developer Edition'

    'Enterprise Edition'

    'Enterprise Evaluation Edition'

    'Personal Edition' (non disponibile per SQL Server)

    'Standard Edition'

    'Express Edition'

    'Express Edition with Advanced Services'

    'Workgroup Edition'

    'Windows Embedded SQL'

    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.

    -1253826760 = Desktop

    -1592396055 = Express

    -1534726760 = Standard

    1333529388 = Workgroup

    1804890536 = Enterprise

    -323382091 = Personal

    -2117995310 = Developer

    610778273 = Enterprise Evaluation

    1044790755 = Windows Embedded SQL

    4161255391 = Express with Advanced Services

    Tipo di dati di base: int

    EngineEdition

    Edizione del Motore di database dell'istanza di SQL Server installata nel server.

    1 = Personal o Desktop Engine (non disponibile per SQL Server)

    2 = Standard (valore restituito per le edizioni Standard e Workgroup)

    3 = Enterprise (valore restituito per le edizioni Enterprise, Enterprise Evaluation e Developer)

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

    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 protezione integrata.

    1 = Protezione integrata attivata.

    0 = Protezione 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

    Modalità dell'istanza corrente di SQL Server.

    PER_SEAT = Modalità Per Postazione

    PER_PROCESSOR = Modalità Per Processore

    DISABLED = Gestione licenze disabilitata.

    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

    Numero di licenze client registrate per l'istanza corrente di SQL Server, se è attiva la modalità Per Postazione.

    Numero di processori per i quali è disponibile la licenza per l'istanza corrente di SQL Server, se è attiva la modalità Per Processore.

    Restituisce NULL se nel server non è attiva alcuna delle due modalità precedenti.

    Tipo di dati di base: int

    ProcessID

    ID di 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 uno dei valori 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 di FILESTREAM.

    FilestreamEffectiveLevel

    Livello di accesso di FILESTREAM effettivo. Questo valore può essere diverso da 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 di 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

Vedere anche

Riferimento