Megosztás a következőn keresztül:


SERVERPROPERTY (Transact-SQL)

A következőkre vonatkozik:SQL ServerAzure SQL DatabaseFelügyelt Azure SQL-példányAzure Synapse AnalyticsElemzési platformrendszer (PDW)SQL Analytics-végpont a Microsoft FabricbenRaktár a Microsoft FabricbenSQL-adatbázis a Microsoft Fabricben

A kiszolgálópéldány tulajdonságadatait adja vissza.

Transact-SQL szintaxis konvenciók

Note

A Microsoft Entra ID-t korábban Azure Active Directorynak (Azure AD) nevezték.

Syntax

SERVERPROPERTY ( 'propertyname' )

Important

Az SQL Server, az Azure SQL Database és a Microsoft Fabric adatbázismotor-verziószámai nem összehasonlíthatók egymással, és belső buildszámokat jelentenek ezekhez a különálló termékekhez. Az Azure SQL Database adatbázismotorja ugyanazon a kódbázison alapul, mint az SQL Server adatbázismotorja. További fontos tudnivaló, hogy az Azure SQL Database adatbázismotorja mindig az SQL-adatbázismotor legújabb bitverziójával rendelkezik. Például az Azure SQL Database 12-es verziója újabb, mint az SQL Server 16-os verziója.

Arguments

propertyname

A kiszolgálóhoz visszaadandó tulajdonságadatokat tartalmazó kifejezés. A tulajdonságnév az alábbi értékek egyike lehet. Az adatbázismotor ezen verziójában érvénytelen vagy nem támogatott tulajdonságnév használata ad vissza NULL.

Property Visszaadott értékek
BuildClrVersion A Microsoft .NET Framework közös nyelvi futtatókörnyezetének (CLR) verziója, amelyet az SQL Server-példány létrehozásakor használtak.

NULL = A bemenet érvénytelen, hiba vagy nem alkalmazható.

Alapadattípus: nvarchar(128)
Collation A kiszolgáló alapértelmezett rendezési nevének neve.

NULL = A bemenet érvénytelen, vagy hiba.

Alapadattípus: nvarchar(128)
CollationID Az SQL Server-rendezés azonosítója.

Alapadattípus: int
ComparisonStyle A rendezés Windows-összehasonlító stílusa.

Alapadattípus: int
ComputerNamePhysicalNetBIOS Annak a helyi számítógépnek a NetBIOS-neve, amelyen az SQL Server példánya jelenleg fut.

A feladatátvevő fürtön lévő SQL Server fürtözött példánya esetén ez az érték úgy változik, hogy az SQL Server példánya a feladatátvevő fürt más csomópontjaira is átkerül.

Az SQL Server önálló példányán ez az érték állandó marad, és ugyanazt az értéket adja vissza, mint a MachineName tulajdonság.

Jegyzet: Ha az SQL Server-példány egy feladatátvevő fürtben található, és be szeretné szerezni a feladatátvevő fürtözött példány nevét, használja a MachineName tulajdonságot.

NULL = A bemenet érvénytelen, hiba vagy nem alkalmazható.

Alapadattípus: nvarchar(128)
Edition Az SQL Server példányának telepített termékverziója. Ennek a tulajdonságnak az értékével határozza meg a funkciókat és a korlátokat, például a számítási kapacitás korlátait az SQL Server kiadása szerint. Az adatbázismotor 64 bites verziói hozzáfűzik a verzióhoz (64 bites).

A lehetséges értékek azonosításához használja a következő Kiadás táblát .

Alapadattípus: nvarchar(128)
EditionID Az SQL Server-példány telepített termékverziójának azonosítóját jelöli. Ennek a tulajdonságnak az értékével meghatározhatja a funkciókat és a korlátokat, például a számítási kapacitás korlátait az SQL Server kiadása alapján.

A lehetséges értékek azonosításához használja a következő Kiadás táblát .

Alapadattípus: bigint
EngineEdition A kiszolgálón telepített SQL Server-példány adatbázismotor-kiadása.

1 = Személyes vagy asztali motor (az SQL Server 2005 (9.x) és újabb verzióiban nem érhető el.)
2 = Standard (Standard, Standard Developer, Web és Business Intelligence esetén.)
3 = Enterprise (Enterprise, Enterprise Developer, Developer és Evaluation kiadásokhoz.)
4 = Express (Express, Express with Tools, express with Advanced Services)
5 = SQL adatbázis
6 = Azure Synapse Analytics
8 = Felügyelt Azure SQL-példány
9 = Azure SQL Edge (Az Azure SQL Edge összes kiadásához)
11 = Azure Synapse kiszolgáló nélküli SQL-készlet vagy Microsoft Fabric
12 = Microsoft Fabric SQL adatbázis a Microsoft Fabric-ben.

Alapadattípus: int
FilestreamConfiguredLevel A FILESTREAM-hozzáférés konfigurált szintje. További információkért tekintse meg a fájlstream hozzáférési szintjét.

0 = A FILESTREAM le van tiltva
1 = A FILESTREAM engedélyezve van Transact-SQL hozzáféréshez
2 = A FILESTREAM engedélyezve van Transact-SQL és helyi Win32 streamelési hozzáféréshez
3 = A FILESTREAM engedélyezve van Transact-SQL és helyi és távoli Win32 streamelési hozzáféréshez is.

Alapadattípus: int
FilestreamEffectiveLevel A FILESTREAM-hozzáférés tényleges szintje. Ez az érték eltérhet a FilestreamConfiguredLevel értékétől, ha a szint megváltozott, és a példány újraindítása vagy a számítógép újraindítása függőben van. További információkért tekintse meg a fájlstream hozzáférési szintjét.

0 = A FILESTREAM le van tiltva
1 = A FILESTREAM engedélyezve van Transact-SQL hozzáféréshez
2 = A FILESTREAM engedélyezve van Transact-SQL és helyi Win32 streamelési hozzáféréshez
3 = A FILESTREAM engedélyezve van Transact-SQL és helyi és távoli Win32 streamelési hozzáféréshez is.

Alapadattípus: int
FilestreamShareName A FILESTREAM által használt megosztás neve.

NULL = A bemenet érvénytelen, hiba vagy nem alkalmazható.

Alapadattípus: nvarchar(128)
HadrManagerStatus Azt jelzi, hogy az Always On rendelkezésre állási csoportok kezelője elindult-e.

0 = Nincs elindítva, függőben lévő kommunikáció.
1 = Elindult és fut.
2 = Nem indult el és nem sikerült.
NULL = A bemenet érvénytelen, hiba vagy nem alkalmazható.

Alapadattípus: int
InstanceDefaultBackupPath A példány biztonsági mentési fájljainak alapértelmezett elérési útja.

A: SQL Server 2019 (15.x) és újabb verziókra vonatkozik.

Alapadattípus: nvarchar(128)
InstanceDefaultDataPath A példány adatfájljainak alapértelmezett elérési útja.

A következőkre vonatkozik: SQL Server.

Alapadattípus: nvarchar(128)
InstanceDefaultLogPath A példány naplófájljainak alapértelmezett elérési útja.

A következőkre vonatkozik: SQL Server.

Alapadattípus: nvarchar(128)
InstanceName Annak a példánynak a neve, amelyhez a felhasználó csatlakozik.

Akkor adja NULL vissza, ha a példány neve az alapértelmezett példány, ha a bemenet nem érvényes, vagy hiba.

NULL = A bemenet érvénytelen, hiba vagy nem alkalmazható.

Alapadattípus: nvarchar(128)
IsAdvancedAnalyticsInstalled 1 értéket ad vissza, ha az Advanced Analytics szolgáltatás telepítve volt a telepítés során; 0, ha az Advanced Analytics nincs telepítve.

Alapadattípus: int
IsBigDataCluster Az SQL Server 2019 -ben (15.x) a CU 4-től kezdve vezettük be.

1 értéket ad vissza, ha a példány SQL Server Big Data-fürt; 0, ha nem.

Alapadattípus: int
IsClustered A kiszolgálópéldány egy feladatátvevő fürtben van konfigurálva.

1 = fürtözött.
0 = Nincs fürtözve.
NULL = A bemenet érvénytelen, hiba vagy nem alkalmazható.

Alapadattípus: int
IsExternalAuthenticationOnly Azt adja vissza, hogy engedélyezve van-e a Microsoft Entra-hitelesítés .

1 = A microsoft entra-only hitelesítés engedélyezve van.
0 = A microsoft entra-only hitelesítés le van tiltva.

A következőkre vonatkozik: Azure SQL Database és felügyelt Azure SQL-példány.

Alapadattípus: int
IsExternalGovernanceEnabled Azt adja vissza, hogy engedélyezve vannak-e a Microsoft Purview hozzáférési szabályzatai .

1 = A külső szabályozás engedélyezve van.
0 = A külső szabályozás le van tiltva.

A következőkre vonatkozik: SQL Server 2022 (16.x) és újabb verziók.

Alapadattípus: int
IsFullTextInstalled A teljes szöveges és szemantikai indexelő összetevők az SQL Server aktuális példányán vannak telepítve.

1 = A teljes szöveges és szemantikai indexelő összetevők telepítve vannak.
0 = A teljes szöveges és szemantikai indexelő összetevők nincsenek telepítve.
NULL = A bemenet érvénytelen, hiba vagy nem alkalmazható.

Alapadattípus: int
IsHadrEnabled Az Always On rendelkezésre állási csoportok engedélyezve van ezen a kiszolgálópéldányon.

0 = Az Always On rendelkezésre állási csoportok funkció le van tiltva.
1 = Az Always On rendelkezésre állási csoportok funkció engedélyezve van.
NULL = A bemenet érvénytelen, hiba vagy nem alkalmazható.

Ahhoz, hogy a rendelkezésre állási replikákat az SQL Server egy példányán lehessen létrehozni és futtatni, engedélyezni kell az Always On rendelkezésre állási csoportokat a kiszolgálópéldányon. További információ: Always On rendelkezésreállási csoport funkció engedélyezése vagy letiltása.

Jegyzet: A IsHadrEnabled tulajdonság csak az Always On rendelkezésre állási csoportokra vonatkozik. A kiszolgálótulajdonság nem érinti az egyéb magas rendelkezésre állású vagy vészhelyreállítási funkciókat, például az adatbázis-tükrözést vagy a naplószállítást.

A következőkre vonatkozik: SQL Server.

Alapadattípus: int
IsIntegratedSecurityOnly A kiszolgáló integrált biztonsági módban van.

1 = Integrált biztonság (Windows-hitelesítés)
0 = Nem integrált biztonság. (Windows-hitelesítés és SQL Server-hitelesítés egyaránt.)
NULL = A bemenet érvénytelen, hiba vagy nem alkalmazható.

Alapadattípus: int
IsLocalDB A kiszolgáló az SQL Server Express LocalDB egy példánya.

NULL = A bemenet érvénytelen, hiba vagy nem alkalmazható.

A következőkre vonatkozik: SQL Server.

Alapadattípus: int
IsPolyBaseInstalled Azt adja vissza, hogy a kiszolgálópéldány telepítve van-e a PolyBase szolgáltatással.

0 = A PolyBase nincs telepítve.
1 = A PolyBase telepítve van.

A következőkre vonatkozik: SQL Server 2016 (13.x) és újabb verziók.

Alapadattípus: int
IsServerSuspendedForSnapshotBackup A kiszolgáló felfüggesztési módban van, és kiszolgálószintű felengedést igényel.

1 = Felfüggesztve.
0 = Nincs felfüggesztve.

Alapadattípus: int
IsSingleUser A kiszolgáló egyfelhasználós módban van.

1 = Egy felhasználó.
0 = Nem egyfelhasználós
NULL = A bemenet érvénytelen, hiba vagy nem alkalmazható.

Alapadattípus: int
IsTempDbMetadataMemoryOptimized 1 értéket ad vissza, ha tempdb engedélyezve van a memóriaoptimalizált táblák metaadatokhoz való használata; 0, ha tempdb a metaadatokhoz normál, lemezalapú táblákat használ. További információ: tempdb Database.

A: SQL Server 2019 (15.x) és újabb verziókra vonatkozik.

Alapadattípus: int
IsXTPSupported A kiszolgáló támogatja In-Memory OLTP-t.

1 = A kiszolgáló támogatja In-Memory OLTP-t.
0 = A kiszolgáló nem támogatja In-Memory OLTP-t.
NULL = A bemenet érvénytelen, hiba vagy nem alkalmazható.

A következőkre vonatkozik: AZ SQL Server 2014 (12.x) és újabb verziói, valamint az Azure SQL Database.

Alapadattípus: int
LCID A rendezés Windows területi azonosítója (LCID).

Alapadattípus: int
LicenseType Unused. A licencinformációkat az SQL Server-termék nem őrzi meg vagy tartja karban. Mindig LETILTVA értéket ad vissza.

Alapadattípus: nvarchar(128)
MachineName Windows rendszerű számítógép neve, amelyen a kiszolgálópéldány fut.

Fürtözött példány esetén, amely a Microsoft Fürtszolgáltatás egy virtuális kiszolgálón futó SQL Server-példánya, a virtuális kiszolgáló nevét adja vissza.

NULL = A bemenet érvénytelen, hiba vagy nem alkalmazható.

Alapadattípus: nvarchar(128)
NumLicenses Unused. A licencinformációkat az SQL Server-termék nem őrzi meg vagy tartja karban. Mindig NULLad vissza.

Alapadattípus: int
PathSeparator \ Visszatérés Windowson és / Linuxon

A következőkre vonatkozik: SQL Server 2017 (14.x) és újabb verziók.

Alapadattípus: nvarchar
ProcessID Az SQL Server szolgáltatás folyamatazonosítója. A ProcessID hasznos annak meghatározásához, hogy melyik Sqlservr.exe tartozik ehhez a példányhoz.

NULL = A bemenet érvénytelen, hiba vagy nem alkalmazható.

Alapadattípus: int
ProductBuild A buildszám.

A következőkre vonatkozik: SQL Server 2014 (12.x) és újabb verziók.

Alapadattípus: nvarchar(128)
ProductBuildType Az aktuális build buildjének típusa.

Az alábbi értékek egyikét adja vissza:

OD = Igény szerinti kiadás egy adott ügyfél.
GDR = a Windows Update-en keresztül kiadott általános terjesztési kiadás.
NULL = Nem alkalmazható.

A következőkre vonatkozik: SQL Server.

Alapadattípus: nvarchar(128)
ProductLevel Az SQL Server-példány verziójának szintje.

Az alábbi értékek egyikét adja vissza:

"RTM" = Eredeti kiadási verzió
'SPn' = Szervizcsomag verziója
'CTPn', = Community Technology Preview verzió.

Alapadattípus: nvarchar(128)
ProductMajorVersion A főverzió.

A következőkre vonatkozik: SQL Server.

Alapadattípus: nvarchar(128)
ProductMinorVersion Az alverzió.

A következőkre vonatkozik: SQL Server.

Alapadattípus: nvarchar(128)
ProductUpdateLevel Az aktuális build frissítési szintje. A CU kumulatív frissítést jelez.

Az alábbi értékek egyikét adja vissza:

CUn = Kumulatív frissítés
NULL = Nem alkalmazható.

A következőkre vonatkozik: SQL Server és Felügyelt Azure SQL-példány.

Alapadattípus: nvarchar(128)
ProductUpdateReference TUDÁSBÁZIS-cikk a kiadáshoz.

A következőkre vonatkozik: SQL Server.

Alapadattípus: nvarchar(128)
ProductUpdateType A példány által követett frissítési ütem. Megfelel az Azure SQL Felügyelt példány frissítési szabályzat-nek.

Az alábbi értékek egyikét adja vissza:

CU = A frissítések kumulatív frissítésekkel (CU-kkal) vannak üzembe helyezve a megfelelő fő SQL Server-kiadáshoz (SQL Server 2022 frissítési szabályzathoz).

Folyamatos = Az új funkciók azonnal elérhetők az Azure SQL Managed Instance-ben, függetlenül az SQL Server kiadási ütemétől (Always-up-to-date update policy).

A következőkre vonatkozik: Felügyelt Azure SQL-példány.

Alapadattípus: nvarchar(128)
ProductVersion Az SQL Server példányának verziója major.minor.build.revision formában.

Alapadattípus: nvarchar(128)
ResourceLastUpdateDateTime Az erőforrás-adatbázis legutóbbi frissítésének dátumát és időpontját adja vissza.

Alapadattípus: datetime
ResourceVersion A verzióerőforrás-adatbázist adja vissza.

Alapadattípus: nvarchar(128)
ServerName A Windows-kiszolgáló és a megadott példányhoz társított példányadatok is.

NULL = A bemenet érvénytelen, vagy hiba.

Alapadattípus: nvarchar(128)
SqlCharSet Az SQL-karakterkészlet azonosítója a rendezési azonosítóból.

Alapadattípus: tinyint
SqlCharSetName Az SQL-karakterkészlet neve a rendezésből.

Alapadattípus: nvarchar(128)
SqlSortOrder Az SQL rendezési sorrend azonosítója a rendezésből.

Alapadattípus: tinyint
SqlSortOrderName Az SQL rendezési sorrend neve a rendezésből.

Alapadattípus: nvarchar(128)
SuspendedDatabaseCount A kiszolgálón lévő felfüggesztett adatbázisok száma.

Alapadattípus: int

Az alábbi táblázat a lehetséges értékeket sorolja fel.EditionIDEdition

EditionID Edition
1804890536 Vállalati
1872460670 Enterprise Edition: Alapszintű licencelés
610778273 Nagyvállalati kiértékelés
284895786 Üzleti intelligencia
-2117995310 Developer 1 vagy Developer Enterprise 2
-2509700633 Fejlesztői Standard 2
-1592396055 Expressz
-133711905 Expressz fejlett szolgáltatásokkal
-1534726760 Standard
1293598313 Web 1
1674378470 SQL Database vagy Azure Synapse Analytics
-1461570097 Azure SQL Edge Developer 3
1994083197 Azure SQL Edge 4

1A következőkre vonatkozik: SQL Server 2022 (16.x) és korábbi verziók.
2Érvényes: SQL Server 2025 (17.x) és újabb verziók.
3 Az Azure SQL Edge csak fejlesztési kiadását jelzi.
4 Az Azure SQL Edge fizetős kiadását jelzi.

Visszatérési típusok

sql_variant

Remarks

ServerName tulajdonság

A ServerName függvény tulajdonsága és SERVERPROPERTY hasonló információkat ad vissza. A ServerName tulajdonság tartalmazza a Windows-kiszolgáló és a példány nevét, amelyek együttesen alkotják az egyedi kiszolgálópéldányt. @@SERVERNAME a jelenleg konfigurált helyi kiszolgálónevet adja meg.

A ServerName tulajdonság és @@SERVERNAME ugyanazt az információt adja vissza, ha a telepítéskor az alapértelmezett kiszolgálónév nem módosult. A helyi kiszolgáló neve a következő végrehajtásával konfigurálható:

EXECUTE sp_dropserver 'current_server_name';
GO

EXECUTE sp_addserver 'new_server_name', 'local';
GO

Ha a helyi kiszolgáló neve a telepítéskor megváltozott az alapértelmezett kiszolgálónévtől, @@SERVERNAME az új nevet adja vissza.

A ServerName függvény tulajdonsága a SERVERPROPERTY Mentett Windows-kiszolgáló nevét adja vissza. A korábbi főverziókban nagybetűket adott vissza. Ez a viselkedés visszaállt a nagybetűkre az SQL Server 2019 (15.x) CU 9 és a CU 12 között, de az SQL Server 2019 (15.x) CU 13-as verziójától kezdve a kiszolgáló neve a mentés során visszatér.

Ha a Windows-kiszolgáló neve kisbetűket tartalmaz, ez a viselkedésváltozás különbségeket okozhat a ServerNameSERVERPROPERTY függvény tulajdonsága és a @@SERVERNAME (nagybetű és kisbetű) között, még akkor is, ha a kiszolgáló neve nem változik.

Vegye figyelembe, hogy van egy kiszolgáló neve server01, amelynek neve egy SQL Server-példány INST1. Az alábbi táblázat az SQL Server 2019 különböző buildjei közötti viselkedésváltozást (15.x) foglalja össze:

SQL Server 2019 (15.x) kiadás SERVERPROPERTY('ServerName') További információk
RTM SERVER01\INST1 Nagybetűs tulajdonságot ad ServerName vissza
CU 1 – CU 8 server01\INST1 A tulajdonságot a ServerName következőképpen adja vissza, nagybetűsre váltás nélkül
CU 9 – CU 12 SERVER01\INST1 Nagybetűs tulajdonságot ad ServerName vissza
CU 13 és újabb verziók server01\INST1 ServerName A as-istulajdonságot adja vissza nagybetűsre váltás nélkül

Verziótulajdonságok

A SERVERPROPERTY függvény a verzióinformációkhoz kapcsolódó egyedi tulajdonságokat ad vissza, míg a @@VERSION függvény egyetlen sztringben egyesíti a kimenetet. Ha az alkalmazás egyedi tulajdonságsztringeket igényel, a SERVERPROPERTY függvény használatával visszaadhatja őket ahelyett , hogy elemezné a @@VERSION eredményeket.

Permissions

Minden felhasználó lekérdezheti a kiszolgáló tulajdonságait.

Examples

Az alábbi példa egy utasítás függvényével SERVERPROPERTYSELECT adja vissza az SQL Server aktuális példányára vonatkozó információkat.

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