SERVERPROPERTY (Transact-SQL)

  • Artikel

Gilt für:SQL ServerAzure SQL-DatenbankAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

Gibt Eigenschaftsinformationen über die Serverinstanz zurück.

Transact-SQL-Syntaxkonventionen

Hinweis

Microsoft Entra-ID wurde zuvor als Azure Active Directory (Azure AD) bezeichnet.

Syntax

SERVERPROPERTY ( 'propertyname' )

Wichtig

Die Datenbank-Engine-Versionsnummern für SQL Server und Azure SQL-Datenbank sind nicht miteinander vergleichbar, sondern stellen interne Buildnummern für diese separaten Produkte dar. Die Datenbank-Engine für Azure SQL-Datenbank basiert auf der gleichen Codebasis wie die SQL Server-Datenbank-Engine. Vor allem aber weist Datenbank-Engine in Azure SQL-Datenbank immer die neuesten SQL Datenbank-Engine-Bits auf. Die Version 12 von Azure SQL-Datenbank ist z. B. neuer als die Version 16 von SQL Server.

Hinweis

Informationen zum Anzeigen der Transact-SQL-Syntax für SQL Server 2014 (12.x) und früher finden Sie unter Dokumentation zu früheren Versionen.

Argumente

propertyname

Ein Ausdruck, der die Eigenschaftsinformationen enthält, die für Server zurückgegeben werden sollen. Für propertyname sind die folgenden Werte möglich. Die Verwendung eines propertyname, der für diese Version der Datenbank-Engine ungültig ist oder nicht unterstützt wird, gibt NULL zurück.

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.

NULL = Eingabe ist ungültig, ein Fehler oder nicht zutreffend.

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, ein Fehler oder nicht zutreffend.

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, z.B. Rechenkapazitätsgrenzen von bestimmten Editionen von SQL Server. 64-Bit-Versionen des Datenbank-Engines fügen "(64-Bit)" an die Version an.

Rückgabewerte:

'Enterprise Edition'

'Enterprise Edition: Core-basierte Lizenzierung'

'Enterprise Evaluation Edition'

'Business Intelligence Edition'

'Developer Edition'

'Express Edition'

'Express Edition with Advanced Services'

'Standard Edition'

'Web Edition'

„SQL Azure“ gibt SQL-Datenbank oder Azure Synapse Analytics an.

„Azure SQL Edge Developer“ gibt an, dass es sich um die Azure SQL Edge-Edition handelt, die ausschließlich für die Entwicklung vorgesehen ist.

„Azure SQL Edge“ gibt an, dass es sich um die zahlungspflichtige Azure SQL Edge-Edition handelt.

Basisdatentyp: nvarchar(128)
EditionID EditionID stellt die installierte Produktedition der Instanz von SQL Server dar. Verwenden Sie den Wert dieser Eigenschaft, um Features und Beschränkungen zu ermitteln, z.B. Rechenkapazitätsgrenzen von bestimmten Editionen von SQL Server.

1804890536 = Enterprise

1872460670 = Enterprise Edition: Kernbasierte Lizenzierung

610778273 = Enterprise Evaluation

284895786 = Business Intelligence

-2117995310 = Developer

-1592396055 = Express

-133711905 = Express mit Advanced Services

–1534726760 = Standard

1293598313 = Web

1674378470 = SQL-Datenbank oder Azure Synapse Analytics

-1461570097 = Azure SQL Edge Developer

1994083197 = Azure SQL Edge

Basisdatentyp: bigint
EngineEdition Datenbank-Engine-Edition der Instanz von SQL Server, die auf dem Server installiert ist.

1 = Personal oder Desktop Engine (Nicht verfügbar in SQL Server 2005 (9.x) und höheren Versionen.)

2 = Standard (Für die Standard-, Web- und Business Intelligence-Edition)

3 = Enterprise (Für die Evaluation-, Developer- und Enterprise-Editionen)

4 = Express (Für die Express-Edition, Express-Edition mit Tools und Express-Edition mit erweiterten Diensten)

5 = SQL-Datenbank

6 = Azure Synapse Analytics

8 = Verwaltete Azure SQL-Instanz

9 = Azure SQL Edge (Für alle Editionen von Azure SQL Edge)

11= Azure Synapse SQL-Pool (serverlos)

Basisdatentyp: int
FilestreamConfiguredLevel Die konfigurierte FILESTREAM-Zugriffsebene. Weitere Informationen finden Sie unter Filestream-Zugriffsebene.

0 = FILESTREAM ist deaktiviert

1 = FILESTREAM ist für Transact-SQL-Zugriff aktiviert

2 = FILESTREAM ist für Transact-SQL- und Win32-Streamingzugriff aktiviert

3 = FILESTREAM ist für Transact-SQL sowie für lokalen und Remote-Win32-Streamingzugriff aktiviert.

Basisdatentyp: int
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.

0 = FILESTREAM ist deaktiviert

1 = FILESTREAM ist für Transact-SQL-Zugriff aktiviert

2 = FILESTREAM ist für Transact-SQL- und Win32-Streamingzugriff aktiviert

3 = FILESTREAM ist für Transact-SQL sowie für lokalen und Remote-Win32-Streamingzugriff aktiviert.

Basisdatentyp: int
FilestreamShareName Der Name der von FILESTREAM verwendeten Freigabe.

NULL = Eingabe ist ungültig, ein Fehler oder nicht zutreffend.

Basisdatentyp: nvarchar(128)
HadrManagerStatus Gilt für: SQL Server 2012 (11.x) und höher.

Gibt an, ob der Always On-Verfügbarkeitsgruppen-Manager gestartet wurde.

0 = Nicht gestartet, ausstehende Kommunikation.

1 = Gestartet und wird ausgeführt.

2 = Nicht gestartet und fehlgeschlagen.

NULL = Eingabe ist ungültig, ein Fehler oder nicht zutreffend.

Basisdatentyp: int
InstanceDefaultBackupPath Gilt für: SQL Server 2019 (15.x) und höher.

Der Name des Standardpfads zu den Sicherungsdateien der Instanz
InstanceDefaultDataPath Gilt für: SQL Server 2012 (11.x) bis zur aktuellen Version, ab den Updates ab Ende 2015

Name des Standardpfads zu den Datendateien der Instanz.

Basisdatentyp: nvarchar(128)
InstanceDefaultLogPath Gilt für: SQL Server 2012 (11.x) bis zur aktuellen Version, ab den Updates ab Ende 2015

Name des Standardpfads zu den Protokolldateien der Instanz.

Basisdatentyp: nvarchar(128)
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.

NULL = Eingabe ist ungültig, ein Fehler oder nicht zutreffend.

Basisdatentyp: nvarchar(128)
IsAdvancedAnalyticsInstalled Gibt 1 zurück, wenn das Advanced Analytics-Feature während des Setups installiert wurde. Wenn Advanced Analytics nicht installiert wurde, wird 0 zurückgegeben.

Basisdatentyp: int
IsBigDataCluster Wurde in SQL Server 2019 (15.x) ab CU 4 eingeführt.

Gibt 1 zurück, wenn es sich bei der Instanz um einen Big Data-Cluster für SQL Server handelt; andernfalls wird 0 zurückgegeben

Basisdatentyp: int
IsClustered Die Serverinstanz ist als Teil eines Failoverclusters konfiguriert.

1 = Gruppiert.

0 = Nicht gruppiert.

NULL = Eingabe ist ungültig, ein Fehler oder nicht zutreffend.

Basisdatentyp: int
IsExternalAuthenticationOnly Gilt für: Azure SQL-Datenbank und Azure SQL Managed Instance

Gibt zurück, ob die microsoft Entra-only-Authentifizierung aktiviert ist.

1 = Microsoft Entra-only-Authentifizierung ist aktiviert.

0 = Microsoft Entra-only-Authentifizierung ist deaktiviert.

Basisdatentyp: int
IsExternalGovernanceEnabled Gilt für: SQL Server 2022 (16.x) und höher.

Gibt zurück, ob Microsoft Purview-Zugriffsrichtlinien aktiviert sind.

1 = Externe Governance ist aktiviert.

0 = Externe Governance ist deaktiviert.

Basisdatentyp: int
IsFullTextInstalled Der Komponenten der Volltext- und semantischen Indizierung sind in der aktuellen Instanz von SQL Server installiert.

1 = Komponenten der Volltext- und semantischen Indizierung sind installiert.

0 = Komponenten der Volltext- und semantischen Indizierung sind nicht installiert.

NULL = Eingabe ist ungültig, ein Fehler oder nicht zutreffend.

Basisdatentyp: int
IsHadrEnabled Gilt für: SQL Server 2012 (11.x) und höher.

Always On-Verfügbarkeitsgruppen ist für diese Serverinstanz aktiviert.

0 = Die Always On-Verfügbarkeitsgruppen-Funktion ist deaktiviert.

1 = Die Always On-Verfügbarkeitsgruppen-Funktion ist aktiviert.

NULL = Eingabe ist ungültig, ein Fehler oder nicht zutreffend.

Basisdatentyp: int

Damit Verfügbarkeitsreplikate in einer Instanz von SQL Server erstellt und ausgeführt werden können, muss Always On-Verfügbarkeitsgruppen auf der Serverinstanz aktiviert sein. Weitere Informationen finden Sie unter Aktivieren und Deaktivieren von Always On-Verfügbarkeitsgruppen (SQL Server).

Hinweis: Die Eigenschaft „IsHadrEnabled“ bezieht sich nur auf Always On-Verfügbarkeitsgruppen. Auf andere Hochverfügbarkeitsfunktionen oder Funktionen für die Wiederherstellung im Notfall, z. B. Datenbankspiegelung oder Protokollversand, hat diese Servereigenschaft keine Auswirkung.
IsIntegratedSecurityOnly Gibt an, ob der Server sich im integrierten Sicherheitsmodus befindet.

1 = Integrierte Sicherheit (Windows-Authentifizierung)

0 = Keine integrierte Sicherheit. (Sowohl Windows-Authentifizierung als auch SQL Server-Authentifizierung.)

NULL = Eingabe ist ungültig, ein Fehler oder nicht zutreffend.

Basisdatentyp: int
IsLocalDB Gilt für: SQL Server 2012 (11.x) und höher.

Server ist eine Instanz von SQL Server Express LocalDB.

NULL = Eingabe ist ungültig, ein Fehler oder nicht zutreffend.

Basisdatentyp: int
IsPolyBaseInstalled Gilt für: SQL Server 2016 (13.x).

Gibt zurück, ob das PolyBase-Feature für die Serverinstanz installiert wurde.

0 = PolyBase ist nicht installiert.

1 = PolyBase ist installiert.

Basisdatentyp: int
IsServerSuspendedForSnapshotBackup Der Server befindet sich im Ruhezustand und erfordert Thaw auf Serverebene.

1 = Angehalten

0 = Nicht angehalten

Basisdatentyp: int
IsSingleUser Gibt an, ob der Server sich im Einzelbenutzermodus befindet.

1 = Einzelbenutzermodus.

0 = Kein Einzelbenutzermodus

NULL = Eingabe ist ungültig, ein Fehler oder nicht zutreffend.

Basisdatentyp: int
IsTempDbMetadataMemoryOptimized Gilt für: SQL Server 2019 (15.x) und höher.

Gibt „1“ zurück, wenn die Verwendung von speicheroptimierten Tabellen für Metadaten in tempdb aktiviert wurde, „0“ (null) wird zurückgegeben, wenn tempdb reguläre, datenträgerbasierte Tabellen für Metadaten verwendet. Weitere Informationen finden Sie unter tempdb Database.

Basisdatentyp: int
IsXTPSupported Gilt für: SQL Server (SQL Server 2014 (12.x) und höher), SQL-Datenbank.

Server unterstützt In-Memory OLTP.

1 = Server unterstützt In-Memory OLTP.

0 = Server unterstützt kein In-Memory OLTP.

NULL = Eingabe ist ungültig, ein Fehler oder nicht zutreffend.

Basisdatentyp: int
LCID Windows-Gebietsschemabezeichner (LCID, Locale Identifier) der Sortierung.

Basisdatentyp: int
LicenseType Nicht verwendet. Lizenzinformationen werden vom SQL Server-Produkt weder beibehalten noch gepflegt. Gibt immer DISABLED zurück.

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 Cluster Service ausgeführt wird, wird der Name des virtuellen Servers zurückgegeben.

NULL = Eingabe ist ungültig, ein Fehler oder nicht zutreffend.

Basisdatentyp: nvarchar(128)
NumLicenses Nicht verwendet. Lizenzinformationen werden vom SQL Server-Produkt weder beibehalten noch gepflegt. Gibt immer NULL zurück.

Basisdatentyp: int
PathSeparator Gilt für: SQL Server 2017 (14.x) und höher

Gibt unter Windows \ und unter Linux / zurück.

Basisdatentyp: nvarchar
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, ein Fehler oder nicht zutreffend.

Basisdatentyp: int
ProductBuild Gilt für: SQL Server 2014 (12.x) (ab Oktober 2015).

Die Buildnummer.

Basisdatentyp: nvarchar(128)
ProductBuildType Gilt für: SQL Server 2012 (11.x) bis zur aktuellen Version, ab den Updates ab Ende 2015

Der Buildtyp des aktuellen Builds.

Gibt einen der folgenden Werte zurück:

OD = Bedarfsgesteuertes Release eines bestimmten Kunden

GDR = Die allgemeine Vertriebsversion, die über Windows Update veröffentlicht wurde.

NULL = nicht anwendbar

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

'CTPn' = Community Technology Preview-Version

Basisdatentyp: nvarchar(128)
ProductMajorVersion Gilt für: SQL Server 2012 (11.x) bis zur aktuellen Version, ab den Updates ab Ende 2015

Die Hauptversion.

Basisdatentyp: nvarchar(128)
ProductMinorVersion Gilt für: SQL Server 2012 (11.x) bis zur aktuellen Version, ab den Updates ab Ende 2015

Die Nebenversion.

Basisdatentyp: nvarchar(128)
ProductUpdateLevel Gilt für: SQL Server 2012 (11.x) bis zur aktuellen Version, ab den Updates ab Ende 2015

Updateebene des aktuellen Builds. CU gibt ein kumulatives Update an.

Gibt einen der folgenden Werte zurück:

CUn = kumulatives Update

NULL = nicht anwendbar

Basisdatentyp: nvarchar(128)
ProductUpdateReference Gilt für: SQL Server 2012 (11.x) bis zur aktuellen Version, ab den Updates ab Ende 2015

KB-Artikel für dieses Release.

Basisdatentyp: nvarchar(128)
ProductVersion Version der Instanz von SQL Server im Format Hauptversion.Nebenversion.Build.Revision.

Basisdatentyp: nvarchar(128)
ResourceLastUpdateDateTime Gibt das Datum und die Zeit des letzten Updates 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)
SuspendedDatabaseCount Die Anzahl der angehaltenen Datenbanken auf dem Server

Basisdatentyp: int

Rückgabetypen

sql_variant

Bemerkungen

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.

Die ServerName-Eigenschaft der SERVERPROPERTY-Funktion gibt den Namen des Windows-Servers so zurück, wie er gespeichert wurde. In früheren Hauptversionen wurde er in Großbuchstaben zurückgegeben. Zwischen SQL Server 2019 (15.x) CU 9 und CU 12 hat sich dieses Verhalten geändert, und er wurde wieder in Großbuchstaben zurückgegeben. Ab SQL Server 2019 (15.x) CU 13 wird der Servername jedoch so zurückgegeben, wie er gespeichert wurde.

Wenn der Windows-Servername Kleinbuchstaben enthält, kann diese Änderung des Verhaltens Unterschiede zwischen der ServerName-Eigenschaft der SERVERPROPERTY-Funktion und @@SERVERNAME (Großbuchstaben vs. Kleinbuchstaben) verursachen, selbst wenn der Name des Servers nicht geändert wurde.

Angenommen, Sie haben einen Server namens server01 mit einer SQL Server-Instanz namens INST1. In der folgenden Tabelle wird die Änderung des Verhaltens zwischen verschiedenen Builds von SQL Server 2019 (15.x) zusammengefasst:

Release von SQL Server 2019 (15.x) SERVERPROPERTY('ServerName') Zusätzliche Informationen
RTM SERVER01\INST1 Gibt die ServerName-Eigenschaft in Großbuchstaben zurück.
CU 1 – CU 8 server01\INST1 Gibt die ServerName-Eigenschaft unverändert zurück, ohne in Großbuchstaben zu ändern.
CU 9 – CU 12 SERVER01\INST1 Gibt die ServerName-Eigenschaft in Großbuchstaben zurück.
CU 13 und höhere Versionen server01\INST1 Gibt die ServerName-Eigenschaft unverändert zurück, ohne in Großbuchstaben zu ändern.

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 die einzelnen Eigenschaftszeichenfolgen getrennt voneinander benötigt, können Sie diese mithilfe der SERVERPROPERTY-Funktion ermitteln, statt die Ergebnisse der Funktion @@VERSION zu analysieren.

Berechtigungen

Alle Benutzer können die Servereigenschaften abfragen.

Beispiele

Das folgende Beispiel verwendet die SERVERPROPERTY-Funktion in einer SELECT-Anweisung, um Informationen zur aktuellen Instanz von SQL Serverzurückzugeben.

SELECT
 SERVERPROPERTY('MachineName') AS ComputerName,
 SERVERPROPERTY('ServerName') AS InstanceName,
 SERVERPROPERTY('Edition') AS Edition,
 SERVERPROPERTY('ProductVersion') AS ProductVersion,
 SERVERPROPERTY('ProductLevel') AS ProductLevel;
GO

Zugehöriger Inhalt

Eine Liste der Features, die von den SQL Server-Editionen auf Windows unterstützt werden, finden Sie hier: