SERVERPROPERTY (Transact-SQL)
Gibt Eigenschaftsinformationen über die Serverinstanz zurück.
Syntax
SERVERPROPERTY ( propertyname )
Argumente
propertyname
Ein Ausdruck, der die für den Server zurückzugebenden Eigenschafteninformationen enthält. Für propertyname sind folgende Werte möglich.Eigenschaft
Zurückgegebene Werte
BuildClrVersion
Version der Common Language Runtime (CLR) von Microsoft.NET Framework, die beim Erstellen der Instanz von SQL Server verwendet wurde.
Basisdatentyp: nvarchar(128)
Collation
Der Name der Standardsortierung für den Server.
NULL = Eingabe ist ungültig oder ein Fehler.
Basisdatentyp: nvarchar(128)
CollationID
ID der SQL Server-Sortierung.
Basisdatentyp: int
ComparisonStyle
Die Windows-Vergleichsart der Sortierung.
Basisdatentyp: int
ComputerNamePhysicalNetBIOS
NetBIOS-Name des lokalen Computers, auf dem die Instanz von SQL Server derzeit ausgeführt wird.
Für eine gruppierte Instanz von SQL Server in einem Failovercluster ändert sich dieser Wert, wenn für die Instanz von SQL Server ein Failover zu anderen Knoten im Failovercluster ausgeführt wird.
Bei einer eigenständigen Instanz von SQL Server bleibt dieser Wert konstant und gibt denselben Wert zurück wie die MachineName-Eigenschaft.
Hinweis
Wenn sich die Instanz von SQL Server in einem Failovercluster befindet und der Name der Failoverclusterinstanz abgerufen werden soll, verwenden Sie die MachineName-Eigenschaft.NULL = Eingabe ist ungültig oder ein Fehler.
Basisdatentyp: nvarchar(128)
Edition
Installierte Produktedition der Instanz von SQL Server. Verwenden Sie den Wert dieser Eigenschaft, um die Features und Beschränkungen zu ermitteln, wie z. B. die maximale Anzahl der CPUs, die vom installierten Produkt unterstützt werden. 64-Bit-Versionen von Database Engine (Datenbankmodul) fügen "(64-Bit)" an die Version an.
Rückgabewerte:
'Desktop Engine' (Nicht verfügbar für SQL Server)
'Developer Edition'
'Enterprise Edition'
'Enterprise Evaluation Edition'
'Personal Edition' (Nicht verfügbar für SQL Server)
'Standard Edition'
'Express Edition'
'Express Edition with Advanced Services'
'Workgroup Edition'
'Windows Embedded SQL'
Basisdatentyp: nvarchar(128)
EditionID
Eine ID, die die installierte Produktedition der Instanz von SQL Server darstellt. Verwenden Sie den Wert dieser Eigenschaft, um Features und Beschränkungen zu ermitteln, wie z. B. die maximale Anzahl von CPUs, die vom installierten Produkt unterstützt wird.
-1253826760 = Desktop
-1592396055 = Express
-1534726760 = Standard
1333529388 = Workgroup
1804890536 = Enterprise
-323382091 = Persönlich
-2117995310 = Developer
610778273 = Enterprise (Evaluation)
1044790755 = Windows Embedded SQL
4161255391 = Express with Advanced Services
Basisdatentyp: int
EngineEdition
Database Engine (Datenbankmodul) Edition der Instanz von SQL Server, die auf dem Server installiert ist.
1 = Personal Edition oder Desktop Engine (Nicht verfügbar für SQL Server)
2 = Standard (Rückgabewert für Standard Edition und Workgroup Edition)
3 = Enterprise (Rückgabewert für Enterprise, Enterprise Evaluation und Developer)
4 = Express (Rückgabewert für Express, Express with Advanced Services sowie Windows Embedded SQL)
Basisdatentyp: int
InstanceName
Der Name der Instanz, mit der der Benutzer verbunden ist.
Wenn der Instanzname der Standardinstanz entspricht, die Eingabe ungültig ist oder ein Fehler auftritt, wird NULL zurückgegeben.
Basisdatentyp: nvarchar(128)
IsClustered
Die Serverinstanz ist als Teil eines Failoverclusters konfiguriert.
1 = In einem Cluster gruppiert.
0 = Nicht in einem Cluster gruppiert.
NULL = Eingabe ist ungültig oder ein Fehler.
Basisdatentyp: int
IsFullTextInstalled
Gibt an, ob die Volltextkomponente mit der aktuellen Instanz von SQL Server installiert ist.
1 = Volltext ist installiert.
0 = Volltext ist nicht installiert.
NULL = Eingabe ist ungültig oder ein Fehler.
Basisdatentyp: int
IsIntegratedSecurityOnly
Gibt an, ob der Server sich im integrierten Sicherheitsmodus befindet.
1 = Integrierte Sicherheit.
0 = Keine integrierte Sicherheit.
NULL = Eingabe ist ungültig oder ein Fehler.
Basisdatentyp: int
IsSingleUser
Gibt an, ob der Server sich im Einzelbenutzermodus befindet.
1 = Einzelbenutzermodus.
0 = Kein Einzelbenutzermodus
NULL = Eingabe ist ungültig oder ein Fehler.
Basisdatentyp: int
LCID
Windows-Gebietsschemabezeichner (LCID, Locale Identifier) der Sortierung.
Basisdatentyp: int
LicenseType
Modus dieser Instanz von SQL Server.
PER_SEAT = Pro-Arbeitsplatz-Modus
PER_PROCESSOR = Pro-Prozessor-Modus
DISABLED = Lizenzierung ist deaktiviert.
Basisdatentyp: nvarchar(128)
MachineName
Der Name des Windows-Computers, auf dem die Serverinstanz ausgeführt wird.
Für eine Clusterinstanz, d. h. eine Instanz von SQL Server, die auf einem virtuellen Server unter Microsoft Clusterdienste ausgeführt wird, wird der Name des virtuellen Servers zurückgegeben.
NULL = Eingabe ist ungültig oder ein Fehler.
Basisdatentyp: nvarchar(128)
NumLicenses
Anzahl der Clientlizenzen, die für diese Instanz von SQL Server registriert sind, wenn der Pro-Arbeitsplatz-Modus aktiviert ist.
Anzahl der Prozessoren, die für diese Instanz von SQL Server lizenziert sind, wenn der Pro-Prozessor-Modus aktiviert ist.
Gibt NULL zurück, wenn sich der Server in keinem dieser Modi befindet.
Basisdatentyp: int
ProcessID
Prozess-ID des SQL Server-Diensts. ProcessID ist nützlich, um die zu dieser Instanz gehörende Datei Sqlservr.exe zu identifizieren.
NULL = Eingabe ist ungültig oder ein Fehler.
Basisdatentyp: int
ProductVersion
Version der Instanz von SQL Server im Format 'major.minor.build'.
Basisdatentyp: nvarchar(128)
ProductLevel
Ebene der Version der Instanz von SQL Server.
Gibt einen der folgenden Werte zurück:
'RTM' = Ursprüngliche Version
'SPn' = Service Pack-Version
'CTP', = Community Technology Preview-Version
Basisdatentyp: nvarchar(128)
ResourceLastUpdateDateTime
Gibt das Datum und die Zeit der letzten Aktualisierung der Ressourcendatenbank zurück.
Basisdatentyp: datetime
ResourceVersion
Gibt die Version der Ressourcendatenbank zurück.
Basisdatentyp: nvarchar(128)
ServerName
Einer angegebenen Instanz von SQL Server zugeordnete Informationen zum Windows-Server und zur Instanz.
NULL = Eingabe ist ungültig oder ein Fehler.
Basisdatentyp: nvarchar(128)
SqlCharSet
Die ID des SQL-Zeichensatzes aus der Sortierungs-ID.
Basisdatentyp: tinyint
SqlCharSetName
Der Name des SQL-Zeichensatzes aus der Sortierung.
Basisdatentyp: nvarchar(128)
SqlSortOrder
Die ID der SQL-Sortierreihenfolge aus der Sortierung.
Basisdatentyp: tinyint
SqlSortOrderName
Der Name der SQL-Sortierreihenfolge aus der Sortierung.
Basisdatentyp: nvarchar(128)
FilestreamShareName
Der Name der von FILESTREAM verwendeten Freigabe.
FilestreamConfiguredLevel
Die konfigurierte FILESTREAM-Zugriffsebene. Weitere Informationen finden Sie unter FILESTREAM-Zugriffsebene.
FilestreamEffectiveLevel
Die effektive FILESTREAM-Zugriffsebene. Dieser Wert kann sich von FilestreamConfiguredLevel unterscheiden, wenn die Ebene geändert wurde und ein Neustart der Instanz oder des Computers aussteht. Weitere Informationen finden Sie unter FILESTREAM-Zugriffsebene.
Rückgabetypen
sql_variant
Hinweise
ServerName-Eigenschaft
Die ServerName-Eigenschaft der SERVERPROPERTY-Funktion und @@SERVERNAME geben ähnliche Informationen zurück. Die ServerName-Eigenschaft stellt den Namen des Windows-Servers und den Instanznamen bereit, die zusammen die eindeutige Serverinstanz bezeichnen. @@SERVERNAME stellt den aktuell konfigurierten lokalen Servernamen bereit.
Die ServerName-Eigenschaft und @@SERVERNAME geben dieselben Informationen zurück, wenn der zur Installationszeit gültige Standardservername nicht geändert wurde. Der lokale Servername kann durch Ausführen der folgenden Anweisung konfiguriert werden:
EXEC sp_dropserver 'current_server_name';
GO
EXEC sp_addserver 'new_server_name', 'local';
GO
Wenn der lokale Servername gegenüber dem zur Installationszeit gültigen Standardservernamen geändert wurde, gibt @@SERVERNAME den neuen Namen zurück.
Versionseigenschaften
Die SERVERPROPERTY-Funktion gibt die einzelnen, sich auf Versionsinformationen beziehenden Eigenschaften zurück, während die Funktion @@VERSION die Ausgabe in einer Zeichenfolge kombiniert. Wenn Ihre Anwendung einzelne Eigenschaftszeichenfolgen benötigt, können Sie diese mithilfe der SERVERPROPERTY-Funktion zurückgeben, anstatt die @@VERSION-Ergebnisse zu analysieren.
Beispiele
Das folgende Beispiel verwendet die SERVERPROPERTY -Funktion in einer SELECT-Anweisung, um Informationen zum aktuellen Server zurückzugeben. Dieses Szenario ist nützlich, wenn auf einem Windows-Server mehrere Instanzen von SQL Server installiert sind und der Client eine weitere Verbindung mit der Instanz herstellen muss, die auch von der aktuellen Verbindung verwendet wird.
SELECT CONVERT(sysname, SERVERPROPERTY('servername'));
GO
Das folgende Beispiel verwendet die SERVERPROPERTY-Funktion in einer SELECT-Anweisung, um Versionsinformationen zum Produkt zurückzugeben.
SELECT
SERVERPROPERTY('ProductVersion') AS ProductVersion,
SERVERPROPERTY('ProductLevel') AS ProductLevel,
SERVERPROPERTY('Edition') AS Edition,
SERVERPROPERTY('EngineEdition') AS EngineEdition;
GO