Ескертпе
Бұл бетке кіру үшін қатынас шегін айқындау қажет. Жүйеге кіруді немесе каталогтарды өзгертуді байқап көруге болады.
Бұл бетке кіру үшін қатынас шегін айқындау қажет. Каталогтарды өзгертуді байқап көруге болады.
Применимо к:
SQL ServerБаза данных Azure SQLУправляемый экземпляр Azure SQLAzure Synapse AnalyticsСистема платформы аналитики (PDW)Конечная точка SQL аналитики в Microsoft FabricХранилище в Microsoft FabricБаза данных SQL в Microsoft Fabric
Возвращает сведения о свойстве экземпляра сервера.
Соглашения о синтаксисе Transact-SQL
Note
Идентификатор Microsoft Entra ранее был известен как Azure Active Directory (Azure AD).
Syntax
SERVERPROPERTY ( 'propertyname' )
Important
Номера версий ядра СУБД для SQL Server и Базы данных SQL Azure и Microsoft Fabric не сравниваются друг с другом и представляют внутренние номера сборок для этих отдельных продуктов. Ядро СУБД Базы данных SQL Azure основано на той же базе кода, что и ядро СУБД SQL Server. Что важнее всего, ядро СУБД в базе данных Azure SQL всегда имеет самые новые части ядра СУБД SQL. Версия 12 базы данных Azure SQL более новая, чем версия 16 SQL Server.
Arguments
propertyname
Выражение, содержащее сведения о свойстве, которые необходимо вернуть для сервера.
свойствоname может быть одним из следующих значений. Использование имени свойства , недопустимого или не поддерживаемого в этой версии ядра СУБД NULL.
| Property | Возвращаемые значения |
|---|---|
BuildClrVersion |
Версия среды CLR( среда CLR) Microsoft платформа .NET Framework, которая использовалась при создании экземпляра SQL Server. NULL = входные данные недопустимы, ошибка или неприменимо. Базовый тип данных: nvarchar(128) |
Collation |
Имя параметров сортировки для сервера, установленного по умолчанию. NULL = входные данные недопустимы или ошибка. Базовый тип данных: nvarchar(128) |
CollationID |
Идентификатор параметров сортировки SQL Server. Базовый тип данных: int |
ComparisonStyle |
Стиль сравнения Windows для параметров сортировки. Базовый тип данных: int |
ComputerNamePhysicalNetBIOS |
NetBIOS-имя локального компьютера, на котором в настоящее время выполняется экземпляр SQL Server. Для кластеризованного экземпляра SQL Server в отказоустойчивом кластере это значение изменяется при отработке отказа экземпляра SQL Server на другие узлы в отказоустойчивом кластере. В автономном экземпляре SQL Server это значение остается постоянным и возвращает то же значение, что MachineName и свойство.Заметка: Если экземпляр SQL Server находится в отказоустойчивом кластере и вы хотите получить имя отказоустойчивого кластеризованного экземпляра, используйте MachineName это свойство.NULL = входные данные недопустимы, ошибка или неприменимо. Базовый тип данных: nvarchar(128) |
Edition |
Установленный выпуск продукта экземпляра SQL Server. Используйте значение этого свойства для определения функций и ограничений, таких как ограничения емкости вычислений по выпуску SQL Server. 64-разрядные версии ядро СУБД добавления (64-разрядного) к версии. Используйте следующую таблицу Edition , чтобы определить возможные значения. Базовый тип данных: nvarchar(128) |
EditionID |
Представляет идентификатор установленного выпуска продукта экземпляра SQL Server. Используйте значение этого свойства для определения функций и ограничений, таких как ограничения емкости вычислений по выпуску SQL Server. Используйте следующую таблицу Edition , чтобы определить возможные значения. Базовый тип данных: bigint |
EngineEdition |
ядро СУБД выпуск экземпляра SQL Server, установленного на сервере. 1 = персональный или классический модуль (недоступно в SQL Server 2005 (9.x) и более поздних версиях.) 2 = Standard (для стандартного, стандартного разработчика, веб-аналитики и бизнес-аналитики).) 3 = Корпоративные (для корпоративных, корпоративных разработчиков, разработчиков и выпусков оценки).) 4 = Express (для Express, Express с инструментами и Express с расширенными службами) 5 = База данных SQL 6 = Azure Synapse Analytics 8 = Управляемый экземпляр SQL Azure 9 = Azure SQL Edge (для всех выпусков Azure SQL Edge) 11 = бессерверный пул SQL Azure Synapse или Microsoft Fabric 12 = SQL база данных Microsoft Fabric в Microsoft Fabric. Базовый тип данных: int |
FilestreamConfiguredLevel |
Настроенный уровень доступа FILESTREAM. Дополнительные сведения см. в разделе Уровень доступа к файловому потоку. 0 = FILESTREAM отключен 1 = FILESTREAM включен для доступа Transact-SQL 2 = FILESTREAM включен для потокового доступа Transact-SQL и локального потокового доступа Win32 3 = FILESTREAM включен для Transact-SQL и локального и удаленного потокового доступа Win32. Базовый тип данных: int |
FilestreamEffectiveLevel |
Действующий уровень доступа FILESTREAM. Это значение может отличаться от значения FilestreamConfiguredLevel, если уровень был изменен и ожидается перезапуск экземпляра или перезагрузка компьютера. Дополнительные сведения см. в разделе Уровень доступа к файловому потоку. 0 = FILESTREAM отключен 1 = FILESTREAM включен для доступа Transact-SQL 2 = FILESTREAM включен для потокового доступа Transact-SQL и локального потокового доступа Win32 3 = FILESTREAM включен для Transact-SQL и локального и удаленного потокового доступа Win32. Базовый тип данных: int |
FilestreamShareName |
Имя общего ресурса, используемое FILESTREAM. NULL = входные данные недопустимы, ошибка или неприменимо. Базовый тип данных: nvarchar(128) |
HadrManagerStatus |
Указывает, запущен ли диспетчер групп доступности AlwaysOn. 0 = не запущен, ожидает связи. 1 = запущен и выполняется. 2 = не запущен и завершился неудачно. NULL = входные данные недопустимы, ошибка или неприменимо. Базовый тип данных: int |
InstanceDefaultBackupPath |
Имя пути по умолчанию к файлам резервных копий экземпляра. Область применения: SQL Server 2019 (15.x) и более поздних версий. Базовый тип данных: nvarchar(128) |
InstanceDefaultDataPath |
Имя пути по умолчанию к файлам данных экземпляра. Область применения: SQL Server. Базовый тип данных: nvarchar(128) |
InstanceDefaultLogPath |
Имя пути по умолчанию к файлам журналов экземпляра. Область применения: SQL Server. Базовый тип данных: nvarchar(128) |
InstanceName |
Имя экземпляра, к которому подключен пользователь. Возвращает NULL , если имя экземпляра является экземпляром по умолчанию, если входные данные недопустимы или ошибка.NULL = входные данные недопустимы, ошибка или неприменимо. Базовый тип данных: nvarchar(128) |
IsAdvancedAnalyticsInstalled |
Возвращает значение 1, если компонент расширенной аналитики был установлен во время установки системы, или значение 0, если компонент расширенной аналитики не был установлен. Базовый тип данных: int |
IsBigDataCluster |
Представлено в SQL Server 2019 (15.x) начиная с накопительного пакета обновления 4 (CU 4). Возвращает значение 1, если экземпляр является кластером больших данных SQL Server, в противном случае — значение 0. Базовый тип данных: int |
IsClustered |
Экземпляр сервера настроен для работы в отказоустойчивом кластере. 1 = в кластере. 0 = не в кластере. NULL = входные данные недопустимы, ошибка или неприменимо. Базовый тип данных: int |
IsExternalAuthenticationOnly |
Возвращает значение, включена ли проверка подлинности только для Microsoft Entra. 1 = включена проверка подлинности только для записи Майкрософт. 0 = проверка подлинности только для записи Майкрософт отключена. Область применения. Эта статья относится к Базе данных SQL Azure и Управляемому экземпляру SQL Azure. Базовый тип данных: int |
IsExternalGovernanceEnabled |
Возвращает, включены ли политики доступа Microsoft Purview. 1 = включена внешняя система управления. 0 = внешняя система управления отключена. Область применения: SQL Server 2022 (16.x) и более поздних версий. Базовый тип данных: int |
IsFullTextInstalled |
Компоненты полнотекстового и семантического индексирования устанавливаются в текущем экземпляре SQL Server. 1 = компоненты полнотекстового и семантического индексирования установлены. 0 = компоненты полнотекстового и семантического индексирования не установлены. NULL = входные данные недопустимы, ошибка или неприменимо. Базовый тип данных: int |
IsHadrEnabled |
Группы доступности AlwaysOn включены на этом экземпляре сервера. 0 = функция групп доступности AlwaysOn отключена. 1 = включена функция групп доступности AlwaysOn. NULL = входные данные недопустимы, ошибка или неприменимо. Для создания и запуска реплик доступности на экземпляре SQL Server необходимо включить группы доступности AlwaysOn на экземпляре сервера. Дополнительные сведения см. в разделе "Включить" или отключить функцию группы доступности AlwaysOn. Заметка: Свойство IsHadrEnabled относится только к группам доступности AlwaysOn. Другие возможности высокого уровня доступности или аварийного восстановления, такие как зеркальное отображение базы данных или доставка журналов, не затрагиваются этим свойством сервера.Область применения: SQL Server. Базовый тип данных: int |
IsIntegratedSecurityOnly |
Сервер запущен во встроенном режиме безопасности. 1 = встроенная безопасность (проверка подлинности Windows) 0 = без встроенного режима безопасности. (Проверка подлинности Windows и проверка подлинности SQL Server.) NULL = входные данные недопустимы, ошибка или неприменимо. Базовый тип данных: int |
IsLocalDB |
Сервер — это экземпляр SQL Server Express LocalDB. NULL = входные данные недопустимы, ошибка или неприменимо. Область применения: SQL Server. Базовый тип данных: int |
IsPolyBaseInstalled |
Возвращает значение, показывающее, установлен ли компонент PolyBase в экземпляре сервера. 0 = компонент PolyBase не установлен. 1 = компонент PolyBase установлен. Область применения: SQL Server 2016 (13.x) и более поздних версий. Базовый тип данных: int |
IsServerSuspendedForSnapshotBackup |
Сервер находится в режиме приостановки и требует оттаивания уровня сервера. 1 = приостановлено. 0 = не приостановлено. Базовый тип данных: int |
IsSingleUser |
Server запущен в однопользовательском режиме. 1 = однопользовательский режим. 0 = не однопользовательский режим. NULL = входные данные недопустимы, ошибка или неприменимо. Базовый тип данных: int |
IsTempDbMetadataMemoryOptimized |
Возвращает значение 1, если оно было включено для использования оптимизированных для памяти таблиц для метаданных; 0, если tempdbtempdb используется обычная таблица на основе дисков для метаданных. Дополнительные сведения см. в статье tempdb Database.Область применения: SQL Server 2019 (15.x) и более поздних версий. Базовый тип данных: int |
IsXTPSupported |
Сервер поддерживает компонент In-Memory OLTP. 1 = сервер поддерживает компонент In-Memory OLTP. 0 = сервер не поддерживает компонент In-Memory OLTP. NULL = входные данные недопустимы, ошибка или неприменимо. Область применения: SQL Server 2014 (12.x) и более поздних версий, а также база данных SQL Azure. Базовый тип данных: int |
LCID |
Код локали Windows для параметров сортировки. Базовый тип данных: int |
LicenseType |
Unused. Информация о лицензии не сохраняется и не поддерживается продуктом SQL Server. Всегда возвращает DISABLED. Базовый тип данных: nvarchar(128) |
MachineName |
Имя компьютера Windows, на котором запущен экземпляр сервера. Для кластеризованного экземпляра экземпляра SQL Server, работающего на виртуальном сервере в службе кластеров Майкрософт, он возвращает имя виртуального сервера. NULL = входные данные недопустимы, ошибка или неприменимо. Базовый тип данных: nvarchar(128) |
NumLicenses |
Unused. Информация о лицензии не сохраняется и не поддерживается продуктом SQL Server. Всегда возвращает значение NULL.Базовый тип данных: int |
PathSeparator |
Возвращает \ в Windows и / в Linux.Область применения: SQL Server 2017 (14.x) и более поздних версий. Базовый тип данных: nvarchar |
ProcessID |
Идентификатор процесса службы SQL Server. С помощью свойства ProcessID удобно определять, какой файл Sqlservr.exe принадлежит этому экземпляру. NULL = входные данные недопустимы, ошибка или неприменимо. Базовый тип данных: int |
ProductBuild |
Номер сборки. Область применения: SQL Server 2014 (12.x) и более поздних версий. Базовый тип данных: nvarchar(128) |
ProductBuildType |
Тип текущей сборки. Возвращает одно из следующих значений: OD = выпуск по запросу для определенного клиента. GDR = выпуск для общего распространения через Центр обновления Windows. NULL = неприменимо. Область применения: SQL Server. Базовый тип данных: nvarchar(128) |
ProductLevel |
Уровень версии экземпляра SQL Server. Возвращает одно из следующих значений: 'RTM' = Исходная выпущенная версия 'SPn' = версия пакета обновления CTPn, = версия Community Technology Preview. Базовый тип данных: nvarchar(128) |
ProductMajorVersion |
Основная версия. Область применения: SQL Server. Базовый тип данных: nvarchar(128) |
ProductMinorVersion |
Дополнительная версия. Область применения: SQL Server. Базовый тип данных: nvarchar(128) |
ProductUpdateLevel |
Уровень обновления текущей сборки. CU означает накопительный пакет обновления. Возвращает одно из следующих значений: CUn = накопительный пакет обновления NULL = неприменимо. Применимо: SQL Server и Управляемый экземпляр SQL Azure. Базовый тип данных: nvarchar(128) |
ProductUpdateReference |
Статья базы знаний для этого выпуска. Область применения: SQL Server. Базовый тип данных: nvarchar(128) |
ProductUpdateType |
Обновите периодичность экземпляра следующим образом. Соответствует политике обновления Управляемый экземпляр SQL Azure. Возвращает одно из следующих значений: CU = обновления развертываются с помощью накопительных обновлений (CUS) для соответствующего основного выпуска SQL Server (политика обновления SQL Server 2022 ). Непрерывно = новые функции передаются в Управляемый экземпляр SQL Azure сразу после их доступности, независимо от срока выпуска SQL Server (политика обновления always-up-to-date ). Область применения: Управляемый экземпляр SQL Azure. Базовый тип данных: nvarchar(128) |
ProductVersion |
Версия экземпляра SQL Server в форме major.minor.build.revision. Базовый тип данных: nvarchar(128) |
ResourceLastUpdateDateTime |
Отображаются дата и время последнего изменения базы данных Resource. Базовый тип данных: datetime |
ResourceVersion |
Возвращает версию базы данных Resource. Базовый тип данных: nvarchar(128) |
ServerName |
Сведения о сервере Windows и экземпляре, связанные с указанным экземпляром. NULL = входные данные недопустимы или ошибка. Базовый тип данных: nvarchar(128) |
SqlCharSet |
Идентификатор кодировки SQL из идентификатора параметров сортировки. Базовый тип данных: tinyint |
SqlCharSetName |
Имя кодировки SQL из параметров сортировки. Базовый тип данных: nvarchar(128) |
SqlSortOrder |
Идентификатор порядка сортировки SQL из параметров сортировки. Базовый тип данных: tinyint |
SqlSortOrderName |
Имя порядка сортировки SQL из параметров сортировки Базовый тип данных: nvarchar(128) |
SuspendedDatabaseCount |
Количество приостановленных баз данных на сервере. Базовый тип данных: int |
В следующей таблице перечислены возможные значения для EditionID и Edition.
| EditionID | Издание |
|---|---|
1804890536 |
Предприятие |
1872460670 |
Enterprise Edition: лицензирование на основе ядра |
610778273 |
Корпоративная оценка |
284895786 |
Бизнес-аналитика |
-2117995310 |
Разработчик 1 или разработчик Enterprise 2 |
-1785266663 |
Разработчик уровня "Стандартный 2" |
-1592396055 |
Express |
-133711905 |
Экспресс с расширенными службами |
-1534726760 |
Стандарт |
1293598313 |
Веб-1 |
1674378470 |
База данных SQL или Azure Synapse Analytics |
-1461570097 |
Разработчик SQL Azure для пограничных вычислений 3 |
1994083197 |
Azure SQL Edge 4 |
1Применимо к: SQL Server 2022 (16.x) и более ранним версиям.
2Применимо к: SQL Server 2025 (17.x) и более поздним версиям.
3Применимо к: Azure SQL Edge (выпуск разработки).
4Применимо к: Azure SQL Edge (платная версия).
Типы возвращаемых данных
sql_variant
Remarks
Свойство ServerName
Свойство ServerName функции SERVERPROPERTY и функция @@SERVERNAME возвращают аналогичные сведения. В свойстве ServerName задаются имена экземпляра и сервера Windows, которые вместе образуют уникальный экземпляр сервера.
@@SERVERNAME возвращает настроенное имя локального сервера.
Свойство ServerName и переменная @@SERVERNAME возвращают одинаковые сведения, если установленное по умолчанию имя сервера не было изменено во время установки. Имя локального сервера можно настроить, выполнив следующие команды:
EXECUTE sp_dropserver 'current_server_name';
GO
EXECUTE sp_addserver 'new_server_name', 'local';
GO
Если имя локального сервера было изменено во время установки и отличается от заданного по умолчанию, то функция @@SERVERNAME будет возвращать новое имя.
Свойство ServerNameSERVERPROPERTY функции возвращает имя сервера Windows по мере его сохранения. В предыдущих основных версиях он вернул верхний регистр. Это поведение изменилось обратно в верхний регистр между SQL Server 2019 (15.x) CU 9 и CU 12, но начиная с SQL Server 2019 (15.x) CU 13, имя сервера возвращается по мере сохранения.
Если имя сервера Windows содержит любые строчные символы, это изменение поведения может привести к различиям между ServerName свойством SERVERPROPERTY функции и @@SERVERNAME (верхним регистром и строчным регистром), даже если имя сервера не изменяется.
Предположим, у вас есть сервер с именем server01 и экземпляр SQL Server с именем INST1. В следующей таблице приводится сводка изменений поведения между различными сборками SQL Server 2019 (15.x):
| Выпуск SQL Server 2019 (15.x) | SERVERPROPERTY('ServerName') | Дополнительные сведения |
|---|---|---|
| RTM | SERVER01\INST1 |
Возвращает свойство ServerName в верхнем регистре |
| CU 1 — CU 8 | server01\INST1 |
Возвращает свойство ServerName как есть, без изменения на верхний регистр |
| CU 9 — CU 12 | SERVER01\INST1 |
Возвращает свойство ServerName в верхнем регистре |
| Накопительный пакет обновления 13 и более поздние версии | server01\INST1 |
Возвращает свойство ServerName как есть, без изменения на верхний регистр |
Свойства версии
Функция SERVERPROPERTY возвращает отдельные свойства, которые относятся к информации о версии, а функция @@VERSION объединяет все выходные данные в одну строку. Если для конкретного приложения требуются отдельные строки свойств, лучше использовать функцию SERVERPROPERTY, которая возвращает эти строки, чем заниматься синтаксическим анализом результатов функции @@VERSION.
Permissions
Все пользователи могут запрашивать свойства сервера.
Examples
В следующем примере функция в SERVERPROPERTY инструкции используется SELECT для возврата сведений о текущем экземпляре SQL Server.
SELECT SERVERPROPERTY('MachineName') AS ComputerName,
SERVERPROPERTY('ServerName') AS InstanceName,
SERVERPROPERTY('Edition') AS Edition,
SERVERPROPERTY('ProductVersion') AS ProductVersion,
SERVERPROPERTY('ProductLevel') AS ProductLevel;
GO