Share via

SERVERPROPERTY (Transact-SQL)

  • Artikel

Gibt Eigenschaftsinformationen über die Serverinstanz zurück.

Themenlink (Symbol) Transact-SQL-Syntaxkonventionen

Syntax

SERVERPROPERTY ( propertyname )

Argumente

  • propertyname
    Ein Ausdruck, der die Eigenschafteninformationen enthält, die für Server zurückgegeben werden sollen. Für propertyname sind die folgenden 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.

    HinweisHinweis

    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 Funktionen und Beschränkungen zu ermitteln, z. B. Rechenkapazitätsgrenzen von bestimmten Editionen von SQL Server. 64-Bit-Versionen des Database Engine (Datenbankmodul)s fügen "(64-Bit)" an die Version an.

    Rückgabewerte:

    'Enterprise Edition'

    'Enterprise Edition: Kernbasierte Lizenzierung'

    'Enterprise Evaluation Edition'

    "Business Intelligence Edition"

    'Developer Edition'

    'Express Edition'

    'Express Edition with Advanced Services'

    'Standard Edition'

    'Web Edition'

    Basisdatentyp: nvarchar(128)

    EditionID

    EditionID stellt die installierte Produktedition der Instanz von SQL Server dar. Verwenden Sie den Wert dieser Eigenschaft, um die Funktionen 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 with Advanced Services

    -1534726760 = Standard

    1293598313 = Web

    Basisdatentyp: bigint

    EngineEdition

    Database Engine (Datenbankmodul)-Edition der Instanz von SQL Server, die auf dem Server installiert ist.

    1 = Personal oder Desktop Engine (Nicht verfügbar für SQL Server 2005 und höhere Versionen.)

    2 = Standard (Rückgabewert für Standard, Web und Business Intelligence)

    3 = Enterprise (Rückgabewert für Evaluation, Developer und beide Enterprise Editionen)

    4 = Express (Rückgabewert für Express, Express with Tools und Express with Advanced Services)

    5 = SQL Azure

    Basisdatentyp: int

    HadrManagerStatus

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

    0 = Nicht gestartet, ausstehende Kommunikation.

    1 = Gestartet und wird ausgeführt.

    2 = Nicht gestartet und fehlgeschlagen.

    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 = Gruppiert.

    0 = Nicht gruppiert.

    NULL = Eingabe ist ungültig oder ein Fehler.

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

    Basisdatentyp: int

    IsHadrEnabled

    AlwaysOn-Verfügbarkeitsgruppen ist für diese Serverinstanz aktiviert.

    0 = Die AlwaysOn-Verfügbarkeitsgruppen-Funktion ist deaktiviert.

    1 = Die AlwaysOn-Verfügbarkeitsgruppen-Funktion ist aktiviert.

    Basisdatentyp: int

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

    HinweisHinweis

    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.

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

    Basisdatentyp: int

    IsLocalDB

    Server ist eine Instanz von SQL Server Express LocalDB.

    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

    Wird nicht verwendet. Lizenzinformationen werden vom SQL Server-Produkt weder beibehalten noch aufbewahrt. 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 oder ein Fehler.

    Basisdatentyp: nvarchar(128)

    NumLicenses

    Wird nicht verwendet. Lizenzinformationen werden vom SQL Server-Produkt weder beibehalten noch aufbewahrt. Gibt immer NULL zurück.

    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.revision'.

    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 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)

    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

Siehe auch

Verweis

Editionen und Komponenten von SQL Server 2012