Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
Van toepassing op:
SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)SQL Analytics-eindpunt in Microsoft FabricMagazijn in Microsoft FabricSQL-database in Microsoft Fabric Preview
Retourneert eigenschapsgegevens over het serverexemplaren.
Transact-SQL syntaxis-conventies
Note
Microsoft Entra-id werd voorheen Azure Active Directory (Azure AD) genoemd.
Syntax
SERVERPROPERTY ( 'propertyname' )
Important
De versienummers van de Database Engine voor SQL Server en Azure SQL Database en Microsoft Fabric zijn niet vergelijkbaar met elkaar en vertegenwoordigen interne buildnummers voor deze afzonderlijke producten. De database-engine voor Azure SQL Database is gebaseerd op dezelfde codebasis als de SQL Server database-engine. Het belangrijkste is dat de database-engine in Azure SQL Database altijd over de nieuwste SQL-database-engine-bits beschikt. Zo is versie 12 van Azure SQL Database bijvoorbeeld nieuwer dan versie 16 van SQL Server.
Arguments
propertyname
Een expressie die de eigenschapsgegevens bevat die moeten worden geretourneerd voor de server.
eigenschapsnaam kan een van de volgende waarden zijn. Gebruik van een eigenschapsnaam die ongeldig is of niet wordt ondersteund in die versie van de database-engine NULL.
| Property | Geretourneerde waarden |
|---|---|
BuildClrVersion |
Versie van microsoft .NET Framework Common Language Runtime (CLR) die is gebruikt tijdens het bouwen van het exemplaar van SQL Server. NULL = Invoer is ongeldig, een fout of niet van toepassing. Basisgegevenstype: nvarchar(128) |
Collation |
Naam van de standaardsortering voor de server. NULL = Invoer is ongeldig of een fout. Basisgegevenstype: nvarchar(128) |
CollationID |
Id van de SQL Server-sortering. Basisgegevenstype: int |
ComparisonStyle |
Vergelijkingsstijl van Windows van de sortering. Basisgegevenstype: int |
ComputerNamePhysicalNetBIOS |
NetBIOS-naam van de lokale computer waarop het exemplaar van SQL Server momenteel wordt uitgevoerd. Voor een geclusterd exemplaar van SQL Server op een failovercluster verandert deze waarde naarmate het exemplaar van SQL Server een failover naar andere knooppunten in het failovercluster uitvoert. Op een zelfstandig exemplaar van SQL Server blijft deze waarde constant en wordt dezelfde waarde geretourneerd als de MachineName eigenschap.Notitie: Als het exemplaar van SQL Server zich in een failovercluster bevindt en u de naam van het failoverclusterexemplaren wilt ophalen, gebruikt u de MachineName eigenschap.NULL = Invoer is ongeldig, een fout of niet van toepassing. Basisgegevenstype: nvarchar(128) |
Edition |
Geïnstalleerde producteditie van het exemplaar van SQL Server. Gebruik de waarde van deze eigenschap om de functies en limieten te bepalen, zoals limieten voor rekencapaciteit per editie van SQL Server. 64-bits versies van de database-engine toevoegen (64-bits) aan de versie. Gebruik de volgende editietabel om mogelijke waarden te identificeren. Basisgegevenstype: nvarchar(128) |
EditionID |
Vertegenwoordigt de id van de geïnstalleerde producteditie van het SQL Server-exemplaar. Gebruik de waarde van deze eigenschap om functies en limieten te bepalen, zoals limieten voor rekencapaciteit per editie van SQL Server. Gebruik de volgende editietabel om mogelijke waarden te identificeren. Basisgegevenstype: bigint |
EngineEdition |
Database Engine-editie van het exemplaar van SQL Server dat op de server is geïnstalleerd. 1 = Personal of Desktop Engine (Niet beschikbaar in SQL Server 2005 (9.x) en latere versies.) 2 = Standard (voor Standard, Standard Developer, Web en Business Intelligence.) 3 = Enterprise (Voor Enterprise-, Enterprise Developer-, Developer- en Evaluation-edities.) 4 = Express (Voor Express, Express met Hulpprogramma's en Express met Geavanceerde services) 5 = SQL Database 6 = Azure Synapse Analytics 8 = Azure SQL Managed Instance 9 = Azure SQL Edge (voor alle edities van Azure SQL Edge) 11 = Serverloze SQL-pool van Azure Synapse of Microsoft Fabric 12 = Microsoft Fabric SQL-database in Microsoft Fabric Preview. Basisgegevenstype: int |
FilestreamConfiguredLevel |
Het geconfigureerde niveau van FILESTREAM-toegang. Zie het toegangsniveau filestream voor meer informatie. 0 = FILESTREAM is uitgeschakeld 1 = FILESTREAM is ingeschakeld voor Transact-SQL toegang 2 = FILESTREAM is ingeschakeld voor Transact-SQL en lokale Win32-streamingtoegang 3 = FILESTREAM is ingeschakeld voor Transact-SQL en zowel lokale als externe Win32-streamingtoegang. Basisgegevenstype: int |
FilestreamEffectiveLevel |
Het effectieve niveau van FILESTREAM-toegang. Deze waarde kan afwijken van filestreamConfiguredLevel als het niveau is gewijzigd en het opnieuw opstarten van een exemplaar of het opnieuw opstarten van een computer in behandeling is. Zie het toegangsniveau filestream voor meer informatie. 0 = FILESTREAM is uitgeschakeld 1 = FILESTREAM is ingeschakeld voor Transact-SQL toegang 2 = FILESTREAM is ingeschakeld voor Transact-SQL en lokale Win32-streamingtoegang 3 = FILESTREAM is ingeschakeld voor Transact-SQL en zowel lokale als externe Win32-streamingtoegang. Basisgegevenstype: int |
FilestreamShareName |
De naam van de share die wordt gebruikt door FILESTREAM. NULL = Invoer is ongeldig, een fout of niet van toepassing. Basisgegevenstype: nvarchar(128) |
HadrManagerStatus |
Geeft aan of de Manager van AlwaysOn-beschikbaarheidsgroepen is gestart. 0 = Niet gestart, in behandeling communicatie. 1 = Gestart en uitgevoerd. 2 = Niet gestart en mislukt. NULL = Invoer is ongeldig, een fout of niet van toepassing. Basisgegevenstype: int |
InstanceDefaultBackupPath |
Naam van het standaardpad naar de back-upbestanden van het exemplaar. van toepassing op: SQL Server 2019 (15.x) en latere versies. Basisgegevenstype: nvarchar(128) |
InstanceDefaultDataPath |
Naam van het standaardpad naar de gegevensbestanden van het exemplaar. Van toepassing op: SQL Server. Basisgegevenstype: nvarchar(128) |
InstanceDefaultLogPath |
Naam van het standaardpad naar de logboekbestanden van het exemplaar. Van toepassing op: SQL Server. Basisgegevenstype: nvarchar(128) |
InstanceName |
Naam van het exemplaar waarmee de gebruiker is verbonden. Retourneert NULL als de exemplaarnaam het standaardexemplaren is, als de invoer niet geldig is of als er een fout optreedt.NULL = Invoer is ongeldig, een fout of niet van toepassing. Basisgegevenstype: nvarchar(128) |
IsAdvancedAnalyticsInstalled |
Retourneert 1 als de Advanced Analytics-functie is geïnstalleerd tijdens de installatie; 0 als Advanced Analytics niet is geïnstalleerd. Basisgegevenstype: int |
IsBigDataCluster |
Geïntroduceerd in SQL Server 2019 (15.x) vanaf CU 4. Retourneert 1 als het exemplaar SQL Server Big Data Cluster is; 0 als dat niet zo is. Basisgegevenstype: int |
IsClustered |
Serverexemplaren worden geconfigureerd in een failovercluster. 1 = Gegroepeerd. 0 = Niet geclusterd. NULL = Invoer is ongeldig, een fout of niet van toepassing. Basisgegevenstype: int |
IsExternalAuthenticationOnly |
Retourneert of Microsoft Entra-verificatie is ingeschakeld. 1 = Alleen Microsoft Entra-verificatie is ingeschakeld. 0 = Alleen Microsoft Entra-verificatie is uitgeschakeld. Van toepassing op: Azure SQL Database en Azure SQL Managed Instance. Basisgegevenstype: int |
IsExternalGovernanceEnabled |
Retourneert of Microsoft Purview-toegangsbeleid is ingeschakeld. 1 = Extern beheer is ingeschakeld. 0 = Extern beheer is uitgeschakeld. Van toepassing op: SQL Server 2022 (16.x) en latere versies. Basisgegevenstype: int |
IsFullTextInstalled |
De onderdelen voor volledige tekst en semantische indexering worden geïnstalleerd op het huidige exemplaar van SQL Server. 1 = Onderdelen voor volledige tekst en semantische indexering worden geïnstalleerd. 0 = Onderdelen voor volledige tekst en semantische indexering worden niet geïnstalleerd. NULL = Invoer is ongeldig, een fout of niet van toepassing. Basisgegevenstype: int |
IsHadrEnabled |
AlwaysOn-beschikbaarheidsgroepen zijn ingeschakeld op dit serverexemplaren. 0 = De functie AlwaysOn-beschikbaarheidsgroepen is uitgeschakeld. 1 = De functie AlwaysOn-beschikbaarheidsgroepen is ingeschakeld. NULL = Invoer is ongeldig, een fout of niet van toepassing. Als u beschikbaarheidsreplica's wilt maken en uitvoeren op een exemplaar van SQL Server, moeten AlwaysOn-beschikbaarheidsgroepen zijn ingeschakeld op het serverexemplaren. Zie De functie AlwaysOn-beschikbaarheidsgroep in- of uitschakelen voor meer informatie. Notitie: De IsHadrEnabled eigenschap heeft alleen betrekking op AlwaysOn-beschikbaarheidsgroepen. Andere functies voor hoge beschikbaarheid of herstel na noodgevallen, zoals databasespiegeling of logboekverzending, worden niet beïnvloed door deze servereigenschap.Van toepassing op: SQL Server. Basisgegevenstype: int |
IsIntegratedSecurityOnly |
Server bevindt zich in de geïntegreerde beveiligingsmodus. 1 = Geïntegreerde beveiliging (Windows-verificatie) 0 = Niet geïntegreerde beveiliging. (Zowel Windows-verificatie als SQL Server-verificatie.) NULL = Invoer is ongeldig, een fout of niet van toepassing. Basisgegevenstype: int |
IsLocalDB |
Server is een exemplaar van SQL Server Express LocalDB. NULL = Invoer is ongeldig, een fout of niet van toepassing. Van toepassing op: SQL Server. Basisgegevenstype: int |
IsPolyBaseInstalled |
Retourneert of het serverexemplaren de PolyBase-functie heeft geïnstalleerd. 0 = PolyBase is niet geïnstalleerd. 1 = PolyBase is geïnstalleerd. Van toepassing op: SQL Server 2016 (13.x) en latere versies. Basisgegevenstype: int |
IsServerSuspendedForSnapshotBackup |
Server bevindt zich in de onderbrekingsmodus en vereist ontdooiing op serverniveau. 1 = Onderbroken. 0 = Niet onderbroken. Basisgegevenstype: int |
IsSingleUser |
De server bevindt zich in de modus voor één gebruiker. 1 = Enkele gebruiker. 0 = Geen enkele gebruiker NULL = Invoer is ongeldig, een fout of niet van toepassing. Basisgegevenstype: int |
IsTempDbMetadataMemoryOptimized |
Retourneert 1 als tempdb deze is ingeschakeld voor het gebruik van tabellen die zijn geoptimaliseerd voor geheugen voor metagegevens; 0 als tempdb gewone, schijftabellen voor metagegevens worden gebruikt. Zie tempdb-database voor meer informatie.van toepassing op: SQL Server 2019 (15.x) en latere versies. Basisgegevenstype: int |
IsXTPSupported |
Server ondersteunt In-Memory OLTP. 1 = Server ondersteunt In-Memory OLTP. 0 = Server biedt geen ondersteuning voor In-Memory OLTP. NULL = Invoer is ongeldig, een fout of niet van toepassing. Van toepassing op: SQL Server 2014 (12.x) en latere versies en Azure SQL Database. Basisgegevenstype: int |
LCID |
LCID (Windows Locale Identifier) van de sortering. Basisgegevenstype: int |
LicenseType |
Unused. Licentiegegevens blijven niet behouden of onderhouden door het SQL Server-product. Retourneert altijd UITGESCHAKELD. Basisgegevenstype: nvarchar(128) |
MachineName |
Windows-computernaam waarop het serverexemplaren worden uitgevoerd. Voor een geclusterd exemplaar retourneert een exemplaar van SQL Server dat wordt uitgevoerd op een virtuele server in Microsoft Cluster Service de naam van de virtuele server. NULL = Invoer is ongeldig, een fout of niet van toepassing. Basisgegevenstype: nvarchar(128) |
NumLicenses |
Unused. Licentiegegevens blijven niet behouden of onderhouden door het SQL Server-product. Retourneert altijd NULL.Basisgegevenstype: int |
PathSeparator |
Retourneert \ in Windows en / linuxVan toepassing op: SQL Server 2017 (14.x) en latere versies. Basisgegevenstype: nvarchar |
ProcessID |
Proces-id van de SQL Server-service. ProcessID is handig bij het identificeren van welke Sqlservr.exe deel uitmaakt van dit exemplaar. NULL = Invoer is ongeldig, een fout of niet van toepassing. Basisgegevenstype: int |
ProductBuild |
Het buildnummer. Van toepassing op: SQL Server 2014 (12.x) en nieuwere versies. Basisgegevenstype: nvarchar(128) |
ProductBuildType |
Type build van de huidige build. Retourneert een van de volgende waarden: OD = On Demand brengt een specifieke klant vrij. GDR = Algemene distributierelease die is uitgebracht via Windows Update. NULL = Niet van toepassing. Van toepassing op: SQL Server. Basisgegevenstype: nvarchar(128) |
ProductLevel |
Niveau van de versie van het exemplaar van SQL Server. Retourneert een van de volgende waarden: 'RTM' = Oorspronkelijke releaseversie 'SPn' = servicepackversie 'CTPn', = Community Technology Preview-versie. Basisgegevenstype: nvarchar(128) |
ProductMajorVersion |
De primaire versie. Van toepassing op: SQL Server. Basisgegevenstype: nvarchar(128) |
ProductMinorVersion |
De secundaire versie. Van toepassing op: SQL Server. Basisgegevenstype: nvarchar(128) |
ProductUpdateLevel |
Updateniveau van de huidige build. CU geeft een cumulatieve update aan. Retourneert een van de volgende waarden: CUn = cumulatieve update NULL = Niet van toepassing. Van toepassing op: SQL Server en Azure SQL Managed Instance. Basisgegevenstype: nvarchar(128) |
ProductUpdateReference |
KB-artikel voor die release. Van toepassing op: SQL Server. Basisgegevenstype: nvarchar(128) |
ProductUpdateType |
Werk de frequentie van het exemplaar als volgt bij. Komt overeen met het azure SQL Managed Instance updatebeleid. Retourneert een van de volgende waarden: CU = Updates worden geïmplementeerd via cumulatieve updates (CU's) voor de bijbehorende primaire SQL Server-release (SQL Server 2022 updatebeleid). Continuous = New features are brought to Azure SQL Managed Instance zodra ze beschikbaar zijn, onafhankelijk van de SQL Server release cadence (Always-up-to-date update policy). Van toepassing op: Azure SQL Managed Instance. Basisgegevenstype: nvarchar(128) |
ProductVersion |
Versie van het exemplaar van SQL Server, in de vorm van major.minor.build.revision. Basisgegevenstype: nvarchar(128) |
ResourceLastUpdateDateTime |
Retourneert de datum en tijd waarop de resourcedatabase voor het laatst is bijgewerkt. Basisgegevenstype: datum/tijd |
ResourceVersion |
Retourneert de versieresourcedatabase. Basisgegevenstype: nvarchar(128) |
ServerName |
Zowel de Windows-server- als de exemplaargegevens die zijn gekoppeld aan een opgegeven instantie. NULL = Invoer is ongeldig of een fout. Basisgegevenstype: nvarchar(128) |
SqlCharSet |
De ID van de SQL-tekenset uit de sorterings-id. Basisgegevenstype: tinyint |
SqlCharSetName |
De naam van de SQL-tekenset uit de sortering. Basisgegevenstype: nvarchar(128) |
SqlSortOrder |
De sorteervolgorde-id van SQL uit de sortering. Basisgegevenstype: tinyint |
SqlSortOrderName |
De naam van de SQL-sorteervolgorde uit de sortering. Basisgegevenstype: nvarchar(128) |
SuspendedDatabaseCount |
Het aantal onderbroken databases op de server. Basisgegevenstype: int |
De volgende tabel bevat mogelijke waarden voor EditionID en Edition.
| EditionID | Edition |
|---|---|
1804890536 |
Enterprise |
1872460670 |
Enterprise Edition: Licenties op basis van kernen |
610778273 |
Enterprise-evaluatie |
284895786 |
Bedrijfsintelligentie |
-2117995310 |
Developer 1 of Developer Enterprise 2 |
-2509700633 |
Developer Standard 2 |
-1592396055 |
Express |
-133711905 |
Express met Geavanceerde services |
-1534726760 |
Standaard |
1293598313 |
Het web |
1674378470 |
SQL Database of Azure Synapse Analytics |
-1461570097 |
Azure SQL Edge Developer 3 |
1994083197 |
Azure SQL Edge 4 |
1Van toepassing op: SQL Server 2022 (16.x) en eerdere versies.
2Van toepassing op: SQL Server 2025 (17.x) Preview en latere versies.
3 Geeft de enige ontwikkelingseditie voor Azure SQL Edge aan.
4 Geeft de betaalde editie voor Azure SQL Edge aan.
Retourtypen
sql_variant
Remarks
Eigenschap ServerName
De ServerName eigenschap van de SERVERPROPERTY functie en @@SERVERNAME vergelijkbare informatie retourneren. De ServerName eigenschap biedt de naam van de Windows-server en het exemplaar die samen het unieke serverexemplaren vormen.
@@SERVERNAME biedt de momenteel geconfigureerde lokale servernaam.
De ServerName eigenschap en @@SERVERNAME dezelfde informatie retourneren als de standaardservernaam op het moment van de installatie niet is gewijzigd. De naam van de lokale server kan worden geconfigureerd door het volgende uit te voeren:
EXECUTE sp_dropserver 'current_server_name';
GO
EXECUTE sp_addserver 'new_server_name', 'local';
GO
Als de naam van de lokale server tijdens de installatie is gewijzigd van de standaardservernaam, retourneert @@SERVERNAME de nieuwe naam.
De ServerName eigenschap van de SERVERPROPERTY functie retourneert de windows-servernaam terwijl deze wordt opgeslagen. In eerdere primaire versies werd hoofdletters geretourneerd. Dit gedrag is gewijzigd in hoofdletters tussen SQL Server 2019 (15.x) CU 9 en CU 12, maar vanaf SQL Server 2019 (15.x) CU 13 wordt de servernaam geretourneerd wanneer deze wordt opgeslagen.
Als de Naam van de Windows-server kleine letters bevat, kan deze wijziging van het gedrag verschillen veroorzaken tussen de ServerName eigenschap van de SERVERPROPERTY functie en @@SERVERNAME (hoofdletters versus kleine letters), zelfs als er geen naamwijziging is voor de server.
Overweeg dat u een server hebt met de naam server01, met een SQL Server-exemplaar met de naam INST1. De volgende tabel bevat een overzicht van de wijziging van gedrag tussen verschillende builds van SQL Server 2019 (15.x):
| SQL Server 2019 -release (15.x) | SERVERPROPERTY('ServerName') | Aanvullende informatie |
|---|---|---|
| RTM | SERVER01\INST1 |
Retourneert de ServerName eigenschap in hoofdletters |
| CU 1 – CU 8 | server01\INST1 |
Retourneert de ServerName eigenschap als zodanig, zonder te worden gewijzigd in hoofdletters |
| CU 9 – CU 12 | SERVER01\INST1 |
Retourneert de ServerName eigenschap in hoofdletters |
| CU 13 en latere versies | server01\INST1 |
Retourneert de ServerName eigenschap as-is, zonder te veranderen in hoofdletters |
Versie-eigenschappen
De SERVERPROPERTY functie retourneert afzonderlijke eigenschappen die betrekking hebben op de versiegegevens, terwijl de functie @@VERSION de uitvoer combineert tot één tekenreeks. Als voor uw toepassing afzonderlijke eigenschapsreeksen zijn vereist, kunt u de SERVERPROPERTY functie gebruiken om deze te retourneren in plaats van de @@VERSION resultaten te parseren.
Permissions
Alle gebruikers kunnen query's uitvoeren op de servereigenschappen.
Examples
In het volgende voorbeeld wordt de SERVERPROPERTY functie in een SELECT instructie gebruikt om informatie te retourneren over het huidige exemplaar van SQL Server.
SELECT SERVERPROPERTY('MachineName') AS ComputerName,
SERVERPROPERTY('ServerName') AS InstanceName,
SERVERPROPERTY('Edition') AS Edition,
SERVERPROPERTY('ProductVersion') AS ProductVersion,
SERVERPROPERTY('ProductLevel') AS ProductLevel;
GO