Udostępnij za pośrednictwem


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 FabricMagazyn w usłudze Microsoft FabricBaza danych SQL w usłudze Microsoft Fabric (wersja zapoznawcza)

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 poniższych wartości. Użycie nazwy właściwości , która jest nieprawidłowa lub nie jest obsługiwana w tej wersji aparatu bazy danych, zwróci wartość NULL.

Property Values returned
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łąd lub nie dotyczy.

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łąd lub nie dotyczy.

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.

Returns:

'Enterprise Edition'

"Wersja Enterprise: licencjonowanie oparte na rdzeniach"

"Enterprise Evaluation Edition"

"Business Intelligence Edition"

'Developer Edition'

'Express Edition'

"Express Edition with Advanced Services" (Wersja Express z usługami zaawansowanymi)

'Standard Edition'

'Web Edition'

"SQL Azure" wskazuje usługę SQL Database lub Azure Synapse Analytics lub Microsoft Fabric

"Azure SQL Edge Developer" wskazuje tylko wersję dewelopera dla usługi Azure SQL Edge

"Azure SQL Edge" wskazuje płatną wersję usługi Azure SQL Edge

Podstawowy typ danych: nvarchar(128)
EditionID EditionID reprezentuje zainstalowaną wersję 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.

1804890536 = Enterprise

1872460670 = Enterprise Edition: licencjonowanie oparte na rdzeniach

610778273 = Ocena przedsiębiorstwa

284895786 = analiza biznesowa

-2117995310 = Developer

-1592396055 = Express

-133711905 = Express z usługami zaawansowanymi

-1534726760 = Standardowa

1293598313 = Sieć Web

1674378470 = SQL Database lub Azure Synapse Analytics

-1461570097 = Deweloper usługi Azure SQL Edge

1994083197 = Azure SQL Edge

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 standardu, sieci Web i analizy biznesowej).

3 = Enterprise (wersje Ewaluacyjne, Developer i Enterprise).

4 = Express (w przypadku usług Express, Express z narzędziami i Express z usługami Advanced Services)

5 = SQL Database

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 = Punkt końcowy analizy SQL usługi 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łąd lub nie dotyczy.

Podstawowy typ danych: nvarchar(128)
HadrManagerStatus Dotyczy: SQL Server 2012 (11.x) i nowsze.

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łąd lub nie dotyczy.

Podstawowy typ danych: int
InstanceDefaultBackupPath Dotyczy: SQL Server 2019 (15.x) i nowszych.

Nazwa domyślnej ścieżki do plików kopii zapasowej wystąpienia.
InstanceDefaultDataPath Dotyczy: PROGRAM SQL Server 2012 (11.x) do bieżącej wersji w aktualizacjach rozpoczynających się pod koniec 2015 roku.

Nazwa domyślnej ścieżki do plików danych wystąpienia.

Podstawowy typ danych: nvarchar(128)
InstanceDefaultLogPath Dotyczy: PROGRAM SQL Server 2012 (11.x) do bieżącej wersji w aktualizacjach rozpoczynających się pod koniec 2015 roku.

Nazwa domyślnej ścieżki do plików dziennika wystąpienia.

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łąd lub nie dotyczy.

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łąd lub nie dotyczy.

Podstawowy typ danych: int
IsExternalAuthenticationOnly Dotyczy: Azure SQL Database i Azure SQL Managed Instance.

Zwraca, czy jest włączone uwierzytelnianie tylko firmy Microsoft .

1 = Włączono uwierzytelnianie tylko firmy Microsoft.

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

Podstawowy typ danych: int
IsExternalGovernanceEnabled Dotyczy: SQL Server 2022 (16.x) i nowszych.

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.

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łąd lub nie dotyczy.

Podstawowy typ danych: int
IsHadrEnabled Dotyczy: SQL Server 2012 (11.x) i nowsze.

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łąd lub nie dotyczy.

Podstawowy typ danych: int

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 i wyłączanie zawsze włączonych grup dostępności (SQL Server).

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.
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łąd lub nie dotyczy.

Podstawowy typ danych: int
IsLocalDB Dotyczy: SQL Server 2012 (11.x) i nowsze.

Serwer jest wystąpieniem bazy danych SQL Server Express LocalDB.

NULL = Dane wejściowe są nieprawidłowe, błąd lub nie dotyczy.

Podstawowy typ danych: int
IsPolyBaseInstalled Dotyczy: SQL Server 2016 (13.x).

Zwraca, czy wystąpienie serwera ma zainstalowaną funkcję PolyBase.

0 = nie zainstalowano programu PolyBase.

1 = zainstalowano program PolyBase.

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łąd lub nie dotyczy.

Podstawowy typ danych: int
IsTempDbMetadataMemoryOptimized Dotyczy: SQL Server 2019 (15.x) i nowszych.

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.

Podstawowy typ danych: int
IsXTPSupported Dotyczy: SQL Server (SQL Server 2014 (12.x) i nowsze), SQL Database.

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łąd lub nie dotyczy.

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łąd lub nie dotyczy.

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 Dotyczy: SQL Server 2017 (14.x) i nowszych.

Zwraca wartość \ w systemie Windows i / w systemie Linux

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łąd lub nie dotyczy.

Podstawowy typ danych: int
ProductBuild Dotyczy: SQL Server 2014 (12.x) począwszy od października 2015 r.

Numer kompilacji.

Podstawowy typ danych: nvarchar(128)
ProductBuildType Dotyczy: PROGRAM SQL Server 2012 (11.x) do bieżącej wersji w aktualizacjach rozpoczynających się pod koniec 2015 roku.

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.

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', = Community Technology Preview version

Podstawowy typ danych: nvarchar(128)
ProductMajorVersion Dotyczy: PROGRAM SQL Server 2012 (11.x) do bieżącej wersji w aktualizacjach rozpoczynających się pod koniec 2015 roku.

Wersja główna.

Podstawowy typ danych: nvarchar(128)
ProductMinorVersion Dotyczy: PROGRAM SQL Server 2012 (11.x) do bieżącej wersji w aktualizacjach rozpoczynających się pod koniec 2015 roku.

Wersja pomocnicza.

Podstawowy typ danych: nvarchar(128)
ProductUpdateLevel Dotyczy: PROGRAM SQL Server 2012 (11.x) do bieżącej wersji w aktualizacjach rozpoczynających się pod koniec 2015 r. i azure SQL Managed Instance.

Poziom aktualizacji bieżącej kompilacji. Cu wskazuje aktualizację zbiorczą.

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

CUn = aktualizacja zbiorcza

NULL = Nie dotyczy.

Podstawowy typ danych: nvarchar(128)
ProductUpdateReference Dotyczy: PROGRAM SQL Server 2012 (11.x) do bieżącej wersji w aktualizacjach rozpoczynających się pod koniec 2015 roku.

Artykuł bazy wiedzy dla tej wersji.

Podstawowy typ danych: nvarchar(128)
ProductUpdateType Dotyczy: Azure SQL Managed Instance

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 natychmiast po ich udostępnieniu, niezależnie od cykli wydania programu SQL Server (zawsze —up-to— zasady aktualizacji daty).

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 zamówienia 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

Return types

sql_variant

Remarks

ServerName property

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:

EXEC sp_dropserver 'current_server_name';
GO
EXEC 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 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') Additional information
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

Version properties

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

Aby uzyskać listę funkcji obsługiwanych przez wersje programu SQL Server w systemie Windows, zobacz: