Udostępnij za pomocą


SERVERPROPERTY (Transact-SQL)

Dotyczy:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)Punkt końcowy analizy SQL w usłudze Microsoft FabricHurtownia danych w usłudze Microsoft FabricBaza danych SQL w usłudze Microsoft Fabric

Zwraca informacje o właściwości dotyczące wystąpienia serwera.

Transact-SQL konwencje składni

Note

Microsoft Entra ID był wcześniej znany jako Azure Active Directory (Azure AD).

Syntax

SERVERPROPERTY ( 'propertyname' )

Important

Numery wersji aparatu bazy danych dla programów SQL Server i Azure SQL Database i Microsoft Fabric nie są porównywalne ze sobą i reprezentują wewnętrzne numery kompilacji dla tych oddzielnych produktów. Aparat bazy danych dla usługi Azure SQL Database bazuje na tym samym kodzie co aparat usługi SQL Server Database. Co najważniejsze, aparat bazy danych w Azure SQL Database zawsze obejmuje najnowsze składniki aparatu bazy danych SQL. Wersja 12 bazy danych Azure SQL Database jest nowsza niż wersja 16 programu SQL Server.

Arguments

propertyname

Wyrażenie zawierające informacje o właściwości, które mają zostać zwrócone dla serwera. propertyname może być jedną z następujących wartości. Użycie nazwy właściwości , która jest nieprawidłowa lub nieobsługiwana w tej wersji aparatu bazy danych zwraca wartość NULL.

Property Zwrócone wartości
BuildClrVersion Wersja środowiska uruchomieniowego języka wspólnego programu Microsoft .NET Framework (CLR) używanego podczas tworzenia wystąpienia programu SQL Server.

NULL = dane wejściowe są nieprawidłowe, błędy lub nie mają zastosowania.

Podstawowy typ danych: nvarchar(128)
Collation Nazwa domyślnego sortowania serwera.

NULL = dane wejściowe są nieprawidłowe lub wystąpił błąd.

Podstawowy typ danych: nvarchar(128)
CollationID Identyfikator sortowania programu SQL Server.

Podstawowy typ danych: int
ComparisonStyle Styl porównania systemu Windows sortowania.

Podstawowy typ danych: int
ComputerNamePhysicalNetBIOS Nazwa NetBIOS komputera lokalnego, na którym jest aktualnie uruchomione wystąpienie programu SQL Server.

W przypadku klastrowanego wystąpienia programu SQL Server w klastrze trybu failover ta wartość zmienia się w miarę przełączania wystąpienia programu SQL Server w tryb failover do innych węzłów w klastrze trybu failover.

W autonomicznym wystąpieniu programu SQL Server ta wartość pozostaje stała i zwraca tę samą wartość co MachineName właściwość.

Nuta: Jeśli wystąpienie programu SQL Server znajduje się w klastrze trybu failover i chcesz uzyskać nazwę wystąpienia klastra trybu failover, użyj MachineName właściwości .

NULL = dane wejściowe są nieprawidłowe, błędy lub nie mają zastosowania.

Podstawowy typ danych: nvarchar(128)
Edition Zainstalowana wersja produktu wystąpienia programu SQL Server. Użyj wartości tej właściwości, aby określić funkcje i limity, takie jak limity pojemności obliczeniowej według wersji programu SQL Server. 64-bitowe wersje aparatu bazy danych dołączają (64-bitowe) do wersji.

Użyj poniższej tabeli Edition , aby zidentyfikować możliwe wartości.

Podstawowy typ danych: nvarchar(128)
EditionID Reprezentuje identyfikator zainstalowanej wersji produktu wystąpienia programu SQL Server. Użyj wartości tej właściwości, aby określić funkcje i limity, takie jak limity pojemności obliczeniowej według wersji programu SQL Server.

Użyj poniższej tabeli Edition , aby zidentyfikować możliwe wartości.

Typ danych podstawowych: bigint
EngineEdition Wersja aparatu bazy danych wystąpienia programu SQL Server zainstalowanego na serwerze.

1 = Aparat osobisty lub klasyczny (niedostępne w programie SQL Server 2005 (9.x) i nowszych wersjach).
2 = Standardowa (dla standardowego, standardowego dewelopera, sieci Web i analizy biznesowej).
3 = Enterprise (dla wersji Enterprise, Enterprise Developer, Developer i Evaluation).
4 = Express (w przypadku usług Express, Express z narzędziami i Express z usługami Advanced Services)
5 = Baza danych SQL
6 = Azure Synapse Analytics
8 = Azure SQL Managed Instance
9 = Azure SQL Edge (dla wszystkich wersji usługi Azure SQL Edge)
11 = bezserwerowa pula SQL usługi Azure Synapse lub Microsoft Fabric
12 = baza danych SQL Microsoft Fabric w Microsoft Fabric.

Podstawowy typ danych: int
FilestreamConfiguredLevel Skonfigurowany poziom dostępu FILESTREAM. Aby uzyskać więcej informacji, zobacz poziom dostępu strumienia plików.

0 = FUNKCJA FILESTREAM jest wyłączona
1 = FUNKCJA FILESTREAM jest włączona dla dostępu Transact-SQL
2 = FILESTREAM jest włączona dla Transact-SQL i lokalnego dostępu do przesyłania strumieniowego Win32
3 = FILESTREAM jest włączony dla Transact-SQL i zarówno lokalnego, jak i zdalnego dostępu do przesyłania strumieniowego Win32.

Podstawowy typ danych: int
FilestreamEffectiveLevel Efektywny poziom dostępu FILESTREAM. Ta wartość może być inna niż FilestreamConfiguredLevel, jeśli poziom został zmieniony, a ponowne uruchomienie wystąpienia lub ponowne uruchomienie komputera jest oczekujące. Aby uzyskać więcej informacji, zobacz poziom dostępu strumienia plików.

0 = FUNKCJA FILESTREAM jest wyłączona
1 = FUNKCJA FILESTREAM jest włączona dla dostępu Transact-SQL
2 = FILESTREAM jest włączona dla Transact-SQL i lokalnego dostępu do przesyłania strumieniowego Win32
3 = FILESTREAM jest włączony dla Transact-SQL i zarówno lokalnego, jak i zdalnego dostępu do przesyłania strumieniowego Win32.

Podstawowy typ danych: int
FilestreamShareName Nazwa udziału używanego przez FILESTREAM.

NULL = dane wejściowe są nieprawidłowe, błędy lub nie mają zastosowania.

Podstawowy typ danych: nvarchar(128)
HadrManagerStatus Wskazuje, czy menedżer zawsze włączonych grup dostępności został uruchomiony.

0 = Nie uruchomiono, oczekiwanie na komunikację.
1 = Uruchomiono i uruchomiono.
2 = Nie uruchomiono i nie powiodło się.
NULL = dane wejściowe są nieprawidłowe, błędy lub nie mają zastosowania.

Podstawowy typ danych: int
InstanceDefaultBackupPath Nazwa domyślnej ścieżki do plików kopii zapasowej wystąpienia.

Dotyczy: SQL Server 2019 (15.x) i nowsze wersje.

Podstawowy typ danych: nvarchar(128)
InstanceDefaultDataPath Nazwa domyślnej ścieżki do plików danych wystąpienia.

Dotyczy: SQL Server.

Podstawowy typ danych: nvarchar(128)
InstanceDefaultLogPath Nazwa domyślnej ścieżki do plików dziennika wystąpienia.

Dotyczy: SQL Server.

Podstawowy typ danych: nvarchar(128)
InstanceName Nazwa wystąpienia, z którym jest połączony użytkownik.

Zwraca wartość NULL , jeśli nazwa wystąpienia jest wystąpieniem domyślnym, jeśli dane wejściowe są nieprawidłowe lub błąd.

NULL = dane wejściowe są nieprawidłowe, błędy lub nie mają zastosowania.

Podstawowy typ danych: nvarchar(128)
IsAdvancedAnalyticsInstalled Zwraca wartość 1, jeśli funkcja analizy zaawansowanej została zainstalowana podczas instalacji; 0, jeśli usługa Advanced Analytics nie została zainstalowana.

Podstawowy typ danych: int
IsBigDataCluster Wprowadzono w programie SQL Server 2019 (15.x) począwszy od aktualizacji CU 4.

Zwraca wartość 1, jeśli wystąpienie jest klastrem danych big data programu SQL Server; 0, jeśli nie.

Podstawowy typ danych: int
IsClustered Wystąpienie serwera jest skonfigurowane w klastrze trybu failover.

1 = Klastrowane.
0 = nie klastrowane.
NULL = dane wejściowe są nieprawidłowe, błędy lub nie mają zastosowania.

Podstawowy typ danych: int
IsExternalAuthenticationOnly Zwraca, czy jest włączone uwierzytelnianie tylko firmy Microsoft .

1 = Włączono uwierzytelnianie tylko firmy Microsoft.
0 = uwierzytelnianie tylko firmy Microsoft jest wyłączone.

Dotyczy: Azure SQL Database i Azure SQL Managed Instance.

Podstawowy typ danych: int
IsExternalGovernanceEnabled Zwraca, czy zasady dostępu usługi Microsoft Purview są włączone.

1 = włączony jest nadzór zewnętrzny.
0 = zarządzanie zewnętrzne jest wyłączone.

Dotyczy: SQL Server 2022 (16.x) i nowsze wersje.

Podstawowy typ danych: int
IsFullTextInstalled Składniki indeksowania pełnotekstowego i semantycznego są instalowane w bieżącym wystąpieniu programu SQL Server.

1 = instalowane są składniki indeksowania pełnotekstowego i semantycznego.
0 = składniki indeksowania pełnotekstowego i semantycznego nie są zainstalowane.
NULL = dane wejściowe są nieprawidłowe, błędy lub nie mają zastosowania.

Podstawowy typ danych: int
IsHadrEnabled Zawsze włączone grupy dostępności są włączone w tym wystąpieniu serwera.

0 = funkcja Zawsze włączone grupy dostępności jest wyłączona.
1 = funkcja Zawsze włączone grupy dostępności jest włączona.
NULL = dane wejściowe są nieprawidłowe, błędy lub nie mają zastosowania.

Aby repliki dostępności mogły być tworzone i uruchamiane w wystąpieniu programu SQL Server, zawsze włączone grupy dostępności muszą być włączone w wystąpieniu serwera. Aby uzyskać więcej informacji, zobacz Włączanie lub wyłączanie funkcji zawsze włączonej grupy dostępności.

Nuta: Właściwość IsHadrEnabled dotyczy tylko zawsze włączonych grup dostępności. Inne funkcje wysokiej dostępności lub odzyskiwania po awarii, takie jak dublowanie bazy danych lub wysyłanie dziennika, nie mają wpływu na tę właściwość serwera.

Dotyczy: SQL Server.

Podstawowy typ danych: int
IsIntegratedSecurityOnly Serwer jest w zintegrowanym trybie zabezpieczeń.

1 = zintegrowane zabezpieczenia (uwierzytelnianie systemu Windows)
0 = Niezintegowane zabezpieczenia. (Zarówno uwierzytelnianie systemu Windows, jak i uwierzytelnianie programu SQL Server).
NULL = dane wejściowe są nieprawidłowe, błędy lub nie mają zastosowania.

Podstawowy typ danych: int
IsLocalDB Serwer jest wystąpieniem bazy danych SQL Server Express LocalDB.

NULL = dane wejściowe są nieprawidłowe, błędy lub nie mają zastosowania.

Dotyczy: SQL Server.

Podstawowy typ danych: int
IsPolyBaseInstalled Zwraca, czy wystąpienie serwera ma zainstalowaną funkcję PolyBase.

0 = nie zainstalowano programu PolyBase.
1 = zainstalowano program PolyBase.

Dotyczy: SQL Server 2016 (13.x) i nowsze wersje.

Podstawowy typ danych: int
IsServerSuspendedForSnapshotBackup Serwer jest w trybie wstrzymania i wymaga odmrożenia na poziomie serwera.

1 = Zawieszone.
0 = Nie zawieszone.

Podstawowy typ danych: int
IsSingleUser Serwer jest w trybie pojedynczego użytkownika.

1 = Pojedynczy użytkownik.
0 = nie pojedynczy użytkownik
NULL = dane wejściowe są nieprawidłowe, błędy lub nie mają zastosowania.

Podstawowy typ danych: int
IsTempDbMetadataMemoryOptimized Zwraca wartość 1, jeśli tempdb włączono używanie tabel zoptymalizowanych pod kątem pamięci dla metadanych; 0, jeśli tempdb używa zwykłych tabel opartych na dyskach dla metadanych. Aby uzyskać więcej informacji, zobacz baza danych tempdb.

Dotyczy: SQL Server 2019 (15.x) i nowsze wersje.

Podstawowy typ danych: int
IsXTPSupported Serwer obsługuje In-Memory OLTP.

1 = Serwer obsługuje In-Memory OLTP.
0 = Serwer nie obsługuje In-Memory OLTP.
NULL = dane wejściowe są nieprawidłowe, błędy lub nie mają zastosowania.

Dotyczy: SQL Server 2014 (12.x) i nowsze wersje oraz Azure SQL Database.

Podstawowy typ danych: int
LCID Identyfikator ustawień regionalnych systemu Windows (LCID) sortowania.

Podstawowy typ danych: int
LicenseType Unused. Informacje o licencji nie są zachowywane ani obsługiwane przez produkt PROGRAMU SQL Server. Zawsze zwraca wartość WYŁĄCZONE.

Podstawowy typ danych: nvarchar(128)
MachineName Nazwa komputera z systemem Windows, na którym działa wystąpienie serwera.

W przypadku wystąpienia klastrowanego wystąpienie programu SQL Server uruchomione na serwerze wirtualnym w usłudze klastra firmy Microsoft zwraca nazwę serwera wirtualnego.

NULL = dane wejściowe są nieprawidłowe, błędy lub nie mają zastosowania.

Podstawowy typ danych: nvarchar(128)
NumLicenses Unused. Informacje o licencji nie są zachowywane ani obsługiwane przez produkt PROGRAMU SQL Server. Zawsze zwraca wartość NULL.

Podstawowy typ danych: int
PathSeparator Zwraca wartość \ w systemie Windows i / w systemie Linux

Dotyczy: SQL Server 2017 (14.x) i nowsze wersje.

Podstawowy typ danych: nvarchar
ProcessID Identyfikator procesu usługi SQL Server. Identyfikator processID jest przydatny podczas identyfikowania, który Sqlservr.exe należy do tego wystąpienia.

NULL = dane wejściowe są nieprawidłowe, błędy lub nie mają zastosowania.

Podstawowy typ danych: int
ProductBuild Numer kompilacji.

Dotyczy: SQL Server 2014 (12.x) i nowsze wersje.

Podstawowy typ danych: nvarchar(128)
ProductBuildType Typ kompilacji bieżącej kompilacji.

Zwraca jedną z następujących wartości:

OD = Wydanie na żądanie określonego klienta.
GDR = wersja dystrybucji ogólnej wydana za pośrednictwem usługi Windows Update.
NULL = Nie dotyczy.

Dotyczy: SQL Server.

Podstawowy typ danych: nvarchar(128)
ProductLevel Poziom wersji wystąpienia programu SQL Server.

Zwraca jedną z następujących wartości:

"RTM" = oryginalna wersja wydania
'SPn' = wersja dodatku Service Pack
"CTPn", = wersja Community Technology Preview.

Podstawowy typ danych: nvarchar(128)
ProductMajorVersion Wersja główna.

Dotyczy: SQL Server.

Podstawowy typ danych: nvarchar(128)
ProductMinorVersion Wersja pomocnicza.

Dotyczy: SQL Server.

Podstawowy typ danych: nvarchar(128)
ProductUpdateLevel Poziom aktualizacji bieżącej kompilacji. Cu wskazuje aktualizację zbiorczą.

Zwraca jedną z następujących wartości:

CUn = aktualizacja zbiorcza
NULL = Nie dotyczy.

Dotyczy: SQL Server i Azure SQL Managed Instance.

Podstawowy typ danych: nvarchar(128)
ProductUpdateReference Artykuł bazy wiedzy dla tej wersji.

Dotyczy: SQL Server.

Podstawowy typ danych: nvarchar(128)
ProductUpdateType Zaktualizuj cykl wystąpienia zgodnie z instrukcjami. Odpowiada zasadom aktualizacji usługi Azure SQL Managed Instance.

Zwraca jedną z następujących wartości:

CU = Aktualizacje są wdrażane za pośrednictwem aktualizacji zbiorczych (CU) dla odpowiedniej głównej wersji programu SQL Server (zasady aktualizacji programu SQL Server 2022 ).

Continuous = Nowe funkcje są wprowadzane do usługi Azure SQL Managed Instance, gdy tylko są dostępne, niezależnie od rytmu wydania programu SQL Server (zawsze —up-to— zasady aktualizacji daty).

Dotyczy: Azure SQL Managed Instance.

Podstawowy typ danych: nvarchar(128)
ProductVersion Wersja wystąpienia programu SQL Server w postaci major.minor.build.revision.

Podstawowy typ danych: nvarchar(128)
ResourceLastUpdateDateTime Zwraca datę i godzinę ostatniej aktualizacji bazy danych zasobów.

Podstawowy typ danych: data/godzina
ResourceVersion Zwraca wersję bazy danych zasobów.

Podstawowy typ danych: nvarchar(128)
ServerName Zarówno serwer systemu Windows, jak i informacje o wystąpieniu skojarzone z określonym wystąpieniem.

NULL = dane wejściowe są nieprawidłowe lub wystąpił błąd.

Podstawowy typ danych: nvarchar(128)
SqlCharSet Identyfikator zestawu znaków SQL z identyfikatora sortowania.

Podstawowy typ danych: tinyint
SqlCharSetName Nazwa zestawu znaków SQL z sortowania.

Podstawowy typ danych: nvarchar(128)
SqlSortOrder Identyfikator kolejności sortowania SQL z sortowania.

Podstawowy typ danych: tinyint
SqlSortOrderName Nazwa kolejności sortowania SQL z sortowania.

Podstawowy typ danych: nvarchar(128)
SuspendedDatabaseCount Liczba zawieszonych baz danych na serwerze.

Podstawowy typ danych: int

W poniższej tabeli wymieniono możliwe wartości dla EditionID i Edition.

Identyfikator edycji Edition
1804890536 Enterprise
1872460670 Enterprise Edition: licencjonowanie oparte na rdzeniach
610778273 Ocena przedsiębiorstwa
284895786 Analiza biznesowa
-2117995310 Developer 1 lub Developer Enterprise 2
-2509700633 Standard deweloperski 2
-1592396055 Ekspresowy
-133711905 Express z usługami zaawansowanymi
-1534726760 Standard
1293598313 Web 1
1674378470 SQL Database lub Azure Synapse Analytics
-1461570097 Azure SQL Edge Developer 3
1994083197 Azure SQL Edge 4

1Dotyczy: SQL Server 2022 (16.x) i starsze wersje.
2Dotyczy do: SQL Server 2025 (17.x) i nowszych wersji.
3 Wskazuje tylko wydanie programistyczne dla usługi Azure SQL Edge.
4 Wskazuje płatną wersję usługi Azure SQL Edge.

Typy zwracane

sql_variant

Remarks

Właściwość ServerName

Właściwość ServerNameSERVERPROPERTY funkcji i @@SERVERNAME zwraca podobne informacje. Właściwość ServerName udostępnia nazwę serwera i wystąpienia systemu Windows, które razem tworzą unikatowe wystąpienie serwera. @@SERVERNAME udostępnia obecnie skonfigurowaną nazwę serwera lokalnego.

Właściwość ServerName i @@SERVERNAME zwracają te same informacje, jeśli domyślna nazwa serwera w czasie instalacji nie została zmieniona. Nazwę serwera lokalnego można skonfigurować, wykonując następujące czynności:

EXECUTE sp_dropserver 'current_server_name';
GO

EXECUTE sp_addserver 'new_server_name', 'local';
GO

Jeśli nazwa serwera lokalnego została zmieniona z domyślnej nazwy serwera w czasie instalacji, @@SERVERNAME zwraca nową nazwę.

Właściwość ServerNameSERVERPROPERTY funkcji zwraca nazwę serwera systemu Windows, ponieważ jest zapisywana. W poprzednich wersjach głównych zwróciła wielkie litery. To zachowanie zmieniło się z powrotem na wielkie litery między programem SQL Server 2019 (15.x) CU 9 i CU 12, ale począwszy od programu SQL Server 2019 (15.x) CU 13, nazwa serwera jest zwracana podczas zapisywania.

Jeśli nazwa serwera systemu Windows zawiera jakiekolwiek małe litery, ta zmiana zachowania może spowodować różnice między ServerName właściwością SERVERPROPERTY funkcji i @@SERVERNAME (wielkie litery i małe litery), nawet jeśli nie ma zmiany nazwy serwera.

Rozważ, że masz serwer o nazwie , server01z wystąpieniem programu SQL Server o nazwie INST1. W poniższej tabeli przedstawiono podsumowanie zmian zachowania między różnymi kompilacjami programu SQL Server 2019 (15.x):

Wersja programu SQL Server 2019 (15.x) SERVERPROPERTY('ServerName') Dodatkowe informacje
RTM SERVER01\INST1 ServerName Zwraca właściwość w wielkiej literze
CU 1 – CU 8 server01\INST1 ServerName Zwraca właściwość tak, jak to jest, bez zmiany na wielkie litery
CU 9 – CU 12 SERVER01\INST1 ServerName Zwraca właściwość w wielkiej literze
CU 13 i nowsze wersje server01\INST1 ServerName Zwraca właściwość as-is, bez zmiany na wielkie litery

Właściwości wersji

Funkcja SERVERPROPERTY zwraca poszczególne właściwości, które odnoszą się do informacji o wersji, podczas gdy funkcja @@VERSION łączy dane wyjściowe w jeden ciąg. Jeśli aplikacja wymaga pojedynczych ciągów właściwości, możesz użyć SERVERPROPERTY funkcji , aby je zwrócić zamiast analizować wyniki @@VERSION .

Permissions

Wszyscy użytkownicy mogą wykonywać zapytania dotyczące właściwości serwera.

Examples

W poniższym przykładzie użyto SERVERPROPERTY funkcji w SELECT instrukcji w celu zwrócenia informacji o bieżącym wystąpieniu programu SQL Server.

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