Заметка
Доступ к этой странице требует авторизации. Вы можете попробовать войти в систему или изменить каталог.
Доступ к этой странице требует авторизации. Вы можете попробовать сменить директорию.
Применимо к:
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 |
-2509700633 |
Разработчик уровня "Стандартный 2" |
-1592396055 |
Express |
-133711905 |
Экспресс с расширенными службами |
-1534726760 |
Стандарт |
1293598313 |
Web 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 Указывает только выпуск разработки для SQL Azure Для Пограничных вычислений.
4 Указывает платный выпуск для Sql Azure 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