Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Gilt für:
SQL ServerAzure SQL-DatenbankVerwaltete Azure SQL-InstanzAzure Synapse AnalyticsAnalytics Platform System (PDW)SQL-Analyseendpunkt in Microsoft FabricLagerhaus in Microsoft FabricSQL-Datenbank in Microsoft Fabric
Gibt Eigenschaftsinformationen über die Serverinstanz zurück.
Transact-SQL-Syntaxkonventionen
Note
Microsoft Entra ID war zuvor als Azure Active Directory (Azure AD) bekannt.
Syntax
SERVERPROPERTY ( 'propertyname' )
Important
Die Versionsnummern des Datenbankmoduls für SQL Server und Azure SQL-Datenbank und Microsoft Fabric sind nicht miteinander vergleichbar und 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.
Arguments
propertyname
Ein Ausdruck, der die Eigenschaftsinformationen enthält, die für Server zurückgegeben werden sollen.
propertyname kann einer der folgenden Werte sein. Die Verwendung eines Eigenschaftsnamens , der für diese Version des Datenbankmoduls ungültig oder nicht unterstützt wird, wird zurückgegeben NULL.
| Property | 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 wie die MachineName Eigenschaft zurück.Anmerkung: Wenn sich die Sql Server-Instanz in einem Failovercluster befindet und Sie den Namen der Failoverclusterinstanz abrufen möchten, 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. Verwenden Sie die folgende Edition-Tabelle , um mögliche Werte zu identifizieren. Basisdatentyp: nvarchar(128) |
EditionID |
Stellt die ID der installierten Produktedition der SQL Server-Instanz dar. Verwenden Sie den Wert dieser Eigenschaft, um Features und Beschränkungen zu ermitteln, z.B. Rechenkapazitätsgrenzen von bestimmten Editionen von SQL Server. Verwenden Sie die folgende Edition-Tabelle , um mögliche Werte zu identifizieren. 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 Standard, Standard Developer, Web und Business Intelligence.) 3 = Enterprise (Enterprise-, Enterprise Developer-, Developer- und Evaluation-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 = Sql-Pool ohne Azure Synapse-Server oder Microsoft Fabric 12 = Microsoft Fabric SQL-Datenbank in Microsoft Fabric. 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 und sowohl lokalen als auch 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 und sowohl lokalen als auch 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 |
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 |
Der Name des Standardpfads zu den Sicherungsdateien der Instanz Gilt für: SQL Server 2019 (15.x) und höhere Versionen. Basisdatentyp: nvarchar(128) |
InstanceDefaultDataPath |
Name des Standardpfads zu den Datendateien der Instanz. Gilt für: SQL Server. Basisdatentyp: nvarchar(128) |
InstanceDefaultLogPath |
Name des Standardpfads zu den Protokolldateien der Instanz. Gilt für: SQL Server. Basisdatentyp: nvarchar(128) |
InstanceName |
Der Name der Instanz, mit der der Benutzer verbunden ist. Gibt zurück NULL , wenn der Instanzname die Standardinstanz ist, wenn die Eingabe ungültig oder ein Fehler ist.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 |
Sendet zurück, ob die Option für die reine Microsoft Entra-Authentifizierung aktiviert ist. 1 = Reine Microsoft Entra-Authentifizierung ist aktiviert. 0 = Reine Microsoft Entra-Authentifizierung ist deaktiviert. Gilt für: Azure SQL-Datenbank und Azure SQL Managed Instance Basisdatentyp: int |
IsExternalGovernanceEnabled |
Gibt zurück, ob Microsoft Purview-Zugriffsrichtlinien aktiviert sind. 1 = Externe Governance ist aktiviert. 0 = Externe Governance ist deaktiviert. Gilt für: SQL Server 2022 (16.x) und höhere Versionen. 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 |
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. 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 oder Deaktivieren der AlwaysOn-Verfügbarkeitsgruppenfunktion". Anmerkung: Die IsHadrEnabled Eigenschaft bezieht sich nur auf AlwaysOn-Verfügbarkeitsgruppen. Auf andere Hochverfügbarkeitsfunktionen oder Funktionen für die Wiederherstellung im Notfall, z. B. Datenbankspiegelung oder Protokollversand, hat diese Servereigenschaft keine Auswirkung.Gilt für: SQL Server. Basisdatentyp: int |
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 |
Server ist eine Instanz von SQL Server Express LocalDB. NULL = Eingabe ist ungültig, ein Fehler oder nicht zutreffend. Gilt für: SQL Server. Basisdatentyp: int |
IsPolyBaseInstalled |
Gibt zurück, ob das PolyBase-Feature für die Serverinstanz installiert wurde. 0 = PolyBase ist nicht installiert. 1 = PolyBase ist installiert. Gilt für: SQL Server 2016 (13.x) und höhere Versionen. 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 |
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.Gilt für: SQL Server 2019 (15.x) und höhere Versionen. Basisdatentyp: int |
IsXTPSupported |
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. Gilt für: SQL Server 2014 (12.x) und höhere Versionen und Azure SQL-Datenbank. Basisdatentyp: int |
LCID |
Windows-Gebietsschemabezeichner (LCID, Locale Identifier) der Sortierung. Basisdatentyp: int |
LicenseType |
Unused. 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 |
Unused. Lizenzinformationen werden vom SQL Server-Produkt weder beibehalten noch gepflegt. Gibt immer NULL zurück.Basisdatentyp: int |
PathSeparator |
Gibt unter Windows \ und unter Linux / zurück.Gilt für: SQL Server 2017 (14.x) und höhere Versionen. 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 |
Die Buildnummer. Gilt für: SQL Server 2014 (12.x) und spätere Versionen. Basisdatentyp: nvarchar(128) |
ProductBuildType |
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 zutreffend. Gilt für: SQL Server. 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 |
Die Hauptversion. Gilt für: SQL Server. Basisdatentyp: nvarchar(128) |
ProductMinorVersion |
Die Nebenversion. Gilt für: SQL Server. Basisdatentyp: nvarchar(128) |
ProductUpdateLevel |
Updateebene des aktuellen Builds. CU gibt ein kumulatives Update an. Gibt einen der folgenden Werte zurück: CUn = kumulatives Update NULL = Nicht zutreffend. Gilt für: SQL Server und Azure SQL Managed Instance. Basisdatentyp: nvarchar(128) |
ProductUpdateReference |
KB-Artikel für dieses Release. Gilt für: SQL Server. Basisdatentyp: nvarchar(128) |
ProductUpdateType |
Aktualisierungsrhythmen, denen die Instanz folgt. Entspricht der Update-Richtlinie von Azure SQL Managed Instance. Gibt einen der folgenden Werte zurück: CU = Updates werden über kumulative Updates (CUs) für die entsprechende Hauptversion von SQL Server (SQL Server 2022 Update-Richtlinie) bereitgestellt. Fortlaufend = Neue Features werden in azure SQL Managed Instance gebracht, sobald sie verfügbar sind, unabhängig von der SQL Server-Veröffentlichungshäufigkeit (Always-up-to-date update policy). Gilt für: Azure SQL Managed Instance. 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 |
Sowohl der Windows-Server als auch die Instanzinformationen, die einer angegebenen Instanz zugeordnet sind. 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 SQL-Sortierreihenfolgen-ID 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 |
In der folgenden Tabelle sind mögliche Werte für EditionID und Edition.
| EditionID | Edition |
|---|---|
1804890536 |
Enterprise |
1872460670 |
Enterprise Edition: Core-basierte Lizenzierung |
610778273 |
Unternehmensauswertung |
284895786 |
Geschäftsdatenanalyse |
-2117995310 |
Entwickler 1 oder Developer Enterprise 2 |
-2509700633 |
Entwicklerstandard 2 |
-1592396055 |
Ausdrücken |
-133711905 |
Express mit Advanced Services |
-1534726760 |
Norm |
1293598313 |
Web 1 |
1674378470 |
SQL-Datenbank oder Azure Synapse Analytics |
-1461570097 |
Azure SQL Edge Developer 3 |
1994083197 |
Azure SQL Edge 4 |
1Gilt für: SQL Server 2022 (16.x) und frühere Versionen.
2Gilt für: SQL Server 2025 (17.x) und spätere Versionen.
3 Gibt die einzige Entwicklungsedition für Azure SQL Edge an.
4 Gibt die kostenpflichtige Edition für Azure SQL Edge an.
Rückgabetypen
sql_variant
Remarks
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:
EXECUTE sp_dropserver 'current_server_name';
GO
EXECUTE 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 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 Verhaltensänderung zu Unterschieden zwischen der ServerName Eigenschaft der SERVERPROPERTY Funktion und @@SERVERNAME (Groß- und Kleinbuchstaben) führen, auch wenn keine Namensänderung für den Server vorhanden ist.
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') | Weitere 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.
Permissions
Alle Benutzer können die Servereigenschaften abfragen.
Examples
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